手把手教程：Claude Code + cc-switch，丝滑接入国产大模型

2次阅读

共计 2904 个字符，预计需要花费 8 分钟才能阅读完成。

Claude Code 作为官方终端编程助手，凭借其强大的上下文理解与文件操作能力迅速出圈。但受限于网络延迟、API 成本与数据合规要求，不少国内开发者望而却步。

本文通过 cc-switch 这一轻量级 API 路由工具，演示如何将 Claude Code 的请求无缝转发至国产大模型（如 kimi、硅基流动、通义千问、DeepSeek 等），在保留终端交互体验的同时，实现低成本、高可用、合规可控的 AI 编程工作流。

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 适配。

可以看星哥之前写的文章：《零门槛上手 Claude Code：不用墙、不魔法、不封号的最稳姿势》https://mp.weixin.qq.com/s/HXJKj699MdBvq45EXildOg

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

新用户注册直接送 15 元免费额度
长文本、代码能力强，适配 OpenClaw 推理任务
国内可直接注册，（实测不用提交个人信息）

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

点击组织认证，再点个人认证（星哥认证的时候，不需要个人信息，不确定您看到的时候是否需要）

手把手教程：Claude Code + cc-switch，丝滑接入国产大模型

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

手把手教程：Claude Code + cc-switch，丝滑接入国产大模型

如下图，点击 API Key 管理，新建 API Key

填写名称和项目

把 apikey 复制下来备用。

手把手教程：Claude Code + cc-switch，丝滑接入国产大模型

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

完成实名认证，赠送 16 元体验金
模型多、响应快，专门适配 AI Agent 场景
接入简单，国内网络稳定
需要提交实名信息

硅基流动，注册实名之后有 16 元代金券

二、活动内容所有用户（含新注册与既有用户），在注册后首次完成有效实名认证，即可获得面值 ¥16 的「认证奖励券」1 张。

手把手教程：Claude Code + cc-switch，丝滑接入国产大模型

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

如下图，点击加号

手把手教程：Claude Code + cc-switch，丝滑接入国产大模型

填写 apikey 和大模型名称

大模型名称可以再硅基流动官网选择

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

手把手教程：Claude Code + cc-switch，丝滑接入国产大模型

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

手把手教程：Claude Code + cc-switch，丝滑接入国产大模型

新版 Claude Code（v2.1.97 及以上）默认会发送 thinking:{type:”adaptive”} 参数，但你用的第三方 API / 代理（比如 CC-Switch、硅基流动、Kimi 等）不支持 adaptive 类型，只认 enabled 或 disabled，因此返回 400 错误。

点击编辑通用配置

手把手教程：Claude Code + cc-switch，丝滑接入国产大模型

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

点击保存

手把手教程：Claude Code + cc-switch，丝滑接入国产大模型

此时终端内的所有请求将经由本地代理路由至国内模型，响应速度通常可稳定在 1~3 秒内。

国产模型虽强，但直接替换原版 Claude 仍可能遇到“水土不服”。以下三点经验能显著提升可用性：

Prompt 适配：Claude Code 依赖特定的系统提示词结构。在 cc-switch 中开启 prompt_inject 功能，追加如下规则可大幅提升代码生成准确率：

system_prompt_suffix: |
  - 始终使用中文注释，优先输出可运行的完整代码块
  - 遇到文件修改时，严格遵循 <path>...</path> 格式输出
  - 不输出与代码无关的解释性文字

流式响应优化：部分国内网关默认关闭 SSE 长连接。在 cc-switch 配置中启用 streaming: true 与 chunk_buffer: 4096，可避免终端卡顿与断流。
上下文窗口管理：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` 日志中的请求命中率