인증

Qwen Code의 첫 실행 /auth 메뉴에는 세 가지 최상위 옵션이 있습니다. CLI를 실행하려는 방식에 맞는 것을 선택하세요:

• Alibaba ModelStudio: 공식 권장 설정. Coding Plan(개인 개발자용 · 주간 할당량 포함), Token Plan(팀 및 회사용 · 전용 엔드포인트의 사용량 기반 과금) 또는 Standard API Key(기존 ModelStudio API 키로 연결) 중 하나를 선택하는 하위 메뉴를 엽니다. Token Plan과 Standard API Key는 추가 설정 없이 내장 web_search 도구를 활성화합니다.
• Third-party Providers: 내장 제공자를 선택하고 API 키로 연결합니다(DeepSeek, Grok, MiniMax, Z.AI, Idealab, ModelScope, OpenRouter, Requesty).
• Custom Provider: 로컬 서버, 프록시 또는 지원되지 않는 제공자를 수동으로 연결합니다 — OpenAI, Anthropic, Gemini 및 기타 호환 엔드포인트를 지원합니다.

옵션 1: Qwen OAuth (중단됨)

• 작동 방식: 첫 시작 시 Qwen Code가 브라우저 로그인 페이지를 엽니다. 완료 후 자격 증명이 로컬에 캐시되어 일반적으로 다시 로그인할 필요가 없습니다.
• 요구 사항: qwen.ai 계정 + 인터넷 접근(최소 첫 로그인 시).
• 이점: API 키 관리 불필요, 자동 자격 증명 갱신.
• 비용 및 할당량: 무료 티어는 2026-04-15부로 중단되었습니다.

CLI를 시작하고 브라우저 흐름을 따르세요:

qwen

Qwen OAuth는 더 이상 /auth 대화상자에서 선택 가능한 항목으로 제공되지 않습니다. /auth를 실행하고 현재 옵션 중 하나(Alibaba ModelStudio, Third-party Providers 또는 Custom Provider)를 대신 선택하세요.

💳 옵션 2: Alibaba Cloud Coding Plan

예측 가능한 비용과 다양한 모델 옵션 및 더 높은 사용량 할당량을 원하는 경우 사용하세요.

• 작동 방식: 고정 월 요금으로 Coding Plan을 구독한 다음, 전용 엔드포인트와 구독 API 키를 사용하도록 Qwen Code를 구성합니다.
• 요구 사항: Alibaba Cloud ModelStudio(베이징)  또는 Alibaba Cloud ModelStudio(국제) 에서 계정 지역에 따라 활성 Coding Plan 구독을 획득합니다.
• 이점: 다양한 모델 옵션, 더 높은 사용량 할당량, 예측 가능한 월 비용, 다양한 모델(Qwen, GLM, Kimi, Minimax 등)에 대한 접근.
• 비용 및 할당량: Aliyun ModelStudio Coding Plan 문서 베이징 국제 를 참조하세요.

Alibaba Cloud Coding Plan은 두 지역에서 사용 가능합니다:

대화형 설정

터미널에서 qwen을 입력하여 Qwen Code를 실행한 다음, /auth 명령을 실행하고 Alibaba ModelStudio를 선택한 후 하위 메뉴에서 Coding Plan을 선택합니다. 지역을 선택한 다음 sk-sp-xxxxxxxxx 키를 입력합니다.

인증 후 /model 명령을 사용하여 모든 Alibaba Cloud Coding Plan 지원 모델(qwen3.5-plus, qwen3.6-plus, qwen3.7-plus, qwen3-coder-plus, qwen3-coder-next, qwen3-max-2026-01-23, glm-5, glm-4.7, kimi-k2.5 및 MiniMax-M2.5 포함) 간에 전환합니다.

헤드리스 또는 스크립트 설정

CI, 컨테이너 또는 스크립트의 경우 제거된 qwen auth coding-plan 명령 대신 환경 변수 또는 settings.json으로 Coding Plan을 구성합니다.

export BAILIAN_CODING_PLAN_API_KEY="sk-sp-xxxxxxxxx"
export OPENAI_BASE_URL="https://coding.dashscope.aliyuncs.com/v1"
export OPENAI_MODEL="qwen3-coder-plus"

중국(베이징) 엔드포인트에는 https://coding.dashscope.aliyuncs.com/v1을, 국제 엔드포인트에는 https://coding-intl.dashscope.aliyuncs.com/v1을 사용하세요.

대안: settings.json을 통한 구성

대화형 /auth 흐름을 건너뛰려면 ~/.qwen/settings.json에 다음을 추가하세요:

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus (Coding Plan)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "qwen3-coder-plus from Alibaba Cloud Coding Plan",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      }
    ]
  },
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

🪙 옵션 3: Alibaba Cloud Token Plan

팀이나 회사가 전용 ModelStudio 엔드포인트에서 사용량 기반 과금을 선호하는 경우 사용하세요.

