Codex 提速技巧：让任务更小、上下文更准、验证更快

适用场景

这篇手册适合觉得 Codex 响应慢、改动绕远、验证耗时长的用户。提速的重点不是催促 Codex，而是让任务更小、上下文更准、验证路径更明确。

OpenAI 官方 Speed 指南提供了 Codex 提效方向。具体策略应结合项目规模和风险选择。

步骤 1：把大任务拆成小任务

大任务通常慢在三个地方：读太多文件、猜太多目标、改太多模块。

不推荐：

帮我把整个网站优化一下。

推荐：

只优化 /manual 详情页的左侧目录排序。
不要改 news 和 tutorials。
完成后运行 lint 和 build。

任务越小，Codex 越容易快速完成并验证。

步骤 2：给出入口文件和范围

如果你知道相关文件，直接告诉 Codex。

示例：

主要看这几个文件：
- src/app/manual/[slug]/page.tsx
- src/components/manual-sidebar.tsx
- src/lib/content.ts

这能减少 Codex 全仓库搜索的时间，也能降低误改概率。

步骤 3：先只读定位，再允许修改

对于不确定问题，先让 Codex 只读定位。

请先找出问题可能在哪些文件，不要修改。
列出你需要验证的假设。

确认方向后再继续：

按方案 2 修改，并运行最小必要验证。

这样比一开始就让 Codex 大范围探索更稳。

步骤 4：写明最小验证命令

验证命令太重也会拖慢任务。把最小必要验证写清楚。

示例：

如果只改 MDX frontmatter，检查内容数量和运行 lint 即可。
如果改路由或内容读取，运行 next build。

不要为了每个小文案改动都跑完整测试矩阵。

步骤 5：并行任务用独立线程或 worktree

如果有多个互不依赖的方向，可以拆开。

适合并行：

• 多篇独立文章写作。
• 多个互不相关 bug。
• 方案探索。
• 文档和代码分开处理。

不适合并行：

• 同一个文件里的冲突修改。
• 需要共享上下文的重构。
• 依赖顺序明确的迁移。

常见错误

不要把“快”理解成跳过验证。真正的提速是减少无效工作。

不要给 Codex 太多无关背景。背景越多，越需要它判断优先级。

不要把多个目标塞进一个提示词。拆开通常更快。

不要让 Codex 猜验证命令。项目命令应写进 AGENTS.md。

小结

Codex 提速的核心是缩小任务、明确范围、先定位再修改、使用最小必要验证，并在互不依赖时并行处理。这样能同时提升速度和稳定性。