Claude CodeでQwen4を使うには?モデル設定と接続エラーの切り分け
QwenCloudの接続先とモデル割り当てを確認し、Qwen4-MaxをClaude Codeに設定。401・403やCC Switchのモデル一覧エラーを順に切り分けます。
Claude CodeでQwen4-Maxを使うには、QwenCloudのAnthropic互換Base URL、その経路に対応するキー、明示的な qwen4-max の割り当てを設定します。 モデル名の表示だけを変えても接続先は変わりません。モデル一覧の取得成功も、会話を始めるための必須条件ではありません。
本記事は2026年11月17日に確認したQwenCloudの文書に基づき、qwen4-max-preview ではなく正式版を扱います。バージョンの違いを確認する場合は、先にQwen4 APIの接続・移行ガイドを参照してください。ここでの目的は、コーディングクライアントを意図した経路につなぎ、どの層で失敗したかを特定することです。
以下のシェル設定は、設定名を記録するローカルの疑似クライアントで確認しました。実際のモデルは呼び出していません。本記事では有料のQwen4リクエストを実行していません。最後の会話テストと課金記録の照合は、利用権限のあるご自身のアカウントで行う手順です。
キーを入力する前に接続経路を選ぶ
QwenCloudにはToken Planと地域別の従量課金経路があります。最初にどちらを使うか決め、片方のキーともう片方のBase URLを組み合わせないでください。
| 利用する経路 | Claude CodeのBase URL | 確認事項 |
|---|---|---|
| QwenCloud Token Plan | https://token-plan.maas.qwencloudapi.com/apps/anthropic | プランのキーと選択モデルへのアクセス権 |
| QwenCloud従量課金、シンガポール | https://ap-southeast-1.maas.qwencloudapi.com/apps/anthropic | その地域で発行したキーとモデル利用権 |
| QwenCloudの別地域 | その地域で文書化されたAnthropic互換URL | 地域、サービス提供状況、キーの範囲 |
これらはBase URLであり、メッセージ送信先の完全なURLではありません。この設定では末尾に /v1 を追加しません。クライアントが配下のmessagesパスを使います。根拠はQwenCloudのClaude Codeガイド(英語)と地域の文書(英語)です。
Ofox APIキーはQwenCloudのキーではありません。Ofoxが提供する別のモデルを選ぶ場合は、Ofoxの認証文書と、その環境で対応する接続設定を使ってください。上記のQwenCloudアドレスへOfoxキーを入力しないでください。本記事はOfoxでのQwen4提供を確認するものではありません。最新のOfoxモデル一覧を別途確認してください。
設定を明示したQwen4のテストセッションを起動する
最初の診断では新しいターミナルと小さな合成テスト用プロジェクトを使い、普段の設定をバックアップします。次のBashランチャーでエクスポートする変数は、そのプロセスと子クライアントだけに適用されます。グローバル設定ファイルを書き換えず、キーを表示したりスクリプトに保存したりもしません。
launch-qwen4.sh として保存します。
#!/usr/bin/env bash
set -euo pipefail
# Singapore pay-as-you-go. For Token Plan, replace only this route
# and enter the matching Token Plan key when prompted.
export ANTHROPIC_BASE_URL="https://ap-southeast-1.maas.qwencloudapi.com/apps/anthropic"
unset ANTHROPIC_API_KEY
read -r -s -p "QwenCloud key for this route: " ANTHROPIC_AUTH_TOKEN
printf '\n'
if [[ -z "$ANTHROPIC_AUTH_TOKEN" ]]; then
printf 'No key entered; no request sent.\n' >&2
exit 1
fi
export ANTHROPIC_AUTH_TOKEN
# Deliberately use one model while diagnosing routing.
export ANTHROPIC_MODEL="qwen4-max"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen4-max"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen4-max"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen4-max"
export CLAUDE_CODE_SUBAGENT_MODEL="qwen4-max"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616"
exec claude "$@"
テストプロジェクトで bash launch-qwen4.sh を実行します。Token Planを試す場合は表のBase URLに差し替え、対応するプランキーを入力してください。安価そうなモデルIDへ変更する前に、その経路で使えることを確認します。
すべての別名をQwen4-Maxへ割り当てるのは診断のためで、費用面の推奨ではありません。バックグラウンド処理やサブエージェントが別の設定モデルを選ぶ不確実性を除きます。経路を確認した後で、軽い処理を別の対応モデルへ割り当て、その設定を個別に検証できます。
このランチャーは、管理された設定、ラッパー、IDE拡張機能をすべて上書きするものではありません。組織管理のクライアントでは組織の方針に従ってください。今回のテストはCLIを直接起動し、IDEが別の環境を渡す可能性を切り分けます。Windowsでは対応するWSLまたはGit Bash環境で実行してください。ネイティブのPowerShellは環境変数の構文が異なります。Windows側のCLIとWSLのインストールが同じ設定を読むとは限りません。
接続先、成果物、課金を別々に確認する
新しいClaude Codeセッション内で /status を実行し、プロバイダーURLと選択モデルを予定した値と照合します。資格情報を含む設定の生データやスクリーンショットは公開しないでください。経路が空、または別の接続先のままなら、モデルを変える前にそのクライアントプロセスが読み込んだ設定を調べます。
非公開リポジトリを使わない、小さな依頼から始めます。
Create a Python function named normalize_code(value).
It must accept a string, trim surrounding spaces and preserve leading zeros.
Raise TypeError for non-string input.
Add tests for " 0017 ", "", and the integer 17.
Do not install dependencies or access the network.
Show which files you changed and how to run the tests.
この英語の依頼では、文字列の前後の空白を除去して先頭のゼロを残す normalize_code(value) を作り、文字列以外は TypeError にするよう指定しています。指定入力のテストを追加し、依存関係のインストールとネットワーク利用は禁止しています。
検証記録は3つに分けます。
- 経路:セッションが予定した接続先と割り当てを示し、利用できる場合はプロバイダーのリクエスト記録も対象モデルを示すこと。モデルの自己紹介は経路の証拠になりません。
- 成果物:ファイルが存在し、
" 0017 "が"0017"に、空文字列は空のままになり、整数ではTypeErrorが発生すること。生成されたテストを実行し、差分を確認します。 - 課金:対象アカウントまたはプランの使用量画面に呼び出しが記録されること。ツールのモデル表示から課金元を推測しないでください。
回答がよくても別のアカウントに課金されたなら、設定は合格ではありません。経路が正しくテストが失敗した場合は、接続問題ではなくタスクの失敗として記録します。最初の実験を小さく保ち、確認できてから広い範囲のリポジトリ編集や長いタスクへ進みます。
症状から失敗した層を切り分ける
公式のトラブルシューティング(英語)では、ひとまとめに「Qwenが動かない」と見えがちな問題を分けています。
| 症状 | 最初の確認 | 次の対処 |
|---|---|---|
401 invalid_api_key | キーの経路・地域と実効プロバイダーURL | 対応するQwenCloudキーを使い再起動。ログにキーを出さない |
| Claude CodeがAnthropicへ接続する | /status と現在のプロセスが読んだ設定 | 環境変数や設定を修正し、ラッパーや認証の競合を調べる |
| CC Switchでモデル一覧のエンドポイントが見つからない | messagesではなくモデル検出を試していないか | モデルを手動で割り当て、文書化された経路でメッセージを試す |
モデル変更後に 403 AccessDenied | 利用権とQwenCloudモデル一覧のライフサイクル表示 | 利用不可・廃止予定の割り当てを利用可能な現行モデルへ変更し、エラーとリクエストIDを保持 |
| 旧経路でモデル変更が反映されない | Base URLに claude-code-proxy があるか | 文書化された /apps/anthropic へ移行 |
| 長い回答が途中で止まる | クライアントの出力上限と応答の停止理由 | モデル固有の制限を確認し、タスクを小さくするか上限を意図して調整 |
カスタムプロバイダーを正しく設定しても起動時にAnthropic公式ログインへ進む場合、QwenCloudのFAQでは ~/.claude.json の hasCompletedOnboarding: true も確認するよう案内しています。~/.claude/settings.json とは別ファイルです。先にJSONをバックアップし、関連フィールドだけをマージしてください。ファイル全体の置換や組織管理設定の変更は避け、新しいターミナルで再起動します。それでも文書どおりの設定が動かなければ、公式のインストール方法でクライアントを更新し、読み込まれた設定を再確認します。
モデル一覧の問題には注意が必要です。QwenCloudのAnthropic互換経路は /v1/messages を提供しますが、モデル一覧用エンドポイントは提供しません。このためCC Switchの検出が失敗しても、会話の経路は利用できる場合があります。すべての404を無視してよいという意味ではありません。 メッセージURLの誤り、余分なパス、非対応モデルは修正が必要です。どのリクエストが失敗したのかを確認してください。
直接のリクエストは成功しコーディングクライアントだけ失敗する場合は、Claude Codeでcurlは成功するのに接続できない場合の対処を参照してください。モデルIDが利用できない場合は、OpenAIのmodel-not-found対処ガイド(英語)のプロバイダーとエンドポイントの確認方法が参考になります。Qwen固有のエラー再現記録ではありません。証明書エラーはモデル割り当てではなくTLSと証明書のトラブルシューティングで扱います。証明書検証を無効にして回避しないでください。
コンテキストと出力上限を意図して設定する
現在のQwenCloudガイドは、Qwen4-Maxの CLAUDE_CODE_MAX_CONTEXT_TOKENS を 983616 に保つよう案内しています。このクライアント設定はモデルの公称100万トークンのコンテキストとは同じ量ではなく、設定できたことが長いタスクの成功を保証するわけでもありません。
11月17日版のガイドは、Qwen4-Maxの長い出力が切れる場合に CLAUDE_CODE_MAX_OUTPUT_TOKENS=131072 を推奨しています。同じページのプレビュー向け注記は 64000 です。プレビューの値を正式版に混ぜないでください。最初の疎通確認から最大値にする必要はありません。許容出力が大きいと処理時間や消費量が増える可能性があります。停止理由を調べ、タスクに適した上限を選びます。
エージェントが大きな参考文書を繰り返し読む場合は、Qwen4の明示的キャッシュのチュートリアルへ進んでください。大きなコンテキストは容量の設定であり、キャッシュは別のリクエスト仕様です。対応する使用量フィールドがなければ、どちらもキャッシュ命中の証拠にはなりません。
復元できる設定記録を残す
テストに通ったら、クライアントのバージョン、Base URL、モデル割り当て、キーの種類と地域、テスト結果、日時を記録します。キー自体は通常の安全な資格情報管理先に保存してください。永続設定では必要な項目を既存ファイルへマージし、無関係な権限や設定を置き換えないようにします。
次に問題が起きたときは1回に1つだけ変数を変更し、機密情報を除いたリクエストID、HTTPステータス、エラーコード、モデルIDを残します。このランチャーから戻すには起動したセッションを終了し、親ターミナルから通常のクライアントを起動します。親の環境変数や設定ファイルは変更されていません。別途永続設定を変えた場合は、そのバックアップも戻してください。
意図した経路、実際のファイル、意図した使用量記録が一致すれば設定完了です。毎回別の経路を調べ直すことなく、安定した条件で実際のコーディング作業を比較できます。
よくある質問
- Claude Codeを使うにはQwenのモデル一覧を取得する必要がありますか?
- いいえ。QwenCloudのAnthropic互換エンドポイントはmessagesを提供しますが、モデル検出には対応しないと文書化されています。CC Switchの一覧取得失敗と、メッセージ送信失敗は別です。
- Opusを選ぶとAnthropicのモデルが動きますか?
- 必ずしもそうではありません。カスタムプロバイダーではOpusの別名をQwen4-Maxに割り当てられます。プロバイダー、正確な割り当て、プロバイダー側のリクエスト記録を確認してください。


