codex-deepseek-ccswitch

tongVSYOUHUO

186人浏览 · 2026-07-06 14:38:07

tongVSYOUHUO · 2026-07-06 14:38:07 发布

Codex + ccswitch + DeepSeek 零代理安装部署教程

国产大模型 + 最强 AI 编程助手，一条命令都不用翻墙

为什么你需要这个组合

如果你在日常工作中用 AI 来写代码、改 Bug、做 Code Review，那你大概率听说过 Codex——基于 GPT-5 的新一代 AI 编程助手。但问题是，想用到最新模型总得折腾网络环境。

这篇文章要帮你解决的就是这件事：用国内的 DeepSeek 模型 + 一个轻量级路由工具 ccswitch，让你在 Codex 上直接跑起来，全程不需要任何代理。

全程操作不超过 15 分钟，跟着步骤走就行。

认识三个主角

在动手之前，花 30 秒认识一下今天要操作的三样东西：

Codex——AI 编程助手桌面客户端。它是基于 GPT-5 的 Coding Agent，能在你的本地项目中帮你读代码、写代码、修 Bug，像一个坐在你旁边的工程师。你可以把它理解成「高级版 Cursor / GitHub Copilot 的开源平替」。

ccswitch——本地模型路由/切换器。它是一个轻量级工具，跑在你自己的电脑上，充当 Codex 和 DeepSeek 之间的「翻译官」。Codex 用的是 OpenAI 兼容的接口格式，ccswitch 把请求转成 DeepSeek 能理解的格式，再把结果传回来。

DeepSeek——深度求索公司出品的高性能国产大模型。编程能力出色，而且不需要科学上网就能直接调用。你只需要去官网申请一个 API Key 就行。

简单来说：Codex 说话 → ccswitch 翻译 → DeepSeek 处理 → ccswitch 传回 → Codex 展示给你。

准备工作

✅ 操作系统：Windows 10 或 Windows 11（本教程以 Windows 为例）

✅ ccswitch：已安装在你的电脑上（本教程不涉及 ccswitch 的安装步骤）

✅ DeepSeek API Key：已从 DeepSeek 官网申请并拿到密钥

✅ 网络环境：你的电脑可以直接访问 DeepSeek API（国内网络即可，无需代理）

第一步：下载并安装 Codex

首先，我们要把 Codex 本体装到电脑上。

1. 下载安装包

打开浏览器，访问 Codex 官网下载页面，下载 Windows 版本的安装包（.exe 文件，大约 300MB 左右）。

2. 双击安装

找到下载好的 CodexSetup.exe，双击运行。安装过程是全自动的，默认会安装在 %USERPROFILE%\.codex\ 目录下。

💡 %USERPROFILE% 是你的用户文件夹，比如 C:\Users\你的用户名\，后面配置会经常用到这个路径。

3. 启动 Codex

安装完成后桌面会出现 Codex 图标，双击启动。首次启动会看到欢迎界面，不需要登录或注册，直接进入主界面。

⚠️ 用默认的 GPT 模型会提示需要 API Key，没关系，我们后面几步会把它切换成 DeepSeek。

第二步：找到并编辑 Codex 配置文件

Codex 的配置都存放在一个叫 config.toml 的文件里。找到它：

打开「此电脑」→ 进入 C:\Users\你的用户名\ → 找到 .codex 文件夹 → 双击 config.toml

或者直接在地址栏粘贴：

%USERPROFILE%\.codex\config.toml

右键用记事本打开（或者用 VS Code、Notepad++ 都行）。里面内容很少，默认大概是这样的：

model_provider = "openai"
model = "gpt-4o"

[marketplaces.openai-bundled]
...

下一步我们就要把里面的内容全部替换掉。

第三步：配置 ccswitch 作为自定义模型提供者

这是最关键的一步。把 config.toml 里的内容全部删除，粘贴下面这段：

model_provider = "custom"
model = "deepseek-v4-flash"
model_reasoning_effort = "high"
disable_response_storage = true
model_catalog_json = "cc-switch-model-catalog.json"

[model_providers.custom]
name = "deepseek"
base_url = "http://127.0.0.1:15721/v1"
wire_api = "responses"
requires_openai_auth = true

保存文件，我们来逐行看懂它：

