Alibaba Cloud Model Studio:Claude Code

Claude Code は、Anthropic 社が開発したコマンドライン AI コーディングアシスタントです。従量課金、Coding Plan、Token Plan Personal Edition、または Token Plan Team Edition を使用して、Alibaba Cloud Model Studio に接続します。

Claude Code のインストール

インストール

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

claude --version

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

ログイン検証のスキップ

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

{
  "hasCompletedOnboarding": true
}

アクセス認証情報の設定

~/.claude/settings.json (Windows パス: C:\Users\<username>\.claude\settings.json) を作成し、課金プランの設定を追加します。

Token Plan Personal Edition

YOUR_API_KEY を、Token Plan Personal Edition 専用の API キーに置き換えます。利用可能なモデルについては、「Token Plan Personal 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.8-max",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-max",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.8-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
    }
}

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.8-max",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-max",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.8-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
    }
}

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://{WorkspaceId}.cn-beijing.maas.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.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"
    }
}

設定を保存したら、新しいターミナルを開いて claude "hello" を実行します。モデルから応答が返されると、セットアップが機能していることが確認できます。さらに確認するには、Claude Code で /status を実行し、ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN が Model Studio アドレスを指していることを確認します。

コンテキストウィンドウサイズの設定

Claude Code は、デフォルトで 200 K のコンテキストウィンドウを使用します。大規模なコードベースや長い会話を処理するために、モデルがそのコンテキスト長をサポートしていれば、コンテキストウィンドウを 1 M (1,000,000 トークン) に拡張できます。設定方法は 2 つあります：

~/.claude/settings.jsonの env フィールドに CLAUDE_CODE_MAX_CONTEXT_TOKENSを追加します：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
    }
}

モデル名に[1m]を付加します。これは、1M コンテキストウィンドウをサポートする Model Studio モデルで機能します：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.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 の公式環境変数ドキュメントをご参照ください。

権限モード

Claude Code には 6 つの権限モードがあり、ツールが操作を実行する前に確認プロンプトを表示するかどうかを制御します。次の表では、各モードの動作について説明します。

コマンドラインフラグ

--permission-mode を使用して、セッションのデフォルト権限モードを設定します:

claude --permission-mode plan
claude --permission-mode acceptEdits

インタラクティブコマンド

セッションで /permissions を入力すると、ツールの事前承認および事前拒否ルールを動的に管理できます。bash、edit、および MCP ツールの自動承認ルールを設定できます。

settings.json の設定

アクセス認証情報が格納されている設定ファイル ~/.claude/settings.json (Windows パス: C:\Users\<username>\.claude\settings.json) で、permissions フィールドを設定します:

{
    "permissions": {
        "allow": ["Bash(git:*)", "Read", "Edit"],
        "deny": ["Bash(rm:*)"],
        "defaultMode": "default"
    }
}

allow フィールドは一致するツールコールを自動的に承認し、deny フィールドは一致するツールコールを自動的に拒否します。どちらのフィールドもワイルドカードをサポートしています。たとえば、Bash(npm:*) は npm で始まるすべてのコマンドに一致します。defaultMode フィールドはセッションのデフォルトの権限モードを設定し、前の表に記載されているいずれかのモードを受け入れます。

CC Switch の使用

CC Switch は、複数の API キーや課金プランを管理するための、コミュニティによるオープンソースのデスクトップ GUI です。settings.json を手動で編集することなく、ワンクリックでプロバイダーを切り替えることができます。

CC Switch のインストール

• macOS: brew tap farion1231/ccswitch && brew install --cask cc-switch を実行するか、リリースから .dmg をダウンロードします。
• Windows：リリースから .msi インストーラーまたはポータブル .zip をダウンロードします。
• Linux: Arch では paru -S cc-switch-bin を実行し、その他のディストリビューションでは リリースから .deb / .rpm / .AppImage をダウンロードします。

プロバイダーの追加

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

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

   • メインモデル: qwen3.7-max (コーディングプランはサポート対象外)
   • 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 の接続

Claude Code Desktop (Claude Desktop) と Claude Code CLI は 2 つの別々のエントリポイントであり、CC Switch ではそれぞれ [Claude Code] パネルと [Claude Desktop] パネルとして表示されます。デスクトップアプリは、CC Switch のローカルゲートウェイを介して Model Studio に接続します。CC Switch はゲートウェイアドレスと認証トークンの両方をデスクトップ設定に自動的に書き込むため、デスクトップアプリに Model Studio API キーを入力しないでください。Model Studio API キーは CC Switch のプロバイダー設定にのみ入力され、ローカルルーターがリクエストを転送する際に自動的に挿入されます。

