Alibaba Cloud Model Studio:Claude Code

インストール

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

ログイン認証のスキップ

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

{
  "hasCompletedOnboarding": true
}

Token Plan (Team Edition)

YOUR_API_KEY を Token Plan (Team Edition) 専用のAPI キーに置き換えてください。利用可能なモデルについては、Token Plan (Team Edition) でサポートされているモデルをご参照ください。

{
    "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"
    }
}

Coding Plan

YOUR_API_KEY を Coding Plan 専用のAPI キーに置き換えます。 利用可能なモデルについては、Coding Plan の対応モデルをご参照ください。

{
    "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 に置き換えます。

{
    "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 を実行するか、Releases から .dmg をダウンロードします。

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

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

プロバイダーの追加

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

   料金プラン	設定
   Token Plan (Team Edition)	プロバイダー名： Bailian-Token Plan API キー： コンソールから取得 エンドポイント： https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
   Coding Plan	プロバイダー名： 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 のデフォルトモデルを、ご利用のプランでサポートされているモデルに設定します。例えば、Coding Plan 以外のプランでは、次のようなマッピングが考えられます。

   • メインモデル： 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	CC Switch で現在有効になっているプロバイダーの API キー。
   Gateway auth scheme	bearer
   Model list	モデル ID は claude-3-opus のように Anthropic 形式である必要があります。実際に呼び出されるモデルは、[詳細オプション] のモデルマッピングで設定した内容に基づき、CC Switch のルーティングによって決定されます。表示名はドロップダウンのラベルにのみ影響します。

4. CC Switch で、左上の設定アイコンをクリックし、[Router] に進んで [Router Master 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. ダイアログボックスで / を入力し、[General config] を選択して、[Selected Model] でモデルを設定します。

JetBrains

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

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

エラーコード

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

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

• Coding Plan： Coding Plan FAQ

• Token Plan (Team Edition)： Token Plan (Team Edition) 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 を実行すると、変更が反映されます。