手把手教程：Claude Code + cc-switch，絲滑接入國(guó)產(chǎn)大模型

Claude Code 作為官方終端編程助手，憑借其強(qiáng)大的上下文理解與文件操作能力迅速出圈。但受限于網(wǎng)絡(luò)延遲、API成本與數(shù)據(jù)合規(guī)要求，不少國(guó)內(nèi)開發(fā)者望而卻步。

本文通過 cc-switch 這一輕量級(jí) API 路由工具，演示如何將 Claude Code 的請(qǐng)求無縫轉(zhuǎn)發(fā)至國(guó)產(chǎn)大模型（如kimi、硅基流動(dòng)、通義千問、DeepSeek等），在保留終端交互體驗(yàn)的同時(shí)，實(shí)現(xiàn)低成本、高可用、合規(guī)可控的 AI 編程工作流。

一、 為什么是“Claude Code + cc-switch + 國(guó)產(chǎn)模型”？

Claude Code 是 Anthropic 官方推出的命令行 AI 編程助手，它能理解你的整個(gè)項(xiàng)目、直接修改代碼、執(zhí)行開發(fā)任務(wù)，讓開發(fā)者在終端里用自然語(yǔ)言"對(duì)話式編程"。

cc-switch (Claude Code Switch) 是一款 跨平臺(tái)桌面圖形工具，專為 Claude Code 等 AI 命令行助手設(shè)計(jì)，核心作用是 一鍵切換、統(tǒng)一管理不同大模型服務(wù)商（含國(guó)內(nèi)模型）的 API 配置。

cc-switch 本質(zhì)上是一個(gè)協(xié)議轉(zhuǎn)換層 + 智能路由器，運(yùn)行在本地或內(nèi)網(wǎng)服務(wù)器。其數(shù)據(jù)流如下：

                                                           Claude Code (終端) 
   ↓ 發(fā)起 Anthropic 格式請(qǐng)求 (POST /v1/messages)
cc-switch (監(jiān)聽 127.0.0.1:8899)
   ├─ 1. 解析請(qǐng)求頭與 Body
   ├─ 2. 匹配 config.yaml 中的路由規(guī)則 (model_pattern / 路徑 / 標(biāo)簽)
   ├─ 3. 協(xié)議轉(zhuǎn)換：Anthropic 消息結(jié)構(gòu) → 目標(biāo)模型兼容格式 (OpenAI/國(guó)產(chǎn)專屬)
   ├─ 4. 替換鑒權(quán) Key、注入自定義 System Prompt、處理流式分塊
   ├─ 5. 轉(zhuǎn)發(fā)至國(guó)內(nèi) API 網(wǎng)關(guān)
   └─ 6. 接收響應(yīng) → 逆向轉(zhuǎn)換 → 返回 Claude Code 期望的 SSE/JSON 格式

cc-switch 不僅可以

二、 實(shí)操指南

注：以下流程基于 macOS/Linux 環(huán)境，Windows 用戶可使用 WSL2 或 PowerShell 適配。

1.安裝 Claude Code 與 cc-switch

可以看星哥之前寫的文章：《零門檻上手 Claude Code：不用墻、不魔法、不封號(hào)的最穩(wěn)姿勢(shì)》

2.注冊(cè)大模型配置路由規(guī)則 Kimi（月之暗面）

https://platform.moonshot.cn/console/account

• ? 新用戶注冊(cè)直接送 15 元免費(fèi)額度

• ? 長(zhǎng)文本、代碼能力強(qiáng)，適配 OpenClaw 推理任務(wù)

• ? 國(guó)內(nèi)可直接注冊(cè)， （實(shí)測(cè)不用提交個(gè)人信息）

https://platform.moonshot.cn/console/auth

點(diǎn)擊組織認(rèn)證，再點(diǎn)個(gè)人認(rèn)證（星哥認(rèn)證的時(shí)候，不需要個(gè)人信息，不確定您看到的時(shí)候是否需要）

再點(diǎn)賬戶總覽，有15元的贈(zèng)送金額。

申請(qǐng)key

如下圖，點(diǎn)擊 API Key管理，新建API Key

填寫名稱和項(xiàng)目

把a(bǔ)pikey復(fù)制下來備用。

硅基流動(dòng) 登錄注冊(cè)賬號(hào)

https://cloud.siliconflow.cn/i/kYj0toCC

• ? 完成實(shí)名認(rèn)證，贈(zèng)送 16 元體驗(yàn)金

• ? 模型多、響應(yīng)快，專門適配 AI Agent 場(chǎng)景

• ? 接入簡(jiǎn)單，國(guó)內(nèi)網(wǎng)絡(luò)穩(wěn)定

• ? 需要提交實(shí)名信息

硅基流動(dòng)，注冊(cè)實(shí)名之后有16元代金券

