Qwen4-Max-Preview: Claude Code 설정과 11월 25일 제공 종료
Token Plan 전용 키와 올바른 엔드포인트로 Qwen4-Max-Preview를 시험합니다. Claude Code, OpenCode 또는 Qwen Code를 설정하고 저장소 파일 읽기로 동작을 검증합니다. 추론과 답변이 공유하는 출력 한도를 조정하고, 프리뷰 종료 전에 별도의 종량제 API로 전환하는 방법을 설명합니다. 구독 요금, 사용 제한, Qwen3.8-Max 대안도 포함합니다.
목차
Qwen4-Max-Preview는 기간을 정한 대화형 코딩 시험에 사용하고, 애플리케이션 백엔드에는 사용하지 않습니다. Token Plan 전용 키로 연결한 뒤 자동 선택에 의존하지 않고 qwen4-max-preview를 명시적으로 선택합니다. 공식 프리뷰 기간이 끝나는 2026년 11월 25일 24:00 UTC+8 전에 대체 경로를 준비해야 합니다.
아래 제공 현황, 설정, 요금 정보는 2026-11-12 기준입니다.
어떤 방식으로 이용하며 언제 종료됩니까?
Qwen4-Max-Preview는 Token Plan Personal과 Team으로 이용할 수 있습니다. 종량제 접근은 지원하지 않습니다. 프리뷰는 2026년 11월 11일 10:00부터 2026년 11월 25일 24:00까지이며, 두 시각 모두 UTC+8 기준입니다. Alibaba는 이 기간에 모델을 변경하지 않고, 기간이 끝나면 제공을 종료한다고 안내합니다.
종료 시각은 11월 26일 00:00 UTC+8 또는 11월 25일 16:00 UTC와 같습니다. 이 시각이 대체 모델의 출시일을 뜻하지는 않습니다.
모델의 컨텍스트 창은 1M tokens이며 최대 출력은 393,216 tokens입니다. 추론과 최종 답변이 이 출력 한도를 공유합니다. 텍스트, 이미지, 동영상을 입력받으며 함수 호출과 구조화된 출력을 지원합니다.
Alibaba는 Chat Completions, Responses, Anthropic Messages와의 호환성을 문서화했습니다. 그렇다고 모든 클라이언트에서 모델의 모든 기능을 사용할 수 있다는 뜻은 아닙니다. Qwen3.8-Max와 비교할 때는 성능 순위를 전제하지 말고 실제 작업으로 시험합니다.
Token Plan과 Qwen Chat의 모델 이름이 같아도 서버 설정이나 도구 동작까지 같다는 근거는 되지 않습니다. 같은 클라이언트에서 도구, 프롬프트, 출력 한도를 맞춘 뒤 결과를 비교합니다.
Token Plan 요금은 얼마이며 어떤 사용이 허용됩니까?
Qwen4의 백만 토큰당 요금이 아니라 구독 비용을 기준으로 예산을 잡습니다. Personal Edition 개요는 신규 구독에 다음 월간 정가를 안내합니다. 신규 가입 프로모션은 제외한 금액입니다.
| Personal 요금제 | 월 정가, USD | 월간 사용량 |
|---|---|---|
| Lite | $6 | 20,000 Credits |
| Essential | $10 | 45,000 Credits |
| Standard | $18 | 80,000 Credits |
| Pro | $43 | 200,000 Credits |
Credits는 구독의 과금 단위이며 일정한 토큰 수를 뜻하지 않습니다. 시험 작업을 마친 뒤 실제 소비량을 확인합니다. 이 표를 API 토큰당 요금으로 임의 환산하지 않습니다.
Personal FAQ에 따르면 적용되는 사용량 한도를 소진하면 호출이 차단됩니다. 초과 사용이 자동으로 종량제에 청구되지는 않습니다. 추가 사용량 패키지 구매와 구독 갱신은 별도로 결정해야 합니다.
Personal Edition은 현재 구독 취소를 지원하지 않습니다. 프리뷰 종료가 구독을 자동 취소하거나 환불 권리를 발생시킨다고 가정하면 안 됩니다. 이 시험만을 위해 구매한다면 먼저 갱신 설정을 확인합니다.
두 에디션 모두 코딩 및 에이전트 도구 안에서의 대화형 사용으로 접근을 제한합니다. 자동화 스크립트, 애플리케이션 백엔드, 비대화형 일괄 작업은 문서에 명시된 사용 범위에 포함되지 않습니다. Team Edition 정책도 같은 대화형 사용 제한을 명시합니다.
대화형 세션에서 에이전트가 도구를 호출하는 것과 평가 스크립트를 예약 실행하는 것은 다릅니다. 아래 예제는 대화형으로 사용합니다. Token Plan 키를 범용 백엔드 인증 정보로 사용하지 않습니다.
클라이언트를 설정하기 전에 전용 키를 발급합니다
Token Plan 엔드포인트에는 Token Plan 키를 사용합니다. 일반 Model Studio 키나 Coding Plan 키로 대체할 수 없습니다.
Personal Edition은 구독한 뒤 Token Plan 콘솔의 My Subscription에서 키를 생성합니다. Personal 시작 가이드에 따라 진행합니다.
Team Edition에서는 관리자가 계정에 사용 좌석을 할당한 뒤 키를 생성해야 합니다. Team 시작 가이드는 이 단계를 Member Management에서 진행하도록 안내합니다.
아래 예제는 클라이언트가 설치되어 있고 macOS 또는 Linux에서 Bash를 사용한다고 가정합니다. 새 터미널을 엽니다. 다음 명령을 실행하고 키를 붙여 넣은 뒤 Enter를 누릅니다.
read -rs TOKEN_PLAN_API_KEY && export TOKEN_PLAN_API_KEY입력한 키는 화면에 표시되지 않습니다. 내보낸 환경 변수를 전달받도록 선택한 클라이언트를 이 터미널에서 실행합니다.
Claude Code를 설정하고 실제 파일 읽기를 검증합니다
Opus에 연결할 모델을 Qwen4-Max-Preview로 지정한 다음 Opus를 명시적으로 선택합니다. Alibaba의 Claude Code 설정 가이드는 Token Plan에 다음 모델 매핑을 사용합니다.
README.md가 있는 저장소에서 다음 명령을 실행합니다.
unset ANTHROPIC_API_KEY
export ANTHROPIC_AUTH_TOKEN="$TOKEN_PLAN_API_KEY"
export ANTHROPIC_BASE_URL="https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic"
export ANTHROPIC_MODEL="auto"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3.6-flash"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.8-flash"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen4-max-preview"
export CLAUDE_CODE_SUBAGENT_MODEL="auto"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616"
claude --model opusClaude Code의 기본 URL은 /apps/anthropic으로 끝납니다. 뒤에 /v1을 추가하지 않습니다.
--model opus 인수는 해당 별칭에 매핑된 주 모델을 선택합니다. 이는 Claude Code에 문서화된 모델 선택 및 별칭 규칙에 따른 동작입니다.
나머지 매핑은 보조 작업에 다른 모델을 사용할 수 있게 합니다. 특히 CLAUDE_CODE_SUBAGENT_MODEL="auto"는 모든 보조 에이전트인 서브에이전트를 Qwen4-Max-Preview로 고정하지 않습니다. 여러 모델을 사용한 전체 세션을 Qwen4 단독 벤치마크라고 설명하면 안 됩니다.
대화형 세션에 다음 프롬프트를 입력합니다.
Read README.md using the file tool. Quote its first heading and summarize the project in two sentences. Do not modify files.파일 읽기 작업이 화면에 나타나는지 확인하고, 인용된 제목을 실제 파일의 제목과 대조합니다. 이어서 같은 시간대의 Token Plan 사용량을 확인합니다. 단순한 인사 응답보다 도구 호출과 결과 처리가 끝까지 이루어지는지 확인하는 편이 유용합니다.
다음으로 합격 여부를 확인할 테스트가 있는 작은 변경 작업을 하나 시도합니다. 선택한 모델, 추론 수준, 경과 시간, 테스트 결과, 소비한 Credits를 기록합니다.
Claude Code가 여전히 다른 제공업체를 사용하는 것 같다면 모델을 평가하기 전에 실제 연결 경로 확인 절차를 따릅니다.
긴 답변이 잘리면 컨텍스트와 구분해 출력 한도를 조정합니다
긴 답변이 중간에 잘리면 출력 한도를 늘립니다. Alibaba는 이 모델에 CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000을 권장합니다.
클라이언트를 종료하고 같은 Bash 터미널에서 다시 실행합니다.
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000
claude --model opus이 설정은 CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616"과 별개입니다. 어느 설정도 393,216 tokens 길이의 답변을 보장하지 않습니다. 모델의 최대치, 클라이언트 설정, 실제 요청에 적용되는 한도는 서로 다른 제한입니다.
OpenCode 또는 Qwen Code를 사용합니다
실제로 사용하는 클라이언트에 맞는 설정을 적용합니다. 각 예제의 기본 URL은 서로 바꿔 쓸 수 없습니다. 기존 설정을 백업하고, 예제를 추가할 때 관련 없는 설정은 유지합니다.
OpenCode: 어댑터 URL 끝의 /v1을 유지합니다
~/.config/opencode/opencode.json에 Alibaba의 Anthropic 어댑터 설정을 사용합니다.
이 예제는 Alibaba가 제공한 V1 형식의 제공업체 스키마를 사용합니다. OpenCode V2의 마이그레이션 문서는 지원되는 V1 설정을 계속 허용한다고 설명합니다. 이 제공업체 객체 안에 V2 전용 필드 이름을 섞지 않습니다.
{
"$schema": "https://opencode.ai/config.json",
"model": "bailian-token-plan/qwen4-max-preview",
"provider": {
"bailian-token-plan": {
"npm": "@ai-sdk/anthropic",
"options": {
"baseURL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic/v1",
"apiKey": "{env:TOKEN_PLAN_API_KEY}"
},
"models": {
"qwen4-max-preview": {
"name": "Qwen4-Max-Preview",
"modalities": {
"input": ["text", "image"],
"output": ["text"]
},
"limit": {
"context": 1000000,
"output": 131072
}
}
}
}
}
}끝의 /v1은 이 어댑터를 위해 의도적으로 포함한 값입니다. Alibaba의 OpenCode 가이드도 같은 주소를 사용합니다. Claude Code의 더 짧은 기본 URL을 이 설정에 복사하지 않습니다.
출력 값 131072는 Alibaba의 OpenCode 모델 항목에서 가져온 설정입니다. 이는 클라이언트 설정이며, 모델에 공개된 최대 출력 393,216 tokens가 변경되었다는 뜻이 아닙니다.
OpenCode의 환경 변수 치환 기능은 {env:TOKEN_PLAN_API_KEY}를 통해 내보낸 키를 읽습니다. opencode를 실행하고 /models로 제공업체와 모델을 확인한 다음 파일 읽기 프롬프트를 반복합니다.
Qwen Code: 추론과 답변의 공유 출력 한도를 명시합니다
~/.qwen/settings.json에는 OpenAI 호환 Token Plan 엔드포인트를 사용합니다.
Alibaba의 Qwen Code 가이드는 이 모델의 기본 출력 한도를 32768로 안내합니다. 아래 예제는 첫 코딩 시험을 위해 64000과 추론 수준 medium을 선택합니다. 명시적으로 선택한 설정이며 모델의 기본값은 아닙니다.
{
"$version": 4,
"modelProviders": {
"openai": [
{
"id": "qwen4-max-preview",
"name": "Qwen4-Max-Preview",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"samplingParams": {
"max_tokens": 64000,
"reasoning_effort": "medium"
},
"extra_body": {
"preserve_thinking": true
}
}
}
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "qwen4-max-preview"
}
}envKey 필드는 환경 변수 이름을 지정하며 비밀 키 자체를 담지 않습니다. Qwen Code의 제공업체 설정 문서는 이 인증 정보 전달 방식과 생성 설정을 설명합니다.
키를 내보낸 터미널에서 qwen을 실행합니다. /model로 모델을 확인하고 같은 파일 읽기 작업을 반복합니다.
max_tokens 때문에 최종 답변이 잘리는 이유는 무엇입니까?
Qwen4-Max-Preview의 Chat Completions는 추론과 답변 토큰을 같은 출력 한도에 포함합니다. API 호환성 변경 안내에 따르면 이 모델의 max_tokens는 max_completion_tokens와 같은 의미입니다.
아래 예제는 공유 한도가 답변에 미치는 영향을 보여 줍니다.
Combined output budget: 64,000 tokens
Assumed thinking usage: 48,000 tokens
Remaining answer allowance: at most 16,000 tokens이 수치는 가정에 따른 계산이며 실제 실행을 측정한 결과가 아닙니다. 이전에 화면에 표시되는 답변만 고려해 정한 한도는 이제 답변에 너무 적은 여유를 남길 수 있습니다.
추론은 기본으로 활성화됩니다. reasoning_effort가 지원하는 값은 low, medium, xhigh이며 기본값은 xhigh입니다. reasoning_effort와 thinking_budget을 동시에 설정하지 않습니다.
범위를 정한 시험에서는 medium부터 시작합니다. 단순한 수정에는 low를 시도하고, 어려운 작업에서 더 깊은 추론을 평가할 필요가 있으면 xhigh를 시도합니다. 한 번에 설정 하나만 바꾸고 답변 길이뿐 아니라 작업 완료 결과를 비교합니다.
기존 Qwen 모델은 이전의 max_tokens 동작을 유지합니다. 프리뷰의 변경 사항을 모든 Qwen 연동에 소급해서 적용하지 않습니다.
Chat Completions에서 추론 기록을 보존합니다
여러 차례 이어지는 대화에서는 과거 추론을 모두 지정된 필드에 보관합니다. Qwen4-Max-Preview는 preserve_thinking을 기본으로 활성화합니다.
이전 어시스턴트 메시지의 추론은 reasoning_content에 넣어야 합니다. 어시스턴트의 content 필드에 붙이거나 새 사용자 메시지로 보내지 않습니다.
이 처리는 클라이언트 어댑터의 책임입니다. 숨겨진 추론을 직접 채팅에 붙여 넣으라는 의미가 아닙니다. 연동을 평가할 때는 첫 답변만 보지 않고 다음 대화 차례와 전체 도구 호출 과정을 검증합니다.
Messages, Chat Completions, Responses 비교에서는 HTTP 호환성만으로 에이전트가 올바르게 동작한다고 판단할 수 없는 이유를 설명합니다.
오류에 맞는 원인을 확인합니다
401 InvalidApiKey: Invalid API-key provided.가 발생하면 먼저 키의 과금 플랜, 구독 상태, 키가 끝까지 복사되었는지 확인합니다. 키에 맞는 엔드포인트인지 확인한 뒤 클라이언트를 다시 실행하고 파일 읽기 시험을 반복합니다.
모델 매핑 후 HTTP 403과 코드 access_denied를 포함한 AccessDenied가 발생하면 Model Studio의 Model Gallery를 확인합니다. Alibaba는 Upcoming deprecation 상태를 가능한 원인 중 하나로 설명합니다. 권한과 플랜의 모델 이용 자격도 확인해야 합니다. 모든 403이 모델 제공 종료를 뜻하지는 않습니다.
출력이 잘리면 인증 설정을 바꾸기 전에 실제 출력 한도와 추론 수준을 확인합니다. 앞서 제시한 Claude Code 또는 Qwen Code 설정을 적용하고 같은 작업을 다시 실행합니다.
사용량 한도를 소진했다면 구독에서 제공하는 한도 관리 옵션을 사용합니다. max_tokens를 늘려도 Credits가 복구되지는 않습니다. 다음 호출이 성공했을 때 소비량이 늘어날 수 있습니다.
프리뷰 종료 전에 별도의 유료 경로로 전환합니다
프리뷰 이후에도 작업을 계속하려면 qwen3.8-max를 종량제 대안으로 사용합니다. Alibaba의 종량제 연결 설정 안내는 이 모델을 명시하고 사용량 기반 과금을 설명합니다. API 요금은 별도의 모델 페이지에 공개되어 있습니다.
이는 접근 경로에 대한 권장 사항입니다. 코딩 품질이 Qwen4-Max-Preview와 같다는 주장은 아닙니다.
API 키 발급 안내에 따라 싱가포르 리전에서 별도의 Model Studio API 키를 생성합니다. 이어서 키, 엔드포인트, 주 모델, 보조 모델 매핑을 바꿉니다.
다음 Bash 예제는 문서에 명시된 싱가포르 공용 엔드포인트를 사용합니다. Alibaba의 기본 URL 문서는 프로덕션용으로 권장하는 워크스페이스별 엔드포인트도 제공합니다.
read -rs DASHSCOPE_API_KEY && export DASHSCOPE_API_KEY
unset ANTHROPIC_API_KEY
export ANTHROPIC_AUTH_TOKEN="$DASHSCOPE_API_KEY"
export ANTHROPIC_BASE_URL="https://dashscope-intl.aliyuncs.com/apps/anthropic"
export ANTHROPIC_MODEL="qwen3.8-max"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3.8-max"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.8-max"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen3.8-max"
export CLAUDE_CODE_SUBAGENT_MODEL="qwen3.8-max"
claude --model qwen3.8-max여기서는 나열한 모든 모델 항목을 의도적으로 같은 대체 모델에 연결합니다. 보조 모델은 나중에 제공 여부와 비용을 확인한 뒤 다시 조정합니다.
새 대화를 시작하고 파일 읽기 작업을 반복한 뒤 유료 경로의 사용량을 확인합니다. Token Plan 인증 정보를 그대로 둔 채 모델만 바꾸면 과금이 종량제로 전환되지 않습니다.
다른 OpenAI 호환 유료 경로로는 BetterToken이 있으며, 2026-11-12 기준으로 qwen3.8-max를 목록에 제공합니다. 기본 URL은 https://www.bettertoken.ai/v1입니다. 본인의 BetterToken 키와 문서화된 OpenCode 연동 절차를 사용합니다. 이는 별도의 유료 API 접근이며 Qwen4 프리뷰 접근이 아닙니다. 전환 전에 현재 요금을 확인합니다.
