2026 年社区和官方文档里公认最实用的 Codex（CLI / App）使用技巧

以下是 2026 年社区和官方文档里公认最实用的 Codex（CLI / App）使用技巧，按重要性整理：
1. 写好 AGENTS.md（性价比最高的技巧）
AGENTS.md 是 Codex 最重要的配置资产，放在仓库根目录（可用 codex /init 自动生成）。建议包含：
• 构建、lint、type-check、测试命令及其预期退出条件
• 目录结构与模块边界
• 架构约定（状态管理、API 规范、依赖规则）
• 禁止事项（如"不要改迁移文件""实现任务中不要改测试"）
• 验收标准（什么条件下任务算完成）
之后每次你纠正 Codex 输出的地方，都是一条可以写进 AGENTS.md 的规则，让下个会话起点更高
2. 提示词四要素 + 先规划后执行
四要素：目标 + 上下文（用 @ 引用文件）+ 约束 + 输出格式。别写"写个登录接口"，要写清楚技术栈、参考文件、安全要求和交付物
大型任务一律先规划：用 /plan 或 /plan 模式让它先扫描仓库、列出步骤、不要改文件，确认后再逐步执行。跳过规划是复杂任务"越改越糟"的最常见原因
3. 会话管理：会话崩了就 fork，别硬救
• 交互模式支持上下文记忆，是日常主力；codex exec 留给 CI/CD
• 对话跑偏时，用 /fork 分叉出干净线程重试，比在坏上下文里反复纠正更省 token
• 上下文不足 30% 时 /compact 压缩；阶段性任务完成就 /new 开新会话
• codex resume --last 可以恢复昨天关掉的会话
4. 权限与安全分级
• 日常开发：--sandbox workspace-write + 默认审批就够
• 代码审查：read-only + -a never，防止误改
• --full-auto 保留沙箱的低摩擦模式；--yolo（--dangerously-bypass-approvals-and-sandbox）只用于 CI/Docker 隔离环境，本机别用
5. 按场景配置别名，省钱又提速
推理等级直接决定 token 消耗：简单任务 low，日常 medium，复杂重构/排查 Bug 才用 high
alias cx='codex -c model_reasoning_effort="high" --search' # 日常开发
alias cxr='codex --sandbox read-only -a never' # 只读审查
alias cxci='codex exec' # CI 脚本
6. 实用的隐藏操作
操作快捷键/命令
写长提示 Ctrl+G 打开外部编辑器
编辑上一条消息空输入框按两次 Esc
执行中排队下一条 Tab
精确引用文件输入 @ 触发模糊搜索
多目录/共享库 codex --add-dir /path/to/lib
用第二个 agent 审计改动 /review
额度查询 /status
Plus 订阅额度按「5 小时滚动窗口 + 每周上限」计算，查剩余额度用 /status
7. 生态扩展
• MCP：让 Codex 操作数据库、浏览器、GitHub 等外部工具，接一个测一个，别一次堆一堆
• Skills：重复性任务（如生成测试脚手架）写成 .codex/skills/，一次性任务不值得写
• CI 集成：codex exec --json 输出结构化结果，可接 GitHub Actions 做 PR 自动审查
一句话总结：AGENTS.md 定规矩 → 提示词带四要素 → 复杂任务先 /plan → 会话跑偏就 /fork → 权限按场景分级 → 推理等级按任务难度选。这几条做到位，体验会有质的飞跃。