Codex 使用教程：CLI 安装、登录与终端网络设置（2026）

Codex 是什么

Codex 是 OpenAI 的 AI 编程工具。它可以读取项目代码、修改文件、运行命令，完成从修 Bug 到写新功能的完整任务。常见的使用方式有三种：

• Codex CLI：在终端里运行，本文重点介绍；
• ChatGPT 桌面应用：Windows 与 Mac 上的 ChatGPT 桌面应用已经包含 Codex；
• 编辑器扩展：官方扩展支持 VS Code、Cursor、Windsurf；
• 网页版：在 ChatGPT 里把任务交给云端执行。

开始前请确认能正常使用 ChatGPT，见 ChatGPT 使用教程。

下载与安装

命令行安装按系统选一条即可，也可以用 npm 或 Homebrew。安装前先开启代理。安装完成后确认版本：

codex --version

登录与开始使用

1. 进入项目目录：cd 你的项目路径；
2. 输入 codex 启动；
3. 首次启动选择用 ChatGPT 账号登录，在浏览器里完成授权；也可以选择使用 API Key；
4. 登录后用中文描述任务即可，Codex 修改文件和运行命令前会按权限设置询问你。

终端代理设置（国内使用关键）

方式一：开启 TUN 模式（推荐）。 在 Clash Verge Rev 设置里开启 TUN 模式，终端和编辑器都会自动走代理，操作见 Clash Verge 新手使用教程。

方式二：设置环境变量。 端口以代理客户端实际显示为准：

export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897

验证：

curl -I https://api.openai.com

节点与线路建议

• 节点选美国或日本，固定一个，不要用香港；
• 长任务对断流非常敏感，晚高峰的中转线路容易让任务失败，建议使用 IEPL / IPLC 专线，详见 IEPL 和 IPLC 有什么区别。

常见问题

登录授权后终端没有反应

终端访问不到 OpenAI 服务。确认 TUN 模式或环境变量已生效，再重新运行 codex。

白天正常，晚上任务经常中断

典型的中转线路晚高峰拥塞，换专线节点即可。

在编辑器扩展里连不上

编辑器同样需要走代理，开启 TUN 模式最简单；或者在编辑器设置中配置 HTTP 代理地址。