Alibaba Cloud Model Studio:Claude Code

インストール

npm install -g @anthropic-ai/claude-code

ログイン認証のスキップ

Anthropic の公式ログイン認証をスキップするには、~/.claude.json (Windows のパス: C:\Users\<username>\.claude.json) を編集または作成し、hasCompletedOnboarding を true に設定します。

{
  "hasCompletedOnboarding": true
}

トークンプラン (チーム版)

YOUR_API_KEY を、トークンプラン (チーム版) 専用の API キーに置き換えます。利用可能なモデルについては、トークンプラン (チーム版) のサポート対象モデルをご参照ください。

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus"
    }
}

コーディングプラン

YOUR_API_KEY を、コーディングプラン専用の 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"
    }
}

従量課金

YOUR_API_KEY を、Alibaba Cloud Model Studio の API キーに置き換えます。利用可能なモデルについては、「Anthropic 互換 API」をご参照ください。

リージョンに応じて ANTHROPIC_BASE_URL を設定します。API キーは、選択したリージョンと一致させる必要があります：

• 中国華北 2 (北京)：https://dashscope.aliyuncs.com/apps/anthropic

• シンガポール: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic。 WorkspaceId を、ワークスペース ID の取得 を参照して得られる実際のワークスペース ID に置き換えてください。

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus"
    }
}

CC Switch のインストール

• macOS: brew tap farion1231/ccswitch && brew install --cask cc-switch を実行するか、リリースから .dmg をダウンロードします。

• Windows：リリースから .msi インストーラーまたはポータブル .zip をダウンロードします。

• Linux: Arch では、paru -S cc-switch-bin を実行します。その他のディストリビューションでは、Releases から .deb、.rpm、または .AppImage をダウンロードします。

プロバイダーの追加

1. CC Switch のメイン画面で、上部のアイコンバーにある Claude Code (オレンジ色の星のアイコン) を選択し、右上の [+] をクリックして [Add New Provider] を開きます。以下の表に従ってフィールドに入力し、[Add] をクリックします。

   料金プラン	設定
   トークンプラン (チーム版)	プロバイダー名：Bailian-Token Plan API キー：コンソールから取得 エンドポイント: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
   コーディングプラン	プロバイダー名：Bailian-Coding Plan API キー：コンソールから取得 エンドポイント: https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
   従量課金	プロバイダー名：Bailian-Pay-as-you-go API キー：Model Studio の API キー エンドポイント: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

2. [Advanced Options] を展開して、モデルマッピングを設定します。メインモデルと、Haiku、Sonnet、Opus のデフォルトモデルを、ご使用のプランでサポートされているモデルに設定します。コーディングプランのマッピング例は次のとおりです。

   • メインモデル： qwen3.7-max (Coding Plan ではサポートされていません)

   • Haiku デフォルトモデル: qwen3.6-flash (Coding Plan ではサポートされていません)

   • Sonnet デフォルトモデル: qwen3.7-max (Coding Plan ではサポートされていません)

   • Opus のデフォルトモデル: qwen3.7-max (Coding Plan ではサポートされていません)

3. メイン画面に戻り、プロバイダーの横にある [Enable] をクリックしてから、新しい Claude Code セッションを開始すると、設定が有効になります。

Claude Code Desktop の接続

1. Claude のダウンロードページから Claude Code Desktop をインストールします。

2. 上部メニューで、[Help] > [Troubleshooting] > [Enable Developer Mode] を選択します。再起動後、上部に [Developer] メニューが表示されます。

3. [Developer] > [Configure Third-Party Inference] を選択し、[Connection] を [Gateway] に設定し、以下の表に従ってフィールドに入力してから、[Apply locally] をクリックします：

   フィールド	値
   Gateway base URL	CC Switch ルーターのリッスンアドレス。デフォルトは http://127.0.0.1:15721 です。変更した場合は、次のステップと一致させてください。
   Gateway API key	Model Studio の API キー
   Gateway auth scheme	bearer
   Model list	モデル ID は、claude-opus-4.7 のような Anthropic スタイルである必要があります。実際に呼び出されるモデルは、詳細オプションのモデルマッピングに対応する CC Switch ルーティングによって決定されます。表示名は、ドロップダウンラベルにのみ影響します。

