Qwen4-Max Claude Code 설정: API 요금과 프리뷰 전환
QwenCloud 종량제 API 또는 Token Plan 엔드포인트로 qwen4-max를 Claude Code에 연결합니다. Qwen3.8-Max, Opus 5.5와 토큰 요금, 캐시 생성 비용, 공개된 코딩 평가 결과를 비교합니다. 프리뷰 종료 전에 모델 ID를 바꾸고, API 한도와 Claude Code 출력 상한을 구분하며 실제 저장소 작업으로 연결을 검증합니다.
목차

Token Plan 구독 없이 Claude Code에서 Qwen4-Max를 시험하려면 QwenCloud 종량제 API를 사용하고 qwen4-max를 명시적으로 선택합니다. Qwen3.8-Max나 Opus 5.5와 비교하는 개발자는 이 방식으로 모델에 직접 연결하고, 사용한 토큰만큼 비용을 지불하며 시작할 수 있습니다. 기존 qwen4-max-preview 사용자는 프리뷰 기간이 끝나는 2026년 11월 25일 24:00 UTC+8 전에 모델 ID를 교체해야 합니다.
아래 제공 여부, 한도, 요금은 2026년 11월 17일 기준입니다.
프리뷰에서 달라진 점
11월 16일 정식 출시로 Token Plan 외에 종량제 API도 사용할 수 있게 됐습니다. 프리뷰는 Token Plan에서만 제공됐습니다. 정식 모델에는 qwen4-max-preview가 아니라 qwen4-max를 사용합니다.
API 한도와 Claude Code 설정값은 구분해야 합니다. 정식 모델 사양에 따르면 컨텍스트 길이는 1,000,000 토큰이며, 추론 모드의 최대 입력은 983,616 토큰입니다. 추론을 사용하지 않을 때 최대 출력은 131,072 토큰입니다. 추론과 최종 답변을 합친 한도는 262,144 토큰입니다.
프리뷰 사양에서는 추론과 답변이 393,216 토큰의 한도를 함께 사용했습니다. 따라서 정식 API의 합산 출력 한도는 오히려 낮아졌습니다. QwenCloud가 Claude Code의 출력 설정값을 높이도록 권장하는 것과는 별개의 제한입니다.
프리뷰 기간은 11월 25일이 끝나는 시점, 즉 11월 26일 00:00 UTC+8에 종료됩니다. 이후 프리뷰 모델을 서비스에서 제외할 예정입니다. 셸과 클라이언트 설정에 명시된 프리뷰 ID를 교체하고 클라이언트를 다시 시작한 뒤 정식 모델 ID를 확인합니다. 다른 앱에서 모델이 자동으로 업그레이드됐다고 해서 Claude Code 설정까지 전환되는 것은 아닙니다.
종량제 API와 Token Plan 선택 기준
API 시험 사용 비용을 측정하거나 앱에 통합하려면 종량제를 선택합니다. 구독 사용량 안에서 대화형으로 코딩하려면 Token Plan을 선택합니다.
| 접속 방식 | 요구 사항과 과금 방식 | 선택할 상황 |
|---|---|---|
| QwenCloud 종량제 | QwenCloud 계정, 같은 리전의 API 키와 엔드포인트, 활성화된 결제가 필요합니다. 입력 토큰과 출력 토큰은 따로 과금합니다. | Qwen4-Max 비용을 직접 측정하거나 앱 백엔드와 자동화에 사용할 때 선택합니다. |
| QwenCloud Token Plan | 싱가포르 서비스를 통한 QwenCloud 구독과 Token Plan 전용 키 및 엔드포인트가 필요합니다. 사용량은 Credits에서 차감합니다. | 지원되는 코딩 도구에서 월 사용량 안에서 대화형으로 작업할 때 선택합니다. |
| OpenRouter | 잔액이 충전된 OpenRouter 계정과 호환 클라이언트가 필요합니다. qwen/qwen4-max를 사용하며 크레딧 구매 시 수수료가 부과됩니다. | 이미 OpenRouter로 제공업체를 비교하고 있을 때 선택합니다. |
| 다른 모델을 위한 BetterToken | 본인 계정과 API 키, 모델별 종량제 과금, 문서에 따른 Claude Code 설정이 필요합니다. | 사용 가능한 다른 모델과 접속 방식을 비교합니다. 현재 모델과 요금을 확인합니다. |
Token Plan Lite의 표준 정가는 $6/month이며, 제공량은 20,000 토큰이 아니라 20,000 Credits입니다. 사용 정책은 자동화 스크립트, 앱 백엔드, 비대화형 일괄 호출을 허용하지 않습니다. 플랜과 Credit Packs를 모두 소진해도 요청이 자동으로 종량제 과금으로 전환되지는 않습니다.
전체 지출을 비교할 때는 표시된 토큰 요금뿐 아니라 OpenRouter의 충전 수수료도 고려해야 합니다. BetterToken API 이용과 모델 제공업체의 구독은 별개입니다. 현재 작동하는 접속 방식을 바꾸기 전에 계정 활성화 여부와 이용 가능한 결제 수단을 확인합니다.
싱가포르 종량제 API는 Token Plan Credits와 별도로 1 million tokens의 무료 사용량을 제공합니다. 무료 사용량의 대상 조건과 유효 기간을 확인해야 합니다. 해당 무료 사용량이 지금도 계정에 남아 있다고 가정하지 않습니다.
Claude Code에 Qwen4-Max 연결하기
설치된 Claude Code CLI와 싱가포르 리전에서 생성한 QwenCloud 종량제 API 키가 필요합니다. 콘솔에서 리전을 선택하고 API Keys를 연 뒤 키를 생성합니다.
먼저 ~/.claude/settings.json과 프로젝트의 .claude/settings.json에 이전 제공업체 설정이 남아 있는지 확인합니다. 그런 다음 Bash에서 아래 명령을 실행합니다. 첫 명령이 입력을 기다리면 키를 붙여 넣고 Enter를 누릅니다. 입력한 키는 화면에 표시되지 않으며 셸 명령 기록에도 저장되지 않습니다.
read -rs ANTHROPIC_AUTH_TOKEN && export ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://ap-southeast-1.maas.qwencloudapi.com/apps/anthropic"
export ANTHROPIC_MODEL="qwen4-max"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen4-max"
export CLAUDE_CODE_SUBAGENT_MODEL="qwen4-max"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616"
claude -p "Hello"
이 설정은 QwenCloud가 문서에 명시한 Anthropic 호환 엔드포인트와 모델별 안내를 사용합니다. 일반 종량제 예제에는 아직 qwen3.7-max가 적혀 있습니다. 위 설정은 정식 Qwen4-Max를 선택하도록 모델 값을 명시적으로 바꾼 구성입니다.
ANTHROPIC_MODEL은 주 모델을 선택합니다. ANTHROPIC_DEFAULT_OPUS_MODEL은 Claude Code의 Opus 별칭에 모델을 연결합니다. 이 별칭만 설정하는 것은 실제로 사용할 모델을 선택하는 것과 다릅니다. 내보낸 환경 변수는 현재 터미널에 적용됩니다.
응답이 오면 기본 인증과 요청 전달 경로가 작동함을 확인할 수 있습니다. 다음으로 README.md가 있는 저장소 안에서 아래 명령을 실행합니다.
claude -p "Read README.md and report the project name and any documented test command. Do not edit files."
응답을 실제 파일 내용과 비교합니다. 연결이 정상이라면 파일을 수정하지 않고 해당 저장소의 구체적인 정보를 반환해야 합니다. 이후에는 기존 테스트로 확인할 수 있는 작은 변경을 시도합니다. 인사에 답했다는 사실만으로 코딩 도구와의 호환성까지 확인됐다고 판단하지 않습니다.
기존 Token Plan을 사용하는 경우
위의 qwen4-max 모델 설정은 유지하고, 인증 정보와 엔드포인트를 모두 Token Plan용으로 교체합니다.
read -rs ANTHROPIC_AUTH_TOKEN && export ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://token-plan.maas.qwencloudapi.com/apps/anthropic"
claude
종량제 키가 아닌 Token Plan 전용 키를 붙여 넣습니다. 저장소 검증은 Claude Code에서 대화형으로 진행합니다. 사용자 개입 없이 실행하는 자동화에는 종량제 API를 사용합니다.
긴 답변이 잘리거나 요청이 실패하는 경우
긴 답변이 잘리면 QwenCloud는 프리뷰에서 사용하던 64000 설정을 다음 값으로 바꾸도록 권장합니다.
export CLAUDE_CODE_MAX_OUTPUT_TOKENS="131072"
해당 터미널에서 새 Claude Code 세션을 시작합니다. 이는 QwenCloud가 권장하는 클라이언트 설정이지, CLI가 131,072 토큰을 반환한다는 보장은 아닙니다. 현재 Claude Code 문서는 인식하지 못하는 모델 ID의 출력 상한을 128000 토큰으로 제한합니다. 더 높은 값을 설정해도 이 상한으로 낮춰 적용합니다.
어느 설정값도 API의 추론과 답변 합산 한도인 262,144 토큰을 클라이언트에서 그대로 사용할 수 있게 하지는 않습니다. 클라이언트 상한만 남은 제약이라면 큰 결과물을 여러 요청으로 나누어 생성합니다.
인증에 실패하면 키를 계속 새로 만들기 전에 인증 정보의 종류와 리전을 확인합니다. QwenCloud의 리전 규칙에 따르면 API 키와 엔드포인트는 같은 리전에 속해야 합니다.
Token Plan 오류는 공식 오류 안내를 참고해 429 insufficient_quota와 429 Requests rate limit exceeded를 구분합니다. 사용량을 소진했다면 초기화를 기다리거나 Credit Pack을 구매합니다. 요청 속도 제한이라면 요청 빈도 또는 동시 호출 수를 줄여야 합니다. 원인을 수정한 뒤 작은 대화형 요청 하나로 다시 확인합니다.
컨텍스트 오류가 반복되면 명시적으로 지정한 983616 값을 유지합니다. 한도를 높이기 전에 게이트웨이 사용 시 Claude Code의 컨텍스트 창 처리 방식을 확인합니다.
작업 비용을 비교하기 전에 토큰 요금 계산하기
이 구성에는 싱가포르 요금을 적용합니다. 싱가포르 엔드포인트를 쓰면서 다른 리전의 가격으로 계산하지 않습니다.
아래 예상 비용은 모든 모델이 캐시 없는 입력 100,000 토큰과 추론을 포함한 과금 대상 출력 10,000 토큰을 동일하게 사용한다고 가정합니다. 모델 토큰 요금만 계산하며, 캐시, 제공업체의 유료 호스팅 도구, 충전 수수료, 세금은 포함하지 않습니다.
| 모델과 직접 접속 방식 | 1M 토큰당 입력 요금 | 1M 토큰당 출력 요금 | 모델 토큰 예상 비용 |
|---|---|---|---|
| Qwen4-Max, 싱가포르 | $1.50 | $4.50 | $0.195 |
| Qwen3.8-Max, 싱가포르 | $2.00 | $6.00 | $0.260 |
| Claude Opus 5.5, 표준 API | $4.00 | $20.00 | $0.600 |
Qwen4-Max의 계산식은 0.1 × $1.50 + 0.01 × $4.50 = $0.195입니다. 가정에 따른 금액이며 같은 코딩 작업을 완료하는 데 든 실측 비용이 아닙니다. 모델마다 추론, 컨텍스트, 재시도에 사용하는 토큰 수가 달라질 수 있습니다. QwenCloud 문서의 기본값은 reasoning_effort=high와 thinking_budget=131072입니다. 이 예산은 상한이지 실제 청구되는 사용량이 아닙니다.
캐시 읽기뿐 아니라 생성 비용도 포함하기
싱가포르에서 Qwen4-Max의 캐시 읽기 요금은 암시적 캐시와 명시적 캐시 모두 1M 토큰당 $0.075입니다. 명시적 캐시 생성 요금은 유지 시간이 5분이면 1M 토큰당 $1.875, 1시간이면 $3.00입니다.
토큰 수를 백만 단위로 환산해 다음 식으로 계산합니다.
cost_USD = 1.50U + 0.075R + 1.875W5 + 3.00W60 + 4.50O
U는 캐시를 쓰지 않은 입력, R은 캐시에서 읽은 입력입니다. W5와 W60은 각 유지 시간에 해당하는 캐시 쓰기 토큰 수입니다. 입력 토큰 하나는 한 범주에만 포함합니다. O에는 추론과 최종 답변을 모두 포함합니다.
캐시 생성부터 읽기까지 포함한 예로 요청 두 개를 가정합니다. 각 요청에는 변하지 않는 접두부 100,000 토큰, 새 입력 5,000 토큰, 출력 2,000 토큰이 있습니다. 첫 요청이 접두부를 캐시에 기록하고, 두 번째 요청이 유지 시간이 5분인 해당 캐시를 읽는 조건입니다.
예상 합계는 0.010 × $1.50 + 0.100 × $0.075 + 0.100 × $1.875 + 0.004 × $4.50 = $0.228입니다. 캐시를 쓰지 않고 같은 토큰 양을 처리하면 0.210 × $1.50 + 0.004 × $4.50 = $0.333이 됩니다.
이 예는 캐시 적중에 성공한다고 가정합니다. 제공업체의 캐시 사용량 필드로 실제 읽기와 쓰기 토큰 수를 확인합니다. 코딩 세션을 반복할 때는 Claude Code 백그라운드 에이전트의 추가 토큰 소비도 살펴봅니다. 모든 비용을 주 답변에서 발생한 것으로 계산하지 않습니다.
코딩용으로 Opus 5.5와 비교하는 기준
비용이 중요하고 작업 범위가 명확한 저장소 과제라면 Qwen4-Max부터 시험합니다. 어려운 터미널 작업에는 자체 인수 테스트로 전환의 타당성을 확인할 때까지 Opus 5.5를 비교 대상으로 유지합니다.
11월 17일 기준 Vals AI Terminal-Bench 4.0 순위표의 결과는 다음과 같습니다.
| 공개된 모델 항목 | Mini-SWE-agent 점수 | 테스트당 비용 |
|---|---|---|
| Qwen 4 Max | 48.48% | $3.90 |
| Qwen 3.8 Max 0902 | 38.89% | $12.15 |
| Claude Opus 5.5 | 65.15% | $12.04 |
이 결과로 내릴 수 있는 결론은 단순히 “Opus를 대체한다”는 주장보다 제한적입니다. Qwen4-Max는 표에 날짜가 표시된 Qwen3.8-Max 버전보다 나은 결과를 내지만, 해당 터미널 작업에서는 Opus보다 뒤처집니다. 테스트당 비용은 검증을 통과한 코드 수정 하나를 완성하는 비용과 다릅니다.
이 수치는 공개된 에이전트 실행 결과이며, 동일한 추론 수준으로 진행한 Claude Code 테스트가 아닙니다. Vals의 Qwen4-Max 평가는 xhigh를 사용했고, Opus 페이지에는 max가 표시되어 있습니다. Opus 출시 당시 보고서는 다른 모델로 전환하는 폴백도 사용했다고 밝혔습니다. 따라서 현재 표를 다른 모델의 도움 없이 조건을 통제한 비교로 보면 안 됩니다. 추론 수준과 폴백이 코딩 에이전트 비교에 미치는 영향을 확인한 뒤 결과 차이를 실제 작업에 적용해야 합니다.
첫 시험은 30분으로 제한합니다. 인수 테스트가 정해진 작은 과제 하나를 고르고, 저장소의 초기 상태와 지시를 동일하게 유지하며 재시도를 포함한 총비용을 기록합니다. Qwen4-Max가 같은 인수 기준을 만족하고 총비용도 받아들일 만하다면 해당 유형의 작업에 도입합니다. 추가 시도나 수정 때문에 토큰 단가의 이점이 사라지는 작업에는 Opus를 유지합니다.