前几天团队里有个同事跟我抱怨“Codex 不是挺厉害的吗为什么我每次用它改代码还是得反复对话好几轮改出来的东西也不对”说实话我一开始也踩过不少坑。Codex CLI 是 OpenAI 开源的终端 AI 编程助手功能确实强大——它能读懂整个项目、自主修改代码、跑测试验证结果。但如果你只是把它当成聊天机器人来用那基本上只发挥了它 10% 的能力。这篇文章总结了我在实际项目中摸索出来的 Codex 使用技巧从 AGENTS.md 配置、Plan 模式、沙盒策略到多 Agent 协作每一条都是实战验证过的。⚠️适用人群已经安装 Codex CLI但觉得效率不够高或者想解锁更多玩法的开发者。问题根源你可能一直在错误地使用 Codex用 Codex 写代码时你大概率遇到过这些情况每次都要花很长时间解释项目结构和代码规范AI 改出来的代码风格跟项目不一致改一个文件结果影响到其他地方复杂任务做到一半就跑偏不得不重新开始根本原因很简单你没有给 Codex 足够的上下文也没有用对正确的模式。传统做法就是把需求扔给 AI让它自己去猜。但项目越大、逻辑越复杂猜错的概率就越高。结果就是来回修改、效率低下、Token 浪费严重。不过掌握了下面这些技巧之后情况会完全不同。技巧一AGENTS.md——你的项目说明书这是 Codex 最强大但最容易被忽略的功能。什么是 AGENTS.mdAGENTS.md 是一个放在项目根目录的 Markdown 文件它相当于给 Codex 写了一份项目使用手册。Codex 每次启动时都会自动读取它里面的指令会直接影响 AI 的行为方式。实际效果有多明显对比项没有 AGENTS.md有 AGENTS.md改善幅度每次解释项目规范需要反复说明自动读取省 100%代码风格一致性经常不一致严格遵循✅修改影响范围容易误伤精准控制✅Token 消耗大量重复说明一次配置降低 30-50%怎么写一个高质量的 AGENTS.md# 项目规范 ## 技术栈 - 后端Node.js Express TypeScript - 数据库PostgreSQL Prisma ORM - 测试Jest Supertest ## 代码风格 - 使用函数式编程风格避免 class - 变量命名camelCase - 常量命名UPPER_SNAKE_CASE - 文件命名kebab-case.ts ## 目录结构 - src/routes/ - API 路由 - src/services/ - 业务逻辑 - src/models/ - 数据模型 - src/utils/ - 工具函数 ## 测试规范 - 每个 service 必须有对应的单元测试 - API 路由必须有集成测试 - 运行测试命令npm test⚠️ AGENTS.md 的作用域规则这一点非常关键根目录的 AGENTS.md对整个项目生效子目录的 AGENTS.md只对该目录及其子目录生效嵌套冲突时更深层的 AGENTS.md 优先级更高这意味着你可以针对不同模块设置不同的规范项目根目录/ ├── AGENTS.md # 全局规范 ├── src/ │ ├── frontend/ │ │ └── AGENTS.md # 前端专属规范React 组件规范等 │ └── backend/ │ └── AGENTS.md # 后端专属规范API 规范等小技巧把npm test、npm run lint这些命令写进 AGENTS.mdCodex 会自动在修改代码后运行验证。技巧二善用 Plan 模式复杂任务不再跑偏你有没有遇到过这种情况让 Codex 做一个复杂功能做到一半它就开始自由发挥偏离了你的预期Plan 模式的正确打开方式Codex 支持多种协作模式其中Plan 模式特别适合复杂任务。在 Plan 模式下Codex 会先列出执行计划等你确认后再动手。在提示词中明确要求请用 Plan 模式帮我完成以下任务 1. 为 /api/users 接口添加分页功能 2. 添加对应的单元测试 3. 更新 API 文档Codex 会生成一个可视化的步骤列表□ 分析现有 /api/users 路由实现 □ 添加分页参数page, limit解析 □ 修改 Service 层查询逻辑 □ 编写分页单元测试 □ 更新 Swagger 文档你可以✅ 逐条确认或修改计划✅ 调整步骤顺序✅ 补充遗漏的步骤✅ 确认后再执行什么时候该用 Plan 模式场景推荐模式原因修改单个文件的小 bug默认模式简单直接添加一个新功能模块Plan 模式需要多步协调重构项目架构Plan 模式影响范围大快速查询代码逻辑默认模式不需要修改修复测试失败默认模式目标明确技巧三沙盒权限——安全与效率的平衡点Codex 提供了精细的沙盒权限控制很多开发者要么完全放开有安全风险要么限制太死效率低下。三种沙盒模式对比模式安全性自由度适用场景Workspace Only 最高⚠️ 最低只允许修改工作区文件Suggest 中等 中等需要审批才能执行命令Full Access⚠️ 最低✅ 最高信任环境追求效率我的实战建议开发环境使用 Full Access让 Codex 自由运行测试、安装依赖生产环境或共享服务器使用 Suggest 模式每次执行命令前确认# 以 suggest 模式启动codex --approval-mode suggest# 以 full access 模式启动仅限可信环境codex --approval-mode full-auto小技巧如果你发现 Codex 总是反复请求确认把常用命令如npm test、npm run lint加入自动批准前缀列表效率会显著提升。技巧四多 Agent 协作——让 Codex 自己分身这是 Codex 最被低估的能力之一。场景同时处理多个子任务假设你有一个大需求为电商项目添加优惠券系统。这个任务涉及数据库模型设计API 接口开发前端页面开发单元测试编写传统做法是一个一个来但 Codex 可以同时启动多个子任务并行处理请帮我实现优惠券系统包含以下子任务 1. 创建优惠券数据模型和数据库迁移 2. 实现 CRUD API 接口 3. 编写管理后台前端页面 4. 添加完整的测试覆盖Codex 会自动拆分任务必要时创建独立的工作线程Thread每个子任务在自己的上下文中执行互不干扰。线程管理技巧# 查看当前所有任务线程 列出所有线程 # 查看特定线程的进度 查看线程 [threadId] 的最新状态 # 等待某个线程完成 等待线程 [threadId] 完成技巧五提示词工程——让 Codex 一次就做对提示词的质量直接决定了 Codex 的输出质量。以下是我总结的高效提示词模板。❌ 低效提示词帮我加个搜索功能✅ 高效提示词在 src/services/user.service.ts 的 findAll 方法中添加搜索功能 1. 支持按 name 和 email 模糊搜索 2. 搜索参数为空时返回全部结果 3. 使用 Prisma 的 contains 操作符 4. 添加对应的单元测试覆盖搜索和空参数两种情况 5. 确保测试命令是 npm test提示词黄金公式目标 位置 约束 验证方式要素说明示例目标具体要做什么添加用户搜索功能位置改哪个文件/模块src/services/user.service.ts约束技术限制或规范使用 Prisma contains支持模糊搜索验证如何确认完成运行 npm test 且全部通过技巧六上下文管理——避免 Token 爆炸跟前面提到的 OpenClaw QMD 类似Codex 也有上下文管理的问题。Token 消耗对比场景不优化优化后节省比例大型项目全量上下文50K tokens精准引用 2K tokens96%跨文件修改20K tokens逐文件处理 5K tokens75%长对话累积100K tokens定期总结 10K tokens90%实用策略1. 精确指定文件范围# ❌ 不要这样说 帮我看看项目里哪里有问题 # ✅ 应该这样说 检查 src/routes/auth.ts 和 src/services/auth.service.ts 中的错误处理逻辑2. 利用 AGENTS.md 减少重复说明把项目规范、技术栈、常用命令写进 AGENTS.md避免每次对话都要重新解释。3. 复杂任务分步执行不要一次性让 Codex 改 10 个文件。把大任务拆成小任务每步完成后验证再进行下一步。技巧七自动化工作流——让 Codex 持续运转Codex 支持自动化Automation功能可以设置定时任务、监控和跟进。实用自动化场景场景一每日代码质量检查每天早上 9 点自动运行以下检查 1. npm run lint 检查代码规范 2. npm test 运行全部测试 3. 如果有失败生成修复建议场景二依赖更新监控每周一检查 package.json 中的依赖是否有安全漏洞 1. 运行 npm audit 2. 如果有高危漏洞生成升级方案 3. 将报告发送到飞书群场景三文档自动同步当 API 路由文件发生变化时 1. 自动更新 Swagger 文档 2. 生成 changelog全面对比掌握技巧前后维度使用前使用后改善幅度单次任务完成率40-60%85-95%⬆️ 2 倍平均对话轮数5-8 轮1-3 轮⬇️ 70%Token 消耗50K/次5-15K/次⬇️ 70-90%代码风格一致性随机严格一致✅复杂任务成功率经常跑偏按计划执行✅开发效率提升有限效率翻 5-10 倍⬆️ 5-10 倍常见问题QAGENTS.md 会不会被提交到 Git 仓库A建议提交。这样团队所有人使用 Codex 时都能共享同一套规范。如果包含敏感信息可以在.gitignore中排除。QPlan 模式下可以中途修改计划吗A可以。Plan 模式的计划列表是动态的你可以随时调整步骤、添加新步骤或删除不需要的步骤。Q多 Agent 模式会不会互相冲突A不会。每个子任务在独立的工作线程中运行有自己的上下文。Codex 会自动处理文件冲突——如果两个子任务修改了同一个文件会提示你合并。QCodex 支持哪些编程语言A理论上支持所有主流编程语言。它对 TypeScript、Python、Go、Rust 等强类型语言的支持最好因为这些语言的类型信息能帮助 AI 更准确地理解代码。Q如何查看 Codex 的 Token 消耗A可以在对话中直接询问Codex 会返回当前会话的 Token 使用情况。也可以通过--token-budget参数设置单次会话的 Token 上限。QCodex 和 Cursor/Copilot 有什么区别A最大的区别是自主性。Cursor 和 Copilot 主要是补全和对话模式而 Codex 可以自主阅读代码、修改文件、运行命令、验证结果——它是一个完整的编程 Agent不只是辅助工具。总结Codex CLI 的核心价值不在于帮你写几行代码而在于它能自主完成复杂的编程任务。⚠️关键提醒✅AGENTS.md 是基石——花时间写好它后面每次使用都在省钱✅Plan 模式是利器——复杂任务一定要先规划再执行✅提示词决定质量——用目标位置约束验证公式✅分步执行是保障——大任务拆小步步步验证✅自动化是未来——让 Codex 持续运转而不是一次性使用掌握这些技巧后你会发现 Codex 不再只是一个代码补全工具而是一个真正能帮你干活的 AI 编程伙伴。