Codex 的三种使用形态
OpenAI 的 Codex 目前主要有三种用法,网络环境要求也各不相同:
| 形态 |
运行位置 |
网络要求 |
代理设置重点 |
| Codex CLI |
本机终端 |
持续调用接口,流式输出 |
终端必须走代理 |
| IDE 扩展 |
VS Code 及其衍生编辑器 |
编辑器发出请求 |
编辑器代理或 TUN 模式 |
| Codex 云端 |
OpenAI 服务器 |
提交任务和查看结果时需访问 |
浏览器走支持地区节点 |
三种形态共用同一套账号,但本机运行的 CLI 和扩展最容易出现“网页能用、工具不能用”的情况,原因同样是流量没有经过代理。
无论哪种形态,节点出口都需要在 OpenAI 支持的地区内。中国大陆和香港不在支持范围,其他地区以 OpenAI 官方支持地区列表为准。
与 ChatGPT 账号的关系
Codex 支持两种登录方式:
- 使用 ChatGPT 账号登录。 部分 ChatGPT 付费套餐包含 Codex 使用额度,适合已有订阅的用户。具体包含哪些套餐和额度,以 OpenAI 官方页面为准。
- 使用 API 密钥。 通过 OpenAI 开发者平台的密钥按用量计费,适合有接口使用需求的开发者。
使用 ChatGPT 账号登录时,Codex 和 ChatGPT 网页的账号安全是联动的。如果你在网页端经常遇到验证或异地登录提醒,在 Codex 中也可能遇到类似情况。因此建议两者使用同一地区的固定节点,避免一边用美国节点、一边用日本节点。账号相关的更多建议见 ChatGPT 机场。
终端与编辑器的代理设置
CLI 的设置。 可以在终端中设置标准的代理环境变量,例如:
export HTTPS_PROXY=http://127.0.0.1:端口号
export HTTP_PROXY=http://127.0.0.1:端口号
端口号以代理客户端设置页显示的 HTTP 或混合端口为准。如果设置后仍然无法连接,可以开启 TUN 模式测试,排除环境变量没有生效的可能。环境变量只对当前终端窗口生效,希望每次打开终端都自动生效,可以写入 shell 的配置文件;如果项目需要访问本地或内网服务,记得用 NO_PROXY 把这些地址排除。用 npm 安装 CLI 时,下载依赖同样需要网络,可以为 npm 设置 proxy 和 https-proxy,或在 TUN 模式下安装。
IDE 扩展的设置。 Codex 扩展运行在编辑器中,可以在编辑器设置里配置 http.proxy,或直接使用 TUN 模式。编辑器扩展会启动子进程,有时子进程不继承编辑器的代理设置,TUN 模式在这类场景下更可靠。客户端开启 TUN 的方法可参考 Clash Verge Rev 教程。
常见连接问题
登录卡住。 CLI 登录时会打开浏览器授权,再由本地程序完成后续步骤。浏览器显示成功而终端报错,基本可以判断是终端没有走代理。
任务执行到一半断开。 Codex 的单个任务可能包含多轮请求,持续时间较长,节点自动切换或线路抖动都会打断任务。建议为 OpenAI 相关域名指定固定节点,关闭自动测速切换。
提示地区不可用。 检查出口 IP 是否落在支持地区,以及分流规则是否覆盖了 Codex 用到的全部域名。某些请求漏网直连,也会触发地区提示。
命令内无法联网。 Codex 在本地执行命令时有沙箱机制,部分模式下会限制网络访问,这属于工具本身的权限设计,不是代理问题。
选择节点时,IP 稳定性比速度更关键,各机场的 Codex 支持情况和 IP 稳定性评级见上方支持矩阵。如果你同时使用 Anthropic 的命令行工具,可以对照阅读 Claude Code 机场。