すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud Model Studio:Claude Code

最終更新日:Nov 18, 2026

Alibaba Cloud Model Studio のモデルを Claude Code で使用します。

モデルを追加

クライアントを選択して設定を完了します。

CLI

  1. 1

    Configure the model

    Token Plan

    YOUR_API_KEY を Token Plan API キーに置き換えます:

    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. 2

    Verify

    次のコマンドを実行して確認します。

    claude -p "Hello"
    

CC Switch

  1. 1

    Install CC Switch

    CC Switch をダウンロードしてインストールします。

  2. 2

    Add a Bailian provider

    CC Switch で Claude Code アイコンを選択し、+ をクリックして、対応するタブのフィールドに入力します。

    Token Plan

    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. 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. 4

    Switch to the Claude Desktop panel

    CC Switch で、左側の Claude Desktop パネルに切り替えます。表示されない場合は、Settings > General > App visibility で有効にします。

  5. 5

    Import the provider

    Claude Code ですでに設定したプロバイダーをインポートするか、+ をクリックして追加します。Bailian モデル ID に対して Needs model mapping をオンにし、Sonnet、Opus、Haiku を実際のモデルにマッピングします。

  6. 6

    Enable local routing

    Settings > Routing > Local Routing に移動してメインページのスイッチをオンにし、Claude Desktop パネルでローカルルーティングをオンにします。デフォルトアドレスは 127.0.0.1:15721 です。

  7. 7

    Enable and restart the desktop app

    プロバイダーカードの Enable をクリックし、デスクトップアプリで API キーを手動で入力しないでください。CC Switch を実行したまま、デスクトップアプリを 完全に終了して再起動 します。

IDE plugin

  1. 1

    Install the plugin

    IDE の拡張機能マーケットプレイスから Claude Code プラグインをインストールします。

  2. 2

    Configure the model

    設定ファイルによる設定の説明に従って settings.json に設定を追加するか、先に CLI の設定を完了します。

  3. 3

    設定ファイルを開く/新規作成

    IDE を再起動し、Claude Code アイコンをクリックして、ダイアログに / と入力し、General config を選択して、Selected Model でモデルを設定します。

Desktop

Claude Code Desktop は、CC Switch ローカルゲートウェイを介して Model Studio に接続します。

  1. 1

    Install Claude Code Desktop

    Claude ダウンロードページからダウンロードしてインストールします。

  2. 2

    Configure CC Switch

    CC Switch タブの手順に従って、プロバイダーとルーティングを設定します。

  3. 3

    Restart the desktop app

    CC Switch を実行したまま、Claude Code Desktop を完全に終了して再起動します。

設定ファイルによる設定

上記の方法に加えて、設定ファイルでも接続できます。

  1. 1

    設定ファイルを開く

    • macOS / Linux: ~/.claude/settings.json
    • Windows: C:\Users\<username>\.claude\settings.json
  2. 2

    設定を追加する

    Token Plan

    YOUR_API_KEY を Token Plan APIキーに置き換えます:

    {
        "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. 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も使用可能)、セッションを再起動してください。

方法1:コマンドラインフラグ

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

claude --permission-mode plan
claude --permission-mode acceptEdits
方法2:インタラクティブコマンド

セッション内で/permissionsを入力すると、bash、edit、MCPツールの事前承認ルールと事前拒否ルールを管理できます。

方法3:settings.jsonの設定

~/.claude/settings.jsonのpermissionsフィールドを設定します:

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

Bailian CLI の統合

  1. 1

    Bailian CLI をインストールする

    Please install the Alibaba Cloud Bailian CLI globally: npm install -g bailian-cli
    
  2. 2

    API Key の設定

    Bailianコンソールで API Key を取得し、Claude Code に次のように伝えます:

    My API Key is: sk-xxxxxxxxxxxxx
    
  3. 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 ドキュメントを参照してください:

よくある質問

従量課金で節約プランを使用するには?

従量課金の接続方法は変わりません。Model Studio の汎用 API Key と Base URL を使用します。節約プランを購入すると自動的に有効になり、対象の利用料金が自動的に控除されます。詳細は節約プランをご参照ください。

公式 Anthropic のログイン検証をスキップするにはどうすればよいですか?

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

{
  "hasCompletedOnboarding": true
}

リクエストが 401 invalid_api_key を返す

API キーの種類が ANTHROPIC_BASE_URL と一致していません。Model Studio は 3 つのアクセス方法を提供しており、各アクセス方法では異なるベース URL と専用の API キーを使用します。

アクセス方法

ベース URL

API キー

Token Plan

https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

Token Plan API キー

Pay-as-you-go

https://dashscope-intl.aliyuncs.com/apps/anthropic

Model Studio API キー(sk- で始まる)

Coding Plan

https://coding-intl.dashscope.aliyuncs.com/apps/anthropic

Coding Plan 専用 API キー

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

  1. リクエスト URL を確認する。 ~/.claude/settings.json 内の ANTHROPIC_BASE_URL を確認します。
  2. API キーの種類を確認する。 上の表を使用して、API キーの種類がベース URL と一致していることを確認します。
  3. 設定を修正する。 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 サービスに接続しようとしています。これは通常、環境変数が欠落しているか、反映されていないことを意味します。次の手順に従ってください:

  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 を実行して最新バージョンに更新し、再度お試しください。

レガシーインターフェース使用時にモデル切り替えが反映されない

レガシー互換インターフェース 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 を返します。次の手順に従ってください:

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

注記モデルのライフサイクルにご注意ください。Model Studio コンソール > Model Gallery で今後非推奨予定としてマークされたモデルは、いつでも利用できなくなる可能性があります。モデルの利用可能ステータスはそこで確認できます。