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