문서 스냅샷 · CLI 7.30.1 · SDK 2.6.53. Desktop은 자체 릴리스에 포함된 런타임을 사용합니다. 명령과 예제는 영어 원문을 유지합니다. 영어 원문

모델 선택 및 변경

사용 가능한 모델 찾기

먼저 공급자를 연결합니다. 터미널 UI에서 /models를 입력하고 연결된 공급자 안에서 모델을 검색해 선택합니다. 즐겨찾기와 최근 선택을 통해 다시 찾을 수 있습니다.

선택기는 공급자별로 모델을 묶습니다. 필수 텍스트 출력이나 도구 호출 능력이 없는 모델은 숨겨지거나 비활성화될 수 있습니다. 관리형 로컬 모델은 가중치 다운로드 전에도 표시될 수 있으므로 사용 전에 준비를 마치세요.

설치된 CLI에서 사용 가능한 ID는 다음으로 확인합니다:

ax-code models
ax-code models --json --verbose

완전한 provider/model ID를 복사합니다. 같은 표시 이름도 공급자가 다르면 인증 정보, 기능, 제한이 다를 수 있습니다.

예시 값을 설치된 버전이 출력한 ID로 바꿉니다. 첫 명령은 터미널 UI를 열고, 두 번째는 프롬프트 하나를 실행합니다. 프롬프트는 -- 뒤에 둡니다.

MODEL='provider/model'
ax-code --model "$MODEL"
ax-code run --model "$MODEL" -- "Explain the project entry point without changing files."

계열 별칭 deepseek, glm, qwen는 사용 가능한 연결을 통해 지원 Flash 모델을 선택합니다. 대상은 릴리스마다 바뀔 수 있습니다. 특정 모델이나 등급을 지정하려면 완전한 ID를 사용하세요. 단독 SKU는 완전한 ID가 아닙니다.

다음 필드를 기존 프로젝트 또는 전역 ax-code.json에 병합합니다. 전체 파일 대신 자리표시자만 바꾸세요:

{
  "model": "provider/model"
}

편집 후 재시작합니다. 모델을 명시하지 않으면 기존 에이전트, 세션, 최근 선택이 영향을 줄 수 있습니다. 작업을 보내기 전에 활성 모델을 확인하세요. Desktop은 자체 설정을 관리합니다.

작은 저장소 질문부터 시작합니다. 편집 시 도구 호출을 확인하고 프로젝트 검사를 실행하세요. 이미지에는 이미지 입력 지원을 확인합니다. 긴 작업은 모델 이름보다 컨텍스트와 출력 한도를 확인하세요.

동일한 작업, 입력, 승인 검사로 후보를 비교합니다. 지연, 공급자 이용 약관, 데이터 처리, 로컬 메모리 요구량을 고려하세요. 어떤 모델도 올바른 변경을 보장하지 않습니다.

추론 강도와 자동 라우팅은 별개 설정입니다. 라우팅을 켜기 전에 모델 하나를 명시해서 시작하세요. Wiki 생성은 포그라운드 세션과 별도로 자체 wiki.model을 사용할 수 있습니다.

목록에 없음: 공급자가 연결되고 활성화되었는지 확인한 뒤 기능 필터와 게이트웨이 검색을 점검합니다. 홍보 이름으로 ID를 만들지 마세요.
인증 또는 권한 오류: 정확한 요청 모델 ID와 계정·키 권한을 확인합니다. 로그인이나 목록 조회 성공이 실행 권한을 뜻하지는 않습니다.
로컬 준비 또는 메모리 오류: 다운로드와 로드를 마치고 하드웨어 요구 사항을 확인합니다. 작업량을 줄이거나 지원되는 더 작은 모델을 선택하세요.