Codex 使用技巧：写好任务描述、先规划再动手、管好长对话

Codex 能读代码、改文件、跑命令，但它做得好不好，很大程度取决于你怎么交代任务、怎么组织对话。下面按 OpenAI 官方的 Codex 最佳实践，整理出日常最用得上的几条技巧。

技巧一：任务描述写全四个要素

官方建议每次交代任务时，说清楚这四件事：

1. 目标（Goal）：要做什么，例如「给登录页加上记住密码」。
2. 背景（Context）：相关的文件、文档、报错信息。可以用 @ 直接提到具体文件。
3. 约束（Constraints）：要遵守的代码规范、架构要求、安全要求。
4. 完成标准（Done when）：怎样算做完，例如测试全部通过、某个行为改变了、bug 不再复现。

对比一下：

不好的写法：
帮我修一下登录的问题。

好的写法：
目标：修复登录后偶尔跳回首页的问题。
背景：@src/auth/session.ts，报错日志见下方。
约束：不要改动数据库结构。
完成标准：npm test 全部通过，登录后停留在原页面。

第四项最容易被忽略，但它决定了 Codex 什么时候停手、怎么检查自己的结果。

技巧二：按任务难度选推理强度

Codex 可以调整推理强度，官方的建议是：

• 低：范围明确的小任务；
• 中或高：比较复杂的修改，或者需要排查的问题；
• 超高：耗时长、需要大量推理的工作。

小改动用低强度，响应更快；遇到难查的 bug 再调高。

技巧三：难的任务先规划

对于复杂任务，先别急着让它改代码。用 /plan 命令或按 Shift+Tab 进入计划模式，让 Codex 先给出方案，确认后再动手。

如果你只有一个模糊的想法，可以让 Codex 反过来「采访」你，通过一问一答把想法整理成具体的需求说明。长期、多步骤的工作，官方建议用一个 PLANS.md 之类的执行计划文件来跟踪进度。

技巧四：让 Codex 自己测试、自己检查

• 让它编写或更新测试，并运行相关检查；
• 改完后让它审查自己的改动；
• 用 /review 命令做代码审查，可以对比主分支、检查未提交的改动、审查某个提交，或者按你给的要求审查。

在 ChatGPT 桌面 App 里，还可以在差异面板里逐行查看改动，并把针对某几行的意见直接发给下一轮对话。

技巧五：管好长对话

官方建议一个对话只做一件完整的事。把整个项目都塞进一个对话，上下文会越来越臃肿，结果也会变差。命令行里这几个命令很有用：

• /resume：继续之前保存的对话；
• /fork：开一个新对话，同时保留原来的记录，适合工作真正分出两条路的时候；
• /compact：对话太长时，把前面的内容压缩成摘要；
• /status：查看当前会话状态；
• /subagents：在子任务之间切换。

探索代码、跑测试、初步排查这类边界清楚的活，可以交给子任务，主对话专注在核心问题上。

技巧六：先用默认权限

Codex 有两项关键设置：审批模式决定它运行命令前要不要先问你，沙箱模式决定它能读写哪些地方。官方建议一开始保持默认，只在你信任的仓库里再逐步放宽。个人默认设置写在 ~/.codex/config.toml，某个仓库专用的设置写在仓库的 .codex/config.toml。命令行、编辑器扩展和桌面 App 共用同一套配置。

官方列出的常见误区

• 把长期要遵守的规则写在提示词里，而不是写进 AGENTS.md 或技能（skill）；
• 没告诉 Codex 怎么构建和运行测试；
• 复杂任务跳过规划直接开改；
• 还没弄清工作方式，就给了它完整的电脑权限；
• 多个任务同时改同一批文件，却没用 Git worktree 隔开；
• 一步一步盯着 Codex 操作，而不是让它跑着、自己去做别的事；
• 一个对话用到底。

上手建议

• 从下一个任务开始，就按「目标、背景、约束、完成标准」四段来写。
• 遇到改动范围大的任务，先 /plan，确认方案再执行。
• 每做完一件事就开新对话，长了就 /compact。
• 用量大的开发者，日常写代码选 Plus 就够用；每天高强度使用的，可以在 BuyBuy代充（buybuytopup.cn） 开通 ChatGPT Pro，获得更高的用量，各套餐具体用量以 ChatGPT 官网为准。