1. Claude のダウンロードページから Claude Code Desktop をインストールします。
2. CC Switch で、左側のアプリスイッチャーから [Claude Desktop] パネルに切り替えます。エントリが表示されない場合は、 [Settings] > [General] に移動し、アプリの表示設定で Claude Desktop が非表示になっていないことを確認します。
3. Model Studio プロバイダーを追加します。[Claude Code] パネルで Model Studio プロバイダーをすでに設定している場合は、[Import existing providers from Claude Code] をクリックして再利用します。それ以外の場合は、右上の [+] をクリックして追加します。Model Studio のモデル ID (qwen3.7-max など) は、Claude Desktop が認識する 3 つのロール ID (claude-sonnet-* / claude-opus-* / claude-haiku-*) ではないため、[Needs model mapping] をオンにし、Sonnet、Opus、Haiku のロールを、リクエストする実際の Model Studio モデルにマッピングします (例: Sonnet > qwen3.7-max)。
4. ローカルルーティングを有効にするには、[設定] > [ルーティング] > [ローカルルーティング] に移動して [メインページにルーティングの切り替えを表示] をオンにします。次に、Claude Desktop パネルに戻り、[Claude Desktop ローカルルーティング] スイッチをオンにします。デフォルトのリッスンアドレスは 127.0.0.1:15721 です。
5. プロバイダーカードの [Enable] をクリックします。CC Switch は、サードパーティ推論の設定を Claude Code Desktop に自動的に書き込みます。
6. CC Switch を実行したまま、Claude Code Desktop を完全に終了して再起動し、変更を有効にします。モデルメニューから設定したモデルを選択して使用を開始します。

Claude Code IDE プラグイン

上記の CLI 設定が完了したら、IDE に Claude Code プラグインをインストールします。このプラグインは、settings.json 内の設定を直接再利用します。

VS Code

1. 拡張機能マーケットプレイスで Claude Code for VS Code を検索し、インストールします。
2. VS Code を再起動し、右上隅のアイコンをクリックして Claude Code を開きます。
3. ダイアログボックスに / を入力し、[一般設定] を選択して、[選択モデル] でモデルを設定します。

JetBrains

1. 拡張機能マーケットプレイスで Claude Code を検索してインストールしてください。
2. IDE を再起動し、右上隅のアイコンをクリックして使用を開始します。

よくある質問

エラーコード

設定中にエラーが発生した場合は、ご自身の料金プランに対応するよくある質問のドキュメントをご参照ください：

• 従量課金： Anthropic API 互換 - エラーコード
• Coding Plan： Coding Plan よくある質問
• Token Plan Personal Edition： Token Plan よくある質問
• Token Plan Team Edition： Token Plan Team Edition よくある質問

リクエストが 401 invalid_api_key を返す

API キータイプが ANTHROPIC_BASE_URL と一致しません。Model Studio では 3 つのアクセス方法が提供されており、アクセス方法ごとに異なるベース URL と専用の API キーが使用されます。

トラブルシューティングの手順：

1. リクエスト URL を確認します。~/.claude/settings.json 内の ANTHROPIC_BASE_URL を確認します。
2. API キーのタイプの確認： 上記の表を使用して、API キーのタイプがベース URL と一致していることを確認します。
3. 設定を修正します。 Model Studio の従量課金 API キーを使用する場合、 ANTHROPIC_BASE_URL を https://dashscope.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 の公式サービスに接続しています。これは通常、環境変数が欠落しているか、有効になっていないことを意味します。次の手順に従ってください：

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 で終わる) は、メッセージエンドポイント /v1/messages のみを提供し、モデルリストエンドポイントは提供しません。そのため、プローブは 404 を返し、CC Switch は「利用可能なモデルリストエンドポイントが見つかりません」と報告します。

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

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

CC Switch のモデルマッピングが AccessDenied を返す

モデルマッピングを設定した後に Claude Code でモデルの呼び出しが AccessDenied エラー (HTTP 403、コード: access_denied) で失敗する場合は、Model Studio コンソール > [モデルギャラリー] でモデルに [近日廃止予定] のマークが付いているかどうかを確認してください。 近日廃止予定のマークが付いたモデルは引き続きリストに表示されますが、API コールは 403 AccessDenied を返します。 以下の手順に従ってください。

1. モデルが非推奨とマークされているか確認します： Model Studio コンソールの [Model Gallery] で、使用しているモデルを検索し、そのステータスラベルを確認します。
2. 利用可能な最新モデルに切り替えます。モデルマッピング内の旧モデル (qwen-coder-turbo-0919 など) を、利用可能な最新モデル (qwen3-coder-plus など) に置き換えます。
3. モデルマッピングを再設定してテストします： CC Switch の [Advanced options] でモデルマッピングを更新し、 [Enable] をクリックして新しい Claude Code セッションを開始し、検証します。