Codex 用法手册
第 02 章让你跟 Codex 通了个气;这一章我们把它正式当工具来用。审批模式、沙盒、看懂 diff、何时该重启——这些是接下来所有实战章节默认你会的能力。
3.1 三种审批模式
审批模式决定 Codex 做事前要不要问你。你可以把它理解成“助手的自主程度”。
| 模式 | 通俗理解 | 新手建议 |
|---|---|---|
| Read-only | 只看不动 | 你想让它解释项目、找问题、给计划时用。 |
| Auto / workspace-write | 能在当前项目里读写,越界会问 | 日常最推荐。第 05 章开始基本用它。 |
| Full Access | 限制最少,风险最高 | 新手先别用,除非你非常清楚它要做什么。 |
在 CLI 里,你可以用 /permissions 调整权限。刚开始不确定时,宁可保守一点。让 Codex 先解释计划,你确认后再给它更大的权限。
3.2 沙盒到底罩着什么
沙盒是 Codex 的活动边界。它控制的是“技术上能碰哪里”。审批控制的是“什么时候问你”。两者一起工作。
默认情况下,Codex 会围绕你启动它的当前目录工作。比如你在 my-product-site 里运行 codex,它就应该把这个文件夹当成工作区。
常见边界可以这样理解:
- 当前项目文件:日常可以读写。
- 项目外目录:通常需要额外授权。
- 联网:默认更保守,需要时会说明理由。
- 危险命令:比如删除、重置、改系统设置,你应该格外仔细。
想知道当前会话的边界,可以输入 /status。它会显示当前工作目录、权限、上下文等信息。
3.3 看懂它的"剧本":diff 视图怎么读
Diff 是“这次改了什么”的对照表。你不用看懂所有代码,但一定要看大方向。
+开头:新增的内容。-开头:删除的内容。- 文件名变化:这次动了哪些文件。
新手看 diff 时只问四个问题:
- 它改的是不是我刚才要求的地方?
- 有没有动到不相关文件?
- 有没有删掉大段内容?
- 有没有新增奇怪链接、账号、密钥或陌生脚本?
如果你看不懂,不要硬装懂。直接让 Codex 解释。
3.4 几个常用内置命令
在 Codex CLI 输入框里敲 /,会出现一组 slash 命令。先记这几个就够:
| 命令 | 用途 | 什么时候用 |
|---|---|---|
/plan | 先规划 | 任务超过两步、你怕它直接乱改时。 |
/permissions | 改权限 | 想从只读切到可写,或反过来收紧权限时。 |
/diff | 看改动 | 想确认当前文件改了什么时。 |
/review | 让 Codex 自查 | 提交前让它找风险、bug、遗漏测试。 |
/status | 看会话状态 | 想知道当前目录、权限、模型、上下文时。 |
/model | 选择模型和推理强度 | 想换 GPT-5.6,或调整速度与思考深度时。 |
/fast on | 打开 Fast mode | 确实赶时间,并愿意多消耗额度时。 |
/agent | 查看和切换子智能体 | 让多个智能体并行工作后,想检查各自进度时。 |
/goal | 设置持续目标 | 任务步骤多,需要持续推进到明确完成标准时。 |
/export | 导出完整会话 | 把对话复制到剪贴板或保存成 Markdown 文件时。 |
/import | 从其他 Agent 导入 | 想带入 Claude Code 或 Cursor 的支持设置与近期工作时。 |
/plugins | 打开插件浏览器 | 从已配置的市场查找和安装插件时。 |
/new | 开新对话 | 当前对话太乱,想重新开始但不退出 CLI。 |
/resume | 恢复旧会话 | 昨天做到一半,今天继续。 |
/quit | 退出 | 收工时用。 |
不要一口气背所有命令。你真的会高频用到的,前期就是 /plan、/diff、/review、/status。多智能体和 Fast mode 等真正需要时再开。
3.5 GPT-5.6、Fast mode 和多智能体
截至 2026 年 8 月,CLI 可以使用 GPT-5.6、Fast mode 和子智能体。最省心的做法是先用默认推荐模型;需要手动指定时,可以在启动时写:
codex --model gpt-5.6
/model:在当前会话里切换模型和推理强度。复杂任务先用 GPT-5.6,轻量任务再选更快的模型。/fast on:让支持模型约快 1.5 倍,但 ChatGPT 额度消耗更高。用/fast off关闭,/fast status查看状态。/agent:查看并切换正在运行的子智能体线程。你也可以直接要求 Codex 停止或调整某个子智能体。
每个子智能体都会单独使用模型和工具,所以多智能体通常更耗额度。它们会继承当前会话的权限和沙盒,不会因为分工就自动扩大访问范围。
gpt-5.6-terra 和 gpt-5.6-luna。检查工作区默认值、自定义智能体和定时任务里有没有写死旧模型。2026 年 8 月新增的会话整理工具
Codex CLI 0.148.0 把长会话的“保存、另开路线和收纳”补得更完整。先升级并确认版本:
npm install -g @openai/codex@0.148.0 codex --version
| 功能 | 怎么操作 | 为什么有用 |
|---|---|---|
| 导出 | 在 TUI 输入 /export | 把完整对话复制出去或保存成 Markdown，方便交接和复盘。 |
| 分叉 | 使用 codex exec fork；先运行 codex exec fork --help 查看当前版本参数 | 保留原会话，同时尝试另一条实现路线。 |
| 归档 / 恢复 | 在 TUI 的 Resume 会话选择器里操作 | 把暂时不用的会话收起来，需要时再恢复。 |
| 插件 | 输入 /plugins 安装，随后新开会话 | 让新会话加载插件里的 Skills 和工具。 |
| 导入 | 在空闲的本地会话输入 /import | 从 Claude Code 或 Cursor 导入最多 30 天内的 50 条近期聊天及支持设置。 |
/import 在任务正在运行、远程会话或连接本地 app-server daemon 时不可用。0.147 还加入 --approve-for-me 自动审查审批；它会改变批准流程，新手先保持默认审批，熟悉风险后再考虑。
3.6 一次会话的健康长度
Codex 的会话越聊越长,上下文会越来越复杂。长到一定程度,它可能开始变得迟钝或跑偏。
出现这些信号,就该考虑 /new 或重新开一个任务:
- 它连续两三次犯同一个错。
- 你已经换了目标,但它还抓着旧目标不放。
- 它开始给很长的解释,但实际改动很少。
- 你自己也说不清这条对话现在到底在做什么。
重开不是失败。就像整理桌面一样,有时候清空一下反而更快。
3.7 中断、撤回、重来的三件套
你需要会三种“刹车”。
| 动作 | 通俗理解 | 场景 |
|---|---|---|
| Esc 或取消当前输入 | 我这句话不发了 | 还没提交给 Codex 时。 |
| Ctrl+C | 先停一下 | 命令跑太久、方向明显不对时。 |
| Git 回退 | 回到保存点 | 文件已经改坏,需要撤销时。 |
最稳的习惯是:每完成一个小阶段就提交一次。这样你永远有地方可退。
3.8 给项目留下"长期记忆"
如果你发现自己反复提醒 Codex 同一件事,就该把它写进 AGENTS.md。
AGENTS.md 可以理解成“项目里的工作说明”。每次 Codex 进入这个项目时,都会先读这些规则。比如:
# AGENTS.md ## 写作风格 - 面向零基础读者,用口语化中文解释。 - 先讲用途,再讲步骤,避免堆术语。 ## 修改规则 - 不要引入构建工具。 - 保持纯 HTML/CSS/JS。 - 修改后检查站内链接和 HTML 结构。
你可以用 /init 让 Codex 生成一个初稿,再让它根据你的项目补充。
3.9 新手日常工作流
把本章内容合起来,你日常可以这样用 Codex CLI:
- 进入项目文件夹,运行
codex。 - 先说目标,如果任务复杂就用
/plan。 - 确认计划后让它改一小块。
- 用
/diff或 Review 面板看改动。 - 在浏览器或终端里检查结果。
- 满意后让 Codex 帮你提交保存点。
- 任务结束前让它总结改了什么。
- 在你的项目目录里启动 Codex。
- 把权限切到只读或明确告诉它先不要改文件。
- 让它解释项目结构并给三步建议。
- 用
/status看当前会话状态。