Qwen Code

Qwen Code는 ~/.qwen/settings.json의 modelProviders에서 엔드포인트를 읽습니다 — baseUrl과 envKey가 있는 항목 하나로 /model 선택기에서 Claude와 GPT를 사용할 수 있습니다

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI-compatible",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "env": {
    "KUNAVO_API_KEY": "sk-kn-..."
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. ~/.qwen/settings.json를 열고(없으면 새로 만드세요) 위의 네 블록을 병합하세요. 문서에서는 “프로젝트 설정과 사용자 설정 간 병합 충돌을 방지하기 위해” modelProviders를 사용자 범위 파일에 선언할 것을 권장합니다.
3. 가능하면 키를 env보다 안전한 곳에 두세요. Qwen Code는 process.env[envKey]에서 키를 읽습니다. 문서에 따르면 우선순위는 높은 순서대로 셸 export, .env 파일, 그리고 settings.json의 env 블록이며, 마지막 방식은 평문 저장이라고 명시되어 있습니다. 위의 env 블록은 실행에 필요한 최소 설정이지, 계속 보관하기에 가장 좋은 방식은 아닙니다.
4. qwen를 실행하세요. security.auth.selectedType가 openai로 설정되고 model.name가 선언한 id와 일치하면 대화형 /auth 단계가 필요하지 않습니다. 한 파일 예시 뒤에서 문서가 이를 명확히 설명합니다.
5. 인사말이 아니라 파일을 읽고 수정하는 작업을 맡기세요. Qwen Code는 에이전트입니다. 첫 실행에서는 도구 호출과 스트리밍을 확인해야 하며, 이 두 기능은 호환성이 불완전한 엔드포인트에서 가장 먼저 실패합니다.
6. modelProviders.openai 아래에 항목을 더 추가하면 /model로 실행 중 모델을 전환할 수 있습니다. 이 설정은 실행 중인 세션에서 핫 리로드되지만, providerProtocol는 시작 시 한 번 읽으므로 변경 후 재시작해야 합니다.

Qwen Code 인증 페이지, 옵션 4: API 키(유연한 방식)에서 확인했습니다(2026년 9월 21일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Qwen Code에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

문서로 확인되는 사실 세 가지: 사람들이 자주 잘못 짐작하는 부분

위에 링크한 인증 페이지와 모델 제공업체 참조 문서에서 확인한 내용입니다. 문서를 읽지 않고 추측하면 각각 실제 디버깅 시간을 잡아먹습니다.

1. modelProviders 항목은 CLI 플래그보다 우선합니다. 문서에 명시된 우선순위는 높은 순서대로 실행 중인 세션에서 /auth로 설정한 재정의, 선택한 모델 제공업체의 envKey, --openai-api-key 같은 CLI 인수, 환경 변수, 설정의 security.auth.apiKey입니다. 대부분은 플래그가 우선한다고 생각하지만 그렇지 않습니다. 그래서 --openai-base-url가 무시되는 것처럼 보일 수 있습니다.
2. security.auth.apiKey와 security.auth.baseUrl는 더 이상 사용되지 않습니다. 참조 문서에서도 이를 명시하고 modelProviders로 이전할 것을 권장합니다. 오래된 튜토리얼에서 이 두 키를 수정하라고 한다면, 곧 폐기될 경로를 설정하고 있는 것입니다.
3. wireApi가 요청 형식을 결정하며, 형식 불일치를 감지하는 기능은 없습니다. 이를 생략하면 위 설정 블록에서 사용하는 Chat Completions가 기본값으로 선택됩니다. "wireApi": "responses"를 설정하려면 실제로 Responses와 호환되는 엔드포인트가 필요합니다. 문서에는 요청이 실패해도 엔드포인트를 감지하거나 자동으로 대체 경로를 사용하지 않는다고 명시되어 있습니다. Kunavo는 /v1/responses와 /v1/chat/completions 모두에 응답하지만, 이 페이지에서는 어느 조합도 테스트하지 않았으므로 기본값으로 시작하세요.

무료 요금제를 찾아 이곳에 오셨다면

Qwen Code에 관한 기존 자료 중 상당수는 일일 무료 한도가 있는 Qwen OAuth 로그인을 설명합니다. 이 옵션은 더 이상 제공되지 않습니다. 문서에 따르면 무료 요금제는 2026년 4월 15일에 종료되었으며, Qwen OAuth는 이제 /auth 대화상자에서 선택할 수 없습니다. 현재 문서에 나오는 항목은 Alibaba ModelStudio(하위 메뉴에 Coding Plan, Token Plan, Standard API Key 포함), Third-party Providers, 그리고 “로컬 서버, 프록시 또는 지원되지 않는 제공업체”에 연결하는 기능으로 설명된 Custom Provider입니다. Kunavo는 이 세 번째 항목입니다. ModelStudio 하위 메뉴의 항목들은 하나의 청구 방식에서 고르는 세 가지 옵션이 아닙니다. 각 항목은 호스트와 키가 별개이므로, Token Plan 호스트에서 Coding Plan 키를 사용할 수 없습니다.