幫助中心
首頁 Alibaba Cloud Model Studio 操作指南（模型） 接入用戶端/開發工具 Claude Code

Claude Code

更新時間：
Copy as MD
產品

Claude Code 是 Anthropic 推出的命令列 AI 編程助手。通過阿里雲百鍊，可以使用隨用隨付、Coding Plan 或 Token Plan 團隊版接入 Claude Code。

安裝 Claude Code

安裝

macOS

  1. 安裝或更新 Node.js（v18.0 或更高版本）。

  2. 在終端中執行以下命令安裝 Claude Code。

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

  3. 驗證安裝結果。輸出版本號碼即表示安裝成功。

    claude --version

Windows

在 Windows 上使用 Claude Code，需先安裝 WSL 或 Git for Windows，然後在 WSL 或 Git Bash 中執行以下命令。

npm install -g @anthropic-ai/claude-code
詳情參見 Claude Code 官方文檔的 Windows 安裝教程 。

跳過登入驗證

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

{
  "hasCompletedOnboarding": true
}

配置接入憑證

建立 ~/.claude/settings.json（Windows 路徑：C:\Users\<使用者名稱>\.claude\settings.json），寫入對應套餐的配置。

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 "你好"。若模型正常返迴響應，配置成功。如需進一步確認，在 Claude Code 中執行 /status，檢查 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 是否正確指向百鍊地址。

使用 CC Switch

CC Switch 是社區開源的案頭 GUI，支援在多個API Key 或計費套餐之間一鍵切換，無需手動修改 settings.json。

安裝

  • 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即可使用。

Claude Code IDE 外掛程式

完成上述 CLI 配置後，在 IDE 中安裝 Claude Code 外掛程式，可直接複用 settings.json 中的配置。

VS Code

  1. 在擴充市場搜尋 Claude Code for VS Code 並安裝。

  2. 重啟 VS Code，點擊右上方表徵圖進入 Claude Code。

  3. 在對話方塊中輸入 /，選擇 General config，在 Selected Model 中設定模型。

JetBrains

  1. 在擴充市場搜尋 Claude Code 並安裝。

  2. 重啟 IDE，點擊右上方表徵圖即可使用。

常見問題

錯誤碼

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

啟動 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，配置才會生效。

上一篇：Hermes Agent下一篇：OpenCode