Alibaba Cloud Model Studio のモデルを Claude Code で使用します。
モデルを追加
クライアントを選択して設定を完了します。
CLI
- 1
Configure the model
Token Plan
YOUR_API_KEYを Token Plan API キーに置き換えます:- Token Plan Personal Edition:API Key を作成または表示
- Token Plan Team Edition:シートを割り当てて API Key を取得
export ANTHROPIC_AUTH_TOKEN="YOUR_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"注記qwen4-max-preview を使用する場合、長い出力が切り詰められる場合は、
CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000を設定します。注記qwen4-max を使用する場合は、
ANTHROPIC_DEFAULT_OPUS_MODELをqwen4-maxに設定し、CLAUDE_CODE_MAX_CONTEXT_TOKENSは983616のままにします。長い出力が切り詰められる場合は、CLAUDE_CODE_MAX_OUTPUT_TOKENS=131072を設定します。qwen4-max のコンテキスト長は 1M Token です。非思考モードの最大出力は 131,072 Token、思考と最終回答の合計は最大 262,144 Token です。デフォルトは reasoning_effort=high、thinking_budget=131072 です。Pay-as-you-go
YOUR_API_KEYを Alibaba Cloud Model Studio API キー に置き換え、{WorkspaceId}を実際の Workspace ID に置き換えます。次の例では Singapore を使用します。export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_BASE_URL="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic" export ANTHROPIC_MODEL="qwen3.7-max" export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3.6-flash" export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.7-max" export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen3.7-max" export CLAUDE_CODE_SUBAGENT_MODEL="qwen3.7-max"Coding Plan
YOUR_API_KEYを Coding Plan API キー に置き換えます。export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_BASE_URL="https://coding-intl.dashscope.aliyuncs.com/apps/anthropic" export ANTHROPIC_MODEL="qwen3.7-plus" export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3.7-plus" export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.7-plus" export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen3.7-plus" export CLAUDE_CODE_SUBAGENT_MODEL="qwen3.7-plus"注記これらの環境変数は現在のターミナルでのみ有効です。永続的な設定には、設定ファイルによる設定を使用してください。
- 2
Verify
次のコマンドを実行して確認します。
claude -p "Hello"
CC Switch
- 1
Install CC Switch
CC Switch をダウンロードしてインストールします。
- 2
Add a Bailian provider
CC Switch で Claude Code アイコンを選択し、+ をクリックして、対応するタブのフィールドに入力します。
Token Plan
- プロバイダー名: Bailian-Token Plan
- Token Plan Personal Edition API キー:API Key を作成または表示
- Token Plan Team Edition API キー:シートを割り当てて取得
- エンドポイント:
https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
Pay-as-you-go
- プロバイダー名: Bailian-Pay-as-you-go
- API キー: Model Studio API キー
- エンドポイント:
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
Coding Plan
- プロバイダー名: Bailian-Coding Plan
- API キー: コンソールから取得
- エンドポイント:
https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
- 3
Configure model mapping
Advanced Options を展開し、メイン、Haiku、Sonnet、Opus のモデルを設定します。例:
- メインモデル:
qwen3.8-max - Haiku デフォルトモデル:
qwen3.8-flash - Sonnet デフォルトモデル:
qwen3.8-flash - Opus デフォルトモデル:
qwen3.8-max
- メインモデル:
- 4
Switch to the Claude Desktop panel
CC Switch で、左側の Claude Desktop パネルに切り替えます。表示されない場合は、Settings > General > App visibility で有効にします。
- 5
Import the provider
Claude Code ですでに設定したプロバイダーをインポートするか、+ をクリックして追加します。Bailian モデル ID に対して Needs model mapping をオンにし、Sonnet、Opus、Haiku を実際のモデルにマッピングします。
- 6
Enable local routing
Settings > Routing > Local Routing に移動してメインページのスイッチをオンにし、Claude Desktop パネルでローカルルーティングをオンにします。デフォルトアドレスは
127.0.0.1:15721です。 - 7
Enable and restart the desktop app
プロバイダーカードの Enable をクリックし、デスクトップアプリで API キーを手動で入力しないでください。CC Switch を実行したまま、デスクトップアプリを 完全に終了して再起動 します。
IDE plugin
- 1
Install the plugin
IDE の拡張機能マーケットプレイスから Claude Code プラグインをインストールします。
- 2
Configure the model
設定ファイルによる設定の説明に従って
settings.jsonに設定を追加するか、先に CLI の設定を完了します。 - 3
設定ファイルを開く/新規作成
IDE を再起動し、Claude Code アイコンをクリックして、ダイアログに
/と入力し、General config を選択して、Selected Model でモデルを設定します。
Desktop
Claude Code Desktop は、CC Switch ローカルゲートウェイを介して Model Studio に接続します。
- 1
Install Claude Code Desktop
Claude ダウンロードページからダウンロードしてインストールします。
- 2
Configure CC Switch
CC Switch タブの手順に従って、プロバイダーとルーティングを設定します。
- 3
Restart the desktop app
CC Switch を実行したまま、Claude Code Desktop を完全に終了して再起動します。
設定ファイルによる設定
上記の方法に加えて、設定ファイルでも接続できます。
- 1
設定ファイルを開く
- macOS / Linux:
~/.claude/settings.json - Windows:
C:\Users\<username>\.claude\settings.json
- macOS / Linux:
- 2
設定を追加する
Token Plan
YOUR_API_KEYを Token Plan APIキーに置き換えます:- Token Plan Personal Edition:API Key を作成または表示
- Token Plan Team Edition:シートを割り当てて API Key を取得
{ "env": { "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic", "ANTHROPIC_MODEL": "auto", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash", "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-flash", "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen4-max-preview", "CLAUDE_CODE_SUBAGENT_MODEL": "auto", "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616" } }Pay-as-you-go
YOUR_API_KEYを Alibaba Cloud Model Studio APIキー に、{WorkspaceId}を実際の Workspace ID に置き換えます。次の例では Singapore を使用します。{ "env": { "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic", "ANTHROPIC_MODEL": "qwen3.7-max", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash", "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-max", "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max", "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max" } }Coding Plan
YOUR_API_KEYを Coding Plan APIキー に置き換えます。{ "env": { "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_BASE_URL": "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic", "ANTHROPIC_MODEL": "qwen3.7-plus", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.7-plus", "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus", "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus", "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus" } } - 3
確認
保存後、次のコマンドを実行して確認します。
claude -p "Hello"
コンテキストウィンドウサイズの設定
Claude Code はデフォルトで 200K のコンテキストウィンドウを使用します。モデルが 1M をサポートしている場合、1M(1,000,000 トークン)に拡張できます。
方法 1:環境変数で設定する~/.claude/settings.json の env フィールドに CLAUDE_CODE_MAX_CONTEXT_TOKENS を追加します:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.7-plus",
"CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
}
}
方法 2:モデル名のサフィックスを使用する
モデル名に [1m] を追加します。これは 1M コンテキストウィンドウをサポートする Model Studio モデルで機能します:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.7-plus[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus[1m]",
"CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus[1m]"
}
}
設定を変更した後、新しいターミナルウィンドウを開いて Claude Code を再起動すると、変更が反映されます。
権限モード
Claude Codeは次の権限モードを提供します:
default: すべての操作の前に確認を求めます。acceptEdits: ファイル編集を自動的に承認します。その他の操作は引き続き確認を求めます。plan: 読み取り専用のプランニングモードです。変更は実行されません。auto: クラシファイアが操作を実行できるかどうかを判断し、確認プロンプトを減らします。インタラクティブターミナルおよびVS Codeセッションでは、Claude Code v2.1.283以降でこのモードがデフォルトで使用されます。dontAsk: 確認を求めません。確認が必要になる操作は直接拒否されます。bypassPermissions: すべての権限チェックをバイパスします。delegate: 委任モード。
注記Token Planエンドポイントでautoモードを使用する場合、クラシファイアチェックが結果を返さないことがあります。一部のモデルではNot run · auto mode's check had no usable answerが表示され、操作が実行されません。
このメッセージが表示された場合は、permissions.defaultModeをdefaultまたはacceptEditsに設定するか、クラシファイアが使用するモデルを調整し(ANTHROPIC_DEFAULT_SONNET_MODEL、Claude Code v2.1.302以降ではCLAUDE_CODE_AUTO_MODE_MODELも使用可能)、セッションを再起動してください。
--permission-modeを使用して、セッションのデフォルトの権限モードを設定します:
claude --permission-mode plan
claude --permission-mode acceptEdits
方法2:インタラクティブコマンド
セッション内で/permissionsを入力すると、bash、edit、MCPツールの事前承認ルールと事前拒否ルールを管理できます。
~/.claude/settings.jsonのpermissionsフィールドを設定します:
{
"permissions": {
"allow": ["Bash(git:*)", "Read", "Edit"],
"deny": ["Bash(rm:*)"],
"defaultMode": "default"
}
}
Bailian CLI の統合
- 1
Bailian CLI をインストールする
Please install the Alibaba Cloud Bailian CLI globally: npm install -g bailian-cli - 2
- 3
始める
タスクを自然言語で記述します。例:
Generate 6 Amazon e-commerce hero images for a white wireless Bluetooth headset. Generate a 30-second product demo video for a white wireless Bluetooth headset.
エラーコード
設定中にエラーが発生した場合は、ご利用の課金プランに対応する FAQ ドキュメントを参照してください:
- Token Plan: Personal Edition FAQ · Team Edition FAQ
- Pay-as-you-go: エラーコード
- Coding Plan: Coding Plan FAQ
よくある質問
従量課金で節約プランを使用するには?
従量課金の接続方法は変わりません。Model Studio の汎用 API Key と Base URL を使用します。節約プランを購入すると自動的に有効になり、対象の利用料金が自動的に控除されます。詳細は節約プランをご参照ください。
リクエストが 401 invalid_api_key を返す
API キーの種類が ANTHROPIC_BASE_URL と一致していません。Model Studio は 3 つのアクセス方法を提供しており、各アクセス方法では異なるベース URL と専用の API キーを使用します。
アクセス方法 | ベース URL | API キー |
|---|---|---|
Token Plan |
| Token Plan API キー |
Pay-as-you-go | Model Studio API キー( | |
Coding Plan | Coding Plan 専用 API キー |
トラブルシューティング手順:
- リクエスト URL を確認する。
~/.claude/settings.json内のANTHROPIC_BASE_URLを確認します。 - API キーの種類を確認する。 上の表を使用して、API キーの種類がベース URL と一致していることを確認します。
- 設定を修正する。 Model Studio の Pay-as-you-go API キーを使用する場合は、
ANTHROPIC_BASE_URLをhttps://dashscope-intl.aliyuncs.com/apps/anthropicに設定します。
Claude Code の起動後、インターフェースに "Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST" と表示される
Claude Code が Alibaba Cloud Model Studio ではなく公式 Anthropic サービスに接続しようとしています。これは通常、環境変数が欠落しているか、反映されていないことを意味します。次の手順に従ってください:
- 設定を確認する。 Claude Code を起動した後、
/statusコマンドを実行します。ANTHROPIC_BASE_URLとANTHROPIC_AUTH_TOKENが Model Studio のアドレスを指していることを確認します。出力が空である場合、または Model Studio 以外のアドレスが表示される場合は、settings.jsonの設定を確認してください。 - hasCompletedOnboarding を確認する。
~/.claude.jsonでhasCompletedOnboardingがtrueに設定されていることを確認します。これが設定されていないと、Claude Code は起動時にログイン検証のために公式 Anthropic サービスへの接続を試みます。 - 新しいターミナルを開く。 設定ファイルの編集後、新しいターミナルウィンドウを開いて
claudeを実行し、変更を反映させます。 - Claude Code を更新する。 上記のすべての手順を実行しても問題が解決しない場合、Claude Code のバージョンが古い可能性があります。
npm install -g @anthropic-ai/claude-code@latestを実行して最新バージョンに更新し、再度お試しください。
レガシーインターフェース使用時にモデル切り替えが反映されない
レガシー互換インターフェース https://dashscope-intl.aliyuncs.com/api/v2/apps/claude-code-proxy は、非推奨のモデルのみをサポートします。他のモデルを指定しても効果はありません。利用可能なモデルを使用するには、このドキュメントの設定に従って新しいインターフェースに移行してください。
プロバイダー追加時に CC Switch が "No available model list endpoint found. Check the Base URL or confirm that the provider has opened the port" と報告する
このメッセージは、プロバイダー保存時に CC Switch が実行する接続チェックによるものです。CC Switch は、設定されたリクエスト URL に対してモデルリストエンドポイント(/v1/models など)をプローブします。Model Studio の Anthropic 互換エンドポイント(末尾が /apps/anthropic)は、メッセージエンドポイント /v1/messages のみを提供し、モデルリストエンドポイントは提供しないため、プローブが 404 を返し、CC Switch が "No available model list endpoint found" と報告します。
このメッセージは Claude Code の通常の使用には影響せず、無視できます。 Claude Code は /v1/messages を介して会話を送信し、使用されるモデルはモデルリストエンドポイントからの自動検出に依存せず、CC Switch の Advanced options にあるモデルマッピングによって直接指定されます。リクエスト URL と API キーが正しく設定されていれば、Enable をクリックして新しい Claude Code セッションを開始するだけで、通常どおりチャットできます。
それでもチャットできない場合は、リクエスト URL の末尾が /apps/anthropic であり、余分な /v1 が付いていないこと、および Advanced options のモデルマッピング にご利用のプランでサポートされているモデルを入力したことを確認してください。
CC Switch のモデルマッピングで AccessDenied が返される
モデルマッピングの設定後、Claude Code でのモデル呼び出しが AccessDenied エラー(HTTP 403、code: access_denied)で失敗する場合、Model Studio コンソール > Model Gallery で、そのモデルが Upcoming deprecation と表示されていないか確認してください。今後非推奨予定としてマークされたモデルはリストに表示されたままですが、API 呼び出しは 403 AccessDenied を返します。次の手順に従ってください:
- モデルが非推奨予定としてマークされているか確認する。 Model Studio コンソール > Model Gallery で、使用中のモデルを検索し、そのステータスラベルを確認します。
- 最新の利用可能なモデルに切り替える。 モデルマッピング内のレガシーモデル(
qwen-coder-turbo-0919など)を最新の利用可能なモデル(qwen3.8-maxなど)に置き換えます。 - モデルマッピングを再設定してテストする。 CC Switch の Advanced options でモデルマッピングを更新し、Enable をクリックしてから、新しい Claude Code セッションを開始して確認します。
注記モデルのライフサイクルにご注意ください。Model Studio コンソール > Model Gallery で今後非推奨予定としてマークされたモデルは、いつでも利用できなくなる可能性があります。モデルの利用可能ステータスはそこで確認できます。