常见误区

官方 best practices 与 CSDN《Codex 使用最佳实践》整理的常见误区。新手容易踩的坑,对照清单自查。

误区 1:把长期规则全塞进 prompt

表现:每次 prompt 都写“用 pnpm”“不要改 xxx”“提交前跑测试”。

问题:prompt 变长、token 浪费、容易漏。

正确:重复规则写进 AGENTS.md 或 Skill,自动加载。

误区 2:只让 Codex 写代码,不告诉它怎么运行、测试、验证

表现:只给“帮我实现 X”,不说怎么跑、怎么验证。

问题:Codex 写完就停,你不知道对不对。

正确:在 prompt 或 AGENTS.md 写明构建、测试、lint 命令和完成标准。

误区 3:复杂任务不先计划,直接让它改

表现:大重构直接“重构这个模块”。

问题:Codex 一上来改一大片,风险高、难 review。

正确:复杂任务先 Plan,出计划、风险点、验证方式,确认后再做。

误区 4:一开始就给它过大的本机权限

表现:刚上手就 danger-full-access + never。

问题:AI 完全无人值守改任何文件,风险极高。

正确:从默认权限起步,熟悉后再逐步放宽(见第 9 章)。

误区 5:多个 live thread 同时改同一批文件,却不用 git worktree 隔离

表现:开两个 Codex 都改 src/auth/。

问题:互相覆盖、diff 混乱、测试不可信。

正确:用 git worktree 隔离,每个 thread 独立工作区(见第 20 章)。

误区 6:还没稳定的流程,过早做 automation

表现:流程还需要频繁纠正,就定时自动跑。

问题:自动化放大错误,产出不可控。

正确:先手动跑通 → Skill → 稳定后再 automation(见第 19 章)。

误区 7:把 Codex 当成必须一步步盯着的工具

表现:不敢放手,每步都盯着。

问题:效率没提升,变成“高级打字员”。

正确:用合适的权限和审批策略,让它并行工作,你做自己的事。

误区 8:一个项目只开一个巨大 session,长期混用所有任务

表现:一个 session 聊所有事,几个月不换。

问题:上下文臃肿,后面任务容易跑偏,结果变差。

正确:一个 session 对应一个相对完整的任务,分叉就 fork(见第 20 章)。

误区 9:把 Codex 当成一次性问答助手

表现:每次都从零开始问,不沉淀任何配置、AGENTS.md、Skill。

问题:Codex 永远像新人,不了解项目。

正确:把 Codex 当成可配置、可复盘、可沉淀经验的工程队友。

误区 10:跳过验证就接受 Codex 的输出

表现:Codex 给代码就直接用,不 review、不测试。

问题:bug、回归、安全风险被引入。

正确:始终审查生成的代码,跑测试,看 diff,不要盲目信任。

自查清单

□ 我是否把重复规则写进 AGENTS.md 了?
□ 复杂任务我是否先 Plan 了?
□ 我是否让 Codex 验证代码(测试、lint、diff)?
□ 我的权限设置是否合理(不过松也不过紧)?
□ 多 thread 时我是否用了 worktree?
□ 我的 session 是否一个任务一个?
□ 我是否把稳定流程做成了 Skill?
□ 我是否把 Codex 当队友而非问答助手?

资料来源

• OpenAI 官方 Codex best practices——Common mistakes 章节
• CSDN《Codex 使用最佳实践》——常见误区中文整理