编辑总结：千云网
本教程演示如何让 Codex（CLI 或桌面客户端）通过 CC Switch 切换到 DeepSeek 的 V4.1 Flash 模型。
## 一、先说清楚原理
- CC Switch 是一个开源的 AI 编程 CLI 统一管理工具，支持 Claude Code、Codex、Gemini CLI 等，用来在同一台机器上切换不同的模型供应商。
- 它通过「本地路由」拦截 Codex 发往模型供应商的请求，再改写转发到 DeepSeek，所以你不需要手动改一堆环境变量。
- DeepSeek V4.1 Flash 在官方 API 里的模型 ID 是 `deepseek-flash`（旧的 `deepseek-v4-flash` 目前仍可兼容，但已下线）。
- 除了 CC Switch，你也可以直接改 Codex 的 `config.toml` 接入 DeepSeek（见「方法二」）。
## 二、准备工作
1. 安装 Codex CLI 或 Codex 桌面客户端。
2. 下载并安装 CC Switch：
- 官方仓库：https://github.com/farion1231/cc-switch
- 官方文档：https://ccswitch.io/
3. 获取 DeepSeek API Key：
- 打开 https://platform.deepseek.com/api_keys 并登录。
- 点「创建 API Key」，填写名称后生成，格式类似 `sk-xxxxxxxxxxxxxxxx`。
- API Key 只在创建时完整显示一次，请立即保存。
## 三、方法一：用 CC Switch 图形化接入（推荐）
### 第 1 步：添加 Codex 供应商
1. 打开 CC Switch。
2. 切到顶部的 `Codex` 标签页。
3. 点右上角 `+` 新增供应商。
4. 在预设列表里选择 `DeepSeek`。
5. 在 `API Key` 输入框粘贴刚才的 `sk-...`。
6. 在「模型」处选择或填写 `deepseek-flash`（对应 V4.1 Flash）。
7. 点击「保存」。
### 第 2 步：开启本地路由
这是最容易漏掉的一步，漏掉后 Codex 会无法调用。
1. 进入 CC Switch 的「设置」。
2. 找到「本地路由」（Routing）。
3. 打开两个开关：
- 路由总开关
- `Codex` 开关
### 第 3 步：激活 DeepSeek 渠道
回到 CC Switch 主界面，在供应商列表里把刚创建的 DeepSeek 设为当前激活渠道。
### 第 4 步：重启 Codex
完全退出 Codex，再重新打开，让它重新读取本地代理配置。
完成后，Codex 的请求就会经 CC Switch 转发到 DeepSeek V4.1 Flash。
> 提示：如果你同时还需要保留 Codex 的官方登录，可在「设置 → 通用 → Codex 应用增强」里打开「第三方切换时保留官方登录」，并保持代理开启。
## 四、方法二：直接修改 Codex 的 config.toml（备用）
如果不使用 CC Switch，也可以直接让 Codex 连 DeepSeek 官方 API。
Windows 配置文件路径：
```text
C:\Users\<你的用户名>\.codex\config.toml
```
内容示例：
```toml
model = "deepseek-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "sk-你的DeepSeekAPIKey"
```
说明：
- `model = "deepseek-flash"`：指定 V4.1 Flash 模型。
- `base_url`：DeepSeek 官方接口地址，保持不变。
- `wire_api = "responses"`：DeepSeek V4 原生支持 Responses API，适配 Codex。
- `experimental_bearer_token`：直接填入 API Key；也可以用 `env_key = "DEEPSEEK_API_KEY"` 改成从环境变量读取。
保存后重启 Codex。
## 五、验证是否成功
打开 Codex 后随便让它回答一句，或检查当前模型：
```text
你当前使用的模型是 deepseek-flash
```
能正常回复就说明接入成功。若想进一步确认，可查看 CC Switch 的日志/路由记录是否有 DeepSeek 请求。
## 六、常见问题
- **提示 API Key 无效**：检查是否复制完整、是否多了空格、Key 是否已删除；建议重新创建一个测试。
- **Codex 没有响应**：优先检查 CC Switch「设置 → 本地路由」里路由总开关和 Codex 开关是否都打开。
- **Codex 里不显示 deepseek 模型名**：在 CC Switch「设置 → 通用 → Codex 应用增强」里开启「非接管切换时保留官方登录」并使用代理，然后重启 Codex。
- **推理强度只能选「高」**：这是模型目录（model catalog）限制，可按 DeepSeek 官方文档配置 `models.json` 和 `config.toml` 扩展选项。
- **配置完仍连不上**：尝试「切换渠道 → 保存 → 重启 CC Switch → 重启 Codex」的组合，多数情况可恢复。
## 七、参考链接
- DeepSeek 接入 Codex 官方文档：https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/codex/
- CC Switch 官方教程（Codex + DeepSeek 路由）：https://ccswitch.io/zh/tutorials/codex-deepseek-routing-guide
- CC Switch GitHub 仓库：https://github.com/farion1231/cc-switch
游客楼主