全部產品
Search

搜尋本產品

    Alibaba Cloud Model Studio：Claude Code

    文件中心

    Alibaba Cloud Model Studio：Claude Code

    更新時間：Mar 03, 2026

    阿里雲百鍊的千問系列模型支援 Anthropic API 相容介面，可以通過 Claude Code 調用千問系列模型。

    重要

    本文檔僅適用於國際版（新加坡地區），僅可使用新加坡地區下建立的百鍊 API Key。

    快速開始

    如果您已經熟悉 Claude Code，可以通過以下命令快速接入阿里雲百鍊：

    重要

    本文檔僅適用於隨用隨付模式，Coding Plan 使用者請使用專屬 Base URL 和 API Key 接入，詳情請參考 Claude Code Coding Plan說明文檔 進行配置。

    export ANTHROPIC_BASE_URL=https://dashscope-intl.aliyuncs.com/apps/anthropic
export ANTHROPIC_API_KEY=YOUR_DASHSCOPE_API_KEY
export ANTHROPIC_MODEL=qwen3.5-plus # 可替換為本文列舉的其他模型

claude

    如需詳細的配置說明，請參考詳細步驟。

    模型配置

    支援的模型

    百鍊提供的 Anthropic API 相容服務支援以下千問系列模型：

    模型系列

    支援的模型名稱（model）

    千問Max

    （部分模型支援思考模式）

    qwen3-max、qwen3-max-2026-01-23（支援思考模式）、qwen3-max-preview（支援思考模式） 查看更多

    千問Plus

    qwen3.5-plus、qwen3.5-plus-2026-02-15、qwen-plus、qwen-plus-latest、qwen-plus-2025-09-11 查看更多

    千問Flash

    qwen3.5-flash、qwen3.5-flash-2026-02-23、qwen-flash、qwen-flash-2025-07-28 查看更多

    千問Turbo

    qwen-turbo、qwen-turbo-latest 查看更多

    千問Coder

    （不支援思考模式）

    qwen3-coder-next、qwen3-coder-plus、qwen3-coder-plus-2025-09-23、qwen3-coder-flash 查看更多

    千問VL

    （不支援思考模式）

    qwen3-vl-plus、qwen3-vl-flash、qwen-vl-max、qwen-vl-plus 查看更多

    千問開源模型

    qwen3.5-397b-a17b、qwen3.5-120b-a10b、qwen3.5-27b、qwen3.5-35b-a3b

    模型參數及計費規則請參考模型列表。

    模型選型建議

    針對不同任務類型，推薦使用以下模型：

    • 複雜推理任務（設計應用架構、實現複雜演算法等）：推薦使用千問Plus系列模型（已升級至Qwen3.5）、千問 Max 系列模型、qwen3-coder-next（兼具代碼能力與響應速度）、qwen3-coder-plus。

    • 簡單編碼任務（編寫函數、產生代碼注釋等）：推薦使用千問 Flash 系列模型、qwen3-coder-next。

    詳細步驟

    1. 開通阿里雲百鍊

    1. 註冊帳號：若無阿里雲帳號，需首先註冊。

      如遇問題，請參見註冊阿里雲帳號。

    2. 開通阿里雲百鍊：使用阿里雲主帳號前往阿里雲百鍊大模型服務平台，閱讀並同意協議後，將自動開通阿里雲百鍊，如果未彈出服務合約，則表示您已經開通。

      如果開通服務時提示“您尚未進行實名認證”，請先進行實名認證。
    首次開通百鍊後，您可領取新人免費額度（有效期間：百鍊開通後90天內），用於模型推理服務。免費額度領取方法和詳情，請查看新人免費額度頁面。
    說明

    超出額度或期限將產生費用，開啟免費額度用完即停功能將避免此情況下產生費用，具體費用請以控制台的實際報價和最終賬單為準。

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

    3. 配置 Base URL、API Key 和模型

    要通過相容 Anthropic API 的方式來接入阿里雲百鍊的模型服務，需要配置以下環境變數。

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

    2. ANTHROPIC_API_KEY或ANTHROPIC_AUTH_TOKEN：設定為阿里雲百鍊 API Key。

      ANTHROPIC_API_KEY或ANTHROPIC_AUTH_TOKEN均可作為接入認證，只需要設定其一即可。本文以ANTHROPIC_API_KEY為例。

    3. ANTHROPIC_MODEL：設定為模型列表中支援的模型。

    重要

    本文檔僅適用於隨用隨付模式，Coding Plan 使用者請使用專屬 Base URL 和 API Key 接入，詳情請參考 Claude Code Coding Plan說明文檔 進行配置。

    macOS

    1. 在終端中執行以下命令，查看預設 Shell 類型。

      echo $SHELL

    2. 根據 Shell 類型設定環境變數，命令如下：

      Zsh

      # 用百鍊 API KEY 替換 YOUR_DASHSCOPE_API_KEY
echo 'export ANTHROPIC_BASE_URL="https://dashscope-intl.aliyuncs.com/apps/anthropic"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="YOUR_DASHSCOPE_API_KEY"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="qwen3.5-plus"' >> ~/.zshrc

      Bash

      # 用百鍊 API Key 替換 YOUR_DASHSCOPE_API_KEY
