非常抱歉，我之前的整理确实漏掉了文章末尾关于 “常见疑问 (Q&A)” 和 “总结语” 的部分。

现在我已根据你提供的全文，重新补齐了所有细节（包括 Q1-Q7 以及最后的管理建议），这是最完整的版本：

Codex 新手入门指南：从零到上手

这是一篇写给完全没用过 Codex 的新手教程。每条指令我都会先讲它是干嘛的，再用大白话解释什么时候用，最后给一个可以照抄的例子。读完你就能上手。

先说结论： Codex 不是聊天机器人。它更像一个坐在你项目目录里的 AI 编程同事。你可以让它读代码、改文件、跑命令、写测试、看 diff、做 review。但你要先学会控制它，不然它很聪明，也很容易聪明过头。

一、 什么是 Codex 指令？

Codex 里有两种输入：

1. 普通 Prompt：

• 这是你让 Codex 干活。

1. 斜杠指令（/）：

• 比如 /init、/model、/plan、/diff、/review、/compact。
• 这些是你控制 Codex 工作方式的按钮。

一句话区分： 普通 Prompt = 你让 Codex 干什么活 斜杠指令 = 你怎么管理 Codex 这个工具

二、 先记住 3 个常识

1. 指令必须放在开头：

• /model（✅ 正确）
• 请帮我 /model（❌ 错误，Codex 只有在输入框第一个字符看到 / 才会把它当指令）。

1. 忘了指令就直接输入 /：

• 输入 / 后会弹出列表，你可以继续输入字母过滤（如 /mo 找 /model）。
• 注意： 每个人看到的指令列表可能不同（取决于版本、插件等）。你本地看到的列表永远最准。

1. 不要把 Claude Code 的东西硬套过来：

• Claude Code 常用 CLAUDE.md，而 Codex 用的是 `AGENTS.md`。
• 你可以把它理解成写给 Codex 的“项目入职手册”。

三、 新手最该掌握的 10 条指令

1. /init

• 场景： Codex 第一次进项目，对代码库一无所知。
• 作用： 生成 AGENTS.md。建议在里面补上 pnpm 命令、哪些目录不能动等规矩。

2. /status

• 场景： 怀疑模型没切成功、怕改错目录或不知道上下文还剩多少时。
• 作用： 告知当前模型、权限策略、可写目录、上下文情况。

3. /model

• 场景： 切换“快模型”或“强模型”。
• 原则： 小活（改文案、简单脚本）别烧钱；大活（大型重构、架构设计）别省钱。

4. /permissions

• 场景： 控制 Codex 能否直接动你的文件。
• 建议： 新手先设为保守，别一上来就全自动。

5. /plan

• 场景： 大任务不要直接动手，先让它想清楚。
• 例子： /plan 帮我重构方案，先不要改代码。

6. /mention

• 场景： 不想让它全项目乱翻，直接“点名”文件。
• 例子： /mention src/api/user.ts 解释这个文件的流程。

7. /diff

• 场景： 改完代码后必看。
• 原则： AI 的总结会漏，diff 不会。

8. /review

• 场景： 提交代码前，让它以 Reviewer 视角自检是否有 Bug、回归或安全风险。

9. /compact

• 场景： 聊久了对话太长，运行变慢变贵。
• 作用： 压缩前面对话的摘要并继续。

10. /resume

• 场景： 跨天任务，继续昨天的进度。
• 作用： 打开并选择历史会话。

四、 核心区分：/side 和 /fork

• /side (临时问一句)： 侧边小窗口，问完即关，不污染主线。
• /fork (开新路线)： 像 Git Branch 一样复制当前会话，尝试另一种实现方案。

五、 第一次用的标准流程

1. 进目录：cd my-project
2. 初始化：/init
3. 看状态：/status
4. 先让它读项目，不要直接改。
5. 大任务先 /plan，确认后再执行。
6. 看真实改动：/diff
7. 提交前审查：/review

六、 写好 AGENTS.md

这是 Codex 长期复用的关键。应包含：

• Commands: 安装、开发、测试的具体命令。
• Rules: 不要动 dist/、保持改动最小化、必须跑测试。
• Architecture: API、UI 组件、Auth 逻辑的位置。

七、 常见疑问 (Q&A)

• Q1：指令比文章里少？ 正常，以本地输入 / 弹出的为准。
• Q2：会乱改代码吗？ 取决于你的权限设置、Prompt 是否清楚以及你有没有看 /diff。
• Q3：/compact 会忘东西吗？ 它会摘要。如担心丢失，可写：/compact 保留某模块结论。
• Q4：/new 和 /clear 区别？ 换新任务时使用，不用太纠结。
• Q5：/fork 后怎么回主线？ 用 /resume 选回原来的会话。
• Q6：改完代码做什么？ 固定三步：/diff -> /review -> 运行测试。
• Q7：和 ChatGPT 的区别？ ChatGPT 是远程顾问；Codex 是坐在你目录里的同事，能直接读写文件和跑命令。

八、 新手使用口诀

先 /init 认项目，再 /status 确状态。 大任务先 /plan，关键文件用 /mention。 改完必须 /diff，提交前跑 /review。 对话长了用 /compact，明天回来用 /resume。 临时问句用 /side，想试新路线用 /fork。

结语： 别一上来就追求全自动。先把 Codex 当成一个需要管理的编程同事：给它上下文（AGENTS.md），给它边界（权限），看它活干得怎么样（diff）。它是你的副驾，而不是夺走方向盘的人。