Qwen Code와 Qwen 3.7-max: Token Plan 설정

Ailoot 참고 문서: ailoot.ai/docs/.

2026년 10월 3일 업데이트: 게시 이후 세 가지가 바뀌었습니다. Alibaba는 신규 구매를 중단했습니다. Lite 등급은 3월에 판매가 종료됐고, Pro는 매진 상태입니다. Token Plan은 주간 할당량에서 월간 할당량으로 전환됐습니다. 더 새로운 모델 Qwen3.8-max도 출시됐습니다. Token Plan 키 설명의 오류도 수정했습니다. 바로 그 401 오류와 관련된 내용이며 아래에서 설명합니다.

Qwen Code란 무엇이며, 왜 그저 또 다른 모방품이 아닐까요?#

Qwen Code를 처음 들었을 때는 “두 번째 프롬프트에서 고장 날 Claude Code 복제품이 하나 더 나왔구나”라고 생각했습니다. 틀린 생각이었습니다. Alibaba는 인터페이스를 복사한 게 아니라 자체 CLI 에이전트를 처음부터 만들었습니다. 다만 OpenAI API와 완벽하게 호환됩니다. 따라서 Qwen 모델뿐 아니라 DeepSeek, GLM, Kimi, 심지어 Anthropic API를 통한 Claude도 사용할 수 있습니다.

실제로 할 수 있는 일은 다음과 같습니다.

• 프로젝트 구조를 읽고 맥락을 이해합니다(CLAUDE.md를 사용하는 Claude Code와 비슷합니다).
• 셸 명령을 실행하고, 파일을 편집하고, 커밋을 생성합니다.
• Skills와 SubAgents를 지원합니다.
• 기본 제공 터미널이나 확장 프로그램을 통해 VS Code에서 작동합니다.
• /model 명령 하나로 모델을 전환합니다.

단점이 하나 있는데, 매우 중요합니다. 무료 등급은 2026년 4월 15일에 종료됐습니다. 이전에는 Qwen OAuth로 하루 100건의 요청을 무료로 보낼 수 있었지만, 이제는 유료 옵션만 남았습니다. 그래도 유료 Qwen Code는 Claude Pro 구독보다 눈에 띄게 저렴합니다. 지금 도구를 고르고 있다면 “2026년 무엇으로 코딩할까: AI 도구 8가지” 가이드에서 모든 옵션을 다뤘습니다.

비용은 얼마이며 어떤 요금제를 선택해야 할까요?#

요금제에 대한 혼란은 Qwen Code 설정에서 가장 골치 아픈 부분입니다. Alibaba는 콘솔의 각 영역에서 서로 다른 이름을 사용하고, VS Code 확장 프로그램조차 잘못된 옵션을 표시합니다. 실제 작동 방식은 다음과 같습니다(Alibaba Cloud 문서를 기준으로 확인했으며, 해당 문서는 2026년 9월 28일에 업데이트됐습니다).

작성자가 설명한 경험에서는 Token Plan을 선택했습니다. 구독 하나로 Qwen 3.7-max(그리고 더 새로운 Qwen3.8-max), DeepSeek V4 Pro, GLM-5에 접근할 수 있기 때문입니다. 모든 모델이 같은 Credits 풀을 사용합니다. /model 명령으로 전환하면 되므로 provider마다 별도의 키를 구매할 필요가 없습니다.

중요: Coding Plan과 Token Plan은 API 주소가 서로 다른 별개의 제품입니다. Coding Plan 키에는 sk-sp- 접두사가 있습니다. Token Plan 키에는 접두사가 없습니다. 공식 Qwen Code 문서가 그렇게 설명합니다. 제품 간에 주소나 키를 혼동하면 401 오류가 발생합니다. Coding Plan은 신규 구매가 중단됐으므로 현재 대부분의 독자에게 이용 가능한 선택지는 Token Plan뿐입니다.

Qwen Code는 어떻게 설치하나요?#

설치 전에 Node.js 버전을 확인하세요.

node --version

