### [在 Codex 中接入 DeepSeek 模型：使用 CC Switch](https://blog.cikcc.com/article/616)

**Published:** 2026-10-10T10:58:01

**Author:** Allen

**Excerpt:** 使用 CC Switch 为 Codex 配置 DeepSeek 的详细图文教程：GitHub 下载、配置备份…

不想反复打开配置文件，也不想每次换模型都从头排错？这篇教程用 CC Switch 管理 Codex 的模型提供方，带你从 GitHub 下载软件、添加 DeepSeek，到重启、验证与恢复。重点是把“已经保存”“已经切换”和“真正发出请求”分开确认。

> **先选对路线：** 当前 CC Switch 的 DeepSeek 官方预设使用原生 Responses 直连。不要因为看到旧教程，就默认打开本地路由。保留了 Chat 格式的旧供应商，才需要迁移或继续使用路由。

资料核对日期：2026 年 10 月 10 日。GitHub 当前最新发行版为 CC Switch `v4.0.7`；以后更新请以 官方 Releases（见本文下载列表） 为准。本文主要面向本地 Codex CLI，同时说明桌面端注意事项，不把本机配置自动套用到云任务。

本文为资料核对后的操作教程，未使用真实 DeepSeek API Key 完成付费端到端实测。正文配图均为原创操作示意图，不是实际软件界面；按钮名称和位置请以你安装版本为准。

## 先认识 CC Switch：它管理模型配置，不是模型本身

