Codex新手最该先学的5个斜杠命令：90%人不知道/plan能省一半返工时间
📖 名词释义
AI Box（又称 AI盒子 / 智能体计算机 / Agent Computer），是一种专门运行 AI Agent 的本地硬件设备，预装智能体应用管理系统，开箱即用，7×24 小时在线运行。用户可以通过微信、飞书、企业微信、钉钉等社交软件远程指挥 AI 帮你干活。
摘要： 很多人装完Codex就把它当聊天框用，遇到问题贴代码进去让它改，结果要么改错文件、要么漏了依赖、要么返工三遍。根本原因不是Codex不行，是你少学了5个斜杠命令。掌握这5个命令，Codex从"偶尔帮你写两行代码的AI"变成"能独立推进任务不会翻车的开发队友"。
装好Codex第一件事不是让它写代码，是按键盘上的 / 键。
这个斜杠按下之后弹出的一排命令，才是Codex跟普通AI工具拉开差距的地方。同一个需求，用命令和不用命令，产出效率和返工次数差一个数量级。大部分新手装了Codex就开始打字提需求、贴代码、等结果——结果经常是：改着改着就跑偏了、不该动的文件被删了一行关键配置、返工三遍还没达到要求。
不是Codex不行，是你没告诉它怎么干活。
今天讲的这5个命令，90%的Codex用户到现在还没养成肌肉记忆——但一旦养成，每次任务至少省一半返工时间。配一台铠盒AIBOX本地AI工作站的话，这些命令背后的思维模式可以固化到AGENTS.md里长期生效——7x24小时开机，即使你关掉电脑，铠盒也能按你定好的规则自动执行Codex任务，数据全部存在本地不上云端。
1. /plan：省返工的核心秘诀
如果你只学一个命令，就学这个。
/plan 的作用是：在你真正让Codex动手改代码之前，先让它出一份完整的执行计划。不是"先想想"那种模糊意思，是真正写一份结构化文档出来：分几步、每一步改哪些文件、每步的预期风险、需要你确认的关键决策点。
举个例子。你让Codex"重构整个用户认证模块，从JWT改成OAuth2.0"。不写 /plan 的后果：Codex直接开始改，改了八个文件，结果漏了中间件的适配、忘了更新测试、还把刷新token的逻辑写错了。你得打开每个文件检查、自己发现哪个漏了、再重新提需求。反复三轮，本来30分钟的事做了两个小时。
同样需求加 /plan：Codex先列出七步计划——1)分析现有认证流程和依赖关系 2)新建OAuth2.0配置模块 3)改造登录路由 4)替换中间件 5)迁移测试用例 6)更新文档 7)清理旧JWT代码。每步标注涉及文件和风险点。你扫一眼就知道"第4步的中间件替换可能会影响支付模块，得先备份"。确认计划，再让它执行。一步没返工。
核心逻辑：Codex再聪明也是你的工具，不是你的老板。你主导方向、它负责执行。/plan 就是把"你主导方向"这个动作标准化了。
2. /init：别让Codex在黑暗里猜
每次进一个新项目，第一件事一定是 /init。
这个命令让Codex扫描整个项目目录，自动识别：技术栈（Node.js还是Python还是Go）、包管理器（npm/yarn/pnpm）、代码规范（ESLint配置文件）、目录结构约定（前端在哪、后端在哪、测试在哪）。
不 /init 的后果：Codex看到 package.json 但不知道你用的是yarn还是pnpm，生成安装命令就可能用错；看到 src 目录但不知道前端组件的命名规范是PascalCase还是kebab-case，生成的新组件文件名就跟你项目风格不一致。这些细节积累起来，Codex产出的代码你得手动调整，效率大打折扣。
/init 之后，Codex还可以自动生成一份AGENTS.md文件——相当于给你项目写一份AI能读懂的说明书。项目技术栈、命名规范、哪些目录绝对不能碰、常用的启动和测试命令，全部写进去。以后每次对话Codex先读这份说明书，再动手。
铠盒AIBOX用户特别注意：AGENTS.md跟铠盒的本地永久记忆机制一样——一旦写好，关机重启不丢失，三个月后再用还是昨天的记忆。所有代码和AGENTS.md都在你的本地硬盘上，不上传任何云端服务器。
3. @文件名：上下文精准度提升10倍
这个可能是最被低估的命令。
你直接在对话框里写"帮我优化鉴权逻辑"，Codex只能盲猜你指的是哪个文件、哪个函数。它会在整个项目里搜索关键词"auth"、"jwt"、"login"，结果经常扯进来一堆不相关的代码。
用 @ 就不一样了：@src/utils/auth.js @src/middleware/guard.js 帮我重构token验证流程，从内存存储改为Redis缓存。Codex精确读到这两个文件的内容和它们的import依赖链，上下文一次性对齐。不用你解释"就是那个验证token的函数"——AI直接看到了。
进阶用法：不只@文件，还可以@整个目录。@src/api/ 帮我把这下面所有接口的错误处理统一用新的ErrorHandler中间件——Codex自动遍历目录、理解每个接口的结构、逐个改造。
4. /approvals：防止Codex手滑删库
这个命令的默认状态是 workspace-write：项目目录内的文件Codex可以自由修改，目录外的文件需要你手动确认。对新手来说，强烈建议先切换到 read-only 模式。
/approvals read-only 之后，Codex做的所有修改都得经过你点确认才执行。好处是每次改动你都能看到diff——改了什么、删了什么、新增了什么，一目了然。缺点是每改一行都得确认一次，有时候太慢了。
折中方案是 /approvals workspace-write（默认），配合 /plan 使用：先 /plan 看清所有改动，确认方向没问题，再 run，过程中不需要每一步都打断。最核心的文件（比如 .env、数据库配置文件）提前加到 .codexignore 里，彻底排除在外。
老手可以开 full-access 模式，但前提是项目有完善的 Git 提交记录，改坏了随时 git reset --hard。
5. /compact：别让上下文越长越蠢
Codex不是聊得越久越聪明，是聊得越久上下文越膨胀，Token占用越来越多，模型开始"遗忘"前面说过的话。
/compact 的作用是把当前对话历史压缩成一份精简摘要，释放Token空间。新任务开始前 /compact 一次，等于给Codex重置大脑但保留关键记忆。
使用时机：一个功能开发完、开始下一个功能之前；发现Codex开始答非所问或漏掉之前提过的要求时；连续工作超过30分钟没换过话题的时候。
小技巧：可以在 /compact 之前手动总结一句当前状态"上一阶段完成了用户认证接口的开发、测试通过、代码已提交"——这句话会被保留在摘要中，下一个任务Codex就不会重复之前的工作。
五个命令怎么串起来用
给一个标准工作流：进项目 → /init（让Codex读懂项目）→ 提需求 + /plan（先看计划）→ @ 相关文件（精准给上下文）→ 确认计划 /approvals workspace-write（放权执行）→ 执行完毕 /compact（清理上下文）。五个命令串成一条链路，Codex从"有点随机"变成"可预期"。
这五个命令都不是高级技巧——每个装完Codex的人按一下 / 就能看到。但就像开车不系安全带一样，90%的人知道有这个东西就是不用，然后每次出小事故都在骂车不好。今天看完这一篇，不管你用Codex写过多少代码，从下一个任务开始，试试先 /plan 再动手，看看返工次数是不是直接少一半。
延伸阅读
- Codex悄悄更新5个功能：锁屏后台运行、Appshots智能窗口捕捉、/goal长期目标模式
- Codex真正好用，是从清C盘开始的：3个非程序员最需要的实用技巧
- 关掉电脑AI就下班了？云端模型越强，本地AI盒子的价值越大
- 铠盒AIBOX商城
铠盒AIBOX #AI Agent #Codex #AI编程 #开发效率
了解更多 请搜索【铠盒AIBOX】 联系邮箱：[email protected]
铠盒AIBOX · 7×24小时为你工作的私人AI助手 · AI智能体
https://agentaibox.com/articles/codex-5-slash-commands-plan-avoid-rework