全部產品
Search
文件中心

Alibaba Cloud Model Studio:Claude Code

更新時間:May 01, 2026

在 Claude Code 中配置與使用阿里雲百鍊 Token Plan 團隊版。

安裝與使用

手動安裝

macOS/Linux

  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安裝教程

Qwen Code 引導安裝

Claude Code 安裝依賴於 Node.js 環境,手動安裝可能會遇到環境配置問題。可以使用 Qwen Code 來完成安裝和驗證。

  1. 安裝並配置 Qwen Code

  2. 在終端輸入以下命令啟動 Qwen Code。

    qwen
  3. 在 Qwen Code 對話方塊中輸入以下指令。

    macOS/Linux

    請幫我安裝 Claude Code。1. 前置條件:需要先安裝 Node.js(v18.0 或更高版本)。2. 若已安裝 Node.js,執行命令:npm install -g @anthropic-ai/claude-code,安裝完成後執行 claude --version 驗證安裝是否成功。

    Windows

    請幫我安裝 Claude Code。1. 前置條件:需要先安裝 Node.js(v18.0 或更高版本)和 Git for Windows,如果沒有安裝請幫我安裝。2. 若已滿足前置條件,執行命令:npm install -g @anthropic-ai/claude-code,安裝完成後執行 claude --version 驗證安裝是否成功。
  4. 授權允許Qwen Code 執行命令,直至完成安裝。

  5. 輸入/exit退出Qwen Code。

    /exit

配置 Token Plan 團隊版

在 Claude Code 中接入百鍊 Token Plan 團隊版,需要配置以下資訊:

  1. ANTHROPIC_BASE_URL:設定為 https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

  2. ANTHROPIC_AUTH_TOKEN:設定為 Token Plan 團隊版專屬 API Key

  3. ANTHROPIC_MODEL 等模型環境變數:設定為 Token Plan 團隊版支援的模型。Claude Code 內部使用多個模型槽位處理不同任務,需要將全部槽位配置為 Token Plan 團隊版支援的模型,否則未配置的槽位會嘗試調用 Anthropic 官方模型導致請求失敗。

    說明

    DeepSeek V3.2 不支援 Anthropic 協議介面,無法通過 Claude Code 使用,可通過 OpenCode 等支援 OpenAI 相容協議的工具接入。映像產生模型需通過斜杠命令接入,參見接入多模態產生模型

macOS/Linux

  1. 建立並開啟設定檔~/.claude/settings.json

    ~ 代表當前系統賬戶的主目錄。如果 .claude 目錄不存在,需要先行建立。可在終端執行 mkdir -p ~/.claude 來建立。
    nano ~/.claude/settings.json
  2. 編輯設定檔。將 YOUR_API_KEY 替換為 Token Plan 團隊版專屬 API Key

    {
        "env": {
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
            "ANTHROPIC_MODEL": "qwen3.6-plus",
            "ANTHROPIC_SMALL_FAST_MODEL": "qwen3.6-plus",
            "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-plus",
            "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
            "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
            "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus"
        }
    }

    儲存設定檔,重新開啟一個終端即可生效。

  3. 編輯或新增 ~/.claude.json 檔案,將hasCompletedOnboarding 欄位的值設定為 true並儲存檔案。

    {
      "hasCompletedOnboarding": true
    }
    hasCompletedOnboarding 作為頂層欄位,請勿嵌套於其他欄位。

    該步驟可避免啟動Claude Code時報錯:Unable to connect to Anthropic services

Windows

  1. 建立並開啟設定檔C:\Users\<使用者名稱>\.claude\settings.json

    CMD

    1. 建立目錄

      if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"
    2. 建立並開啟檔案

      notepad "%USERPROFILE%\.claude\settings.json"

    PowerShell

    1. 建立目錄

      mkdir -Force $HOME\.claude
    2. 建立並開啟檔案

      notepad $HOME\.claude\settings.json
  2. 編輯設定檔。將 YOUR_API_KEY 替換為 Token Plan 團隊版專屬 API Key

    {
        "env": {
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
            "ANTHROPIC_MODEL": "qwen3.6-plus",
            "ANTHROPIC_SMALL_FAST_MODEL": "qwen3.6-plus",
            "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-plus",
            "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
            "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
            "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus"
        }
    }

    儲存設定檔,重新開啟一個終端即可生效。

  3. 編輯或新增 C:\Users\<使用者名稱>\.claude.json 檔案,將hasCompletedOnboarding 欄位的值設定為 true,並儲存檔案。

    {
      "hasCompletedOnboarding": true
    }