4. CC Switch で、左上の設定アイコンをクリックし、[ルーター] に移動して、[ルーターマスタースイッチ] を有効にします。デフォルトのリッスンアドレスは 127.0.0.1:15721 です。変更した場合は、前の手順と一致させてください。

5. Claude Code Desktop のモデルドロップダウンから設定したモデル ID を選択して使用を開始します。

VS Code

1. 拡張機能マーケットプレイスで Claude Code for VS Code を検索してインストールします。

2. VS Code を再起動し、右上のアイコンをクリックして Claude Code を開きます。

3. ダイアログボックスに/を入力し、[一般設定]を選択して、[選択したモデル]でモデルを設定します。

JetBrains

1. 拡張機能マーケットプレイスで Claude Code を検索し、インストールします。

2. IDE を再起動し、右上のアイコンをクリックして使用を開始します。

エラーコード

設定中にエラーが発生した場合は、ご使用の料金プランの FAQ ドキュメントをご参照ください：

• 従量課金：「Anthropic API 互換 - エラーコード」

• コーディングプラン：「コーディングプラン FAQ」

• トークンプラン (チーム版)：「トークンプラン (チーム版) FAQ」

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 の公式サービスに接続しようとしています。これは通常、環境変数が欠落しているか、設定が有効になっていないことが原因です。次の手順に従ってください：

1. 設定を確認します。 Claude Code の起動後に /status コマンドを実行し、ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN が Model Studio のアドレスを指していることを確認します。出力が空であるか、Model Studio 以外のアドレスが表示される場合は、settings.json の設定を確認してください。

2. hasCompletedOnboarding を確認します。 ~/.claude.json で hasCompletedOnboarding が true に設定されていることを確認します。この設定がない場合、Claude Code は起動時に、ログイン検証のために公式の Anthropic サービスへの接続を試みます。

3. 新しいターミナルを開きます。設定ファイルを編集した後、変更を反映させるために、新しいターミナルウィンドウを開いて claude を実行します。

4. Claude Code の更新。上記すべての手順を実行しても問題が解決しない場合、Claude Code のバージョンが古い可能性があります。npm install -g @anthropic-ai/claude-code@latest を実行して最新バージョンに更新し、再度お試しください。

プロバイダー追加時に CC Switch で「No available model list endpoint found. Check the Base URL or confirm that the provider has opened the port」というエラーが表示される

このメッセージは、プロバイダーを保存する際に CC Switch が実行する接続性チェックに起因します。このチェックでは、設定されたリクエスト URL に対してモデルリストエンドポイント ( /v1/models など) をプローブします。Model Studio の Anthropic 互換エンドポイント (/apps/anthropic で終わる) は、messages エンドポイント /v1/messages のみを提供し、モデルリストエンドポイントは提供しません。そのため、プローブは 404 を返し、CC Switch は「No available model list endpoint found」と報告します。

このメッセージは Claude Code の通常の使用に影響はなく、無視できます。 Claude Code は /v1/messages 経由で会話を送信し、使用するモデルはモデルリストエンドポイントからの自動検出に依存せず、CC Switch の [詳細オプション] にあるモデルマッピングによって直接指定されるためです。リクエスト URL と API キーが正しく設定されていれば、[有効化] をクリックして新しい Claude Code セッションを開始するだけで、通常どおりチャットできます。

それでもチャットできない場合は、リクエスト URL の末尾が、余分な /v1 なしで /apps/anthropic になっていること、およびご利用のプランでサポートされているモデルが 詳細オプションのモデルマッピングに入力されていることを確認してください。