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の100万トークン当たりの単価ではなく、サブスクリプション料金を予算に入れます。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 opus
Claude 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使用量を確認してください。単なるあいさつへの応答よりも、ツールの呼び出しから結果の利用までを確認するほうが有用です。
次に、合格条件を確認できるテストがある、小さな変更を1つ試します。選択したモデル、推論の設定、所要時間、テスト結果、消費した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設定は引き続き受け付けるとしています。この1つのプロバイダーオブジェクト内に、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を試してください。設定は1つずつ変更し、回答の長さだけでなく、作業を完了できたかを比較します。
既存の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という状態を原因の1つとして挙げています。権限とプランでの利用資格も確認してください。すべての403がモデルの提供終了を意味するわけではありません。
出力が途切れる場合は、認証設定を変更する前に、実際に適用される出力上限と推論の強度を確認します。前述のClaude CodeまたはQwen Codeの設定を適用し、同じタスクを繰り返してください。
利用枠を使い切った場合は、契約の利用枠管理機能を確認します。max_tokensを増やしてもCreditsは戻りません。次の呼び出しが成功したときの消費量が増える可能性があります。
提供終了前に別の従量課金APIへ移行します
プレビュー終了後も作業を続けるために、従量課金の代替モデルとして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
ここでは、列挙したすべての割り当て先を意図的に移行先モデルへ統一しています。補助モデルは、提供状況と料金を確認してから改めて調整してください。
新しい会話を開始し、ファイル読み取りを繰り返して、別の従量課金APIで使用量が記録されることを確認します。Token Planの認証情報を残したままモデルだけを変えても、課金は従量課金へ移りません。
別のOpenAI互換有料APIとして、BetterTokenは2026-11-12時点でqwen3.8-maxを掲載しています。ベースURLはhttps://www.bettertoken.ai/v1です。自分のBetterTokenキーとOpenCode連携の公式手順を使ってください。これは別途課金されるAPIへの接続であり、Qwen4プレビューへの接続ではありません。切り替え前に現在の料金を確認します。