Codex指令教程|新手最该掌握的10条指令
Codex 可被视为项目中的 AI 助手,通过斜杠指令(/)进行控制与交互。合理使用这些指令能够显著提升开发效率,优化代码质量。本文将梳理新手最需要掌握的 10 条核心指令,涵盖项目初始化、状态查询、模型切换、权限管理、任务规划、代码审查及会话管理等关键场景,帮助开发者快速上手并规避常见风险。
01项目初始化与状态查看
- /init:项目入职配置
首次接入项目时使用,生成“入职手册”(AGENTS.md)。开发者需补充启动命令、禁改目录、统一接口入口等规范,确立项目基础规则,实现一次配置长期生效。 - /status:环境状态诊断
用于排查问题,实时显示当前使用的模型、权限等级、可写目录范围以及上下文余量,帮助开发者快速掌握当前运行环境底细。
02核心执行与安全控制
| 指令 | 功能定位 | 适用场景与注意事项 |
|---|---|---|
| /model | 模型切换 | 小活(改文案、写小脚本)使用快模型;大活(架构设计、修复杂bug)使用强模型。遵循“小活不烧钱,大活不省钱”原则。 |
| /permissions | 权限管理 | 设置为只读、改前询问或全自动。新手建议保守设置,仅允许查看代码。生产环境或无 Git 项目需严格限制写入权限。 |
| /plan | 任务规划 | 执行大任务前先使用。用于分析现状并输出最低风险方案,确认方案前不执行代码修改,降低实施风险。 |
| /mention | 范围限定 | 指定特定文件进行提问,如 /mention src/api/user.ts。避免 AI 全项目检索,专注于特定文件的小 Bug 修复。 |
执行控制类指令对比
03代码审查与变更验证
代码修改完成后,验证与审查是确保质量的关键环节。单纯依赖 AI 的文字总结可能存在遗漏,必须使用专门的指令进行深度检查。
验证 vs 审查
/diff
查看真实的代码改动差异
显示增删文件及未跟踪内容
用于核对 AI 总结是否准确,避免遗漏


/review
以审查视角自查 Bug 与回归问题
检查边界缺失与安全风险
提交前建议与 /diff 组合使用作为标配
04会话管理与任务续接
- /compact:历史对话压缩
当对话过长导致响应变慢或成本增加时使用。将历史记录压缩为摘要以继续当前任务。注意该指令仅压缩历史,若需切换任务应使用其他方式。 - /resume:任务断点续传
适用于跨天或中断的长周期任务,如未修复完的 Bug 或未完成的数据迁移。可从历史会话列表中接续昨日的工作进度。
熟练掌握上述 10 条指令,开发者即可覆盖约 90% 的日常开发任务。从项目初始化到最终的代码提交,这套指令流建立了一套标准化的 AI 辅助开发工作流,既保证了效率,也通过权限和审查机制确保了代码的安全性。
当前文章无评论,是时候发表评论了