在編程的藝術世界里代碼和靈感需要尋找到最佳的交融點才能打造出令人為之驚嘆的作品。而在這座秋知葉i博客的殿堂里我們將共同追尋這種完美結合為未來的世界留下屬于我們的獨特印記。【Agent】Claude Code CLI 接入阿里 Token Plan 保姆級教程摘要開發環境一、核心原理 用「助理-翻譯-專家」講懂三者關系1.1 Claude Code CLIAI 智能代理 Agent1.2 CC SwitchAI 編程統一配置管理工具1.3 阿里 Token Plan底層大模型推理服務1.4 整體流程總結1.5 架構圖二、環境準備 Windows 下必裝的 3 樣東西缺一不可2.1 必備工具 Claude Code CLI2.2 必備工具 CC Switch v3.19.12.3 API密鑰三、實操步驟 ?小白直接照抄3.1 啟動 CC Switch3.2 如果沒有看到 Claude Code 選項3.3 添加新供應商3.4 選擇自定義配置3.5 填寫供應商名稱3.6 配置 API Key3.7 配置請求地址3.8 高級選項-API格式3.9 高級選項-認證字段3.10 阿里支持的模型3.11 配置大模型3.11.1 模型角色說明3.11.2 模型配置參考3.11.3 默認兜底模型3.12 完成供應商添加五、開啟全局路由功能六、CC Switch 測試連接6.1 開啟 Claude Code 路由功能6.2 測試API連接七、CC Switch 將配置寫入 Claude Code八、Claude Code CLI 選擇阿里 Token Plan 模型8.1 查看可用模型8.2 切換到 GLM-5.28.3 驗證鏈路是否打通九、常見問題與避坑指南9.1 配置后 /model 不顯示自定義模型9.2 連接報錯 401/鑒權失敗十、總結與進階 十一、【 小課堂】Claude Code CLI 實用技巧十二、【 編程冷笑話】十三、【? 今日金句】摘要Windows 環境下想用最新 Claude Code CLI 這款 AI 智能代理通過 CC Switch 對接阿里 Token Plan 大模型很多人都會卡在端口占用、配置錯誤、協議不兼容等問題上。本文以秋知葉i實戰視角精準定位 Claude Code CLI、CC Switch、阿里 Token Plan 三者真實角色。從原理科普、環境準備到一步步實操配置搭配架構圖和高頻避坑方案小白可直接照抄部署老手也能快速理清 Agent 對接大模型的底層邏輯。開發環境開發系統Windows 11Claude Code2.1.220CC Switchv3.19.1一、核心原理 用「助理-翻譯-專家」講懂三者關系在動手配置前先把角色定位捋清楚不然配置永遠只懂照抄、出問題不會排錯。1.1 Claude Code CLIAI 智能代理 Agent定位全能代碼智能助理角色類比你的專屬私人技術助理能自主理解需求、寫代碼、查 Bug、分析工程、編排多智能體并行任務核心特性原生遵循 Anthropic Messages API 規范可通過本地代理方式經 CC Switch 協議轉換后對接阿里 Token Plan 接口。1.2 CC SwitchAI 編程統一配置管理工具定位跨平臺 AI 編碼助手一站式配置管理器角色類比專門接管所有 AI 編程工具配置文件的管家不用再手動改 JSON/TOML/.env核心特性內置本地 HTTP 代理一鍵切換模型供應商統一管理 Claude Code CLI 等工具的密鑰與接口并自動完成 Anthropic 與 Chat Completions 雙向協議格式轉換。1.3 阿里 Token Plan底層大模型推理服務定位云端大模型 API 算力服務角色類比后臺資深技術專家只專注做模型推理、生成回答核心特性對外提供標準 OpenAI Chat Completions 兼容接口需要通過 API 密鑰鑒權支持高并發調用阿里百煉 Token Plan。1.4 整體流程總結真實鏈路Claude Code CLI (AI Agent) → CC Switch (本地代理轉發協議轉換) → 阿里 Token Plan (大模型服務)Agent 發 Anthropic 格式請求 → CC 代理轉發并攜帶鑒權信息、完成格式適配 → 阿里 Token Plan 推理返回 → 原路回傳給 Claude Code CLI。1.5 架構圖Anthropic Messages格式請求攜帶密鑰轉發格式轉換Chat Completions結果返回轉回Anthropic格式回傳支撐運行接口授權Claude Code CLIAI智能代理AgentCC Switch配置管理器/內置代理阿里 Token Plan云端大模型服務Windows系統端口/運行環境阿里 Token Plan API密鑰統一鑒權二、環境準備 Windows 下必裝的 3 樣東西缺一不可在實操前先把環境準備好避免中途卡殼。所有工具都選 Windows 版本。2.1 必備工具 Claude Code CLIClaude Code CLI【Claude Code】Windows11 國內 一鍵安裝保姆級教程WinGet官方純享版2.2 必備工具 CC Switch v3.19.1CC Switch v3.19.12.3 API密鑰阿里 Token Plan API 密鑰在阿里百煉平臺申請三、實操步驟 ?小白直接照抄3.1 啟動 CC Switch雙擊打開 CC Switch。在頂部工具欄切換到Claude Code配置面板。3.2 如果沒有看到 Claude Code 選項如果沒有看到 Claude Code 選項進入 設置 → 通用。勾選上Claude Code以啟用支持。這里要注意 不是Claude Desktop3.3 添加新供應商點擊右上角的號。3.4 選擇自定義配置選擇自定義配置。3.5 填寫供應商名稱找到「供應商名稱」欄填寫百煉-Token Plan3.6 配置 API Key往下滑找到API Key。在這里填寫你在阿里百煉平臺申請的 API Key。3.7 配置請求地址往下滑找到請求地址。填寫百煉 Token Plan 的專屬請求地址https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic注意這個地址是阿里 Token Plan 的專屬端點不要和百煉普通的 OpenAI 兼容端點dashscope.aliyuncs.com搞混了。3.8 高級選項-API格式往下滑找到高級選項-API格式。默認選擇Anthropic Messages (原生)3.9 高級選項-認證字段往下滑找到高級選項-認證字段。默認選擇ANTHROPIC_AUTH_TOKEN幾乎所有 OpenAI 兼容服務都是 Bearer 鑒權3.10 阿里支持的模型截止時間2026年8月6日品牌模型模型能力千問qwen3.8-max文本生成、推理模型、視覺理解千問qwen3.7-plus文本生成、推理模型、視覺理解千問qwen3.7-max文本生成、推理模型千問qwen3.6-plus文本生成、推理模型、視覺理解千問qwen3.6-flash文本生成、推理模型、視覺理解千問qwen-audio-3.0-tts-plus實時語音合成千問qwen-image-2.0圖片生成千問qwen-image-2.0-pro圖片生成千問qwen-audio-3.0-realtime-plus實時語音對話萬相wan2.7-image圖片生成萬相wan2.7-image-pro圖片生成HappyHorsehappyhorse-1.1-i2v視頻生成HappyHorsehappyhorse-1.1-t2v視頻生成HappyHorsehappyhorse-1.1-r2v視頻生成DeepSeekdeepseek-v4-pro文本生成、推理模型DeepSeekdeepseek-v4-flash-0731文本生成、推理模型DeepSeekdeepseek-v4-flash文本生成、推理模型DeepSeekdeepseek-v3.2文本生成、推理模型智譜AIglm-5.2文本生成、推理模型智譜AIglm-5.1文本生成、推理模型智譜AIglm-5文本生成、推理模型月之暗面kimi-k2.7-code文本生成、推理模型、視覺理解月之暗面kimi-k2.6文本生成、推理模型、視覺理解月之暗面kimi-k2.5文本生成、推理模型、視覺理解MiniMaxMiniMax-M2.5文本生成、推理模型3.11 配置大模型3.11.1 模型角色說明角色在 Claude Code 里的用途能力等級Sonnet默認主力模型/model 菜單的默認別名90% 的日常對話、編碼任務都走它平衡能力與成本3Opus高端旗艦檔復雜重構、疑難 bug 排查、架構設計等高難度任務時手動切換使用2Fable比 Opus 更高一檔的公開旗艦Mythos 級目前公開可用的最強 Claude面向超大型、長周期的復雜項目1Haiku輕量快速檔簡單問答、代碼搜索、格式化、小任務成本最低4Subagent子代理Task 工具派生出的獨立執行單元可指定不同模型輕量子代理普遍選用 Haiku兼顧工具調用穩定性與低成本-非獨立模型能力隨底層分配的模型浮動3.11.2 模型配置參考以下為推薦配置方案供參考執行模型名稱填寫建議從前文列出的阿里官方支持模型列表中直接復制模型名稱避免手動輸入造成名稱多字、漏字確保配置準確。顯示名稱規則將復制的模型名稱填入「實際請求模型」字段后系統將自動填充顯示名稱該字段無需手動配置。1M 配置項1M 對應的所有選項請全部勾選。3.11.3 默認兜底模型我直接選glm-5.21M 勾上3.12 完成供應商添加以上所有配置確認無誤后直接點擊右下角「添加」按鈕完成配置。五、開啟全局路由功能點擊 設置 - 路由把這兩個勾選上六、CC Switch 測試連接6.1 開啟 Claude Code 路由功能回到 CC Switch 的Claude Code配置界面。點擊這個按鈕 啟用 。會變成綠色6.2 測試API連接回到 CC Switch 的Claude Code配置界面。點擊對應供應商的「測試」按鈕。顯示「連通正常」且狀態為綠色代表接口配置無誤。七、CC Switch 將配置寫入 Claude Code我們要讓 Claude Code CLI 識別到阿里 Token Plan 的配置。在 CC Switch 的 Claude Code 面板底部點擊「啟用」按鈕會自動將配置寫入 Claude Code 的配置文件添加成功后按鈕文字會從「啟用」變成「使用中」。八、Claude Code CLI 選擇阿里 Token Plan 模型重啟終端重新啟動 Claude Code CLI讓配置生效。若 CLI 正在運行需完全退出后重新進入。8.1 查看可用模型在 Claude Code CLI 中輸入/model命令。列表中會出現我們在 CC Switch 里配置的自定義大模型。8.2 切換到 GLM-5.2在/model列表中鍵盤上下按鍵可以上下移動選擇glm-5.2對應的條目回車切換為主力模型。8.3 驗證鏈路是否打通發一句話測試你好你是誰能正常收到回復、就說明阿里 Token Plan 的鏈路已經完全打通。模型回復中自稱 Claude 屬于正常現象代理層會保留原生交互體驗以實際接口調用成功為準。九、常見問題與避坑指南9.1 配置后 /model 不顯示自定義模型確認 CC Switch 中已點擊「添加」寫入配置必須完全退出 Claude Code CLI 后重新啟動配置文件才會重新加載9.2 連接報錯 401/鑒權失敗檢查 API Key 是否復制完整有無多余空格確認 Token Plan 服務已在阿里百煉控制臺開通核對請求地址是否為 Token Plan 專屬端點不要誤用普通百煉接口十、總結與進階 整套部署核心邏輯Claude Code CLI 通過 CC Switch 本地代理轉發請求由 CC Switch 統一托管 API 密鑰并完成 Anthropic 與 Chat Completions 雙向協議轉換快速完成阿里 Token Plan 大模型對接。核心流程配置 CC Switch 供應商 → 寫入 Claude Code 配置文件 → 開啟本地路由代理 → Claude Code 綁定自定義模型 → 連通測試。十一、【 小課堂】Claude Code CLI 實用技巧Claude Code CLI 支持多會話并行你可以同時開啟多個終端會話讓它們分別處理前端、后端和測試任務互不干擾。最實用的上下文管理技巧當對話過長時可以手動開啟新會話來重置上下文大幅節省 Token 消耗。配合阿里 Token Plan 服務長上下文支持極佳寫大項目遇到復雜邏輯時隨時切換不同模型對比答案全程不用中斷工作流。十二、【 編程冷笑話】為什么 Claude Code AI Agent 不能直接找阿里 Token Plan 對接因為兩者的協議方言不一樣Claude 原生 Messages API vs 百煉 Chat Completions 端點還好有 CC Switch 當專業翻譯官不然根本聊不到一塊去。十三、【? 今日金句】AI Agent 對接大模型的核心不在于堆砌工具而在于理清協議、中轉、鑒權三者的底層邏輯懂原理才不會只會無腦抄配置。 【Agent】Claude Code CLI 接入阿里 Token Plan 保姆級教程
在編程的藝術世界里代碼和靈感需要尋找到最佳的交融點才能打造出令人為之驚嘆的作品。而在這座秋知葉i博客的殿堂里我們將共同追尋這種完美結合為未來的世界留下屬于我們的獨特印記。【Agent】Claude Code CLI 接入阿里 Token Plan 保姆級教程摘要開發環境一、核心原理 用「助理-翻譯-專家」講懂三者關系1.1 Claude Code CLIAI 智能代理 Agent1.2 CC SwitchAI 編程統一配置管理工具1.3 阿里 Token Plan底層大模型推理服務1.4 整體流程總結1.5 架構圖二、環境準備 Windows 下必裝的 3 樣東西缺一不可2.1 必備工具 Claude Code CLI2.2 必備工具 CC Switch v3.19.12.3 API密鑰三、實操步驟 ?小白直接照抄3.1 啟動 CC Switch3.2 如果沒有看到 Claude Code 選項3.3 添加新供應商3.4 選擇自定義配置3.5 填寫供應商名稱3.6 配置 API Key3.7 配置請求地址3.8 高級選項-API格式3.9 高級選項-認證字段3.10 阿里支持的模型3.11 配置大模型3.11.1 模型角色說明3.11.2 模型配置參考3.11.3 默認兜底模型3.12 完成供應商添加五、開啟全局路由功能六、CC Switch 測試連接6.1 開啟 Claude Code 路由功能6.2 測試API連接七、CC Switch 將配置寫入 Claude Code八、Claude Code CLI 選擇阿里 Token Plan 模型8.1 查看可用模型8.2 切換到 GLM-5.28.3 驗證鏈路是否打通九、常見問題與避坑指南9.1 配置后 /model 不顯示自定義模型9.2 連接報錯 401/鑒權失敗十、總結與進階 十一、【 小課堂】Claude Code CLI 實用技巧十二、【 編程冷笑話】十三、【? 今日金句】摘要Windows 環境下想用最新 Claude Code CLI 這款 AI 智能代理通過 CC Switch 對接阿里 Token Plan 大模型很多人都會卡在端口占用、配置錯誤、協議不兼容等問題上。本文以秋知葉i實戰視角精準定位 Claude Code CLI、CC Switch、阿里 Token Plan 三者真實角色。從原理科普、環境準備到一步步實操配置搭配架構圖和高頻避坑方案小白可直接照抄部署老手也能快速理清 Agent 對接大模型的底層邏輯。開發環境開發系統Windows 11Claude Code2.1.220CC Switchv3.19.1一、核心原理 用「助理-翻譯-專家」講懂三者關系在動手配置前先把角色定位捋清楚不然配置永遠只懂照抄、出問題不會排錯。1.1 Claude Code CLIAI 智能代理 Agent定位全能代碼智能助理角色類比你的專屬私人技術助理能自主理解需求、寫代碼、查 Bug、分析工程、編排多智能體并行任務核心特性原生遵循 Anthropic Messages API 規范可通過本地代理方式經 CC Switch 協議轉換后對接阿里 Token Plan 接口。1.2 CC SwitchAI 編程統一配置管理工具定位跨平臺 AI 編碼助手一站式配置管理器角色類比專門接管所有 AI 編程工具配置文件的管家不用再手動改 JSON/TOML/.env核心特性內置本地 HTTP 代理一鍵切換模型供應商統一管理 Claude Code CLI 等工具的密鑰與接口并自動完成 Anthropic 與 Chat Completions 雙向協議格式轉換。1.3 阿里 Token Plan底層大模型推理服務定位云端大模型 API 算力服務角色類比后臺資深技術專家只專注做模型推理、生成回答核心特性對外提供標準 OpenAI Chat Completions 兼容接口需要通過 API 密鑰鑒權支持高并發調用阿里百煉 Token Plan。1.4 整體流程總結真實鏈路Claude Code CLI (AI Agent) → CC Switch (本地代理轉發協議轉換) → 阿里 Token Plan (大模型服務)Agent 發 Anthropic 格式請求 → CC 代理轉發并攜帶鑒權信息、完成格式適配 → 阿里 Token Plan 推理返回 → 原路回傳給 Claude Code CLI。1.5 架構圖Anthropic Messages格式請求攜帶密鑰轉發格式轉換Chat Completions結果返回轉回Anthropic格式回傳支撐運行接口授權Claude Code CLIAI智能代理AgentCC Switch配置管理器/內置代理阿里 Token Plan云端大模型服務Windows系統端口/運行環境阿里 Token Plan API密鑰統一鑒權二、環境準備 Windows 下必裝的 3 樣東西缺一不可在實操前先把環境準備好避免中途卡殼。所有工具都選 Windows 版本。2.1 必備工具 Claude Code CLIClaude Code CLI【Claude Code】Windows11 國內 一鍵安裝保姆級教程WinGet官方純享版2.2 必備工具 CC Switch v3.19.1CC Switch v3.19.12.3 API密鑰阿里 Token Plan API 密鑰在阿里百煉平臺申請三、實操步驟 ?小白直接照抄3.1 啟動 CC Switch雙擊打開 CC Switch。在頂部工具欄切換到Claude Code配置面板。3.2 如果沒有看到 Claude Code 選項如果沒有看到 Claude Code 選項進入 設置 → 通用。勾選上Claude Code以啟用支持。這里要注意 不是Claude Desktop3.3 添加新供應商點擊右上角的號。3.4 選擇自定義配置選擇自定義配置。3.5 填寫供應商名稱找到「供應商名稱」欄填寫百煉-Token Plan3.6 配置 API Key往下滑找到API Key。在這里填寫你在阿里百煉平臺申請的 API Key。3.7 配置請求地址往下滑找到請求地址。填寫百煉 Token Plan 的專屬請求地址https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic注意這個地址是阿里 Token Plan 的專屬端點不要和百煉普通的 OpenAI 兼容端點dashscope.aliyuncs.com搞混了。3.8 高級選項-API格式往下滑找到高級選項-API格式。默認選擇Anthropic Messages (原生)3.9 高級選項-認證字段往下滑找到高級選項-認證字段。默認選擇ANTHROPIC_AUTH_TOKEN幾乎所有 OpenAI 兼容服務都是 Bearer 鑒權3.10 阿里支持的模型截止時間2026年8月6日品牌模型模型能力千問qwen3.8-max文本生成、推理模型、視覺理解千問qwen3.7-plus文本生成、推理模型、視覺理解千問qwen3.7-max文本生成、推理模型千問qwen3.6-plus文本生成、推理模型、視覺理解千問qwen3.6-flash文本生成、推理模型、視覺理解千問qwen-audio-3.0-tts-plus實時語音合成千問qwen-image-2.0圖片生成千問qwen-image-2.0-pro圖片生成千問qwen-audio-3.0-realtime-plus實時語音對話萬相wan2.7-image圖片生成萬相wan2.7-image-pro圖片生成HappyHorsehappyhorse-1.1-i2v視頻生成HappyHorsehappyhorse-1.1-t2v視頻生成HappyHorsehappyhorse-1.1-r2v視頻生成DeepSeekdeepseek-v4-pro文本生成、推理模型DeepSeekdeepseek-v4-flash-0731文本生成、推理模型DeepSeekdeepseek-v4-flash文本生成、推理模型DeepSeekdeepseek-v3.2文本生成、推理模型智譜AIglm-5.2文本生成、推理模型智譜AIglm-5.1文本生成、推理模型智譜AIglm-5文本生成、推理模型月之暗面kimi-k2.7-code文本生成、推理模型、視覺理解月之暗面kimi-k2.6文本生成、推理模型、視覺理解月之暗面kimi-k2.5文本生成、推理模型、視覺理解MiniMaxMiniMax-M2.5文本生成、推理模型3.11 配置大模型3.11.1 模型角色說明角色在 Claude Code 里的用途能力等級Sonnet默認主力模型/model 菜單的默認別名90% 的日常對話、編碼任務都走它平衡能力與成本3Opus高端旗艦檔復雜重構、疑難 bug 排查、架構設計等高難度任務時手動切換使用2Fable比 Opus 更高一檔的公開旗艦Mythos 級目前公開可用的最強 Claude面向超大型、長周期的復雜項目1Haiku輕量快速檔簡單問答、代碼搜索、格式化、小任務成本最低4Subagent子代理Task 工具派生出的獨立執行單元可指定不同模型輕量子代理普遍選用 Haiku兼顧工具調用穩定性與低成本-非獨立模型能力隨底層分配的模型浮動3.11.2 模型配置參考以下為推薦配置方案供參考執行模型名稱填寫建議從前文列出的阿里官方支持模型列表中直接復制模型名稱避免手動輸入造成名稱多字、漏字確保配置準確。顯示名稱規則將復制的模型名稱填入「實際請求模型」字段后系統將自動填充顯示名稱該字段無需手動配置。1M 配置項1M 對應的所有選項請全部勾選。3.11.3 默認兜底模型我直接選glm-5.21M 勾上3.12 完成供應商添加以上所有配置確認無誤后直接點擊右下角「添加」按鈕完成配置。五、開啟全局路由功能點擊 設置 - 路由把這兩個勾選上六、CC Switch 測試連接6.1 開啟 Claude Code 路由功能回到 CC Switch 的Claude Code配置界面。點擊這個按鈕 啟用 。會變成綠色6.2 測試API連接回到 CC Switch 的Claude Code配置界面。點擊對應供應商的「測試」按鈕。顯示「連通正常」且狀態為綠色代表接口配置無誤。七、CC Switch 將配置寫入 Claude Code我們要讓 Claude Code CLI 識別到阿里 Token Plan 的配置。在 CC Switch 的 Claude Code 面板底部點擊「啟用」按鈕會自動將配置寫入 Claude Code 的配置文件添加成功后按鈕文字會從「啟用」變成「使用中」。八、Claude Code CLI 選擇阿里 Token Plan 模型重啟終端重新啟動 Claude Code CLI讓配置生效。若 CLI 正在運行需完全退出后重新進入。8.1 查看可用模型在 Claude Code CLI 中輸入/model命令。列表中會出現我們在 CC Switch 里配置的自定義大模型。8.2 切換到 GLM-5.2在/model列表中鍵盤上下按鍵可以上下移動選擇glm-5.2對應的條目回車切換為主力模型。8.3 驗證鏈路是否打通發一句話測試你好你是誰能正常收到回復、就說明阿里 Token Plan 的鏈路已經完全打通。模型回復中自稱 Claude 屬于正常現象代理層會保留原生交互體驗以實際接口調用成功為準。九、常見問題與避坑指南9.1 配置后 /model 不顯示自定義模型確認 CC Switch 中已點擊「添加」寫入配置必須完全退出 Claude Code CLI 后重新啟動配置文件才會重新加載9.2 連接報錯 401/鑒權失敗檢查 API Key 是否復制完整有無多余空格確認 Token Plan 服務已在阿里百煉控制臺開通核對請求地址是否為 Token Plan 專屬端點不要誤用普通百煉接口十、總結與進階 整套部署核心邏輯Claude Code CLI 通過 CC Switch 本地代理轉發請求由 CC Switch 統一托管 API 密鑰并完成 Anthropic 與 Chat Completions 雙向協議轉換快速完成阿里 Token Plan 大模型對接。核心流程配置 CC Switch 供應商 → 寫入 Claude Code 配置文件 → 開啟本地路由代理 → Claude Code 綁定自定義模型 → 連通測試。十一、【 小課堂】Claude Code CLI 實用技巧Claude Code CLI 支持多會話并行你可以同時開啟多個終端會話讓它們分別處理前端、后端和測試任務互不干擾。最實用的上下文管理技巧當對話過長時可以手動開啟新會話來重置上下文大幅節省 Token 消耗。配合阿里 Token Plan 服務長上下文支持極佳寫大項目遇到復雜邏輯時隨時切換不同模型對比答案全程不用中斷工作流。十二、【 編程冷笑話】為什么 Claude Code AI Agent 不能直接找阿里 Token Plan 對接因為兩者的協議方言不一樣Claude 原生 Messages API vs 百煉 Chat Completions 端點還好有 CC Switch 當專業翻譯官不然根本聊不到一塊去。十三、【? 今日金句】AI Agent 對接大模型的核心不在于堆砌工具而在于理清協議、中轉、鑒權三者的底層邏輯懂原理才不會只會無腦抄配置。