Codex 使用指南：从云端 Agent 到 IDE 工作流

开通与登录

Codex 需要 ChatGPT 账号。个人用户通过 ChatGPT 订阅使用云端与 IDE 功能（Pro/Plus 对应不同档位），也可以在 API 中直接调用 Codex CLI（需要 API key）。

命令行版本安装：

npm install -g @openai/codex
codex login          # ChatGPT 账号登录
codex                # 进入交互式开发 Webview

在 IDE 中使用

在 VS Code 中安装「Codex」扩展后，选中代码即可对话、让 Codex 生成补丁并预览。IDE 模式适合「上下文就在眼前」的精细化工作：修 bug、改样式、拆函数。

学会使用任务面板（Shift + Tab）快速切换项目上下文，它会把当前打开的文件自动摘要给模型，显著减少「模型看不到我在干嘛」的问题。

云端任务模式

把复杂、耗时或跨模块的任务交给云端模式：在 Codex 中打开一个 GitHub Issue，或给出任务描述，Codex 会在云端沙箱中规划、编码、测试并生成一个可审查的补丁，完成后通知你。

云端任务最适合：并行处理多个独立 Issue、夜间处理批量重构、以及在你本机环境配置不佳时的 CI 式任务。

Agent 运行模式（agent1 / agent2）会影响规划深度与速度——常规任务用 agent1 足够，复杂任务再上 agent2。

值得固定的工作流

下面是 CODX 编辑部在不同 Agent 之间对比后，推荐的一种 Codex 固定姿势：

① 新功能：点击 open 让 Codex 快速探索，再在 IDE 里审查关键模块；② 批量修改：写清「全局替换 A 为 B」的规格，云端跑完只审 diff；③ 苦力任务：测试补全、文案替换、依赖升级交给云端队列，人专注架构。

所有改动请务必走 Pull Request 流程，Codex 生成的补丁也要先过 review。