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

첫 모델 공급자 연결하기

연결 방식 선택

공급자는 모델 서비스로 연결하는 통로이며, 모델은 그 연결에서 선택하는 개별 모델입니다. 공급자를 연결한다고 모든 모델이 선택되거나 계정 권한이 생기지는 않습니다.

터미널 UI에서 /connect를 입력하고 아래 경로를 선택합니다. Desktop은 자체 공급자 설정과 번들 런타임을 사용합니다. 이 슬래시 명령은 터미널 UI 기준입니다.

클라우드 API: API Cloud Provider에서 서비스를 선택하고 안내에 따라 인증 정보를 입력합니다. 채팅 구독에 API 접근이나 API 크레딧이 포함되는 것은 아닙니다.
코딩 CLI: 지원 CLI를 먼저 설치하고 로그인한 뒤 CLI Provider를 선택합니다. AX Code는 해당 로컬 로그인을 재사용하며, 기능은 어댑터에 따라 다릅니다.
로컬 모델: Ollama 또는 LM Studio를 시작하고 도구 호출을 지원하는 모델을 로드한 뒤 Local LLM runtime에서 엔드포인트를 확인합니다. 지원 Mac의 AX-Engine runtime에는 별도 설정과 모델 다운로드 절차가 있습니다.
게이트웨이: AX Trust 엔드포인트는 AX Trust, 다른 게이트웨이는 API Cloud Provider → Custom API provider, 전용 호환 배포는 Private GPU cloud를 선택합니다. 서비스 URL, 토큰, 실제로 공개된 정확한 모델 ID를 입력합니다.

연결 확인

대화형 터미널에서 다음 명령을 실행합니다. 로그인 명령은 공급자와 인증 정보를 묻습니다. 실제 키를 공유 명령이나 저장소 파일에 붙여 넣지 마세요.

ax-code providers login
ax-code providers list
ax-code models

공급자와 사용 가능한 모델 ID가 보여야 합니다. 인증 정보 저장이나 모델 목록 조회 성공만으로 추론 권한이 입증되지는 않습니다. 모델 선택으로 이동해 작은 테스트 요청을 보내세요.

인증 정보와 설정 관리

/providers로 연결을 관리하고 /connect로 키를 교체합니다. 비활성화는 저장된 인증 정보를 유지하고, 연결 해제는 저장된 인증 정보를 삭제합니다. 환경 변수나 설정된 키로 여전히 접근할 수도 있습니다.

공유할 비밀이 아닌 설정은 프로젝트 ax-code.json, 개인 기본값은 전역 ~/.config/ax-code/ax-code.json에 둡니다. 비밀을 버전 관리에 넣지 말고 인증 프롬프트나 게이트웨이 안내의 환경 변수 참조를 사용하세요. 수동 편집 후 재시작합니다.

설정이 실패한 경우

인증 실패: 키가 선택한 서비스, 엔드포인트, API 요금제에 속하는지 확인합니다. 코딩 CLI는 자체 로그인을 먼저 확인하세요.
빈 모델 목록 또는 연결 거부: 로컬 서버 실행, 모델 로드, URL과 포트를 확인합니다. Ollama는 보통 http://localhost:11434/v1, LM Studio는 http://localhost:1234/v1을 사용합니다.
모델 거부: 엔드포인트의 정확한 ID와 계정 권한을 확인합니다. 게이트웨이 표시 이름은 상위 요청 ID와 다를 수 있습니다.
공급자가 없음: enabled_providers와 disabled_providers를 확인합니다. 설치 진단은 ax-code doctor를 실행하세요. 공급자 계정을 검증하는 명령은 아닙니다.

다음 단계

공급자 목록과 로그인 방법 · 사용자 지정 게이트웨이와 전용 GPU 엔드포인트 · 모델 선택 · AX Wiki 만들기 · 문서 홈