[CC Switch 官方 GitHub 仓库](https://github.com/farion1231/cc-switch) 是本教程的软件来源。它可以管理包括 Codex 在内的客户端配置。这里采用最简单的单供应商直连，不展开多供应商聚合或自动故障转移。

要区分三件事：Codex 是执行工作流的客户端，DeepSeek 是提供推理接口的服务，CC Switch 是管理连接配置的工具。安装 CC Switch 不等于免费获得 DeepSeek API，也不等于把 ChatGPT 网页模型替换成 DeepSeek。

这不是添加 MCP。MCP 管理工具与数据访问；模型提供方管理请求根地址、协议、认证和模型。已有的 MCP 不需要因为换模型就全部删除重建。OpenAI 对提供方的说明见 [Codex 自定义模型提供方文档](https://developers.openai.com/codex/config-advanced/)。

![图 1：DeepSeek 原生直连与旧 Chat 配置的两种路线](https://heo.cikcc.com/wp-content/uploads/2026/10/cc-switch-deepseek-01-modes.png)

图 1：DeepSeek 原生直连与旧 Chat 配置的两种路线（原创操作示意图，非软件截图）

## 步骤 1：从 GitHub 下载并安装 CC Switch

1.  打开 [farion1231/cc-switch](https://github.com/farion1231/cc-switch)，确认仓库所有者和项目名称；避免同名项目、广告下载页或来源不明的二次打包。
2.  进入 Releases 最新版本（见本文下载列表），展开 Assets。先下载与你的系统对应的安装包，不要把 Source code 当作已编译安装程序。
3.  macOS 选择 `macOS.dmg`；Windows 选择适合架构的 `.msi` 或 Portable 包；Linux 选择合适架构的 AppImage、deb 或 rpm。
4.  安装并启动。macOS 使用 DMG 安装时，按窗口指引把 App 放入应用程序；若被系统拦截，先核对文件来源及发布说明，再按系统提供的批准方式处理。

> **下载提醒：** 正式下载入口已同时放入本文的瓜奇下载模块。链接指向 GitHub 最新发行版；版本会更新，本文不锁死一个过期安装包。

不要为了打开软件而全局关闭 Gatekeeper、防病毒软件或其他系统保护。遇到签名或兼容提示，应检查发行说明，而不是复制来源不明的“一键解除安全限制”命令。

## 步骤 2：准备 Codex 和 DeepSeek API Key

没有安装 Codex CLI 时，从 [OpenAI 官方入门说明](https://developers.openai.com/codex/quickstart/) 安装对应客户端。已有 CLI 则先查看版本：

```
codex --version
codex --help
```

CC Switch 当前接入说明中的 DeepSeek 官方模型目录要求 Codex CLI 至少为 `0.144.0`。如果版本更旧，先按官方说明升级再继续。已安装桌面应用不代表终端里的 CLI 也已安装或升级。

前往 [DeepSeek 开放平台](https://platform.deepseek.com/)，在 API Key 管理中创建独立密钥，核对可用额度。给它起一个能识别用途的名字，例如“Codex 本机”；实际控制台入口以平台当前界面为准。

-   准备 API Key，不要使用账户登录密码。
-   只在本机 CC Switch 的密钥字段中输入；截图前保持隐藏。
-   先用小请求核对用量，确认费用归属后再打开真实项目。
-   不向文章、聊天、日志、Git 仓库或公开备份提交密钥。

> **安全边界：** 输入框显示圆点只是隐藏显示，不等于凭据已加密保存。CC Switch、Codex 配置及导出备份均应按可能含凭据的私密文件处理。

## 步骤 3：备份配置，记录原来的工作状态

先结束相关任务并退出 Codex。记录原来使用的供应商、模型与关键 MCP；如果已经在使用 CC Switch，也保留它的配置备份。下面只做复制，不重写或删除配置。

macOS / Linux：默认目录为 `~/.codex`，自定义 `CODEX_HOME` 时以实际目录为准。

```
cc_codex_dir="${CODEX_HOME:-$HOME/.codex}"
cc_backup_dir="$cc_codex_dir/backup-before-cc-switch-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$cc_backup_dir"
for cc_file in config.toml auth.json models.json cc-switch-model-catalog.json; do
  if [ -f "$cc_codex_dir/$cc_file" ]; then
    cp -p "$cc_codex_dir/$cc_file" "$cc_backup_dir/$cc_file"
  fi
done
echo "备份目录：$cc_backup_dir"
```

Windows PowerShell：

```
$ccCodexDir = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE '.codex' }
$ccBackupDir = Join-Path $ccCodexDir ('backup-before-cc-switch-' + (Get-Date -Format 'yyyyMMdd-HHmmss'))
New-Item -ItemType Directory -Path $ccBackupDir -Force | Out-Null
foreach ($ccFile in @('config.toml', 'auth.json', 'models.json', 'cc-switch-model-catalog.json')) {
  $ccSource = Join-Path $ccCodexDir $ccFile
  if (Test-Path $ccSource) { Copy-Item $ccSource -Destination $ccBackupDir }
}
Write-Host "备份目录：$ccBackupDir"
```

把输出的备份目录记下来。不要将 `auth.json`、完整 `config.toml` 或 CC Switch 数据导出文件上传到公开仓库。它们可能包含登录状态、接口凭据或其他私密配置。

## 步骤 4：在 Codex 下添加 DeepSeek 官方预设

![图 2：添加 DeepSeek 供应商时要检查的六项内容](https://heo.cikcc.com/wp-content/uploads/2026/10/cc-switch-deepseek-02-checklist.png)

图 2：添加 DeepSeek 供应商时要检查的六项内容（原创操作示意图，非软件截图）

1.  在 CC Switch 中选中 `Codex` 应用。4.x 通常从侧栏选应用；旧版本可能在顶部标签中选择。不要停留在 Claude、Gemini 或 MCP 面板。
2.  进入直连页，再点击“添加供应商”（加号）。当前 4.x 添加页先选预设，再填信息。
3.  搜索 `DeepSeek`，选择官方 API 预设，不要误选第三方平台上的同名模型服务。
4.  填写自己的 API Key；可把名称改为“DeepSeek · Codex”，备注写“官方直连”，便于以后辨认。
5.  核对请求根地址为 `https://api.deepseek.com`，上游格式为原生 `Responses`。不要自行在根地址后追加 `/responses` 或 `/chat/completions`。
6.  保留预设提供的模型和能力配置，完成后点击“添加”或“保存”。

当前官方 Codex 集成包括 `deepseek-flash` 和 `deepseek-v4-pro`。建议第一次先保留预设默认模型 `deepseek-flash`，完成短请求验证后再按需求调整。模型 ID 以 [DeepSeek 官方 Codex 指南](https://api-docs.deepseek.com/quick_start/agent_integrations/codex/) 和应用当前预设为准。

不要照搬几个月前的模型别名，也不要把另一家平台的同名模型 ID 当作官方 API 的模型 ID。模型能否显示、是否接受图片、支持哪些工具，取决于所选模型目录和客户端，不应只看营销名称。

添加页中的配置编辑区可能包含全局设置。首次接入只动必要的模型、端点和密钥字段；不要顺手改 MCP、项目权限或整个配置文件。更多字段说明见 [官方添加供应商手册](https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/2-providers/2.1-add.md)。

## 步骤 5：真正切换供应商，然后重启 Codex

1.  返回 Codex 供应商列表，确认刚添加的 DeepSeek 卡片存在。
2.  确认直连是当前生效模式，再点击 DeepSeek 卡片的“切换”。保存卡片不等于切换供应商；只点直连/路由标签也不等于改变生效模式。
3.  查看卡片是否显示“使用中”等当前状态。如原先处于路由模式，按界面说明选择“回到直连并使用”，不要只关闭本地服务而留下旧地址。
4.  CLI 退出当前进程再重新运行 `codex`。macOS 桌面端用 Command + Q 完全退出后重开；关闭一个窗口可能并没有退出后台进程。
5.  新建本地会话再验证。旧会话可能保留创建时的供应商信息，不适合作为首次切换的唯一验收依据。

切换和重启行为以 [官方切换供应商手册](https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/2-providers/2.2-switch.md) 为准。4.0.7 发布说明也提醒：直连与路由互换后，已运行的 Codex 可能还在使用启动时读到的模型目录，因此需要重启。

> **桌面端注意：** 桌面端模型选择器不一定与 CLI 的 /model 完全一致。先确认 CLI 配置加载，再检查桌面应用版本、配置路径和官方登录状态。不能仅凭桌面下拉菜单缺少一个名称，就断定 API 配置失败。

若桌面端无法列出自定义模型，阅读 [CC Switch 的桌面模型可见性说明](https://github.com/farion1231/cc-switch/blob/main/docs/guides/codex-desktop-custom-model-visibility-zh.md)。不要反复覆盖配置或清空官方登录文件来试错。

## 步骤 6：用三层检查确认接入，而不是只看能启动

![图 3：配置加载、实际请求和工具执行的三层验收](https://heo.cikcc.com/wp-content/uploads/2026/10/cc-switch-deepseek-03-verify.png)

图 3：配置加载、实际请求和工具执行的三层验收（原创操作示意图，非软件截图）

### 第一层：确认配置加载

在新 CLI 会话输入 `/model`，核对所选模型是否为刚配置的 DeepSeek 模型。若仍显示旧模型，先退出重开，检查 CC Switch 当前卡片和配置目录，不要用模型自我介绍代替配置检查。

### 第二层：发送最小请求

```
请用一句话解释什么是 Git 分支。不要执行命令，不要修改文件。
```

检查是否得到完整回复、是否发生接口错误；再到 DeepSeek 控制台查看实际 API 用量。短请求也可能包含客户端系统指令等额外 token，因此输出短不代表费用只按这一句话计算。控制台统计可能延迟，不要求立即出现单独一条记录。

直连请求不经过 CC Switch 本地路由，不能要求“路由请求数必须增长”作为成功条件。CC Switch 的会话导入统计与供应商账单也不是同一份数据；对账以提供方控制台为主。

### 第三层：只在临时目录验证文件工具

macOS / Linux 可创建一个全新的测试目录：

```
cc_test_dir="$(mktemp -d)"
cd "$cc_test_dir"
codex
```

Windows PowerShell：

```
$ccTestDir = Join-Path ([System.IO.Path]::GetTempPath()) ('codex-cc-switch-test-' + [guid]::NewGuid())
New-Item -ItemType Directory -Path $ccTestDir | Out-Null
Set-Location $ccTestDir
codex
```

发送以下任务，并按客户端提示人工批准必要操作：

```
请创建 hello.txt，内容为 Hello DeepSeek。读取该文件并确认内容，再把它修改为 Hello Codex + DeepSeek。不要联网、不要访问其他目录、不要删除文件。
```

验收时亲自检查文件是否存在、内容是否正确、补丁是否真的应用。回答“已完成”不等于工具调用成功。出现重复调用、补丁报错或流式中断时，先保留错误摘要，停止扩大任务；不要通过关闭沙箱和审批来掩盖兼容性问题。

## 步骤 7：旧 DeepSeek 卡片提示“需要路由”怎么办

升级 CC Switch 不会自动改写已保存卡片的协议。旧 DeepSeek 卡片可能仍是 Chat 格式。当前官方 Responses 预设与旧卡片是两种配置，不要把旧徽章理解成“DeepSeek 现在都不能直连”。

1.  先备份，再用最新版 DeepSeek 官方预设新建卡片；保持旧卡片以便回退，不急着删除。
2.  若手动迁移旧卡片，检查其端点确实是 DeepSeek 官方接口，再将上游格式调整为 Responses，核对模型映射及目录。
3.  切换到新卡片并重启 Codex，用新的本地会话完成第 6 步验证。
4.  如果你必须保留 Chat 格式的第三方端点，使用路由模式，让 CC Switch 完成协议转换，并保持本地服务运行。

4.x 从 Codex 应用页的路由入口按说明“开始路由”，选择目标供应商；3.x 的入口可能在设置 → 路由。需确认本地服务和 Codex 路由接管都生效，默认本机监听地址通常为 `127.0.0.1:15721`。不要把路由服务开放到公网来解决本机连接问题。

这段属于兼容分支，不是新建官方 DeepSeek 预设的必选步骤。依据见 [仓库中文接入与迁移说明](https://github.com/farion1231/cc-switch/blob/main/docs/guides/codex-deepseek-routing-guide-zh.md) 及 [本地路由手册](https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/4-proxy/4.1-service.md)。中文指南已更新直连支持；仍声称 Pro 必须路由的旧英文内容不能直接套用。

## 故障排查：按现象定位，不要盲目重装

### 认证失败：401 / 403

确认填入的是 DeepSeek API Key，来自当前使用的服务商；检查前后空格、撤销状态和账户权限。不要把密钥发给别人排查，也不要在终端输出整个配置文件。如果曾公开，撤销后重新生成。

### 地址错误：404 或接口路径重复

先核对卡片来源和根地址。原生 Responses 与 Chat 上游不是同一个连接方式；不要把 `/chat/completions` 填成根地址。只有路由模式才应把客户端指向本机路由；直连模式检查的是官方端点。

### 模型没出现，或重启后仍用旧模型

先确认卡片已经切换，而不只是保存；重启客户端、创建新会话，再确认模型目录路径和实际配置目录。桌面端额外核对模型可见性说明。不要直接删掉 `auth.json`、所有 MCP 或整个 `~/.codex`。

### 本地连接失败、502 或路由请求走错

仅路由分支检查：本地服务是否运行、Codex 是否被接管、目标供应商是否正确，以及其他网络代理是否误代理了 `localhost` 或 `127.0.0.1`。改用直连时，应先通过 CC Switch 恢复直连配置，再停路由。

### 额度、限速或上游服务错误

查看提供方返回的具体错误和控制台状态，降低请求频率再重试，不循环自动提交同一个大任务。费用、余额和服务恢复时间以提供方为准；不要通过频繁换客户端假定能绕过账户限额。

## 恢复原配置：保留退路，避免清空整个目录

1.  先结束任务并退出 Codex。
2.  在 CC Switch 中切回原来的供应商；若原来是官方登录，使用对应官方卡片，按客户端要求重新登录。
3.  若需退出路由，通过 CC Switch 的回到直连操作解除接管，再确认配置没有指向已停掉的本机服务。
4.  重启 Codex 并新建会话，检查原模型、MCP 和原有项目设置。
5.  应用内恢复仍不符合预期时，先比较第 3 步备份与当前文件，保留当前副本后再决定恢复哪些文件。

> **不要用删除代替恢复：** 不要清空配置目录、全部会话历史或整个 CC Switch 数据库。备份之后新增的设置也应保留；恢复前先查看差异。

最终验收清单：供应商已切换；客户端已重启；短请求已返回；工具修改已人工核对；计费账户正确；原有 MCP 未丢失。六项都确认后，再把同样配置用于日常项目。

## 参考资料与下载来源

-   [CC Switch 官方 GitHub 仓库](https://github.com/farion1231/cc-switch)
-   CC Switch 最新发行版（见本文下载列表）
-   [添加供应商手册](https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/2-providers/2.1-add.md)
-   [切换供应商与生效方式](https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/2-providers/2.2-switch.md)
-   [Codex / DeepSeek 直连与旧配置迁移](https://github.com/farion1231/cc-switch/blob/main/docs/guides/codex-deepseek-routing-guide-zh.md)
-   [本地路由服务手册](https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/4-proxy/4.1-service.md)
-   [DeepSeek 官方 Codex 集成](https://api-docs.deepseek.com/quick_start/agent_integrations/codex/)
-   [OpenAI 自定义模型提供方](https://developers.openai.com/codex/config-advanced/)

如果更喜欢官方脚本或手动配置，也可阅读本站 [在 Codex 中接入 DeepSeek 模型：完整配置指南](https://blog.cikcc.com/article/608)。两篇是不同配置入口，不建议让官方脚本与 CC Switch 在同一时间反复覆盖设置。

**Tags:** Ai, API 配置, CC Switch, Codex, DeepSeek

**Categories:** AI 工具

**Comments:** 

**Jack:** 用了CC Switch感觉操作方便多了，感谢作者。



---