echo 'export ANTHROPIC_BASE_URL="https://dashscope-intl.aliyuncs.com/apps/anthropic"' >> ~/.bash_profile
echo 'export ANTHROPIC_API_KEY="YOUR_DASHSCOPE_API_KEY"' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL="qwen3.5-plus"' >> ~/.bash_profile

    3. 在終端中執行下列命令，使環境變數生效。

      Zsh

      source ~/.zshrc

      Bash

      source ~/.bash_profile

    4. 在終端中執行下列命令，查看環境變數是否生效。

      echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_MODEL

    Windows

    1. 在 Windows 中，可以通過 CMD 或 PowerShell 將阿里雲百鍊提供的 Base URL 和API Key設定為環境變數。

      CMD

      1. 在 CMD 中運行以下命令，設定環境變數。

        REM 用百鍊 API Key 替換 YOUR_DASHSCOPE_API_KEY
setx ANTHROPIC_API_KEY "YOUR_DASHSCOPE_API_KEY"
setx ANTHROPIC_BASE_URL "https://dashscope-intl.aliyuncs.com/apps/anthropic"
setx ANTHROPIC_MODEL "qwen3.5-plus"

      2. 開啟一個新的 CMD 視窗，運行以下命令，檢查環境變數是否生效。

        echo %ANTHROPIC_API_KEY%
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

      PowerShell

      1. 在 PowerShell 中運行以下命令，設定環境變數。

        # 用百鍊 API Key 替換 YOUR_DASHSCOPE_API_KEY
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "YOUR_DASHSCOPE_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://dashscope-intl.aliyuncs.com/apps/anthropic", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "qwen3.5-plus", [EnvironmentVariableTarget]::User)

      2. 開啟一個新的 PowerShell 視窗，運行以下命令，檢查環境變數是否生效。

        echo $env:ANTHROPIC_API_KEY
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL

    4. 運行 claude code

    進入專案目錄，在終端執行claude命令。

    claude

    初次使用 claude code 時，可能會強制要求登入 Anthropic 賬戶。請按以下步驟操作以跳過該流程：

    image

    1. 定位使用者主目錄下的 .claude.json 檔案，具體路徑如下：

      • macOS / Linux: ~/.claude.json

      • Windows: C:\Users\%USERNAME%\.claude.json

    2. 將hasCompletedOnboarding 欄位的值設定為 true

      {
  "hasCompletedOnboarding": true
}

    3. 儲存檔案，然後在新終端中重新運行 claude。

    （可選）更多配置模型的方式

    Claude Code 支援以下模型配置方式，按優先順序從高到低排列，優先順序高的配置會覆蓋優先順序低的配置。

    1. 對話期間：執行/model <模型名稱>命令切換模型。適用於臨時切換模型。

      /model qwen3.5-plus

    2. 啟動 claude code 時：執行claude --model <模型名稱>指定模型。適用於單次會話。

      claude --model qwen3.5-plus

    3. 設定環境變數：可按任務複雜度配置不同層級的模型，Claude Code 會根據任務類型自動選擇合適的模型。適用於全域生效。

      export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen3.5-plus"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.5-plus"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3-coder-next"

      其中：

      • ANTHROPIC_DEFAULT_OPUS_MODEL：用於複雜推理、架構設計等高難度任務。

      • ANTHROPIC_DEFAULT_SONNET_MODEL：用於代碼編寫、功能實現等日常任務。

      • ANTHROPIC_DEFAULT_HAIKU_MODEL：用於語法檢查、檔案搜尋等簡單任務。

    4. 在 setting.json 設定檔中永久設定：在專案根目錄或使用者主目錄建立settings.json檔案，並寫入模型配置資訊，可分別進行專案級或使用者級的永久配置。

      {
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.5-plus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.5-plus",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3-coder-next"
  }
}

    錯誤碼

    HTTP狀態代碼

    錯誤類型

    說明

    400

    invalid_request_error

    請求格式或內容存在問題。具體原因可能包括：缺少必要的請求參數、參數值的資料類型不正確等。

    400

    Arrearage

    賬戶欠費導致服務暫停，請儲值後重試。

    403

    authentication_error

    API Key 存在問題。具體原因可能包括：要求標頭中未提供 API Key、提供的 API Key 不正確等。

    404

    not_found_error

    未找到請求的資源。具體原因可能包括：相容介面拼字有誤、要求標頭中的模型不存在等。

    429

    rate_limit_error

    賬戶達到了速率限制，建議降低請求頻率。

    500

    api_error

    發生了一個通用的伺服器內部錯誤，建議稍後重試。

    529

    overloaded_error

    API 伺服器當前負載過高，暫時無法處理新的請求。

    常見問題

    問題1：啟動 claude code 後，介面顯示“Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST”，該怎麼辦

    image

    重新配置環境變數，然後在終端執行 claude 命令。

    問題2：Token 消耗太快了，如何節省 Token？

    Claude Code 會掃描整個專案目錄、讀取相關代碼檔案並維護完整對話歷史來提供編碼建議，因而其 Token 消耗遠高於普通對話情境。以下方法可協助您有效控制消耗：

    1. 減少無關檔案：為避免掃描不相關檔案而造成 Token 消耗，建議在具體的專案目錄中啟動 Claude Code，同時僅保留必要的專案檔。

    2. 總結對話：Claude Code 會將歷史對話內容作為上下文，當對話長度達到上下文視窗的 95% 時，Claude Code 會自動地總結對話內容。也可以通過執行/compact命令來手動地總結對話內容。

    3. 精確指令：模糊的請求會觸發非必要的檔案掃描，消耗更多的 Token。請在使用 Claude Code 時提出更明確、具體的問題或指令。

    4. 分解任務：在處理複雜任務時，可以將其分解為若干簡單任務。

    5. 重設上下文：在開啟一個全新的任務之前，使用/clear命令重設上下文，避免無關資訊消耗 Token。

    可以參考 Claude Code 官方文檔瞭解更多節省 Token 的技巧。如需查看具體的 Token 消耗量和費用明細，請參考賬單查詢與成本管理。