配置项	含义
`model_provider = "custom"`	告诉 Codex 我们不使用内置模型提供方，而是用自定义的
`model = "deepseek-v4-flash"`	指定要用的模型名称（这个名称来自 ccswitch 的模型目录）
`model_reasoning_effort = "high"`	推理深度，`high` 适合复杂任务，也可以改成 `medium` 或 `low`
`disable_response_storage = true`	关闭响应存储，保护隐私
`model_catalog_json = "..."`	ccswitch 提供的模型清单文件，告诉 Codex 有哪些模型可用
`base_url = "http://127.0.0.1:15721/v1"`	ccswitch 在本机的地址和端口，Codex 通过它发请求
`wire_api = "responses"`	通信协议格式，和 Codex 的模式保持一致
`requires_openai_auth = true`	告诉 Codex 这个自定义接口需要 API Key（由 ccswitch 代为管理）

💡 关于 model_catalog_json：这个文件由 ccswitch 自动生成，通常在你安装 ccswitch 的目录下。把它复制到 %USERPROFILE%\.codex\ 目录下即可。如果找不到，可以尝试在 ccswitch 目录里搜索 cc-switch-model-catalog.json。

第四步：配置 DeepSeek API 密钥

现在来处理密钥。找到 auth.json 文件，它和 config.toml 在同一个目录：

%USERPROFILE%\.codex\auth.json

用记事本打开，你会看到默认内容：

{}

把它替换成：

{
  "OPENAI_API_KEY": "PROXY_MANAGED"
}

为什么这里不直接填 DeepSeek 的 API Key？

因为密钥管理交给了 ccswitch。你的 DeepSeek API Key 配置在 ccswitch 那一侧（通常是 ccswitch 自己的配置文件里，比如 config.yaml 或环境变量），ccswitch 作为中间层替你统一管理。Codex 只需要告诉它「我用你的认证」，也就是 PROXY_MANAGED 这个标记。

这样做的两个好处：

你的 DeepSeek Key 不会在多个地方暴露
以后想换模型供应商（比如换成通义千问、Moonshot），只需要改 ccswitch 侧的配置，Codex 完全不用动

第五步：重启并验证

配置全部完成后，需要重启 Codex 让它加载新配置。

1. 完全退出 Codex

不要只点关闭窗口，Codex 会在后台继续运行。右键系统托盘里的 Codex 图标 → 选择「退出」。或者在任务管理器中找到 Codex 进程，结束任务。

2. 确认 ccswitch 在运行

在启动 Codex 之前，确保 ccswitch 已经在运行。你可以在命令行里执行：

curl http://127.0.0.1:15721/v1/models

如果返回了一串模型列表，说明 ccswitch 正常工作。

3. 重新启动 Codex

双击桌面图标启动 Codex。这次启动后，左上角的模型名称应该显示为 deepseek-v4-flash。

4. 发一条指令测试

在对话框里输入：

写一个 Python 脚本，用递归方式遍历当前目录下所有 .py 文件，统计每个文件的行数，并输出到控制台。

如果 DeepSeek 正常响应，并且 Codex 开始分析你的代码环境，那就说明全部配置成功了！🎉

常见问题与排查

❌ Codex 启动后提示「模型加载失败」

八成是 ccswitch 没启动。先确认 ccswitch 在运行中，然后再重启 Codex。

❌ 网络连接错误 / 连接超时

检查 config.toml 中 base_url 的端口号是否正确。默认是 15721，但如果你 ccswitch 用的其他端口，记得改过来。另外确认 127.0.0.1 没有被防火墙阻止。

❌ API 认证错误

问题出在 ccswitch 这一侧。检查 ccswitch 配置文件里的 DeepSeek API Key 是否填对了、是否还有余额。可以先直接用浏览器访问 DeepSeek API 测试 Key 是否有效。

❌ 模型列表中找不到 deepseek-v4-flash

检查 cc-switch-model-catalog.json 文件是否在 %USERPROFILE%\.codex\ 目录下。如果文件不存在或内容不对，可以去 ccswitch 的安装目录下重新复制一份。

❌ 配置修改后 Codex 没有变化

退出 Codex 时要确认任务管理器里没有残留的 Codex 进程。有时候关掉窗口进程还在，需要手动结束。

总结与延伸

到这里，你已经完成了 Codex + ccswitch + DeepSeek 的全链路部署。整个过程其实就三步：装 Codex → 改配置 → 填密钥，15 分钟内就能搞定。

这只是一个起点：

换模型：在 config.toml 里改 model 字段就可以切换到 ccswitch 支持的其他模型
调整推理深度：model_reasoning_effort 可以设为 low / medium / high / xhigh，越深越强越慢
隐私保护：把 disable_response_storage 设为 true 可以防止对话记录存储在本地