Skip to main content

Claude Code

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

モデルを追加

クライアントを選択して設定を完了します。
  • CLI
  • CC Switch
  • IDE plugin
  • Desktop
  1. 1

    Configure the model

    • Token Plan
    • Pay-as-you-go
    • Coding 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 を設定します。
    これらの環境変数は現在のターミナルでのみ有効です。永続的な設定には、設定ファイルによる設定を使用してください。
  2. 2

    Verify

    次のコマンドを実行して確認します。
    claude -p "Hello"
    

設定ファイルによる設定

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

    設定ファイルを開く

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

    設定を追加する

    • Token Plan
    • Pay-as-you-go
    • Coding 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"
        }
    }
    
  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は6つの権限モードを提供します:
  • default: すべての操作の前に確認を求めます。
  • acceptEdits: ファイル編集を自動的に承認します。その他の操作は引き続き確認を求めます。
  • plan: 読み取り専用のプランニングモードです。変更は実行されません。
  • dontAsk: 確認を求めません。確認が必要になる操作は直接拒否されます。
  • bypassPermissions: すべての権限チェックをバイパスします。
  • delegate: 委任モード。
方法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
}
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 が 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 が実行する接続チェックによるものです。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 のモデルマッピング にご利用のプランでサポートされているモデルを入力したことを確認してください。
モデルマッピングの設定後、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 で今後非推奨予定としてマークされたモデルは、いつでも利用できなくなる可能性があります。モデルの利用可能ステータスはそこで確認できます。