第 03 章 · 学会跟 Codex 说话

Codex 用法手册

第 02 章让你跟 Codex 通了个气;这一章我们把它正式当工具来用。审批模式、沙盒、看懂 diff、何时该重启——这些是接下来所有实战章节默认你会的能力。

本章学完后你会拥有 一张 Codex CLI 操作地图:知道怎么控制权限、怎么看改动、怎么用 slash 命令、怎么恢复会话,以及怎么给项目留下长期规则。

3.1 三种审批模式

审批模式决定 Codex 做事前要不要问你。你可以把它理解成“助手的自主程度”。

模式	通俗理解	新手建议
Read-only	只看不动	你想让它解释项目、找问题、给计划时用。
Auto / workspace-write	能在当前项目里读写,越界会问	日常最推荐。第 05 章开始基本用它。
Full Access	限制最少,风险最高	新手先别用,除非你非常清楚它要做什么。

在 CLI 里,你可以用 /permissions 调整权限。刚开始不确定时,宁可保守一点。让 Codex 先解释计划,你确认后再给它更大的权限。

不要为了省事直接全权

Full Access 很像把家里钥匙全交出去。不是永远不能用,但第一次装修不要这么干。

3.2 沙盒到底罩着什么

沙盒是 Codex 的活动边界。它控制的是“技术上能碰哪里”。审批控制的是“什么时候问你”。两者一起工作。

默认情况下,Codex 会围绕你启动它的当前目录工作。比如你在 my-product-site 里运行 codex,它就应该把这个文件夹当成工作区。

常见边界可以这样理解:

当前项目文件:日常可以读写。
项目外目录:通常需要额外授权。
联网:默认更保守,需要时会说明理由。
危险命令:比如删除、重置、改系统设置,你应该格外仔细。

想知道当前会话的边界,可以输入 /status。它会显示当前工作目录、权限、上下文等信息。

3.3 看懂它的"剧本":diff 视图怎么读

Diff 是“这次改了什么”的对照表。你不用看懂所有代码,但一定要看大方向。

+ 开头:新增的内容。
- 开头:删除的内容。
文件名变化:这次动了哪些文件。

新手看 diff 时只问四个问题:

它改的是不是我刚才要求的地方?
有没有动到不相关文件?
有没有删掉大段内容?
有没有新增奇怪链接、账号、密钥或陌生脚本?

如果你看不懂,不要硬装懂。直接让 Codex 解释。

看不懂 diff 时

请用零基础能听懂的话解释这次 diff: 1. 每个文件改了什么 2. 为什么要这么改 3. 有没有风险 4. 我应该接受、拒绝,还是让你再改一轮

你不需要马上变懂代码。你需要能判断“这次改动是不是合理”。

3.4 几个常用内置命令

在 Codex CLI 输入框里敲 /,会出现一组 slash 命令。先记这几个就够:

命令	用途	什么时候用
`/plan`	先规划	任务超过两步、你怕它直接乱改时。
`/permissions`	改权限	想从只读切到可写,或反过来收紧权限时。
`/diff`	看改动	想确认当前文件改了什么时。
`/review`	让 Codex 自查	提交前让它找风险、bug、遗漏测试。
`/status`	看会话状态	想知道当前目录、权限、模型、上下文时。
`/new`	开新对话	当前对话太乱,想重新开始但不退出 CLI。
`/resume`	恢复旧会话	昨天做到一半,今天继续。
`/quit`	退出	收工时用。

不要一口气背所有命令。你真的会高频用到的,前期就是 /plan、/diff、/review、/status。

3.5 一次会话的健康长度

Codex 的会话越聊越长,上下文会越来越复杂。长到一定程度,它可能开始变得迟钝或跑偏。

出现这些信号,就该考虑 /new 或重新开一个任务:

它连续两三次犯同一个错。
你已经换了目标,但它还抓着旧目标不放。
它开始给很长的解释,但实际改动很少。
你自己也说不清这条对话现在到底在做什么。

重开不是失败。就像整理桌面一样,有时候清空一下反而更快。

重开前总结

请用 8 条以内总结当前会话:已经完成什么、改了哪些文件、还有什么没做、下一条新会话应该从哪里继续。

复制这段总结到新会话,比带着一堆历史继续纠缠更清爽。

3.6 中断、撤回、重来的三件套

你需要会三种“刹车”。

动作	通俗理解	场景
`Esc` 或取消当前输入	我这句话不发了	还没提交给 Codex 时。
`Ctrl`+`C`	先停一下	命令跑太久、方向明显不对时。
Git 回退	回到保存点	文件已经改坏,需要撤销时。

最稳的习惯是:每完成一个小阶段就提交一次。这样你永远有地方可退。

撤回刚才改动

刚才那次改动我不满意。请先列出你改了哪些文件,然后帮我只撤回这一次改动,不要影响之前已经提交过的内容。

比“全都撤回”更安全。范围越清楚,越不容易误伤。

3.7 给项目留下"长期记忆"

如果你发现自己反复提醒 Codex 同一件事,就该把它写进 AGENTS.md。

AGENTS.md 可以理解成“项目里的工作说明”。每次 Codex 进入这个项目时,都会先读这些规则。比如:

markdown

# AGENTS.md

## 写作风格
- 面向零基础读者,用口语化中文解释。
- 先讲用途,再讲步骤,避免堆术语。

## 修改规则
- 不要引入构建工具。
- 保持纯 HTML/CSS/JS。
- 修改后检查站内链接和 HTML 结构。

你可以用 /init 让 Codex 生成一个初稿,再让它根据你的项目补充。

生成项目规则

请根据当前项目生成一份简洁的 AGENTS.md。重点写:项目是什么、常用检查命令、写作风格、修改边界。不要写太长。

AGENTS.md 不是越长越好。它应该像工作便签,不是法律合同。

3.8 新手日常工作流

把本章内容合起来,你日常可以这样用 Codex CLI:

进入项目文件夹,运行 codex。
先说目标,如果任务复杂就用 /plan。
确认计划后让它改一小块。
用 /diff 或 Review 面板看改动。
在浏览器或终端里检查结果。
满意后让 Codex 帮你提交保存点。
任务结束前让它总结改了什么。

动手试试

让 Codex 只读检查一次项目

在你的项目目录里启动 Codex。
把权限切到只读或明确告诉它先不要改文件。
让它解释项目结构并给三步建议。
用 /status 看当前会话状态。

完成标志:你知道当前工作目录是什么,也知道 Codex 下一步建议先改哪里。

你已经会了 控制 Codex 的权限边界、读懂 diff 的大方向、用常见 slash 命令管理会话,并知道如何用 AGENTS.md 把反复约定沉淀成项目规则。