如何使用 Codex CLI:安装登录 → 在仓库里下可验证的小任务 → 国内再处理代理与节点地区。它和「打开 ChatGPT 网页」不是同一次验收。
代理细节:Codex CLI 代理;IDE:VS Code / ChatGPT Codex;网页 ChatGPT:国内 ChatGPT;对照:如何使用 Claude Code。
使用前先对齐预期
- Codex CLI 会动你磁盘上的文件:没有 Git 就先别让它「大重构」。
- 账号、组织权限、模型额度是一回事;代理通不通是另一回事。
- 官方安装与子命令以 OpenAI 当前文档为准,本文不绑定易变的具体版本号。
安装、登录、第一次任务
- 按官方渠道安装 Codex CLI,确认
codex(或文档指定的命令)在 PATH 里。 - 完成登录 / API Key;公司 SSO 场景以组织文档为准。
- 进入仓库根目录,先做只读任务:「列出测试怎么跑」。确认它读的是你以为的那个项目。
- 再给一个小写任务:改一个函数 + 说明如何本地验证。你跑一遍测试或手动点一下。
日常工作流(写厚一点的可执行约定)
| 步骤 | 你做什么 | Codex 做什么 |
|---|---|---|
| 定范围 | 指定文件/目录、禁止触碰的路径 | 只在范围内改 |
| 定验收 | 给出命令或手工检查项 | 改完对照说明 |
| 看 diff | 拒绝无关大段重排 | 按你的反馈收窄 |
| 提交 | 你来 commit | 不代替你的发布流程 |
提示词里写清「不要更新依赖」「不要改 CI」往往比事后回滚省事。
国内:超时 vs 地区限制
两种常见失败不要混:
- 一直连不上 / timeout:终端多半没走 Clash。开 Tun 或设代理变量,新开终端,看连接页。步骤见代理专文。
- 能连上但 unsupported_country / 地区不可用:换出口更干净、对该服务更友好的节点,用测速筛,而不是狂开多个 CLI。
全局思路见Tun 给 AI 工具开全局代理;端口疑心见混合端口。
和网页 ChatGPT、VS Code 插件一起用时
网页通、CLI 不通 → 查终端代理。CLI 通、VS Code 里挂 → 查 IDE 是否另有代理设置(排错文)。不要假设「开了系统代理就全家桶都好了」。
止损清单
- 连续失败时停掉并发的其它 AI CLI,只留 Codex 做一次最小请求。
- Tun 与
HTTPS_PROXY叠加排错时先只留一种。 - 确认不是 Key/额度问题后再打节点。
客户端:下载 Clash Verge Rev。需要对比 Claude 工作流时读如何使用 Claude Code。