CC Switch 分两大使用场景：Claude Code（Anthropic 协议）、Codex（OpenAI 兼容协议），两种开启思考模式的方法完全不同，下面分开说明。

一、前置准备

1. 安装 CC Switch：npm install -g cc-switch
2. 获取 DeepSeek API Key：platform.deepseek.com/api_keys
3. 打开 CC Switch 图形界面，先新建 DeepSeek 供应商

场景1：Claude Code（Anthropic 接口，最常用）

1. 基础供应商配置（Claude 标签页）

• Base URL：https://api.deepseek.com/anthropic
• 认证类型：ANTHROPIC_AUTH_TOKEN
• API 格式：Anthropic Message（原生）
• API Key：填入你的 DeepSeek sk-密钥
• 模型填写（带[thinking]后缀强制开启思考）：
  • 深度推理：deepseek-v4-pro[thinking] / deepseek-v4-pro[1m][thinking]（百万上下文+思考）
  • 轻量快速：deepseek-v4-flash（不推荐加thinking，速度慢）

2. 全局强制开启思考（环境变量方案，兜底）

进入供应商配置的环境变量 env 区域，新增：

CLAUDE_CODE_ENABLE_THINKING_MODE = true

作用：强制请求携带 thinking 推理字段，解决接口报错「缺少content[].thinking」

3. 开启本地路由（必须）

1. 顶部切换到「设置-路由」

2. 打开路由总开关（本地袋里 127.0.0.1:15721）
3. 路由启用勾选「Claude」
4. 返回供应商列表，点击「启用」DeepSeek，重启 VS Code / Claude Code

场景2：Codex CLI（OpenAI /chat/completions 兼容接口）

1. Codex 供应商基础配置

切换顶部「Codex」标签 → +新增 → 选择内置预设 DeepSeek

• Base URL：https://api.deepseek.com/v1
• API Key：DeepSeek sk密钥
• 勾选两个兼容开关：需要本地路由映射、兼容/chat/completions

2. 两种开启思考模式方式（二选一）

方式A：模型后缀一键开启（最简单）

模型名称直接写：

deepseek-reasoner# 或普通chat模型带标记deepseek-chat[thinking]

deepseek-reasoner 是 DeepSeek 原生深度思考专用模型，默认强制输出推理过程 reasoning_content

方式B：extra_body 参数全局注入（所有模型生效）

1. 编辑 CC Switch 供应商「高级参数/额外请求体」
2. 在 extra_body 填入固定JSON：

{"thinking": {"type": "enabled"}}

原理：OpenAI兼容接口必须把思考参数放在 extra_body 中传递给 DeepSeek 后端，CC Switch 会自动附加到每一条请求里，不用改模型名

三、通用校验 & 排错

验证是否生效

1. 执行 cc-switch status 查看路由、供应商启用状态
2. 发起复杂代码/数学问题，返回内容会出现两段：
   • reasoning_content：模型内部思考过程
   • content：最终答案
3. 日志开启：设置里打开「启用日志记录」，查看请求体是否携带 thinking 字段

常见报错解决

1. 400 缺少 thinking 字段
   • Claude：添加环境变量 CLAUDE_CODE_ENABLE_THINKING_MODE=true + 模型加[thinking]
   • Codex：在extra_body注入{"thinking":{"type":"enabled"}}
2. 路由不转发、模型加载失败
   • 确认路由总开关打开、对应客户端(Claude/Codex)路由勾选
   • 保存供应商配置后重启终端/IDE
3. 思考模式无推理输出
   • 模型必须带[thinking]后缀 / 使用deepseek-reasoner
   • 不要使用flash轻量模型跑深度推理

四、配置文件手动写法（~/.cc-switch/config.json）

不想用图形界面可直接修改配置，核心片段示例：

{"providers": [{"name": "DeepSeek-Claude","type": "anthropic","baseUrl": "https://api.deepseek.com/anthropic","apiKey": "sk-xxx","models": ["deepseek-v4-pro[1m][thinking]"],"env": {"CLAUDE_CODE_ENABLE_THINKING_MODE": "true"}},{"name": "DeepSeek-Codex","type": "openai","baseUrl": "https://api.deepseek.com/v1","apiKey": "sk-xxx","models": ["deepseek-reasoner"],"extraBody": {"thinking": {"type": "enabled"}}}]}