• 작동 방식: Alibaba Cloud ModelStudio에서 Token Plan을 구독한 다음, 지역별 Token Plan 엔드포인트와 API 키를 사용하도록 Qwen Code를 구성합니다. 고정 월 요금 대신 실제 토큰 사용량에 대해 과금됩니다.
• 요구 사항: 계정 지역에 따라 Alibaba Cloud ModelStudio(베이징)  또는 Alibaba Cloud ModelStudio(국제) 에서 Token Plan API 키를 획득합니다.
• 이점: 팀 및 회사용 사용량 기반 과금, 전용 지역별 엔드포인트, 다양한 모델(Qwen, DeepSeek, GLM, Kimi, Minimax 등)에 대한 접근.
• 비용 및 할당량: Alibaba Cloud ModelStudio Token Plan 문서 베이징  국제 를 참조하세요.

Token Plan은 두 지역에서 사용 가능하며, 각 지역마다 전용 엔드포인트가 있습니다:

대화형 설정

터미널에서 qwen을 입력하여 Qwen Code를 실행한 다음, /auth 명령을 실행하고 Alibaba ModelStudio를 선택한 후 하위 메뉴에서 Token Plan을 선택합니다. 지역을 선택합니다(중국(베이징) 또는 싱가포르(국제)). 그런 다음 API 키를 입력합니다. 마법사가 마지막 단계(3/3단계 · 모델 ID)를 표시하며, 여기서 구성할 모델 ID를 선택합니다: 엔드포인트에서 제공하는 모델이 여기에 표시되며 명시적으로 선택한 경우에만 적용됩니다. Token Plan API 키는 접두사 요구 사항이 없습니다(Coding Plan 키와 달리 sk-sp-로 시작하지 않음).

인증 후 /model 명령을 사용하여 Token Plan에 구성된 모델을 탐색하고 전환합니다. 모델 라인업은 시간이 지남에 따라 변화하므로 의도적으로 여기에 나열하지 않습니다. 엔드포인트에서의 모델 검색은 위의 /auth 설정 단계에서 발생합니다(엔드포인트 자체 목록이 여기에 표시되며 명시적으로 선택해야 함). /model은 그러면 계획에 구성된 모델을 표시합니다.

헤드리스 또는 스크립트 설정

CI, 컨테이너 또는 스크립트의 경우 대화형 /auth 흐름 대신 환경 변수 또는 settings.json으로 Token Plan을 구성합니다.

export BAILIAN_TOKEN_PLAN_API_KEY="your-api-key"
export OPENAI_BASE_URL="https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3.7-plus"

중국(베이징) 엔드포인트에는 https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1을, 국제(싱가포르) 엔드포인트에는 https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1을 사용하세요. qwen3.7-plus를 계획에 포함된 다른 모델로 교체하세요.

BAILIAN_TOKEN_PLAN_API_KEY는 제공자별 키입니다: 다음 섹션의 settings.json 제공자 항목이 존재하면 효과가 있는데, 해당 항목이 이를 envKey로 선언하기 때문입니다. 환경 변수만으로 OpenAI 호환 인증을 선택하려면 대신 OPENAI_API_KEY를 export하세요 — 제공자별 키만으로는 인증 유형을 선택할 수 없습니다.

대안: settings.json을 통한 구성

대화형 /auth 흐름을 건너뛰려면 ~/.qwen/settings.json에 다음을 추가하세요:

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.7-plus",
        "name": "qwen3.7-plus (Token Plan)",
        "baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
        "description": "qwen3.7-plus from Alibaba Cloud Token Plan",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      }
    ]
  },
  "env": {
    "BAILIAN_TOKEN_PLAN_API_KEY": "your-api-key"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.7-plus"
  }
}

🚀 옵션 4: API Key (유연한)

OpenAI, Anthropic, Google, Azure OpenAI, OpenRouter, Requesty, ModelScope 또는 자체 호스팅 엔드포인트와 같은 타사 제공자에 연결하려는 경우 사용하세요. 여러 프로토콜과 제공자를 지원합니다.

권장: settings.json을 통한 단일 파일 설정

