Skip to main content
接入用戶端/開發工具

Claude Code

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

安裝 Claude Code

安裝

  • macOS
  • Windows
  1. 安裝或更新 Node.js（v18.0 或更高版本）。
  2. 在終端中執行以下命令安裝 Claude Code。
npm install -g @anthropic-ai/claude-code
  1. 驗證安裝結果。輸出版本號碼即表示安裝成功。
claude --version

跳過登入驗證

編輯或建立 ~/.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.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 團隊版

將 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.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 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 需與所選地區對應，並將WorkspaceId替換為真實的 Workspace ID：
  • 華北2（北京）：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic
  • 新加坡：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
{
    "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 是否正確指向百鍊地址。

配置上下文視窗大小

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://{WorkspaceId}.cn-beijing.maas.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://{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 種許可權模式，控制工具執行操作時的確認行為：

模式

行為

default

每次操作詢問使用者確認。

acceptEdits

自動批准檔案編輯，其他動作仍詢問。

plan

唯讀規劃模式，不執行修改。

dontAsk

不詢問，需要詢問的操作直接拒絕。

bypassPermissions

繞過所有許可權檢查。

delegate

委託模式。

命令列參數

使用 --permission-mode 指定本次會話的預設許可權模式： 
claude --permission-mode plan
claude --permission-mode acceptEdits

互動命令

在會話中輸入 /permissions，可動態管理工具的預批准（pre-approve）和預拒絕（pre-deny）規則，支援配置 bash、edit 和 MCP 工具的規則。

settings.json 配置

在 ~/.claude/settings.json（Windows 路徑：C:\Users\<使用者名稱>\.claude\settings.json）中配置 permissions 欄位： 
{
    "permissions": {
        "allow": ["Bash(git:*)", "Read", "Edit"],
        "deny": ["Bash(rm:*)"],
        "defaultMode": "default"
    }
}
allow 自動批准匹配的工具調用，deny 自動拒絕匹配的工具調用。規則支援萬用字元，例如 Bash(npm:*) 匹配所有以 npm 開頭的命令。defaultMode 設定會話的預設許可權模式，取值為上表 6 種模式之一。

使用 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

    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 不支援，可填 qwen3.7-plus）
    • Haiku 預設模型：qwen3.6-flash（Coding Plan 不支援，可填 qwen3.7-plus）
    • Sonnet 預設模型：qwen3.7-max（Coding Plan 不支援，可填 qwen3.7-plus）
    • Opus 預設模型：qwen3.7-max（Coding Plan 不支援，可填 qwen3.7-plus）
  3. 回到主介面，點擊該供應商右側啟用按鈕，然後新開一個 Claude Code 會話使配置生效。

接入 Claude Code 案頭版

Claude Code 案頭版（Claude Desktop）與 Claude Code CLI 是兩個獨立入口，在 CC Switch 中分別對應 Claude Code 與 Claude Desktop 面板。案頭版通過 CC Switch 本地網關訪問百鍊：網關地址與鑒權令牌均由 CC Switch 自動寫入案頭版配置，無需在案頭版中手動填寫百鍊 API Key——百鍊 API Key 只在 CC Switch 供應商配置中填寫，由本地路由轉寄時自動注入。
請勿在案頭版的第三方推理配置中手動填寫百鍊 API Key。案頭版對 CC Switch 本地網關（地址 http://127.0.0.1:15721/claude-desktop）的鑒權令牌由 CC Switch 自動產生並寫入，手動填入百鍊 API Key 會因令牌不匹配導致鑒權失敗。案頭版第三方配置寫入目前僅支援 macOS、Windows。
  1. 從 Claude 下載頁安裝 Claude Code 案頭版。
  2. 在 CC Switch 左側App 切換切換到 Claude Desktop 面板。若未顯示該入口，前往設定 → 通用 → 應用可見度確認 Claude Desktop 未被隱藏。
  3. 添加百鍊供應商：若已在 Claude Code 面板配置過百鍊供應商，可點擊將 Claude Code 中已有的供應商匯入一鍵複用；也可點擊右上方 + 新增。由於百鍊模型 ID（如 qwen3.7-max）不是 Claude Desktop 識別的 claude-sonnet-* / claude-opus-* / claude-haiku-* 三檔角色 ID，需開啟需要模型映射，為 Sonnet、Opus、Haiku 三檔分別填寫實際請求的百鍊模型（如 Sonnet → qwen3.7-max）。
  4. 開啟本地路由：前往設定 → 路由 → 本地路由，開啟在首頁面顯示本地路由開關；回到 Claude Desktop 面板，開啟 Claude Desktop 本地路由開關，監聽地址預設 127.0.0.1:15721。
  5. 在供應商卡片點擊啟用，CC Switch 會自動將第三方推理配置寫入 Claude Code 案頭版。
  6. 保持 CC Switch 運行，完全退出並重啟 Claude Code 案頭版後生效，在模型菜單中選擇已配置的模型即可使用。

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，點擊右上方表徵圖即可使用。

常見問題

錯誤碼

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

調用時返回 401 invalid_api_key

此錯誤表示 API Key 類型與 ANTHROPIC_BASE_URL 不匹配。百鍊提供三種接入方式，每種方式使用不同的 base_url 和專屬 API Key，兩者必須配套使用：

接入方式

base_url

API Key

隨用隨付

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

百鍊 API Key（sk- 開頭）

Coding Plan

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

Coding Plan 專屬 API Key

Token Plan 團隊版

https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic

Token Plan 團隊版專屬 API Key

排查步驟如下：
  1. 檢查請求地址。查看 ~/.claude/settings.json 中 ANTHROPIC_BASE_URL 的取值。
  2. 確認 API Key 類型。對照上表，確認所用 API Key 的類型與 base_url 匹配。
  3. 修正配置。使用百鍊隨用隨付 API Key 時，將 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 正在嘗試串連 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，並已在進階選項的模型映射中填入對應套餐支援的模型。

CC Switch 中模型映射後無法調用

模型映射配置後在 Claude Code 中無法調用、返回 AccessDenied（HTTP 403，錯誤碼 access_denied）錯誤時，檢查該模型是否在百鍊控制台的模型廣場中被標記為“即將下線”。標記為“即將下線”的模型仍會顯示在列表中，但 API 呼叫會返回 403 AccessDenied。排查步驟如下：
  1. 檢查模型是否標記“即將下線”。在百鍊控制台的模型廣場搜尋所用模型，查看其狀態標籤。
  2. 更換為最新可用模型。將模型映射中的舊版模型（如 qwen-coder-turbo-0919）替換為最新版本的可用模型（如 qwen3-coder-plus）。
  3. 重新設定模型映射並測試。在 CC Switch 的進階選項中更新模型映射，點擊啟用並新開一個 Claude Code 會話驗證。
百鍊控制台的模型廣場中標記“即將下線”的模型可能隨時不可用，請關注模型生命週期，並在模型廣場查看模型的可用狀態。
開始使用
Token Plan
模型體驗
  • 音樂產生
接入用戶端/開發工具
模型推理
模型調優
模型部署
模型評測
用量統計與效能監控
資產中心
安全合規
實踐教程
服務支援
產品動態