Appearance
03 · 核心概念
📚 系列导航：上一篇 02 安装与登录 让你装好了 Codex。这一篇把后面天天打交道的几个关键词一次讲透。
01 代理循环：想 → 做 → 看
Codex 干任何活都在重复三个动作：
- 想（收集上下文）：先搞清楚状况——读相关文件、看报错、查 git 状态
- 做（采取行动）：动手——改代码、跑命令、新建文件
- 看（验证结果）：检查刚才做的对不对——跑测试、看输出，不对就再来一轮
TIP
你也在循环里。Codex 自主干活时，你随时能打断：Esc 刹车，打字补充指令。
02 沙箱：管它能碰哪
沙箱是 Codex 的操作系统级隔离，决定它能读写哪些文件。
| 沙箱模式 | 效果 |
|---|---|
workspace-write（默认） | 工作区目录可读写，圈外只读，.git 只读保护 |
read-only | 只能读，不能改任何文件 |
danger-full-access | 完全访问，无限制 |
WARNING
新手用默认 workspace-write 就够了。danger-full-access 只应在隔离容器里开。
03 审批：管它动手前问不问
审批模式决定 Codex 执行操作前要不要先问你。
| 审批模式 | 效果 |
|---|---|
on-request（默认） | 工作区改文件直接做，出圈动作（改圈外文件、联网）停下来问 |
never | 所有操作都不问 |
always | 所有操作都问 |
默认档的工作流： Codex 在工作区里直接改文件，改完把 diff 摆给你看——你来事后把关。只有要出圈时才停下来弹窗问。
04 AGENTS.md：项目说明书
AGENTS.md 是放在项目里的说明书，Codex 每次会话自动加载进上下文。它解决的核心问题是：Claude Code 的 CLAUDE.md 同理，Codex 用的是 AGENTS.md。
该写什么：
- 项目结构和重要目录
- 怎么跑起来、构建/测试命令
- 工程约定和「绝对别做」的红线
- 干完算数的标准和验证方式
不该写什么：
- 长篇背景（公司介绍、产品愿景）
- 过时信息
- Claude/Codex 看代码能自己推出来的东西
NOTE
判断标准：每行自问「删了它 Codex 会犯错吗？」不会就删。持久的规矩写进 AGENTS.md，一次性的需求写进提示。
05 上下文窗口
上下文窗口是 Codex 在一次会话里能同时「看到」的全部内容，按 token 计。它装的不只是你打的字，大头是它读的文件和命令输出。
症状： 上下文塞满后，Codex 开始前后矛盾、回答变笼统、反复问已回答过的东西。
解决办法： /compact（压缩同任务续聊）、/clear（清空换新任务）、/fork（分叉出新线程）。
06 小结
| 概念 | 一句话 |
|---|---|
| 代理循环 | 想→做→看，转圈直到办完 |
| 沙箱 | 管能碰哪，默认 workspace-write |
| 审批 | 管问不问，默认 on-request |
| AGENTS.md | 项目说明书，每次会话自动加载 |
| 上下文窗口 | 工作台，塞满会变笨 |
NOTE
下一篇：04 四种入口与界面：桌面 App / CLI / IDE 扩展 / 云端 Web，四副面孔各管什么。