22 이상이 필요합니다. 버전이 낮다면 nodejs.org에서 업데이트하거나 nvm을 사용하세요.

nvm install 22
nvm use 22

다음 명령 하나로 Qwen Code를 설치합니다.

npm install -g @qwen-code/qwen-code@latest

또는 macOS에서 Homebrew를 사용하세요.

brew install qwen-code

설치 상태를 확인합니다.

qwen --version

버전이 표시되면 준비가 끝난 것입니다. 터미널에서 qwen 명령으로 Qwen Code를 실행하세요. VS Code에서는 기본 제공 터미널(Ctrl+)을 열고 qwen`을 입력합니다.

VS Code 확장 프로그램도 있습니다. 마켓플레이스에 있는 QwenLM의 Qwen Code Companion입니다. GitHub Copilot처럼 채팅 사이드바가 추가됩니다. 저는 이 확장 프로그램을 사용합니다. 일반 터미널보다 편리합니다.

계정을 만들고 Token Plan을 구매하려면 어떻게 하나요?#

단계별 안내:

1. modelstudio.console.alibabacloud.com으로 이동합니다.
2. 오른쪽 위에서 Free Sign Up을 클릭합니다.
3. 이메일을 입력합니다(Gmail도 사용 가능). 받은 편지함에 온 코드를 확인합니다.
4. 전화번호를 추가합니다.
5. provider가 허용하는 카드를 추가합니다. Alibaba는 카드 확인을 위해 $1를 청구한 뒤 1–3일 안에 환불합니다.
6. 콘솔에서 ModelStudio 섹션과 Token Plan 탭을 찾습니다.
7. 시작할 때 필요한 최소 등급인 Standard를 선택합니다.
8. 결제를 확인합니다.

구매를 마치면 My Subscriptions 페이지로 이동합니다. 이 페이지에서 다음을 확인할 수 있습니다.

• Standard Seat: 0/1 — seat를 구매했지만 아직 본인에게 할당하지 않았다는 뜻입니다.
• Assign을 클릭하고 계정을 선택한 뒤 확인합니다.
• 표시가 1/1로 바뀌어야 합니다.

이 단계를 완료하지 않으면 API 키가 작동하지 않습니다. 작성자가 설명한 경험에서는 이 단계 때문에 20분이 걸렸습니다.

API 키와 올바른 주소는 어디서 찾나요?#

My Subscriptions 페이지에서 큰 보라색 Go to Management Platform 버튼을 클릭합니다. 별도의 패널이 열립니다.

왼쪽 메뉴에서 Overview를 선택합니다. 이 페이지에 두 섹션이 표시됩니다.

Plan-specific API Key — 개인 키입니다. 별표로 가려져 있습니다. 옆의 복사 아이콘을 클릭하세요(마우스로 선택하면 별표가 복사됩니다). Token Plan 키에는 접두사가 없습니다. 안내문의 오타가 아닙니다. 공식 Qwen Code 문서도 그렇게 설명합니다. sk-sp-가 보인다면 다른 제품인 Coding Plan 키입니다. 잘못된 키를 복사한 것입니다.

Plan-specific Base URL — 두 가지 옵션이 있습니다.

• OpenAI 호환 도구(Qwen Code): https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
• Anthropic 호환 도구: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

기억하세요. Token Plan 키와 함께 작동하는 주소는 이것뿐입니다. 표준 dashscope-intl.aliyuncs.com 주소는 일반 키(사용량 기반 결제)용이고, coding-intl.dashscope.aliyuncs.com은 Coding Plan 주소입니다. Token Plan 키를 둘 중 하나에 사용하면 401 오류가 발생합니다.

VS Code에 연결하려면 어떻게 하나요?#

VS Code 마켓플레이스에서 Qwen Code Companion 확장 프로그램을 설치했다면:

1. 명령 팔레트를 엽니다(Cmd+Shift+P).
2. Qwen Code: Choose Provider를 입력합니다.
3. 옵션 메뉴가 표시되면 Coding Plan을 선택하지 마세요(다른 제품입니다). Standard API Key를 선택합니다.
4. Management Platform에서 복사한 키를 붙여넣습니다. Token Plan 키에는 고정 접두사가 없습니다.
5. 지역: Singapore
6. 모델: qwen3.7-max

이후 오류가 발생하면 파일에서 직접 설정하세요. 확장 프로그램이 때때로 잘못된 주소를 입력합니다.

~/.qwen/settings.json 파일을 열거나 새로 만든 뒤 다음을 붙여넣습니다.

{
  "env": {
    "TOKEN_PLAN_API_KEY": "YOUR-KEY-FROM-MANAGEMENT-PLATFORM"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.7-max",
        "name": "qwen3.7-max",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": { "enable_thinking": true },
          "contextWindowSize": 262144
        }
      },
      {
        "id": "qwen3.6-plus",
        "name": "qwen3.6-plus",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": { "enable_thinking": true },
          "contextWindowSize": 1000000
        }
      },
      {
        "id": "deepseek-v4-pro",
        "name": "deepseek-v4-pro",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": { "enable_thinking": true },
          "contextWindowSize": 1000000
        }
      }
    ]
  },
  "security": {
    "auth": { "selectedType": "openai" }
  },
  "model": { "name": "qwen3.7-max" }
}

YOUR-KEY-FROM-MANAGEMENT-PLATFORM을 Management Platform에서 받은 자신의 키로 바꿉니다. VS Code를 다시 시작합니다. 끝입니다.

401 오류는 왜 발생하며 어떻게 해결하나요?#

작성자는 설정 중 겪은 오류를 설명했습니다. 401 오류의 원인과 확인 방법은 다음과 같습니다.

터미널에서 빠르게 키 확인하기:

curl -s -o /dev/null -w "%{http_code}" -X POST \
  "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.7-max","messages":[{"role":"user","content":"hi"}],"max_tokens":5}'

200이 반환되면 키가 작동하며 문제는 확장 프로그램 설정에 있습니다. 401이 반환되면 키나 주소가 잘못된 것입니다.

어떤 모델을 사용할 수 있으며 무엇을 선택해야 하나요?#

바이브 코딩에 실제로 유용한 모델은 다음과 같습니다.

Qwen Code 세션에서 /model 명령으로 모델을 바로 전환할 수 있습니다. 설정을 바꾸거나 다시 시작할 필요가 없습니다.

qwen3.6-plus로 시작하는 것을 권합니다. 일주일 뒤 할당량이 너무 빨리 소진된다고 느껴지면 일상적인 작업에는 qwen3.6-flash를 사용하고, 복잡한 작업에만 qwen3.7-max를 사용하세요.

Qwen Code와 Claude Code 중 무엇을 사용해야 할까요?#

이 리뷰는 작성자가 두 도구를 한 달간 사용한 경험을 설명합니다. 해당 경험에 기반한 비교는 다음과 같습니다.

| VS Code 확장 프로그램 | 기본 제공, 안정적 | 이용 가능하지만 거친 면이 있음 — 때때로 키 문제가 발생합니다. |

Qwen Code가 더 나은 선택인 경우:

• 여러 모델을 사용해야 할 때(수학에는 DeepSeek, 긴 컨텍스트에는 Kimi)
• 하나의 작업에 여러 접근법을 실험할 때
• 예산은 제한적이지만 매일 코딩할 때
• 사용자 지정할 수 있는 오픈 소스 도구를 원할 때

Claude Code가 필수인 경우:

• 코드 품질이 곧 비용인 핵심 프로젝트
• 대규모 레거시 프로젝트 작업(Opus가 맥락을 더 잘 유지합니다) — Claude Code 한도를 소진하지 않는 방법은 별도로 다뤘습니다.
• 수동 설정 없이 안정적인 VS Code 확장 프로그램이 필요할 때

작성자가 설명한 경험에서의 조합은 주요 프로젝트에는 Claude Code, 아이디어를 더 저렴한 모델로 빠르게 시험해 볼 수 있는 실험과 병렬 작업에는 Qwen Code였습니다. 다른 도구와의 상세 비교는 Cursor vs Claude Code와 Codex vs Claude Code를 참고하세요.

누구나 겪는 세 가지 함정#

함정 1: Token Plan ≠ Coding Plan

Alibaba는 콘솔의 각 영역에서 이 제품들을 서로 다른 이름으로 부릅니다. VS Code 확장 프로그램의 “Coding Plan” 옵션은 Token Plan이 아닙니다. 기억하세요. 2026년 3월 20일 현재 Coding Plan Lite는 신규 구매가 종료됐고 Pro는 매진 상태입니다. 이미 가입하지 않았다면 Token Plan만 선택할 수 있습니다. 두 제품의 API 주소는 다릅니다.

• Token Plan: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
• Coding Plan: https://coding-intl.dashscope.aliyuncs.com/v1

Token Plan을 구매하고도 확장 프로그램을 Coding Plan으로 설정하면 401 오류가 발생합니다. 반대의 경우도 마찬가지입니다.

함정 2: VS Code 확장 프로그램이 자체 키를 생성함

확장 프로그램의 GUI에서 설정을 진행할 때(Cmd+Shift+P - Qwen Code: Choose Provider), 확장 프로그램이 Alibaba Auth API를 통해 자체 키를 생성하는 경우가 있습니다. 이 키는 형식이 다르고 Token Plan 구독과 연결되어 있지 않습니다.

해결 방법: GUI 설정을 마친 뒤 ~/.qwen/settings.json을 열어 env의 키가 Management Platform에 표시된 키(Overview - Plan-specific API Key)와 일치하는지 확인하세요. 일치하지 않으면 직접 바꾸세요.

함정 3: Standard Seat가 할당되지 않음

Token Plan을 구매하고 나면 My Subscriptions 페이지에 Standard Seat: 0/1이 표시됩니다. seat를 구매했지만 계정에 연결하지 않았다는 뜻입니다. Assign을 클릭하기 전까지 API 키는 작동하지 않습니다.

작성자의 경험에서는 이 줄을 알아차리기 전까지 401 오류를 디버깅하는 데 20분이 걸렸습니다.

모든 것이 작동하는지 어떻게 확인하나요?#

1단계. 터미널에서 키 확인:

curl -X POST \
  "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.6-plus","messages":[{"role":"user","content":"Hello"}]}'

응답에 모델이 생성한 텍스트가 포함돼 있으면 키와 주소가 작동합니다.

2단계. Qwen Code에서 확인:

VS Code를 열고 기본 제공 터미널을 연 뒤 qwen을 입력합니다. 실행되면 다음과 같은 내용을 입력하세요.

이 폴더의 프로젝트는 무엇인가요?

Qwen Code가 구조를 읽고 답변할 것입니다. 답변이 나오면 설정이 완료된 것입니다.

3단계. Credits 사용량 확인:

첫 요청을 보낸 뒤 5분 후 Management Platform - Overview - Usage Consumption으로 이동합니다. 비율이 0보다 커야 합니다. 10건이 넘는 요청을 보냈는데도 0%라면 잘못된 주소를 사용하고 있는 것입니다(요청이 구독을 거치지 않고 사용량 기반 결제로 가거나 아무 곳에도 도달하지 않습니다).

다음 단계는 무엇인가요?#

Qwen Code를 설치했고 작동합니다. 어떤 프로젝트든 열고 AI와 대화하며 개발을 시작할 수 있습니다.

다음 질문은 이것입니다. Qwen Code에서 같은 프롬프트가 어떤 프로젝트에서는 훌륭한 결과를 내고 다른 프로젝트에서는 엉망인 이유는 무엇일까요? 맥락 때문입니다. 프로젝트에 대상 사용자, 제품, 목표가 담긴 business/ 구조가 있으면 AI는 협업자처럼 작동합니다. 폴더가 비어 있으면 환각을 일으킵니다.

ailoot.ai에서 Ailoot를 계속 둘러보세요.