01 · 介绍
Codex 是什么
Codex 是 OpenAI 推出的软件工作智能体。你不必把代码粘贴到聊天框里,而是把它指向一个项目,然后描述任务:在报告页面中加入日期筛选、找出测试失败的原因、写一个脚本,把这些文件重命名。
它有几种形态,但背后共用同一个智能体:
- Codex CLI:在你自己的电脑上,于项目文件夹内的终端中运行。
- ChatGPT 中的 Codex:在连接到你 GitHub 仓库的云端沙箱中运行,并会把结果提交为一个 pull request。
- IDE 扩展:在 VS Code 及类似编辑器中运行的同一个智能体。
你不必是程序员也能从中获益,但你需要能够运行并检查它产出的内容。
02 · 适合什么场景
何时使用
- 对现有项目进行小而定义清晰的改动:新增一个字段、修复一个有明确报错信息的 bug、编写一次性的数据脚本。
- 那些你本来会拖延的琐事:编写测试、升级依赖、补充注释。
- 学习一个代码库:让它逐个文件地解释某个功能是如何工作的。
对于尚无任何代码的全新产品,先写一份清晰的书面方案;智能体的表现取决于你给它的任务说明有多好。
03 · 配置
入门指南
终端(CLI):
- 安装 Node.js,然后运行
npm install -g @openai/codex。 - 在项目文件夹中运行
codex,并使用你的 ChatGPT 账户登录(或设置 API 密钥)。 - 描述任务。Codex 会提出修改方案,并在运行命令前询问你,除非你放宽了审批模式。
云端(ChatGPT):
- 在 ChatGPT 侧边栏中打开 Codex,并连接你的 GitHub 账户。
- 选择一个代码仓库和一个环境(它会在沙盒中安装依赖项)。
- 输入任务;完成后,检查差异并打开拉取请求(pull request)。
ChatGPT Plus、Pro、Team 或 Enterprise 套餐包含 Codex;CLI 也可以使用按量付费的 API 额度。
04 · 使用说明
日常使用
- 像写工单一样描述任务:改什么、在哪里改、怎样算完成。
- 在代码仓库中添加一个
AGENTS.md文件,写明构建和测试命令以及团队规范。Codex 每次运行都会读取它。 - 让它运行测试。一个通过测试的改动,价值远高于一个“看起来没问题”的改动。
- 合并前检查每一处改动,尤其是涉及数据、支付或权限的部分。
- 保持任务小巧。十个小型拉取请求比一个大型请求更容易检查。
05 · 注意事项
常见陷阱
- 审批模式。 全自动模式会让它在你的项目中执行任何命令。只在你能通过 git 恢复的文件夹中使用它。
- 它对库版本可能非常自信地出错;遇到不对劲的地方,请查阅官方文档。
- 云端沙箱默认无法访问互联网,因此需要在运行时下载软件包的任务,在环境配置完成之前可能会失败。
- 用量按计量计费。在大型代码仓库上进行的长会话,会比聊天更快消耗套餐的额度。
06 · 资源
下一步去哪里
将它与 Claude Code 相比(参见 Claude 手册):工作流程是相同的,许多团队两者都在用。
我的笔记
登录后可以在这本手册上记私人笔记。登录
