0x00 前言
在《从零开始搭建 AI 环境》中，我们提到过三大官方 Agent：
| 大模型 | 供应商 | Agent | 擅长处理场景 |
|---|---|---|---|
| Claude | Anthropic | Claude Code | 编码 |
| Gemini | Gemini CLI | 视觉效果 | |
| GPT | OpenAI | Codex | 通用 |
Codex 是 OpenAI 官方推出的 Agent，也是 ChatGPT 订阅体系下的旗舰产品。相比偏重编码的 Claude Code，Codex 的定位更通用，覆盖本地文件操作、浏览器操作、编码、写作、分析、方案设计等多种场景。
不过同样地，OpenAI 也封锁了中国 IP，ChatGPT OAuth 登录在国内基本不可用。
那 Codex 还能用吗？
可以的。
0x10 安装
首先到官网下载并安装 Codex：
但是在登录界面点击 Continue With ChatGPT 是无法登录的：
即使开了系统全局代理、甚至打开 Tun 模式拦截所有流量也会被识别到
但与 Claude Code 一样，Codex 也可以绕过官方登录认证。
0x20 new-api 配置 Codex 渠道
绕过之前，需要先在 new-api 中配置 Codex 渠道，把 Codex 的请求引流到 new-api 链路。
在《从零开始搭建 AI 环境》中已经提到，new-api 大多数渠道只需要填写 API Key。但 Codex 比较特殊，它走的是个人 OAuth 授权，而不是传统 API Key。
原因是 Codex 和 ChatGPT 订阅体系打通，new-api 需要拿到 ChatGPT 授权令牌，才能调用对应能力。
配置流程如下。
首先在渠道配置页面，找到密钥配置区域下方的 Codex 授权 按钮：
在弹出的窗口中点击 打开授权页面：
此时会打开 ChatGPT 登录页面。这里要登录已经订阅 ChatGPT / Codex 的账号：
登录成功后，浏览器会跳转到一个无法访问的本地回调地址，格式大概如下：
http://localhost:1455/auth/callback?code=xxxxxx&scope=openid+profile+email+offline_access&state=xxxxxx
这不是报错，而是 OAuth 授权流程的一部分。
把这个完整地址复制回 new-api，点击 生成并填入 按钮：
如果授权时跳出手机认证，可参考《Codex / ChatGPT 稳定通过手机认证指引》处理
创建 Codex 渠道后，可以点击 测试 按钮旁边的下拉箭头，打开测试面板进行验证。
Codex 支持两种测试模式：
- OpenAI Responses 流式：边生成边返回，适合正常对话和 Agent 调用
- OpenAI Responses Compaction 非流式：一次性返回结果，适合某些压缩或整理类请求
注意：Codex 通常只能使用当前 ChatGPT 订阅可用的模型。例如当前账号可用的是 GPT 5.5，那么 new-api 侧也只能走对应模型能力。
测试通过，就说明 Codex 渠道配置成功。
0x30 绕过登录认证
有了 new-api 渠道之后，就可以通过 cc-switch 配置登录绕过了。
先在 cc-switch 左上角进入设置，把 Codex 的配置面板显示出来：
回到 cc-switch 主界面，顶部切换到 Codex，然后点击右上角的 + 添加模型供应商：
参考下图配置即可：
保存后，cc-switch 会自动把配置同步到配置文件，其中：
- new-api 的令牌 API Key 会写入
~/.codex/auth.json - new-api 的 BaseURL 和模型会写入
~/.codex/config.toml
然后重启 Codex。首次启动时仍然会回到登录界面，此时点击 Sign in another way：
随后输入 new-api 的令牌 API Key，并选择工作类型：
至此我们已经成功跳过 ChatGPT 登录。
以后运行 Codex，就会直接进入对话界面：
0x40 使用验证
Codex 的强项在于原生支持电脑操作和浏览器操作，可以在插件页面添加 Computer Use 和 Chrome：
Chrome 需要浏览器插件支持：
然后就可以使用 Chrome 操作浏览器：
也可以使用 Computer Use 操作电脑：
虽然 OpenCode 也可以做到，但都是通过 skill 搭配 npm 实现的
0x70 FAQ
0x71 Codex 和 ChatGPT 是什么关系
Codex 本质上是 ChatGPT 的 Agent 形态。ChatGPT 是网页端问答产品，Codex 是本地 CLI + IDE 插件形态的 Agent。它们共享同一套 ChatGPT 订阅体系：
- ChatGPT Plus（$20/月）：订阅后可以在 Codex 中使用最新模型
- ChatGPT Pro（$200/月）：更高额度、更多模型访问权限
Codex 通过 OAuth 绑定 ChatGPT 账号后，走的是订阅额度而不是 API 按量计费，这一点对高频用户非常划算。
0x72 Codex vs OpenCode 的 GPT 模型有什么区别
两者最终都是调用 GPT 模型，但计费链路不同：
- Codex 绑定 ChatGPT 订阅体系，走订阅额度而非 API 按量计费。如果已经是 ChatGPT Plus/Pro 用户，这是最划算的用法
- OpenCode 走的是 API 按量计费（new-api 转发），每次调用都扣钱
简单说：ChatGPT 订阅用户用 Codex 更省钱，非订阅用户通过 OpenCode + new-api 按量付费更灵活。
0x73 Codex 如何计费
Codex 虽然共享 ChatGPT 的包月订阅，但并不是无限使用。它采用的是短周期时间窗口的额度池模式。
可以到下面这个页面查看当前窗口的剩余额度：
https://chatgpt.com/codex/cloud/settings/analytics#usage
