全部產品
Search
文件中心

Alibaba Cloud Model Studio:Claude Code

更新時間:Mar 12, 2026

Coding Plan中的模型支援 Anthropic API 相容介面,可以通過 Claude Code 調用。

安裝與使用

手動安裝

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

在Claude Code配置Coding Plan

在 Claude Code 中接入百鍊 Coding Plan,需要配置以下資訊:

  1. ANTHROPIC_BASE_URL:設定為 https://coding-intl.dashscope.aliyuncs.com/apps/anthropic

  2. ANTHROPIC_AUTH_TOKEN:設定為Coding Plan專屬 API Key

  3. ANTHROPIC_MODEL:設定為 Coding Plan 支援的模型

macOS/Linux

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

    ~ 代表使用者主目錄。如果 .claude 目錄不存在,需要先行建立。可在終端執行 mkdir -p ~/.claude 來建立。
    nano ~/.claude/settings.json
  2. 編輯設定檔。將 YOUR_API_KEY 替換為 Coding Plan 專屬 API Key

    {
        "env": {
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "ANTHROPIC_BASE_URL": "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic",
            "ANTHROPIC_MODEL": "qwen3.5-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 替換為 Coding Plan 專屬 API Key

    {
        "env": {
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "ANTHROPIC_BASE_URL": "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic",
            "ANTHROPIC_MODEL": "qwen3.5-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 是否配置正確。

    image

  4. 在 Claude Code 中對話。

    image

切換模型

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

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

常見命令

命令

說明

樣本

/init

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

/init

/status

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

/status

/model <模型名稱>

切換模型。

/model qwen3-coder-next

/clear

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

/clear

/plan

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

/plan

/compact

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

/compact

/config

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

/config

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

能力擴充

Claude Code 支援通過 MCP 和 Skills 擴充自身能力,例如調用連網搜尋擷取即時資訊、使用圖片理解 Skill 分析映像內容等。詳情請參考最佳實務

使用Claude Code IDE外掛程式

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

VS Code

  1. 請先在Claude Code配置Coding Plan,Windows還需要安裝 WSL 或 Git for Windows

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

    image

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

    截屏2026-02-06 17

    若在對話時彈出 Anthropic 登入介面,說明尚未在Claude Code配置Coding Plan,請先完成配置。

    image

  4. 切換模型:在對話方塊中輸入/,選擇 General config 進入設定頁面,在Selected Model中選擇支援的模型,建立一個新視窗開始對話。

    截屏2026-02-06 17

JetBrains

  1. 請先安裝 Claude Code,並在Claude Code配置Coding Plan

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

    2026-02-25_16-27-56

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

    2026-02-25_16-40-33

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

    image

錯誤碼

請參考常見報錯及解決方案

常見問題

請參考常見問題

最佳實務

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

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

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

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

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

    • 快捷操作:連續按兩次 Shift + Tab 進入 Plan Mode。

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

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

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

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

4. 擴充能力: MCP 與 Skills
  • MCP:安裝成熟的 MCP Server,串連外部服務。例如:添加連網搜尋MCP

  • Skills:編寫詳細的 Skill 描述文案。Claude 決定是否調用該工具,取決於對該工具用途的定義。例如:添加視覺理解能力Skill

  • 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 效果。