Qwen4-MaxをClaude Codeで使う:設定・料金とプレビュー版からの移行
QwenCloudの従量課金APIまたはToken Planからqwen4-maxをClaude Codeに接続します。Qwen3.8-MaxやOpus 5.5とトークン料金、キャッシュ作成費用、公開されたコーディング評価を比較します。プレビュー終了前のID変更、APIとクライアントの出力上限の違い、実際のリポジトリでの確認手順を解説します。
目次

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に加えて従量課金でも利用できるようになりました。プレビュー版はToken Plan限定でした。正式版のモデルにはqwen4-maxを使い、qwen4-max-previewは指定しません。
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を確認してください。別のアプリでモデルが自動更新されても、Claude Codeの設定まで移行されるとは限りません。
どの接続方法を選べばよいですか?
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 Creditsです。20,000トークンではありません。利用規約では、自動化スクリプト、アプリのバックエンド、非対話型のバッチ呼び出しは対象外です。契約の利用枠と追加の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で対話しながら行います。人が操作しない自動処理には、従量課金の接続方法を使ってください。
長い回答が途中で切れる場合とリクエストの失敗
長い回答が途中で切れる場合、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を購入します。リクエスト頻度の制限であれば、送信頻度や同時実行数を減らします。原因を解消した後、小さな対話型リクエストを1つ再試行してください。
コンテキストのエラーが繰り返される場合は、明示的な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は、それぞれの保持時間でキャッシュに書き込んだ量を表します。各入力トークンは、いずれか1つの区分で数えてください。Oには思考と最終回答の両方を含めます。
作成から読み取りまで含めた例として、2回のリクエストを考えます。各リクエストには、変わらない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でのスコア | テスト1件あたりの費用 |
|---|---|---|
| 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を下回ります。また、テスト1件の費用は、受け入れ条件を満たす修正を完成させる費用とは異なります。
これは公開されたエージェントの実行結果であり、思考の強度をそろえたClaude Codeのテストではありません。ValsによるQwen4-Maxの評価はxhighで、Opusのページにはmaxと記載されています。Opusの公開当初のレポートでは、予備モデルへの切り替えも開示されていました。そのため、現在の表を、予備モデルを使わず条件を統一した比較として扱うべきではありません。思考の強度と予備モデルがコーディングエージェントの比較に与える影響を確認してから、自分の作業に結果を当てはめてください。
最初の試用は30分に区切ります。受け入れテストが決まっている小さな課題を1つ選び、リポジトリの初期状態と指示をそろえ、再試行を含む総費用を記録してください。同じ受け入れ条件を満たし、総費用も許容できるなら、その種類の作業にQwen4-Maxを採用します。追加の再試行や修正でトークン単価の利点が失われる作業には、Opusを残してください。