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

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

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

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

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

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

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

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

cc-switch 不僅可以

二、 實操指南

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

1.安裝 Claude Code 與 cc-switch

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

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

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

• ? 新用戶注冊直接送 15 元免費額度

• ? 長文本、代碼能力強，適配 OpenClaw 推理任務

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

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

點擊組織認證，再點個人認證（星哥認證的時候，不需要個人信息，不確定您看到的時候是否需要）

再點賬戶總覽，有15元的贈送金額。

申請key

如下圖，點擊 API Key管理，新建API Key

填寫名稱和項目

把apikey復制下來備用。

硅基流動 登錄注冊賬號

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

• ? 完成實名認證，贈送 16 元體驗金

• ? 模型多、響應快，專門適配 AI Agent 場景

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

• ? 需要提交實名信息

硅基流動，注冊實名之后有16元代金券

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

申請APIkey

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

3、使用cc-switch 添加供應商

如下圖，點擊加號

選擇SiliconFlow

填寫apikey和大模型名稱

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

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

報錯：Claude Code 400 thinking type should be enabled or disabled

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

修復400報錯

點擊編輯通用配置

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

點擊保存

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

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

國產(chǎn)模型雖強，但直接替換原版 Claude 仍可能遇到“水土不服”。以下三點經(jīng)驗能顯著提升可用性：

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

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

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

3. 3. 上下文窗口管理 ：Claude Code 默認攜帶項目文件樹。國產(chǎn)模型對超長上下文的處理策略不同，建議在 ~/.claude/settings.json 中設(shè)置 max_context_tokens: 8192 ，并在 cc-switch 啟用 context_truncate 策略，防止 OOM 或響應截斷。

常見問題

原因分析

解決建議

返回 401 Unauthorized

API Key 未正確映射或格式校驗失敗

檢查 cc-switch 路由中的 api_key 字段，確保目標服務商支持兼容模式

代碼塊不閉合/格式錯亂

模型未識別 Claude Code 的標記語法

在 system_prompt_suffix 中強化格式約束，或切換至 qwen-coder / deepseek-coder 專項版本

終端頻繁斷連

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

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

計費異常飆升

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

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

結(jié)語

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

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