使用 Claude Code

  1. 開啟終端,並進入專案所在的目錄。運行以下命令啟動 Claude Code:

    cd path/to/your_project
    claude
  2. 啟動後,需要授權 Claude Code 執行檔案。

    image

  3. 輸入/status確認模型、Base URL、API Key 是否配置正確。

  4. 在 Claude Code 中對話。

切換模型

  1. 啟動 Claude Code 時切換:在終端執行claude --model <模型名稱>指定模型並啟動 Claude Code,例如claude --model glm-5

  2. 會話期間:在對話方塊輸入/model <模型名稱>命令切換模型,例如/model MiniMax-M2.5

說明

通過 --model/model 切換的是主對話模型(ANTHROPIC_MODEL)。如需長期使用其他模型,建議在 settings.json 中將全部模型槽位同步修改。

常見命令

命令

說明

樣本

/init

在專案根目錄產生 CLAUDE.md 檔案,用於定義專案級指令和上下文。

/init

/status

查看當前模型、API Key、Base URL 等配置狀態。

/status

/model <模型名稱>

切換模型。

/model glm-5

/clear

清除對話歷史,開始全新對話。

/clear

/plan

進入規劃模式,僅分析和討論方案,不修改代碼。

/plan

/compact

壓縮對話歷史,釋放上下文視窗空間。

/compact

/config

開啟配置菜單,可設定語言、主題等。

/config

更多命令與用法詳情,請參考 Claude Code 官方文檔

使用 Claude Code IDE 外掛程式

Claude Code IDE 外掛程式支援在 VS Code、VS Code 系列 IDE(如 Cursor、Trae 等)、JetBrains 系列 IDE(如 IntelliJ IDEA、PyCharm 等)中使用。

VS Code

  1. 請先配置 Token Plan 團隊版,Windows 還需要安裝 WSL 或 Git for Windows

  2. 開啟 VS Code,在擴充市場中搜尋 Claude Code for VS Code 並安裝。

    image

  3. 安裝完成後,重啟 VS Code。點擊右上方表徵圖進入 Claude Code 開始對話。

    image

    若在對話時彈出 Anthropic 登入介面,說明尚未配置 Token Plan 團隊版,請先完成配置。

    image

  4. 切換模型:在 Claude Code 中切換模型配置,然後在 IDE 外掛程式中建立對話即可生效。

JetBrains

  1. 請先安裝 Claude Code,並配置 Token Plan 團隊版

  2. 開啟 JetBrains(如 IntelliJ IDEA、PyCharm 等),在擴充市場中搜尋 Claude Code 並安裝。

    image

  3. 安裝後重啟 IDE,點擊右上方表徵圖即可使用,可通過 /model <模型名稱> 命令切換模型。

    image

    若在對話時出現 Not logged in. Please run /login 報錯,說明尚未配置 Token Plan 團隊版,請先完成配置。

    image

錯誤碼

請參考常見問題

常見問題

報錯 API Error: Unable to connect to API (ECONNRESET)

該錯誤由 Claude Code 用戶端的網路連接問題引起,與配置無關,通常會自行恢複。建議:

  1. 等待幾分鐘後重試。

  2. 檢查網路連接是否正常。

  3. 如果使用了代理或 VPN,請關閉後重試。

  4. 將 Claude Code 升級到最新版本:npm install -g @anthropic-ai/claude-code@latest

報錯 Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

