在 Codex 中接入 DeepSeek 模型：使用 CC Switch

不想反复打开配置文件，也不想每次换模型都从头排错？这篇教程用 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 仓库 是本教程的软件来源。它可以管理包括 Codex 在内的客户端配置。这里采用最简单的单供应商直连，不展开多供应商聚合或自动故障转移。

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

这不是添加 MCP。MCP 管理工具与数据访问；模型提供方管理请求根地址、协议、认证和模型。已有的 MCP 不需要因为换模型就全部删除重建。OpenAI 对提供方的说明见 Codex 自定义模型提供方文档。

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

1. 打开 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 官方入门说明 安装对应客户端。已有 CLI 则先查看版本：

codex --version
codex --help

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

前往 DeepSeek 开放平台，在 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 官方预设

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 指南 和应用当前预设为准。

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

添加页中的配置编辑区可能包含全局设置。首次接入只动必要的模型、端点和密钥字段；不要顺手改 MCP、项目权限或整个配置文件。更多字段说明见 官方添加供应商手册。

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

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

切换和重启行为以 官方切换供应商手册 为准。4.0.7 发布说明也提醒：直连与路由互换后，已运行的 Codex 可能还在使用启动时读到的模型目录，因此需要重启。

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

若桌面端无法列出自定义模型，阅读 CC Switch 的桌面模型可见性说明。不要反复覆盖配置或清空官方登录文件来试错。

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

第一层：确认配置加载

在新 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 预设的必选步骤。依据见 仓库中文接入与迁移说明 及 本地路由手册。中文指南已更新直连支持；仍声称 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 仓库
• CC Switch 最新发行版（见本文下载列表）
• 添加供应商手册
• 切换供应商与生效方式
• Codex / DeepSeek 直连与旧配置迁移
• 本地路由服务手册
• DeepSeek 官方 Codex 集成
• OpenAI 自定义模型提供方

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