在 Claude Code 中配置與使用阿里雲百鍊 Token Plan 團隊版。
安裝與使用
手動安裝
macOS/Linux
-
安裝或更新 Node.js(v18.0 或更高版本)。
-
在終端中執行下列命令,安裝 Claude Code。
npm install -g @anthropic-ai/claude-code -
運行以下命令驗證安裝。若有版本號碼輸出,則表示安裝成功。
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 來完成安裝和驗證。
-
安裝並配置 Qwen Code。
-
在終端輸入以下命令啟動 Qwen Code。
qwen -
在 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 驗證安裝是否成功。 -
授權允許Qwen Code 執行命令,直至完成安裝。
-
輸入/exit退出Qwen Code。
/exit
配置 Token Plan 團隊版
在 Claude Code 中接入百鍊 Token Plan 團隊版,需要配置以下資訊:
-
ANTHROPIC_BASE_URL:設定為https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic。 -
ANTHROPIC_AUTH_TOKEN:設定為 Token Plan 團隊版專屬 API Key。 -
ANTHROPIC_MODEL等模型環境變數:設定為 Token Plan 團隊版支援的模型。Claude Code 內部使用多個模型槽位處理不同任務,需要將全部槽位配置為 Token Plan 團隊版支援的模型,否則未配置的槽位會嘗試調用 Anthropic 官方模型導致請求失敗。
macOS/Linux
-
建立並開啟設定檔
~/.claude/settings.json。~代表當前系統賬戶的主目錄。如果.claude目錄不存在,需要先行建立。可在終端執行mkdir -p ~/.claude來建立。nano ~/.claude/settings.json -
編輯設定檔。將 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" } }儲存設定檔,重新開啟一個終端即可生效。
-
編輯或新增
~/.claude.json檔案,將hasCompletedOnboarding欄位的值設定為true並儲存檔案。{ "hasCompletedOnboarding": true }hasCompletedOnboarding作為頂層欄位,請勿嵌套於其他欄位。該步驟可避免啟動Claude Code時報錯:
Unable to connect to Anthropic services。
Windows
-
建立並開啟設定檔
C:\Users\<使用者名稱>\.claude\settings.json。CMD
-
建立目錄
if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude" -
建立並開啟檔案
notepad "%USERPROFILE%\.claude\settings.json"
PowerShell
-
建立目錄
mkdir -Force $HOME\.claude -
建立並開啟檔案
notepad $HOME\.claude\settings.json
-
-
編輯設定檔。將 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" } }儲存設定檔,重新開啟一個終端即可生效。
-
編輯或新增
C:\Users\<使用者名稱>\.claude.json檔案,將hasCompletedOnboarding欄位的值設定為true,並儲存檔案。{ "hasCompletedOnboarding": true }
使用 Claude Code
-
開啟終端,並進入專案所在的目錄。運行以下命令啟動 Claude Code:
cd path/to/your_project claude -
啟動後,需要授權 Claude Code 執行檔案。

-
輸入
/status確認模型、Base URL、API Key 是否配置正確。 -
在 Claude Code 中對話。
切換模型
-
啟動 Claude Code 時切換:在終端執行
claude --model <模型名稱>指定模型並啟動 Claude Code,例如claude --model glm-5。 -
會話期間:在對話方塊輸入
/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
-
請先配置 Token Plan 團隊版,Windows 還需要安裝 WSL 或 Git for Windows。
-
開啟 VS Code,在擴充市場中搜尋
Claude Code for VS Code並安裝。
-
安裝完成後,重啟 VS Code。點擊右上方表徵圖進入 Claude Code 開始對話。

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

-
切換模型:在 Claude Code 中切換模型配置,然後在 IDE 外掛程式中建立對話即可生效。
JetBrains
-
開啟 JetBrains(如 IntelliJ IDEA、PyCharm 等),在擴充市場中搜尋
Claude Code並安裝。
-
安裝後重啟 IDE,點擊右上方表徵圖即可使用,可通過
/model <模型名稱>命令切換模型。
若在對話時出現
Not logged in. Please run /login報錯,說明尚未配置 Token Plan 團隊版,請先完成配置。
錯誤碼
請參考常見問題。
常見問題
報錯 API Error: Unable to connect to API (ECONNRESET)
該錯誤由 Claude Code 用戶端的網路連接問題引起,與配置無關,通常會自行恢複。建議:
-
等待幾分鐘後重試。
-
檢查網路連接是否正常。
-
如果使用了代理或 VPN,請關閉後重試。
-
將 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 團隊版服務端,通常是因為環境變數未正確配置或未生效。請按以下步驟排查:
-
檢查設定檔:確認
~/.claude/settings.json中已正確配置ANTHROPIC_BASE_URL和ANTHROPIC_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" } } -
檢查環境變數是否衝突:如果同時通過環境變數和設定檔設定了
ANTHROPIC_BASE_URL,請確保兩者指向相同的 Token Plan 團隊版地址,避免衝突。執行以下命令檢查:echo $ANTHROPIC_BASE_URL如果輸出為空白或指向非 Token Plan 團隊版地址,請清除該環境變數或將其設定為正確的 Token Plan 團隊版 Base URL。
-
確認 hasCompletedOnboarding:檢查
~/.claude.json檔案中hasCompletedOnboarding是否設定為true,否則 Claude Code 啟動時會嘗試串連 Anthropic 官方服務進行登入驗證。 -
重新開啟終端:修改設定檔後,需要開啟一個新的終端視窗,再執行
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
5. 自動化守護:Hooks
-
使用Hooks:Hooks 是確定性規則。它在 Claude 工作流程的特定生命週期節點(如 PreToolUse 工具執行前校正等)自動運行本地指令碼,確保關鍵校正或操作 100% 執行。
-
配置方式:
-
運行
/hooks進行互動式配置。 -
直接編輯
.claude/settings.json。 -
讓 Claude 幫你編寫,如:"編寫一個在每次檔案編輯後運行 eslint 的 hook"。
-
6. 建立自檢閉環
-
強制驗證: 要求 Claude 修改代碼後,必須運行相關的測試案例(如
pytest或npm test)。 -
定義成功標準: "修改完成後,請確保編譯通過,並且運行
curl命令驗證 API 傳回值為 200"。 -
視覺反饋: 前端修改時,要求 Claude 截取瀏覽器截圖來確認 UI 效果。