該錯誤表示 Claude Code 嘗試串連 Anthropic 官方服務而非 Token Plan 團隊版服務端,通常是因為環境變數未正確配置或未生效。請按以下步驟排查:

  1. 檢查設定檔:確認 ~/.claude/settings.json 中已正確配置 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN

    # 查看當前配置
    cat ~/.claude/settings.json

    確認配置內容如下(請替換為實際 API Key):

    {
        "env": {
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
            "ANTHROPIC_MODEL": "qwen3.6-plus",
            "ANTHROPIC_SMALL_FAST_MODEL": "qwen3.6-plus",
            "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-plus",
            "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
            "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
            "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus"
        }
    }
  2. 檢查環境變數是否衝突:如果同時通過環境變數和設定檔設定了 ANTHROPIC_BASE_URL,請確保兩者指向相同的 Token Plan 團隊版地址,避免衝突。執行以下命令檢查:

    echo $ANTHROPIC_BASE_URL

    如果輸出為空白或指向非 Token Plan 團隊版地址,請清除該環境變數或將其設定為正確的 Token Plan 團隊版 Base URL。

  3. 確認 hasCompletedOnboarding:檢查 ~/.claude.json 檔案中 hasCompletedOnboarding 是否設定為 true,否則 Claude Code 啟動時會嘗試串連 Anthropic 官方服務進行登入驗證。

  4. 重新開啟終端:修改設定檔後,需要開啟一個新的終端視窗,再執行 claude 命令以使配置生效。

更多常見問題請參考常見問題

最佳實務

1. 上下文管理
  • 及時清理: 使用 /clear 定期重設對話,防止舊的上下文幹擾新任務並節省 Token。

  • 主動壓縮:使用 /compact 命令讓 Claude 總結關鍵決策和修改的檔案,保留核心記憶。

  • 明確指定檔案: 提問時使用 @ 引用檔案(如 write a test for @auth.py),避免模型無效掃描整個專案。

  • 善用子代理(Sub-agents): 對於大規模任務,讓 Claude 啟動子代理執行。子代理完成任務後返回精鍊結論,保護主對話的上下文空間。

2. 先計劃,再執行
  • 啟用 Plan 模式:複雜任務前,先分析方案,不實際修改檔案。

    • 提示詞約束:提示詞明確要求"先輸出詳細實施計劃,經我確認後再修改檔案"。

  • 降低試錯成本:確保邏輯閉環後再進行代碼變更。

3. 沉澱專案核心知識:編寫 CLAUDE.md
  • 包含關鍵資訊:每次會話啟動時自動載入CLAUDE.md,建議填入構建命令、代碼規範及工作流程等通用規則。

  • 動態維護:內容應簡短易讀,僅記錄廣泛適用的全域約定,並隨專案演化持續補充新規則。

4. 擴充能力:MCP 與 Skills
  • MCP:安裝成熟的 MCP Server,串連外部服務。

  • Skills:編寫詳細的 Skill 描述文案。Claude 決定是否調用該工具,取決於對該工具用途的定義。

  • Skills vs MCP:Skills 教會 Claude "怎麼做"(工作流程知識),MCP 給 Claude"做的工具"(外部介面)。兩者互補,Skills 也可整合外部介面。

5. 自動化守護:Hooks
  • 使用Hooks:Hooks 是確定性規則。它在 Claude 工作流程的特定生命週期節點(如 PreToolUse 工具執行前校正等)自動運行本地指令碼,確保關鍵校正或操作 100% 執行。

  • 配置方式

    1. 運行 /hooks 進行互動式配置。

    2. 直接編輯 .claude/settings.json

    3. 讓 Claude 幫你編寫,如:"編寫一個在每次檔案編輯後運行 eslint 的 hook"。

6. 建立自檢閉環
  • 強制驗證: 要求 Claude 修改代碼後,必須運行相關的測試案例(如 pytestnpm test)。

  • 定義成功標準: "修改完成後,請確保編譯通過,並且運行 curl 命令驗證 API 傳回值為 200"。

  • 視覺反饋: 前端修改時,要求 Claude 截取瀏覽器截圖來確認 UI 效果。