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

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

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

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/204569e7e535716aa0f25ec6c1479bc6.png)

##  一、 为什么是“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：不用墙、不魔法、不封号的最稳姿势》https://mp.weixin.qq.com/s/HXJKj699MdBvq45EXildOg



### 2.注册大模型配置路由规则

#### Kimi（月之暗面）

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

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

#### 个人认证获得15元

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

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

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/8ea0bb85b8e12792d05caca0c99a8ab0.png)



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

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/b54de5c8868f5da0f4827b3cc8fc6d81.png)

#### 申请key

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

填写名称和项目

把apikey复制下来备用。

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/40d5e20f58cc99e1aab0ea248a385d53.png)

####  硅基流动

#### 登录注册账号

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

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

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

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

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/54f235d96a4a9aafc4361cbfca2427a7.png)



#### 申请APIkey

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



###  3、使用cc-switch

#### 添加供应商

如下图，点击加号

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/aa8576586354a095091bfeea8f0fef2e.png)

#### 选择SiliconFlow

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/93b2659672df8d401720d62342224ba7.png)

填写apikey和大模型名称

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

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

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/dcba4c757bd20a6b3fe9ab86b3786369.png)

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

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/1a898e8fe3c64dda9f9011a763d513a4.png)

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

#### 修复400报错

点击编辑通用配置

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/d817a4cd8289d170e9e4cff450bff47a.png)

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

点击保存

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/c40446742d2bd58bdbc051efc9010ba8.png)

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

## 四、 进阶调优

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

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

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

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 编程基础设施”。



### 

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

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

运维经理

人工智能

ClaudeCode+cc-switch教程：国内开发者可无缝接入Kimi、硅基流动、通义千问等国产大模型，实现低成本、高可用的AI编程工作流。含配置步骤、400报错修复、Prompt调优与避坑清单，适配终端对话式编程。

单元测试

数据合规

网络延迟

代码解释

服务器

路由器

数据流

DeepSeek

AI编程

OpenClaw

Windows

路由

Linux

MacOS

Agent

JSON

让每一个 Agent，都跑在云上

cngw

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

手把手教程：Claude Code + cc-switch，丝滑接入国产大模型-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