Alibaba Cloud Model Studio：Claude Code

安裝

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

跳過登入驗證

編輯或建立 ~/.claude.json（Windows 路徑：C:\Users\<使用者名稱>\.claude.json），將 hasCompletedOnboarding 設為 true，跳過 Anthropic 官方登入驗證。

{
  "hasCompletedOnboarding": true
}

Token Plan 團隊版

將 YOUR_API_KEY 替換為 Token Plan 團隊版專屬 API Key。可用模型參見 Token Plan 團隊版支援的模型。

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://token-plan.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 Key。可用模型參見 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 替換為阿里雲百鍊API Key。可用模型參見Anthropic 相容 API。

ANTHROPIC_BASE_URL 按地區設定，API Key 需與所選地區對應：

• 華北2（北京）：https://dashscope.aliyuncs.com/apps/anthropic

• 新加坡：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic，請將WorkspaceId替換為真實的擷取Workspace 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 Code 預設使用 200K 上下文視窗。如果需要處理大型代碼倉庫或長對話，可以將上下文視窗擴充到 1M（1,000,000 tokens），前提是所用模型支援該上下文長度。有兩種配置方式：

方式一：通過環境變數設定

在 ~/.claude/settings.json 的 env 欄位中添加 CLAUDE_CODE_MAX_CONTEXT_TOKENS：

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

方式二：通過模型名稱尾碼

在模型名稱後添加 [1m] 尾碼，適用於百鍊支援 1M 內容相關的模型：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://dashscope.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 官方環境變數文檔。

安裝

• 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 橙色星形表徵圖，點擊右上方 + 進入添加新供應商，按下表填入配置後點擊添加。

   計費方案	配置資訊
   Token Plan 團隊版	供應商名稱：百鍊-Token Plan API Key：控制台擷取 請求地址：https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
   Coding Plan	供應商名稱：百鍊-Coding Plan API Key：控制台擷取 請求地址：https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
   隨用隨付	供應商名稱：百鍊-隨用隨付 API Key：百鍊API Key 請求地址：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

2. 展開進階選項配置模型映射，將主模型與 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. 回到主介面，點擊該供應商右側啟用按鈕，然後新開一個 Claude Code 會話使配置生效。

接入 Claude Code 案頭版

1. 從 Claude 下載頁安裝 Claude Code 案頭版。

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	百鍊API Key
   Gateway auth scheme	bearer
   Model list	Model ID須為 Anthropic 風格，如 claude-opus-4.7。實際調用模型由 CC Switch 路由決定，對應關係即供應商進階選項中的模型映射。Display name 僅影響下拉顯示。

4. CC Switch 左上方設定 → 路由，開啟路由總開關，監聽地址預設 127.0.0.1:15721，如需修改請同步上一步。

5. 在案頭版模型下拉中選擇已配置的模型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，點擊右上方表徵圖即可使用。

錯誤碼

配置過程中遇到報錯，參考對應套餐的常見問題文檔：

• 隨用隨付：Anthropic API相容 - 錯誤碼

• Coding Plan：Coding Plan 常見問題

• Token Plan 團隊版：Token Plan 團隊版常見問題

啟動 Claude Code 後，介面顯示"Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST"

此錯誤表示 Claude Code 正在嘗試串連 Anthropic 官方服務而非阿里雲百鍊。通常是環境變數未正確配置或未生效。按以下步驟排查：

1. 檢查配置。啟動 Claude Code 後執行 /status 命令，確認 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 是否正確指向百鍊地址。輸出為空白或指向非百鍊地址時，檢查 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 添加供應商時提示"未找到可用的模型列表端點，請檢查 Base URL 或確認供應商是否開放連接埠"

該提示來自 CC Switch 儲存供應商時的連通性檢查——它會向配置的請求地址探測模型列表端點（如 /v1/models）。百鍊的 Anthropic 相容接入端點（以 /apps/anthropic 結尾）僅提供對話端點 /v1/messages，不提供模型列表端點，該探測因此返回 404，CC Switch 據此提示"未找到可用的模型列表端點"。

該提示不影響 Claude Code 正常使用，可忽略。Claude Code 通過 /v1/messages 發起對話，所用模型由 CC Switch 進階選項中的模型映射直接指定，不依賴模型列表端點的自動探索。請求地址與 API Key 配置正確時，直接點擊啟用並新開一個 Claude Code 會話即可正常對話。

若確實無法對話，請確認：請求地址以 /apps/anthropic 結尾、勿額外添加 /v1，並已在進階選項的模型映射中填入對應套餐支援的模型。