沉眠之海

1. OpenAI API Key（用于 Codex 登录）#

Codex 桌面版启动时需要 API Key 进行认证，这个 Key 必须来自 OpenAI。不需要海外手机号，只需一个 OpenAI 账号。

• 网页版 ChatGPT 注册：访问 chat.openai.com，使用邮箱注册，不需要手机号验证。这一步可以在开启 VPN 后完成。
• 生成 API Key：登录 platform.openai.com，进入 API Keys 页面，点击 “Create new secret key”。复制生成的 sk-xxx 格式字符串，保存好。

注意：这个 Key 仅用于让 Codex 通过本地认证，后续实际请求会转发给 DeepSeek，因此 Key 本身不需要有余额或付费。

2. DeepSeek API Key（实际调用模型）#

DeepSeek 是国内大模型，访问快、价格极低。

1. 访问 platform.deepseek.com，使用手机号注册（国内手机号即可）。
2. 完成实名认证（需要身份证信息）。
3. 进入控制台 → API Keys → 创建 API Key，命名后生成，复制保存（格式如 sk-xxxxxx）。
4. 建议充值 5~10 元，足够日常使用。

CCX（协议转换网关）#

• 作用：将 Codex 发出的 /v1/responses 请求转换为 DeepSeek 支持的 /v1/chat/completions 请求，同时处理角色规范化、模型重定向等。
• 下载：GitHub 搜索 BenedictKing/ccx → Releases → 下载 ccx-windows-amd64.exe。
• 存放：建议新建文件夹 D:\ccx（或任意位置），将 exe 放入。

CC-Switch（图形化配置工具）#

• 作用：用图形界面修改 Codex 的配置文件，将 Codex 的请求地址指向本地的 CCX。
• 下载：GitHub 搜索 farion1231/cc-switch → Releases → 下载 .exe 安装包。
• 安装：双击安装，一路下一步。

创建配置文件（可选）#

CCX 启动时会尝试读取同目录下的 .env 文件。根据实际验证，即使没有 .env 文件，CCX 也会使用默认密钥 your-proxy-access-key。但为了统一管理，建议创建。

在 D:\ccx 文件夹中新建文本文件，重命名为 .env（注意最前面的点）。用记事本打开，输入：

1
PROXY_ACCESS_KEY=my123456
2
PORT=3000

• PROXY_ACCESS_KEY：自定义密码，后面 CCSwitch 和 Codex 登录都会用到，请记牢。
• PORT：CCX 监听端口，保持 3000。

启动 CCX#

双击 ccx-windows-amd64.exe，会弹出黑色命令行窗口。保持窗口打开，最小化即可。

启动日志中应看到类似信息：

1
[Server-Info] API 地址: http://localhost:3000/v1
2
[Server-Info] 代理访问密钥 (PROXY_ACCESS_KEY): my123456

红框的是后面需要用到的

登录 CCX 管理后台#

打开浏览器，访问 http://localhost:3000。弹出登录框，输入你设置的 PROXY_ACCESS_KEY（如 my123456），点击登录。

添加 DeepSeek 渠道（关键步骤）#

重要：左侧菜单必须点击选中 Codex 分组（而不是 Responses 或 OpenAI Chat）。如果渠道不在 Codex 分组下，Codex 请求时会报 NO_RESPONSES_UPSTREAM。

点击“添加渠道”，填写：

点击保存。

开启“角色规范化”（必须）#

返回渠道列表，找到刚添加的 DeepSeek 渠道，点击“编辑”。找到 “规范化非常见 Chat role”（英文可能为 Sanitize Chat Role），勾选启用。

原因：Codex 会发送 role: developer 的请求，而 DeepSeek API 只识别 system/user/assistant/tool。启用此选项后，CCX 会自动将 developer 转换为 system，避免报错。

保存修改。

验证 CCX 是否正常#

在渠道列表中，点击 DeepSeek 渠道旁边的 “测试延迟”，应显示绿色成功。

还可以用命令行（cmd）测试：

1
curl -X POST http://127.0.0.1:3000/v1/responses -H "Authorization: Bearer my123456" -H "Content-Type: application/json" -d "{\"model\":\"deepseek-chat\",\"input\":[{\"role\":\"user\",\"content\":\"Hello\"}]}"

正常返回包含 id 和 choices 的 JSON 响应。

启动 CCSwitch#

从开始菜单打开 CCSwitch。

添加供应商#

• 点击界面上的 OpenAI 图标。
• 点击右上角“添加供应商”。

填写：

点击“获取模型列表”，如果能加载出模型名（如 deepseek-chat），说明成功。然后保存。

应用配置#

在主界面中，选中你刚添加的供应商，点击“应用”或“保存”。CCSwitch 会自动修改 Codex 的配置文件（位于 %USERPROFILE%\.codex\）。

登录 Codex#

打开 Codex 桌面版。首次启动时会要求登录，选择 “Enter API key”（不要选 “ChatGPT Account”）。

输入框内填入与 CCSwitch 中相同的 API Key，即 my123456。

点击验证，通过后进入主界面。

首次对话#

在底部输入框输入问题，例如：

1
用 Python 写一个快速排序函数

如果返回代码，恭喜，配置成功！

配置完ccs并保存后，需要重新启动codex