API Key 인증으로 시작하는 가장 간단한 방법은 모든 것을 단일 ~/.qwen/settings.json 파일에 넣는 것입니다. 다음은 완전하고 바로 사용할 수 있는 예시입니다:

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "description": "Qwen3-Coder via Dashscope",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "env": {
    "DASHSCOPE_API_KEY": "sk-xxxxxxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

각 필드의 역할:

파일을 저장한 후 qwen을 실행하면 됩니다 — 대화형 /auth 설정이 필요 없습니다.

핵심 개념은 모델 제공자(modelProviders)입니다: Qwen Code는 OpenAI 외에도 여러 API 프로토콜을 지원합니다. ~/.qwen/settings.json을 편집하여 어떤 제공자와 모델을 사용할 수 있는지 구성한 다음, 런타임에 /model 명령으로 전환합니다.

지원되는 프로토콜

1단계: ~/.qwen/settings.json에서 모델 및 제공자 구성

각 프로토콜에 대해 사용 가능한 모델을 정의합니다. 각 모델 항목에는 최소한 id가 필요합니다. envKey(API 키를 보관하는 환경 변수 이름)는 선택 사항이며 권장됩니다 — 생략 시 auth 유형의 기본 환경 키(예: openai의 경우 OPENAI_API_KEY)로 폴백됩니다.

~/.qwen/settings.json을 편집합니다(없으면 생성). 단일 파일에서 여러 프로토콜을 혼합할 수 있습니다 — 다음은 modelProviders 섹션만 보여주는 다중 제공자 예시입니다:

{
  "modelProviders": {
    "openai": [
      {
        "id": "gpt-4o",
        "name": "GPT-4o",
        "envKey": "OPENAI_API_KEY",
        "baseUrl": "https://api.openai.com/v1"
      }
    ],
    "anthropic": [
      {
        "id": "claude-sonnet-4-20250514",
        "name": "Claude Sonnet 4",
        "envKey": "ANTHROPIC_API_KEY"
      }
    ],
    "gemini": [
      {
        "id": "gemini-2.5-pro",
        "name": "Gemini 2.5 Pro",
        "envKey": "GEMINI_API_KEY"
      }
    ]
  }
}

ModelConfig 필드(modelProviders 내의 각 항목):

modelProviders의 전체 스키마 및 generationConfig, customHeaders 및 extra_body와 같은 고급 옵션에 대해서는 모델 제공자 레퍼런스를 참조하세요.

2단계: 환경 변수 설정

Qwen Code는 모델 구성의 envKey로 지정된 환경 변수에서 API 키를 읽습니다. 아래에 최우선에서 최하위 우선순위 순으로 나열된 여러 방법이 있습니다:

1. 셸 환경 / export(최우선)

셸 프로필(~/.zshrc, ~/.bashrc 등)에서 직접 설정하거나 시작 전에 인라인으로 설정합니다:

 
# Alibaba Dashscope
export DASHSCOPE_API_KEY="sk-..."
 
# OpenAI / OpenAI 호환
export OPENAI_API_KEY="sk-..."
 
# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."
 
# Google GenAI
export GEMINI_API_KEY="AIza..."

2. .env 파일

Qwen Code는 찾는 첫 번째 .env 파일을 자동 로드합니다(여러 파일 간에 변수가 병합되지 않음). process.env에 아직 없는 변수만 로드됩니다.

검색 순서(현재 디렉토리에서 /를 향해 위로 올라가며 검색):

1. .qwen/.env(권장 — Qwen Code 변수를 다른 도구와 격리)
2. .env

아무것도 찾지 못하면 홈 디렉토리로 폴백합니다:

3. ~/.qwen/.env
4. ~/.env

3. settings.json → env 필드(최하위 우선순위)

~/.qwen/settings.json의 env 키 아래에 직접 API 키를 정의할 수도 있습니다. 이들은 최하위 우선순위 폴백으로 로드됩니다 — 시스템 환경 또는 .env 파일에서 변수가 이미 설정되지 않은 경우에만 적용됩니다.

{
  "env": {
    "DASHSCOPE_API_KEY": "sk-...",
    "OPENAI_API_KEY": "sk-...",
    "ANTHROPIC_API_KEY": "sk-ant-..."
  }
}

이것은 단일 파일 설정 예시에서 사용되는 접근 방식입니다. 모든 것을 한 곳에 보관하기에 편리하지만, settings.json이 공유되거나 동기화될 수 있으므로 민감한 비밀에는 .env 파일을 선호하세요.

우선순위 요약:

3단계: /model로 모델 전환

Qwen Code를 시작한 후 /model 명령을 사용하여 구성된 모든 모델 간에 전환합니다. 모델은 프로토콜별로 그룹화됩니다:

/model

선택기는 modelProviders 구성의 모든 모델을 프로토콜별(예: openai, anthropic, gemini)로 그룹화하여 표시합니다. 선택은 세션 간에 지속됩니다.

명령줄 인수로 모델을 직접 전환할 수도 있으며, 여러 터미널에서 작업할 때 편리합니다.

# 한 터미널에서
 
qwen --model "qwen3-coder-plus"
 
# 다른 터미널에서
 
qwen --model "qwen3.5-plus"

제거된 qwen auth CLI 명령

독립 실행형 qwen auth CLI 명령이 제거되었습니다. 대신 다음 대체 방법을 사용하세요:

qwen auth status와 같은 레거시 호출은 두 지역의 기본 URL을 포함한 Token Plan 항목과 함께 이러한 마이그레이션 경로를 요약하는 제거 알림을 출력합니다.

보안 참고 사항

• API 키를 버전 관리에 커밋하지 마세요.
• 프로젝트 로컬 비밀에는 .qwen/.env를 선호하세요(git에서 제외).
• 검증을 위해 자격 증명을 출력하는 경우 터미널 출력을 민감한 것으로 취급하세요.