지금 바로 Qwen4-Max를 사용하는 방법: 알리바바의 Token Plan을 구독한 뒤 Claude Code, Qwen Code 또는 OpenAI/Anthropic 호환 도구에서 모델 ID qwen4-max-preview를 호출하면 됩니다. 코드를 작성하지 않는다면, 알리바바 Qwen 팀에 따르면 QwenWork, Qoder, Qwen 앱, QwenStudio에서도 얼리 액세스가 열려 있다고 합니다. 아직 종량제 API 가격은 발표되지 않았습니다.
이것이 요약된 내용입니다. Qwen4-Max는 2026년 11월 11일 프리뷰로 공개되었으며, X의 발표에서 시험해 볼 수 있는 5가지 경로를 소개했습니다. 이 가이드는 각 경로를 하나씩 살펴봅니다: 어떤 사용자에게 적합한지, 무엇이 필요한지, 어떤 제한이 적용되는지입니다. 이어서 개발자 경로를 다루는데, 코딩 에이전트가 Qwen4-Max 위에서 실행되어 작은 API를 빌드하고 Apidog CLI로 테스트하는 과정입니다.
모델 자체에 대한 배경 지식이 먼저 필요하다면, Qwen4-Max란 무엇인가를 읽어보세요. 구독 플랜에 대해 자세히 알고 싶다면 Qwen4-Max Token Plan 가이드를 참고하세요.
Qwen4-Max 이용 방법 총정리: 한눈에 비교
Qwen4-Max는 프리뷰 모델이기 때문에 공개된 토큰당 과금 API가 아닌 알리바바 자체 제품을 통해서만 접근할 수 있습니다. 2026년 11월 11일 기준 5가지 경로의 비교는 다음과 같습니다.
| 경로 | 적합한 대상 | 필요한 것 | 시작 비용 |
|---|---|---|---|
| Token Plan | 코딩 에이전트를 사용하는 개발자 | QwenCloud 계정, 플랜, Token Plan API 키 | Lite 첫 달 $3 (이벤트 가격; 정가 $8) |
| Qoder | 에이전트형 IDE를 원하는 개발자 | Qoder 계정 및 앱 | 크레딧 기반; 모델 선택기에서 확인 |
| QwenWork | 지식 작업 및 파일 작업 | QwenWork 계정 (웹 또는 데스크톱) | 무료 플랜 제공 |
| Qwen 앱 | 휴대폰에서 빠르게 테스트 | Qwen 앱 및 계정 | Qwen4-Max 미공개 |
| QwenStudio | 브라우저 채팅 및 프로토타이핑 | Qwen 계정 | Qwen4-Max 미공개 |
아직 공개되지 않은 두 가지가 있으니, 이를 전제로 계획하지 마세요. 공식 벤치마크와 가격이 매겨진 종량제 API 모델 ID입니다. 서드파티 게시물에서는 100만 토큰 컨텍스트 윈도우를 언급하지만, 알리바바는 자사 페이지에서 Qwen4-Max의 컨텍스트 길이를 공식 발표하지 않았습니다. 이 수치는 확정되지 않은 것으로 보세요.
경로 1: Token Plan으로 Qwen4-Max 사용하기 (개발자 경로)
Token Plan은 AI 코딩 도구를 위한 QwenCloud의 구독 플랜입니다. 월 단위로 결제하면 크레딧 풀을 받고, 플랜에 등록된 모델에 사용할 수 있습니다. Token Plan 가격 페이지에서 qwen4-max-preview는 모델 목록 두 번째에 위치하며 "한정 기간 80% 할인" 태그와 함께 텍스트 생성, 추론, 시각 이해의 세 가지 기능이 표시되어 있습니다.
Token Plan 가격 (2026년 11월 11일 기준)
페이지에는 개인 월간 가격이 미국 달러로 표시되어 있습니다. 낮은 금액은 신규 고객을 위한 이벤트 가격이며, 페이지에는 최종 가격은 로그인 후 결제 화면에 표시된 금액이라고 안내되어 있습니다.
| 플랜 | 이벤트 가격 | 정가 | 월간 크레딧 | 동시 실행 에이전트 |
|---|---|---|---|---|
| Lite | $3.00 | $8.00 | 20,000 | 1-2 |
| Essential | $5.00 | $16.00 | 45,000 | 2-3 |
| Standard | $18.00 | $25.00 | 80,000 | 3-4 |
| Pro | $43.00 | $51.00 | 200,000 | 6-8 |
페이지에는 Qwen4-Max 요청 한 번에 얼마나 많은 크레딧이 소모되는지 나와 있지 않으므로, 실제 사용량은 몇 번의 세션 이후 플랜의 사용량 페이지에서 확인하게 될 것입니다.
구매 전에 알아야 할 규칙
Token Plan 개인 FAQ에는 두 번 읽어볼 가치가 있는 몇 가지 제한이 있습니다:
- 대화형 사용 전용. 이 플랜은 "지정된 도구를 통한 개인 대화형 개발"을 위한 것입니다. 프로덕션 자동화, 배치 스크립트, 백그라운드 예약 작업에 키를 사용하는 것은 허용되지 않습니다.
- 공유 금지. 계정이나 API 키 공유는 금지되어 있습니다.
- 환불 불가. Token Plan 개인 플랜은 환불되지 않습니다.
- 단일 리전. 개요에 따르면 Token Plan은 싱가포르 리전에서만 구매 및 사용할 수 있으며, 키는
sb-sp-로 시작합니다.
첫 번째 규칙이 중요합니다. 개발 중에는 코딩 에이전트가 Qwen4-Max를 사용할 수 있습니다. 하지만 출시한 앱의 백엔드는 Token Plan 키를 호출해서는 안 됩니다.
Claude Code를 Qwen4-Max에 연결하기
QwenCloud의 Claude Code 설정 페이지는 Claude Code의 모델 슬롯을 Token Plan 모델에 매핑하며, Qwen4-Max는 Opus 슬롯에 배치됩니다. ~/.claude/settings.json에 다음을 추가하세요:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_TOKEN_PLAN_API_KEY",
"ANTHROPIC_BASE_URL": "https://token-plan.maas.qwencloudapi.com/apps/anthropic",
"ANTHROPIC_MODEL": "auto",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-flash",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen4-max-preview",
"CLAUDE_CODE_SUBAGENT_MODEL": "auto",
"CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
}
}
새 터미널을 열어 claude -p "Hello"를 실행하여 연결을 확인하세요. 세션 전체에서 auto 대신 Qwen4-Max를 강제로 사용하려면 ANTHROPIC_MODEL을 qwen4-max-preview로 설정하세요. 긴 답변이 잘리는 경우, 같은 페이지에서 CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000으로 설정하라고 안내합니다.
Qwen Code 또는 OpenAI 호환 도구 연결하기
Qwen Code 가이드는 대신 OpenAI 호환 엔드포인트를 사용합니다:
Base URL: https://token-plan.maas.qwencloudapi.com/compatible-mode/v1
Model: qwen4-max-preview
Key: QWENCLOUD_TOKEN_PLAN_API_KEY (API Keys 페이지에서 발급)
가이드에 따르면 Qwen4-Max의 기본 출력 제한은 32,768 토큰입니다. 더 긴 출력을 원하면 해당 모델 항목에서 generationConfig.samplingParams.max_tokens를 설정하세요. 가격 페이지에는 지원 도구로 Cline, Cursor, OpenCode, Codex, Kilo CLI, OpenClaw도 나열되어 있습니다.
경로 2: Qoder에서 Qwen4-Max 사용하기
Qoder는 알리바바의 에이전트형 코딩 IDE이며, 발표에서 얼리 액세스 대상으로 언급되었습니다. Qoder는 크레딧 기반으로 과금되며, 모델 선택기 문서에 따르면 프롬프트를 보내기 전에 선택기에서 각 모델의 크레딧 요율을 확인할 수 있습니다.
11월 11일 기준으로 해당 문서에는 Qwen3.8-Max는 있지만 Qwen4-Max는 아직 없습니다. Qoder를 최신 버전으로 업데이트하고 모델 선택기에서 Qwen4-Max를 찾아보세요. 표시되는 요율을 확인하세요. 지난 Qwen Max 프리뷰에서 Qoder는 큰 폭의 프로모션 요율을 적용했었고, Qwen4-Max의 요율은 아직 문서화되지 않았습니다.
에이전트 중심으로 구축된 IDE를 원하고 베이스 URL을 직접 설정하고 싶지 않다면 Qoder를 선택하세요.
경로 3: QwenWork에서 Qwen4-Max 사용하기
QwenWork는 지식 작업을 위한 에이전트 작업 공간입니다. 원하는 결과를 설명하면 단계를 계획하고, 여러분의 파일을 활용하여 완성된 파일을 반환합니다. 브라우저에서 또는 Mac과 Windows용 데스크톱 앱으로 실행됩니다.
QwenWork에는 가입 보너스 크레딧 500개와 일일 로그인 크레딧 200개를 제공하는 $0 무료 플랜이 있으며, 두 크레딧 모두 한정 기간으로 표시되어 있습니다. 유료 플랜은 Plus 기준 월 $20부터 시작합니다. QwenWork 사이트에는 모델 선택기에 대한 설명이 없으므로, 이를 전제로 하기 전에 앱 내부에서 Qwen4-Max를 확인하세요.
보고서, 브리프, 파일 작업에는 QwenWork를 선택하고, 코드 작성에는 사용하지 마세요.
경로 4와 5: Qwen 앱과 QwenStudio
Qwen 앱(모바일)과 QwenStudio(Qwen의 채팅 작업 공간)는 설정이 전혀 필요 없는 경로입니다. 로그인하고, 모델 메뉴를 열고, 계정에 Qwen4-Max가 표시되면 선택하세요. 두 제품 모두 Qwen4-Max 할당량을 공개하지 않았으므로, 프리뷰 기간 동안 얼리 액세스 제한이 변경될 것으로 예상하세요.
이 두 가지는 첫인상을 확인하기에 적합합니다: 어려운 추론 질문을 던지거나, 스크린샷을 붙여넣어 시각 이해를 테스트하거나, Qwen 3.8과 답변을 비교해 보세요. 전체적인 비교는 Qwen4-Max vs Qwen 3.8을 참고하세요.
어떤 Qwen4-Max 경로를 선택해야 할까?
작업에 맞는 경로를 선택하세요:
- 에이전트와 함께 코드를 작성한다: Token Plan. 문서화된 모델 ID, 베이스 URL, 가격을 갖춘 유일한 경로입니다.
- 설정을 알아서 처리해 주는 IDE를 원한다: Qoder.
- 코드가 아닌 완성된 문서를 원한다: QwenWork.
- 오늘 빠르게 살펴보고 싶다: QwenStudio 또는 Qwen 앱.
프로덕션 앱을 개발한다면 종량제 API 등록을 기다리세요. Token Plan의 약관은 백엔드 사용을 금지하고 있으며, 프리뷰 모델은 예고 없이 변경될 수 있습니다. 현재 프로덕션 옵션은 Qwen 3.8 API 가이드에서 다룹니다.
Qwen4-Max와 Apidog CLI로 API 빌드하고 테스트하기
실제 개발자 경로는 다음과 같습니다. 코딩 에이전트가 Token Plan을 통해 Qwen4-Max 위에서 실행되어 작은 REST API를 작성한 뒤, Apidog CLI로 이를 테스트합니다. 여러분은 프롬프트 하나만 작성하면 됩니다. 입력 작업은 에이전트가 합니다.
Apidog CLI 설정하기
CLI를 설치하고, 개인 액세스 토큰으로 로그인한 뒤, 에이전트에 Apidog 스킬을 추가하세요:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick Claude Code when prompted
바로가기 팁: 에이전트에게 Read https://apidog.com/apidog-cli-installation-guide.md and set up Apidog CLI라고 지시하세요. 이 가이드는 에이전트를 위해 작성되었습니다. 사람이 읽는 버전은 설치 가이드에 있습니다.
에이전트에 프롬프트 하나 주기
Claude Code가 qwen4-max-preview를 가리키도록 설정한 상태에서 다음을 보내세요:
Build a small Express API with POST /todos and GET /todos/{id}, plus an
openapi.json for it. Start it on port 3000. Then import the spec into Apidog
project <projectId>, create a test case for POST /todos that asserts a 201
status and a returned id, run it against environment <envId>, and summarize
any failures with the fix you'd make.
에이전트가 실행하는 apidog 명령어
코드와 스펙을 작성한 후, 에이전트는 스펙을 가져오고, 테스트 케이스용 스키마를 읽고, 페이로드를 검증한 뒤 실행합니다:
apidog import --project <projectId> --format openapi --file ./openapi.json
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json
cli 리포터는 터미널에 통과 또는 실패 요약을 출력하고, json은 apidog-reports 폴더에 보고서를 작성하며, 에이전트는 이를 읽어 실패 원인을 설명합니다. Apidog 앱에서 실행 결과를 보고 싶다면 --upload-report를 추가하세요.
이는 프리뷰 모델을 평가하는 공정한 방법이기도 합니다. 공개된 벤치마크가 없는 상황에서는 리더보드보다 여러분 자신의 API에서 테스트를 통과하는 것이 더 많은 것을 알려줍니다. Sonnet 슬롯에 qwen3.8-flash를 넣고 같은 프롬프트를 실행하여 각 모델에 필요한 수정 사이클 횟수를 비교해 보세요.
테스트 자체에는 Qwen4-Max가 필요하지 않으므로, Token Plan 키를 건드리지 않고도 apidog run ... -r junit을 CI로 옮길 수 있습니다. 설정 방법은 Apidog CLI CI/CD 가이드에서, 더 많은 에이전트 프롬프트는 Claude Code에서 Apidog CLI 사용하기에서 확인할 수 있습니다. Apidog 무료 플랜은 최대 4명의 사용자까지 지원합니다.
FAQ
Qwen4-Max API가 있나요?
아직 종량제 API는 없습니다. 2026년 11월 11일 기준으로 문서화된 유일한 API 접근 방식은 모델 ID qwen4-max-preview와 Token Plan 베이스 URL을 사용하는 Token Plan입니다. 공개된 토큰당 과금 모델 ID와 가격은 아직 발표되지 않았습니다.
Qwen4-Max는 얼마인가요?
Token Plan에서 개인 플랜은 월 $3(Lite 이벤트 가격, 정가 $8)부터 $43(Pro 이벤트 가격, 정가 $51)까지입니다(2026년 11월 11일 기준). Qwen4-Max 요청당 크레딧 소모량은 페이지에 명시되어 있지 않습니다.
Qwen4-Max를 무료로 사용할 수 있나요?
QwenWork에는 한정 기간 보너스 크레딧이 제공되는 $0 플랜이 있습니다. 아직 어느 경로도 무료 Qwen4-Max 접근을 문서화하지 않았으므로, QwenWork, Qwen 앱 또는 QwenStudio의 모델 메뉴에서 직접 확인하세요.
Qwen4-Max의 컨텍스트 윈도우는 얼마인가요?
알리바바는 아직 공개하지 않았습니다. 서드파티 보고서에서는 100만 토큰이라고 하며, QwenCloud의 Claude Code 설정은 클라이언트 컨텍스트 제한을 983,616 토큰으로 설정하지만, 어느 쪽도 공식 모델 스펙은 아닙니다.
Token Plan 키를 프로덕션에서 사용할 수 있나요?
아니요. FAQ는 프로덕션 자동화, 배치 스크립트, 백그라운드 예약 작업을 금지합니다. 대화형 코딩에만 사용하고, 출시된 백엔드에는 종량제 API를 사용하세요.
Qwen4-Max가 정식 출시되기 전까지는 어떤 Qwen 모델을 사용해야 하나요?
프로덕션 API에는 가격이 공개된 정식 출시 모델을 사용하세요. 최고의 Qwen 모델 가이드와 코딩을 위한 Qwen 3.8에서 현재 옵션들을 비교해 줍니다.