二、活動(dòng)內(nèi)容 所有用戶（含新注冊(cè)與既有用戶），在注冊(cè)后首次完成有效實(shí)名認(rèn)證，即可獲得面值 ￥16 的「認(rèn)證獎(jiǎng)勵(lì)券」 1 張。

申請(qǐng)APIkey

https://cloud.siliconflow.cn/me/account/ak

3、使用cc-switch 添加供應(yīng)商

如下圖，點(diǎn)擊加號(hào)

選擇SiliconFlow

填寫apikey和大模型名稱

大模型名稱可以在硅基流動(dòng)官網(wǎng)選擇

大模型我填寫：Pro/moonshotai/Kimi-K2.5

報(bào)錯(cuò)：Claude Code 400 thinking type should be enabled or disabled

新版 Claude Code（v2.1.97 及以上）默認(rèn)會(huì)發(fā)送 thinking:{type:"adaptive"} 參數(shù)，但你用的第三方 API / 代理（比如 CC-Switch、硅基流動(dòng)、Kimi 等）不支持 adaptive 類型，只認(rèn) enabled 或 disabled，因此返回 400 錯(cuò)誤。

修復(fù)400報(bào)錯(cuò)

點(diǎn)擊編輯通用配置

                                                           {
  "autoUpdatesChannel": "latest",
  "enabledPlugins": {
    "document-skills@anthropic-agent-skills": false
  },
  "skipDangerousModePermissionPrompt": true,
  "effortLevel": "high",
  "env": {
    "claude_code_disable_adaptive_thinking": "1"
  }
}

點(diǎn)擊保存

此時(shí)終端內(nèi)的所有請(qǐng)求將經(jīng)由本地代理路由至國(guó)內(nèi)模型，響應(yīng)速度通?？煞€(wěn)定在 1~3 秒內(nèi)。

四、 進(jìn)階調(diào)優(yōu)

國(guó)產(chǎn)模型雖強(qiáng)，但直接替換原版 Claude 仍可能遇到“水土不服”。以下三點(diǎn)經(jīng)驗(yàn)?zāi)茱@著提升可用性：

1. 1. Prompt 適配 ：Claude Code 依賴特定的系統(tǒng)提示詞結(jié)構(gòu)。在 cc-switch 中開啟 prompt_inject 功能，追加如下規(guī)則可大幅提升代碼生成準(zhǔn)確率：

                                                                                         system_prompt_suffix: |
     - 始終使用中文注釋，優(yōu)先輸出可運(yùn)行的完整代碼塊
     - 遇到文件修改時(shí)，嚴(yán)格遵循 
                           
    ... 
                格式輸出
     - 不輸出與代碼無關(guān)的解釋性文字

2. 2. 流式響應(yīng)優(yōu)化 ：部分國(guó)內(nèi)網(wǎng)關(guān)默認(rèn)關(guān)閉 SSE 長(zhǎng)連接。在 cc-switch 配置中啟用 streaming: true 與 chunk_buffer: 4096 ，可避免終端卡頓與斷流。

3. 3. 上下文窗口管理 ：Claude Code 默認(rèn)攜帶項(xiàng)目文件樹。國(guó)產(chǎn)模型對(duì)超長(zhǎng)上下文的處理策略不同，建議在 ~/.claude/settings.json 中設(shè)置 max_context_tokens: 8192 ，并在 cc-switch 啟用 context_truncate 策略，防止 OOM 或響應(yīng)截?cái)唷?/p>

常見問題

原因分析

解決建議

返回 401 Unauthorized

API Key 未正確映射或格式校驗(yàn)失敗

檢查 cc-switch 路由中的 api_key 字段，確保目標(biāo)服務(wù)商支持兼容模式

代碼塊不閉合/格式錯(cuò)亂

模型未識(shí)別 Claude Code 的標(biāo)記語(yǔ)法

在 system_prompt_suffix 中強(qiáng)化格式約束，或切換至 qwen-coder / deepseek-coder 專項(xiàng)版本

終端頻繁斷連

網(wǎng)關(guān)超時(shí)設(shè)置過短或網(wǎng)絡(luò)抖動(dòng)

在 cc-switch 調(diào)高 timeout: 120s ，開啟 keep_alive 連接池

計(jì)費(fèi)異常飆升

未限制重試次數(shù)或路由死循環(huán)

配置 retry_limit: 3 ，定期檢查 cc-switch 日志中的請(qǐng)求命中率

結(jié)語(yǔ)

打完收工、Claude Code 搭配 cc-switch 調(diào)用國(guó)內(nèi)大模型，是一種兼顧體驗(yàn)、效率與安全的實(shí)用方案。

建議開發(fā)者在實(shí)際項(xiàng)目中先從小模塊重構(gòu)或單元測(cè)試生成入手，逐步建立提示詞模板與路由策略，最終沉淀出屬于自己的“AI 編程基礎(chǔ)設(shè)施”。