Codex 效率翻 3 倍10 个让你相见恨晚的实战技巧TL;DR本文整理了 Codex CLI 从入门到精通的 10 个核心技巧涵盖 Prompt 工程、多 Agent 协作、自动化工作流和 Token 优化。实测开发效率提升 3 倍以上Token 消耗降低 50%。无论你是刚上手还是深度用户都能直接拿去用。什么是 CodexCodex 是 OpenAI 推出的终端 AI 编程助手直接在命令行中与 AI 结对编程。相比浏览器里的 ChatGPT它有三大杀手锏️直接操作代码读写文件、运行命令、执行测试一气呵成理解整个仓库自动索引项目结构上下文感知代码意图⚡多 Agent 并行同时派遣多个子 Agent 处理不同文件效率拉满一句话总结Codex 不是一个聊天机器人而是一个坐在你终端里的全栈工程师。技巧 1用 AGENTS.md 定义你的编码规范为什么需要 AGENTS.mdCodex 会自动读取仓库中的AGENTS.md文件把它当作团队编码规范来遵守。你可以在里面定义命名风格、目录结构、测试要求等一次配置终身生效。创建你的第一个 AGENTS.md在项目根目录创建AGENTS.md# 项目编码规范 ## 代码风格 - Python 使用 4 空格缩进遵循 PEP 8 - 变量命名使用 snake_case类名使用 PascalCase - 所有公共函数必须写 docstring ## 目录结构 - 业务逻辑放在 src/ 目录 - 测试文件放在 tests/ 目录文件名以 test_ 开头 - 配置文件放在 config/ 目录 ## 测试要求 - 修改代码后必须运行相关测试 - 新增功能必须附带单元测试 - 测试覆盖率不低于 80% ## Git 规范 - commit message 使用中文 - 格式type: description - type 包括feat, fix, docs, refactor, test, chore多层级 AGENTS.mdCodex 支持在子目录放置独立的AGENTS.md子目录的规则会覆盖父目录project/ ├── AGENTS.md # 全局规范 ├── src/ │ ├── AGENTS.md # 前端专属规范 │ └── components/ ├── backend/ │ ├── AGENTS.md # 后端专属规范 │ └── api/ └── tests/ └── AGENTS.md # 测试专属规范Tip把团队的 Code Review checklist 写进 AGENTS.mdCodex 每次提交代码前会自动对照检查。技巧 2掌握 Prompt 的黄金公式好 Prompt vs 坏 Prompt类型示例效果❌ 模糊“帮我改一下登录页面”Codex 不知道改什么、怎么改⚠️ 一般“修改登录页面的样式”方向对了但缺乏细节✅ 优秀“修改 src/pages/Login.tsx把登录按钮改成圆角背景色改为 #4F46E5hover 时加深 10%参考 Tailwind 的 rounded-lg 和 bg-indigo-600”精确定位一次到位黄金公式上下文 具体需求 约束条件上下文我在做一个 SaaS 管理后台技术栈是 Next.js 14 Tailwind Prisma 具体需求新增一个用户管理页面支持分页、搜索、编辑和删除 约束条件 - 使用 Server Components - 表格组件用 shadcn/ui 的 DataTable - API 路由放在 app/api/users/ 下 - 必须有权限校验中间件引用文件和代码在 Prompt 中直接引用文件路径Codex 会自动读取上下文参考 src/utils/auth.ts 的鉴权逻辑给 src/api/orders.ts 也加上同样的中间件。 注意 auth.ts 里用的是 JWT Bearer Token不要改成 Session 方式。⚠️Warning避免一次给太多需求。单次 Prompt 聚焦一个功能点效果远好于把所有页面都改了。技巧 3善用 Plan 模式拆解复杂任务什么时候用 Plan 模式当任务涉及多个文件、需要分步实施时先让 Codex 制定计划请帮我给项目添加用户认证功能。先制定计划不要直接写代码。 我需要看到你的实施步骤确认后再开始。Plan 模式的实际效果Codex 会输出类似这样的结构化计划1. [pending] 安装依赖bcrypt, jsonwebtoken, cookie-parser 2. [pending] 创建 User 数据模型和数据库迁移 3. [pending] 实现注册 APIPOST /api/auth/register 4. [pending] 实现登录 APIPOST /api/auth/login 5. [pending] 创建认证中间件 verifyToken 6. [pending] 给受保护路由添加中间件 7. [pending] 编写单元测试覆盖所有 API每个步骤执行时会自动标记进度in_progress→completed你可以随时介入调整。Tip对复杂任务说先列计划再执行可以大幅减少返工概率。技巧 4用沙盒权限保护你的代码三种安全模式Codex 提供三种沙盒权限级别按需选择模式说明适用场景suggest只建议修改不执行任何操作代码审查、学习探索auto-edit自动修改文件但不运行命令批量重构、格式化full-auto完全自主修改文件并运行命令信任环境下的快速开发切换模式在 Codex 会话中随时切换# 在 Codex 交互界面中/suggest# 切换到只读建议模式/auto-edit# 切换到自动编辑模式/full-auto# 切换到完全自动模式⚠️Warning在生产环境或敏感项目中建议使用suggest或auto-edit模式。full-auto适合在 Git 仓库中使用随时可以git checkout回滚。技巧 5多 Agent 并行效率拉满什么是多 AgentCodex 可以同时派遣多个子 Agent 并行处理不同任务就像你同时带了几个实习生干活。触发多 Agent在 Prompt 中明确要求拆分任务请同时完成以下三个任务 1. 修改 src/components/Header.tsx添加暗色模式切换按钮 2. 修改 src/pages/Dashboard.tsx优化数据加载的 loading 状态 3. 修改 tests/api/users.test.ts补充边界条件测试 每个任务独立进行互不影响。Codex 会自动识别任务独立性分配给不同 Agent 并行执行。实际效果对比场景单 Agent多 Agent 并行提速修改 5 个独立组件~15 分钟~4 分钟3.75x重构 3 个 API 模块~20 分钟~7 分钟2.86x编写 4 个测试文件~12 分钟~4 分钟3xTip多 Agent 最适合互不依赖的并行任务。如果任务间有强依赖比如 A 的输出是 B 的输入还是串行执行更靠谱。技巧 6让 Codex 自动写测试一行命令生成测试给 src/services/orderService.ts 里的所有公共方法写单元测试。 使用 Vitestmock 掉数据库层。覆盖正常流程、边界条件和异常处理。修复失败的测试测试跑挂了直接把错误丢给 Codex运行 pytest tests/ 后报了以下错误 AssertionError: Expected status 200 but got 403 请分析原因并修复。不要改测试改业务代码。测试驱动开发TDD先写测试再让 Codex 实现功能我已经写好了 tests/features/export.test.ts 里的所有测试用例。 现在请实现 src/features/export.ts让所有测试通过。 先运行测试看看哪些失败然后逐步实现。Tip让 Codex “先运行测试再修改代码最后再跑一遍测试”这种闭环方式可以大幅提高代码质量。技巧 7用 Git 集成管理代码变更智能 Diff 查看让 Codex 总结本次修改请查看 git diff用中文总结这次修改做了什么。 按模块分组每个模块用一句话概括。自动生成 Commit Message查看当前的 git diff --staged按照 Conventional Commits 规范生成 commit message。 格式type(scope): description代码审查请审查 src/api/payment.ts 最近的修改 1. 有没有安全隐患SQL 注入、XSS 等 2. 错误处理是否完善 3. 性能有没有明显问题 4. 是否符合项目的 AGENTS.md 规范⚠️WarningCodex 默认不会自动 commit 或 push。如果你需要自动提交请在 Prompt 中明确说明。技巧 8自定义 Codex 的行为通过 Profile 定制人格创建自定义 Profile让 Codex 扮演特定角色codex--profile你是一个资深 Rust 后端工程师。 - 优先考虑类型安全和内存安全 - 所有函数必须有文档注释 - 错误处理使用 ? 操作符不用 unwrap() - 遵循 Rust API Guidelines模型选择策略不同任务选不同模型性价比最优任务类型推荐模型理由简单代码补全gpt-4o-mini快且便宜日常开发gpt-4o性价比最高复杂架构设计o3推理能力最强大量文件重构o4-mini平衡速度与能力使用 Model Flags# 快速问答用轻量模型codex-q解释一下这段代码--modelgpt-4o-mini# 复杂任务用强模型codex-q设计一个分布式任务队列的架构--modelo3Tip日常开发用gpt-4o遇到需要深度推理的 bug 或架构问题时切换到o3Token 成本可降低 60% 以上。技巧 9自动化重复性工作批量文件处理把 src/components/ 下所有 .jsx 文件转换为 .tsx 文件 1. 重命名文件后缀 2. 给每个组件添加 Props interface 3. 补充必要的类型标注 4. 确保转换后代码能正常编译自动生成样板代码我在 src/api/ 下新建了 product.ts。 请参考 src/api/users.ts 的模式CRUD 路由 验证中间件 错误处理 给 Product 模型生成同样的样板代码。 数据模型参考 prisma/schema.prisma 里的 Product 定义。数据库迁移脚本我需要在 users 表添加一个 last_login_at 字段timestamp, nullable。 请生成 1. Prisma schema 修改 2. 迁移文件 3. 更新所有引用 users 表的 Service 和 DTOTip对于经常重复的模式比如新建 CRUD 模块在 AGENTS.md 里写好模板规范Codex 每次都会自动遵循。技巧 10Token 优化与降本控制上下文范围只看 src/auth/ 目录下的代码不要读取其他文件。 分析 login.ts 和 register.ts 的安全问题。分步执行代替一次性大任务❌ 不推荐重构整个项目的状态管理从 Redux 迁移到 Zustand同时更新所有测试✅ 推荐第一步只迁移 src/store/userStore.ts从 Redux 改为 Zustand 第二步运行相关测试确认通过 第三步继续迁移下一个 store...Token 消耗对比策略平均 Token 消耗完成率一次性大任务50,000~60%容易跑偏分步小任务8,000-15,000/步~95%限定范围 分步3,000-8,000/步~98%⚠️WarningToken 消耗最大的陷阱是让 Codex 读取整个项目再修改。始终限定文件范围效果反而更好。常见问题 FAQCodex 改坏了我的代码怎么办如果你在 Git 仓库中使用随时回滚# 撤销所有未提交的修改gitcheckout.# 或者只撤销某个文件gitcheckout -- src/pages/Login.tsx 建议在开始 Codex 会话前确保代码已 commit这样随时可以回退。Codex 运行命令报错怎么办直接告诉它错误信息刚才运行 npm run build 报了 TypeError: Cannot read properties of undefined。 错误在 src/utils/config.ts 第 23 行。请分析并修复。如何让 Codex 不修改某些文件在 AGENTS.md 中声明## 禁止修改的文件 - config/production.json生产配置含敏感信息 - migrations/已执行的数据库迁移 - vendor/第三方依赖Codex 生成的代码质量不行通常是 Prompt 不够具体。试试提供明确的文件路径和行号说明参考的现有代码模式给出验收标准比如必须通过 lint 检查在 AGENTS.md 中定义质量标准如何查看 Codex 消耗了多少 TokenCodex 桌面端会在任务完成后显示 Token 使用统计。CLI 模式下可以设置预算codex --token-budget100000完成这个功能总结10 个技巧速查表#技巧核心价值一句话总结1AGENTS.md统一规范写一次Codex 永远遵守2黄金 Prompt精准输出上下文 需求 约束3Plan 模式减少返工先规划再动手4沙盒权限安全保障按场景选模式5多 Agent并行加速独立任务同时干6自动测试代码质量写测试、跑测试、修 bug 一条龙7Git 集成变更管理Diff、Commit、Review 全自动8自定义行为个性定制Profile 模型选择9自动化告别重复批量处理 样板代码10Token 优化降本增效分步执行 限定范围快速上手3 分钟# 1. 安装 Codex CLInpminstall-gopenai/codex# 2. 配置 API KeyexportOPENAI_API_KEYsk-your-key-here# 3. 进入项目目录cdyour-project# 4. 开始使用codex帮我分析一下这个项目的代码结构效率提升的关键三个核心原则AGENTS.md 先行把规范写进文件比每次在 Prompt 里重复强 100 倍Prompt 要具体文件路径 行号 参考代码 验收标准缺一不可分步执行大任务拆小步每步验证成功率从 60% 飙升到 98%参考资料Codex 官方文档Codex CLI GitHub 仓库AGENTS.md 规范说明
Codex 效率翻 3 倍：10 个让你相见恨晚的实战技巧
Codex 效率翻 3 倍10 个让你相见恨晚的实战技巧TL;DR本文整理了 Codex CLI 从入门到精通的 10 个核心技巧涵盖 Prompt 工程、多 Agent 协作、自动化工作流和 Token 优化。实测开发效率提升 3 倍以上Token 消耗降低 50%。无论你是刚上手还是深度用户都能直接拿去用。什么是 CodexCodex 是 OpenAI 推出的终端 AI 编程助手直接在命令行中与 AI 结对编程。相比浏览器里的 ChatGPT它有三大杀手锏️直接操作代码读写文件、运行命令、执行测试一气呵成理解整个仓库自动索引项目结构上下文感知代码意图⚡多 Agent 并行同时派遣多个子 Agent 处理不同文件效率拉满一句话总结Codex 不是一个聊天机器人而是一个坐在你终端里的全栈工程师。技巧 1用 AGENTS.md 定义你的编码规范为什么需要 AGENTS.mdCodex 会自动读取仓库中的AGENTS.md文件把它当作团队编码规范来遵守。你可以在里面定义命名风格、目录结构、测试要求等一次配置终身生效。创建你的第一个 AGENTS.md在项目根目录创建AGENTS.md# 项目编码规范 ## 代码风格 - Python 使用 4 空格缩进遵循 PEP 8 - 变量命名使用 snake_case类名使用 PascalCase - 所有公共函数必须写 docstring ## 目录结构 - 业务逻辑放在 src/ 目录 - 测试文件放在 tests/ 目录文件名以 test_ 开头 - 配置文件放在 config/ 目录 ## 测试要求 - 修改代码后必须运行相关测试 - 新增功能必须附带单元测试 - 测试覆盖率不低于 80% ## Git 规范 - commit message 使用中文 - 格式type: description - type 包括feat, fix, docs, refactor, test, chore多层级 AGENTS.mdCodex 支持在子目录放置独立的AGENTS.md子目录的规则会覆盖父目录project/ ├── AGENTS.md # 全局规范 ├── src/ │ ├── AGENTS.md # 前端专属规范 │ └── components/ ├── backend/ │ ├── AGENTS.md # 后端专属规范 │ └── api/ └── tests/ └── AGENTS.md # 测试专属规范Tip把团队的 Code Review checklist 写进 AGENTS.mdCodex 每次提交代码前会自动对照检查。技巧 2掌握 Prompt 的黄金公式好 Prompt vs 坏 Prompt类型示例效果❌ 模糊“帮我改一下登录页面”Codex 不知道改什么、怎么改⚠️ 一般“修改登录页面的样式”方向对了但缺乏细节✅ 优秀“修改 src/pages/Login.tsx把登录按钮改成圆角背景色改为 #4F46E5hover 时加深 10%参考 Tailwind 的 rounded-lg 和 bg-indigo-600”精确定位一次到位黄金公式上下文 具体需求 约束条件上下文我在做一个 SaaS 管理后台技术栈是 Next.js 14 Tailwind Prisma 具体需求新增一个用户管理页面支持分页、搜索、编辑和删除 约束条件 - 使用 Server Components - 表格组件用 shadcn/ui 的 DataTable - API 路由放在 app/api/users/ 下 - 必须有权限校验中间件引用文件和代码在 Prompt 中直接引用文件路径Codex 会自动读取上下文参考 src/utils/auth.ts 的鉴权逻辑给 src/api/orders.ts 也加上同样的中间件。 注意 auth.ts 里用的是 JWT Bearer Token不要改成 Session 方式。⚠️Warning避免一次给太多需求。单次 Prompt 聚焦一个功能点效果远好于把所有页面都改了。技巧 3善用 Plan 模式拆解复杂任务什么时候用 Plan 模式当任务涉及多个文件、需要分步实施时先让 Codex 制定计划请帮我给项目添加用户认证功能。先制定计划不要直接写代码。 我需要看到你的实施步骤确认后再开始。Plan 模式的实际效果Codex 会输出类似这样的结构化计划1. [pending] 安装依赖bcrypt, jsonwebtoken, cookie-parser 2. [pending] 创建 User 数据模型和数据库迁移 3. [pending] 实现注册 APIPOST /api/auth/register 4. [pending] 实现登录 APIPOST /api/auth/login 5. [pending] 创建认证中间件 verifyToken 6. [pending] 给受保护路由添加中间件 7. [pending] 编写单元测试覆盖所有 API每个步骤执行时会自动标记进度in_progress→completed你可以随时介入调整。Tip对复杂任务说先列计划再执行可以大幅减少返工概率。技巧 4用沙盒权限保护你的代码三种安全模式Codex 提供三种沙盒权限级别按需选择模式说明适用场景suggest只建议修改不执行任何操作代码审查、学习探索auto-edit自动修改文件但不运行命令批量重构、格式化full-auto完全自主修改文件并运行命令信任环境下的快速开发切换模式在 Codex 会话中随时切换# 在 Codex 交互界面中/suggest# 切换到只读建议模式/auto-edit# 切换到自动编辑模式/full-auto# 切换到完全自动模式⚠️Warning在生产环境或敏感项目中建议使用suggest或auto-edit模式。full-auto适合在 Git 仓库中使用随时可以git checkout回滚。技巧 5多 Agent 并行效率拉满什么是多 AgentCodex 可以同时派遣多个子 Agent 并行处理不同任务就像你同时带了几个实习生干活。触发多 Agent在 Prompt 中明确要求拆分任务请同时完成以下三个任务 1. 修改 src/components/Header.tsx添加暗色模式切换按钮 2. 修改 src/pages/Dashboard.tsx优化数据加载的 loading 状态 3. 修改 tests/api/users.test.ts补充边界条件测试 每个任务独立进行互不影响。Codex 会自动识别任务独立性分配给不同 Agent 并行执行。实际效果对比场景单 Agent多 Agent 并行提速修改 5 个独立组件~15 分钟~4 分钟3.75x重构 3 个 API 模块~20 分钟~7 分钟2.86x编写 4 个测试文件~12 分钟~4 分钟3xTip多 Agent 最适合互不依赖的并行任务。如果任务间有强依赖比如 A 的输出是 B 的输入还是串行执行更靠谱。技巧 6让 Codex 自动写测试一行命令生成测试给 src/services/orderService.ts 里的所有公共方法写单元测试。 使用 Vitestmock 掉数据库层。覆盖正常流程、边界条件和异常处理。修复失败的测试测试跑挂了直接把错误丢给 Codex运行 pytest tests/ 后报了以下错误 AssertionError: Expected status 200 but got 403 请分析原因并修复。不要改测试改业务代码。测试驱动开发TDD先写测试再让 Codex 实现功能我已经写好了 tests/features/export.test.ts 里的所有测试用例。 现在请实现 src/features/export.ts让所有测试通过。 先运行测试看看哪些失败然后逐步实现。Tip让 Codex “先运行测试再修改代码最后再跑一遍测试”这种闭环方式可以大幅提高代码质量。技巧 7用 Git 集成管理代码变更智能 Diff 查看让 Codex 总结本次修改请查看 git diff用中文总结这次修改做了什么。 按模块分组每个模块用一句话概括。自动生成 Commit Message查看当前的 git diff --staged按照 Conventional Commits 规范生成 commit message。 格式type(scope): description代码审查请审查 src/api/payment.ts 最近的修改 1. 有没有安全隐患SQL 注入、XSS 等 2. 错误处理是否完善 3. 性能有没有明显问题 4. 是否符合项目的 AGENTS.md 规范⚠️WarningCodex 默认不会自动 commit 或 push。如果你需要自动提交请在 Prompt 中明确说明。技巧 8自定义 Codex 的行为通过 Profile 定制人格创建自定义 Profile让 Codex 扮演特定角色codex--profile你是一个资深 Rust 后端工程师。 - 优先考虑类型安全和内存安全 - 所有函数必须有文档注释 - 错误处理使用 ? 操作符不用 unwrap() - 遵循 Rust API Guidelines模型选择策略不同任务选不同模型性价比最优任务类型推荐模型理由简单代码补全gpt-4o-mini快且便宜日常开发gpt-4o性价比最高复杂架构设计o3推理能力最强大量文件重构o4-mini平衡速度与能力使用 Model Flags# 快速问答用轻量模型codex-q解释一下这段代码--modelgpt-4o-mini# 复杂任务用强模型codex-q设计一个分布式任务队列的架构--modelo3Tip日常开发用gpt-4o遇到需要深度推理的 bug 或架构问题时切换到o3Token 成本可降低 60% 以上。技巧 9自动化重复性工作批量文件处理把 src/components/ 下所有 .jsx 文件转换为 .tsx 文件 1. 重命名文件后缀 2. 给每个组件添加 Props interface 3. 补充必要的类型标注 4. 确保转换后代码能正常编译自动生成样板代码我在 src/api/ 下新建了 product.ts。 请参考 src/api/users.ts 的模式CRUD 路由 验证中间件 错误处理 给 Product 模型生成同样的样板代码。 数据模型参考 prisma/schema.prisma 里的 Product 定义。数据库迁移脚本我需要在 users 表添加一个 last_login_at 字段timestamp, nullable。 请生成 1. Prisma schema 修改 2. 迁移文件 3. 更新所有引用 users 表的 Service 和 DTOTip对于经常重复的模式比如新建 CRUD 模块在 AGENTS.md 里写好模板规范Codex 每次都会自动遵循。技巧 10Token 优化与降本控制上下文范围只看 src/auth/ 目录下的代码不要读取其他文件。 分析 login.ts 和 register.ts 的安全问题。分步执行代替一次性大任务❌ 不推荐重构整个项目的状态管理从 Redux 迁移到 Zustand同时更新所有测试✅ 推荐第一步只迁移 src/store/userStore.ts从 Redux 改为 Zustand 第二步运行相关测试确认通过 第三步继续迁移下一个 store...Token 消耗对比策略平均 Token 消耗完成率一次性大任务50,000~60%容易跑偏分步小任务8,000-15,000/步~95%限定范围 分步3,000-8,000/步~98%⚠️WarningToken 消耗最大的陷阱是让 Codex 读取整个项目再修改。始终限定文件范围效果反而更好。常见问题 FAQCodex 改坏了我的代码怎么办如果你在 Git 仓库中使用随时回滚# 撤销所有未提交的修改gitcheckout.# 或者只撤销某个文件gitcheckout -- src/pages/Login.tsx 建议在开始 Codex 会话前确保代码已 commit这样随时可以回退。Codex 运行命令报错怎么办直接告诉它错误信息刚才运行 npm run build 报了 TypeError: Cannot read properties of undefined。 错误在 src/utils/config.ts 第 23 行。请分析并修复。如何让 Codex 不修改某些文件在 AGENTS.md 中声明## 禁止修改的文件 - config/production.json生产配置含敏感信息 - migrations/已执行的数据库迁移 - vendor/第三方依赖Codex 生成的代码质量不行通常是 Prompt 不够具体。试试提供明确的文件路径和行号说明参考的现有代码模式给出验收标准比如必须通过 lint 检查在 AGENTS.md 中定义质量标准如何查看 Codex 消耗了多少 TokenCodex 桌面端会在任务完成后显示 Token 使用统计。CLI 模式下可以设置预算codex --token-budget100000完成这个功能总结10 个技巧速查表#技巧核心价值一句话总结1AGENTS.md统一规范写一次Codex 永远遵守2黄金 Prompt精准输出上下文 需求 约束3Plan 模式减少返工先规划再动手4沙盒权限安全保障按场景选模式5多 Agent并行加速独立任务同时干6自动测试代码质量写测试、跑测试、修 bug 一条龙7Git 集成变更管理Diff、Commit、Review 全自动8自定义行为个性定制Profile 模型选择9自动化告别重复批量处理 样板代码10Token 优化降本增效分步执行 限定范围快速上手3 分钟# 1. 安装 Codex CLInpminstall-gopenai/codex# 2. 配置 API KeyexportOPENAI_API_KEYsk-your-key-here# 3. 进入项目目录cdyour-project# 4. 开始使用codex帮我分析一下这个项目的代码结构效率提升的关键三个核心原则AGENTS.md 先行把规范写进文件比每次在 Prompt 里重复强 100 倍Prompt 要具体文件路径 行号 参考代码 验收标准缺一不可分步执行大任务拆小步每步验证成功率从 60% 飙升到 98%参考资料Codex 官方文档Codex CLI GitHub 仓库AGENTS.md 规范说明
