Codex CLI 最佳实践指南：10 个真正提升效率的技能（附详细教程与好处）
Codex CLI 是 OpenAI 推出的本地终端编码代理，能直接读取、修改和运行你的代码库。很多用户只用它来简单生成代码，但真正的高手会通过一系列进阶技巧，把它变成高效、可信赖的“团队成员”。
本文基于实际重度使用者的经验，整理出 10 个真正能“改变游戏规则” 的最佳实践。每一条都包含：是什么、好处、详细教程。照着做，你会发现 Codex 从“聪明助手”变成“能独立完成复杂任务的可靠伙伴”。
1. 先设置 AGENTS.md（项目专属说明书）
是什么：Codex 会自动读取 ~/.codex/AGENTS.md（或项目根目录下的 AGENTS.md）来理解你的技术栈、编码规范、权限边界等。
好处：让 Codex 不再是“陌生人”，而是“懂你项目的人”。后续所有指令准确率大幅提升，减少反复解释，节省 30%-50% 时间。
详细教程：
- 创建目录：
mkdir -p ~/.codex - 新建文件：
~/.codex/AGENTS.md - 写入内容示例（可根据项目调整）：
# 项目规范 技术栈：Next.js 15 + TypeScript + Tailwind + Supabase 编码风格：使用 ESLint + Prettier，函数式组件优先 权限规则：Codex 可以自行修改 src/ 文件夹，但修改 package.json / CI 配置前必须获得批准 构建命令：npm run build && npm run lint 测试命令：npm test - 启动 Codex 后输入任意指令，确认它已加载（通常会提到“根据 AGENTS.md”）。
- 项目级覆盖：在仓库根目录再放一个 AGENTS.md，可覆盖全局设置。
小贴士：花 20 分钟写好这个文件，后续所有操作都会更聪明。
2. 选择正确的模型（Use the right model）
是什么：默认 GPT-5.5 适合复杂任务；轻量任务可切换到 GPT-5.3-Codex-Spark（ChatGPT Pro 用户可用）。
好处：速度与质量平衡，复杂重构用强模型，简单任务用快模型，整体效率提升 2 倍以上。
详细教程：
- 启动时指定：
codex --model gpt-5.3-codex-spark - 会话中切换：输入
/model gpt-5.5并回车（上下文不会丢失） - 查看当前模型：输入
/model
小贴士：复杂重构、调试、多文件编辑 → GPT-5.5；快速脚本、简单修复 → Spark 模型。
3. 始终先批准计划（Always approve the plan）
是什么：Codex 在执行前会显示详细执行计划，你必须手动确认。
好处：极大降低出错风险，让 Codex 在大型代码库中真正“可信”。多数事故都源于跳过这一步。
详细教程：
- 给出任务后，Codex 会输出类似“计划：1. 修改 X 文件 2. 运行测试”的详细说明
- 仔细阅读，输入
y或yes确认，或回复具体修改意见 - 若不满意，直接回复“修改计划：不要改 Y 文件”
小贴士：养成“先读计划、再批准”的习惯，这是 Codex 最强大的安全机制。
4. 切换任务时使用 /clear 清空上下文
是什么：/clear 命令清空终端并开启全新会话。
好处：防止上一个任务的上下文“悄悄污染”下一个任务，输出质量更稳定。
详细教程：
- 完成一个任务后，直接输入
/clear - 或使用快捷键 Ctrl + L（仅清屏，不清上下文）
- 推荐：每切换一个完全不同的模块就
/clear一次
5. 掌握 Skills（技能）—— Codex 最强大的扩展能力
是什么：Skills 是存放在 ~/.codex/skills/ 目录下的可复用指令集（SKILL.md 文件），可手动调用（$.skill-name）或由 Codex 自动触发。
好处：一次编写，永久复用；团队共享；把重复工作自动化，效率飞跃。
值得优先安装的 9 个技能（对应帖子推荐）：
- gh-fix-ci：自动修复 CI 失败
- gh-address-comments：处理 PR 评论
- changelog-generator：自动生成变更日志
- create-plan：强制先输出详细计划
- webapp-testing：运行浏览器真实流程测试
- sentry-triage：自动映射 Sentry 错误到本地源码
- frontend-skill：提升前端 UI 生成质量
- connect：通过 Composio 连接 Slack/GitHub/Notion 等 1000+ 工具
- stop-slop：清理 AI 式写作（移除破折号等痕迹）
详细安装教程（通用方法）：
- 创建目录：
mkdir -p ~/.codex/skills - 推荐方式（Composio 官方技能库）：
（可一次安装多个）git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path gh-fix-ci - 或者从 agensi.io/skills 下载单个技能，解压到
~/.codex/skills/ - 重启 Codex（或新开会话），输入
$.skill-name测试 - 自动触发：直接描述问题，Codex 会根据技能描述自动选用
小贴士：技能支持版本控制，可放入团队 Git 仓库共享。
6. 设置自动化任务（Automations）
是什么：把重复任务设置为后台定时执行，结果放入审查队列。
好处：夜间自动跑测试、周报自动生成依赖审计、发布前自动更新 changelog，完全解放双手。
详细教程：
- 在 Codex 中输入“设置自动化：每周一 9 点生成 changelog”
- 或使用官方自动化界面（Codex App / CLI 配置）
- 结果会进入 Inbox 或指定文件
- 示例：
nightly test summary、weekly dependency audit
7. 处理视觉任务时附加图像（Attach images）
是什么：在提示中直接附加图片，或使用 $imagegen 指令生成图像。
好处：UI 设计、对齐视觉效果、截图修复 bug 时效果惊人。
详细教程：
- 在终端提示中拖拽或使用
--image标志附加图片 - 提示示例：“参考这张截图，重做登录页面”
- 内联生成：提示中加入
$imagegen
8. 大型重构先要求规划（Plan first）
是什么：明确指示 Codex “先输出完整变更计划，再执行”。
好处：在 diff 出现前就能发现逻辑错误，修改成本最低。
详细教程：
- 提示模板：“先输出详细计划（每个文件改什么、为什么改），确认后再执行”
- 或直接使用
create-plan技能
9. 理解 Skills vs Plugins 的区别
是什么：Skill 是编写格式（SKILL.md），Plugin 是打包后的可安装单元。
好处：个人用 Skill 即可，团队协作时打包成 Plugin 更干净。
详细教程：
- 自己写 Skill → 直接放
~/.codex/skills/ - 打包 Plugin：使用官方打包工具，团队成员只需一条命令安装
10. 开启 Codex Security（安全扫描）
是什么：2026 年 3 月推出的功能，结合项目上下文生成威胁模型，并在沙箱验证漏洞。
好处：比通用扫描器更精准，能发现项目特有的安全问题。
详细教程：
- 在配置中开启：
codex config set security.enabled true - 运行安全扫描：
codex security scan - 结果会带详细解释和修复建议
总结：
把上面 10 条实践落地，你会发现 Codex CLI 不再是“偶尔帮忙的工具”，而是每天都在为你节省数小时、减少 bug、提升代码质量的真正伙伴。
建议行动顺序：
- 先写 AGENTS.md
- 安装 3-5 个核心技能
- 养成“批准计划 + /clear”的习惯
- 逐步开启自动化和 Security
开始实践吧！把你的 AGENTS.md 或常用技能分享到评论区，我们一起把 Codex CLI 用得更极致。
（本文基于 2026 年最新 Codex CLI 特性整理，所有命令和路径均来自官方文档与社区实战。）