Claude Code 作为官方终端编程助手，凭借其强大的上下文理解与文件操作能力迅速出圈。但受限于网络延迟、API成本与数据合规要求，不少国内开发者望而却步。
本文通过 cc-switch 这一轻量级 API 路由工具，演示如何将 Claude Code 的请求无缝转发至国产大模型（如kimi、硅基流动、通义千问、DeepSeek等），在保留终端交互体验的同时，实现低成本、高可用、合规可控的 AI 编程工作流。

 一、 为什么是“Claude Code + cc-switch + 国产模型”？



Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，它能理解你的整个项目、直接修改代码、执行开发任务，让开发者在终端里用自然语言"对话式编程"。
cc-switch (Claude Code Switch) 是一款 跨平台桌面图形工具，专为 Claude Code 等 AI 命令行助手设计，核心作用是 一键切换、统一管理不同大模型服务商（含国内模型）的 API 配置。
cc-switch 本质上是一个协议转换层 + 智能路由器，运行在本地或内网服务器。其数据流如下：
 Claude Code (终端) 
 ↓ 发起 Anthropic 格式请求 (POST /v1/messages)
cc-switch (监听 127.0.0.1:8899)
 ├─ 1. 解析请求头与 Body
 ├─ 2. 匹配 config.yaml 中的路由规则 (model_pattern / 路径 / 标签)
 ├─ 3. 协议转换：Anthropic 消息结构 → 目标模型兼容格式 (OpenAI/国产专属)
 ├─ 4. 替换鉴权 Key、注入自定义 System Prompt、处理流式分块
 ├─ 5. 转发至国内 API 网关
 └─ 6. 接收响应 → 逆向转换 → 返回 Claude Code 期望的 SSE/JSON 格式






















cc-switch 不仅可以
二、 实操指南
注：以下流程基于 macOS/Linux 环境，Windows 用户可使用 WSL2 或 PowerShell 适配。
1.安装 Claude Code 与 cc-switch
可以看星哥之前写的文章：《零门槛上手 Claude Code：不用墙、不魔法、不封号的最稳姿势》
2.注册大模型配置路由规则 Kimi（月之暗面）
https://platform.moonshot.cn/console/account
 
 
  
    
    
 
     
 
    
 • 新用户注册直接送 15 元免费额度
 • 长文本、代码能力强，适配 OpenClaw 推理任务
 • 国内可直接注册， （实测不用提交个人信息）
个人认证获得15元
https://platform.moonshot.cn/console/auth
点击组织认证，再点个人认证（星哥认证的时候，不需要个人信息，不确定您看到的时候是否需要）

再点账户总览，有15元的赠送金额。

 申请key



如下图，点击 API Key管理，新建API Key
填写名称和项目
把apikey复制下来备用。

 硅基流动 登录注册账号



https://cloud.siliconflow.cn/i/kYj0toCC
 
 
  
    
    
 
     
 
    
 • 完成实名认证，赠送 16 元体验金
 • 模型多、响应快，专门适配 AI Agent 场景
 • 接入简单，国内网络稳定
 • 需要提交实名信息
硅基流动，注册实名之后有16元代金券
二、活动内容 所有用户（含新注册与既有用户），在注册后首次完成有效实名认证，即可获得面值 ¥16 的「认证奖励券」 1 张。

 申请APIkey



https://cloud.siliconflow.cn/me/account/ak
3、使用cc-switch 添加供应商
如下图，点击加号

 选择SiliconFlow 



填写apikey和大模型名称
大模型名称可以在硅基流动官网选择
大模型我填写：Pro/moonshotai/Kimi-K2.5

报错：Claude Code 400 thinking type should be enabled or disabled

新版 Claude Code（v2.1.97 及以上）默认会发送 thinking:{type:"adaptive"} 参数，但你用的第三方 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"
 }
}




























点击保存

此时终端内的所有请求将经由本地代理路由至国内模型，响应速度通常可稳定在 1~3 秒内。
四、 进阶调优
国产模型虽强，但直接替换原版 Claude 仍可能遇到“水土不服”。以下三点经验能显著提升可用性：
 
 
  
    
    
 
     
 
    
 1. Prompt 适配 ：Claude Code 依赖特定的系统提示词结构。在 cc-switch 中开启 prompt_inject 功能，追加如下规则可大幅提升代码生成准确率：
 system_prompt_suffix: |
 - 始终使用中文注释，优先输出可运行的完整代码块
 - 遇到文件修改时，严格遵循 




 
…
 
 格式输出
 - 不输出与代码无关的解释性文字

 2. 流式响应优化 ：部分国内网关默认关闭 SSE 长连接。在 cc-switch 配置中启用 streaming: true 与 chunk_buffer: 4096 ，可避免终端卡顿与断流。
 3. 上下文窗口管理 ：Claude Code 默认携带项目文件树。国产模型对超长上下文的处理策略不同，建议在 ~/.claude/settings.json 中设置 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 专项版本
 终端频繁断连
 网关超时设置过短或网络抖动
 在 cc-switch 调高 timeout: 120s ，开启 keep_alive 连接池
 计费异常飙升
 未限制重试次数或路由死循环
 配置 retry_limit: 3 ，定期检查 cc-switch 日志中的请求命中率
打完收工、Claude Code 搭配 cc-switch 调用国内大模型，是一种兼顾体验、效率与安全的实用方案。
建议开发者在实际项目中先从小模块重构或单元测试生成入手，逐步建立提示词模板与路由策略，最终沉淀出属于自己的“AI 编程基础设施”。