# 38 · 术语表

> 📚 **系列导航**：上一篇〔[37 常见问题排查](37-faq.md) 〕帮你把跑 Codex 时最容易撞上的报错、卡壳、奇怪行为一个个排掉了。这一篇换个用法——它不是拿来从头读的，是拿来**随时翻**的：把全书出现过的术语收成一本随身词典，哪个词当时没记牢，回头查一下就行。下一篇〔[39 企业管理与治理](39-enterprise.md) 〕再讲团队和公司层面怎么把 Codex 管起来。

兄弟们，咱们这套教程走到这儿，已经甩出去一卡车术语了。

代理循环、沙箱、审批、推理强度、`service_tier`、MCP、子代理、Skill、Hook……我自己第一次系统学这类工具时，最劝退的就是这个——**不是哪个概念有多难，是名词太多、还互相串门**，看到第十个的时候，前面五个已经糊成一团了。

说句实话，被术语劝退是新手的通病，跟笨不笨没关系。这玩意儿的解法也简单：**别背，要查。** 真用到哪个词，回来翻一眼，看完接着干活——查个三五回，它自己就长脑子里了。

这一篇就是给你准备的那本随身词典。按主题分了组，每个词一句大白话解释，再补一句「在 Codex 里到底指啥」或一个类比。不用从头读，**Ctrl+F 搜你卡住的那个词，看完就走。**

**看完这一篇，你会拿到：**

- 一份按主题分组的 Codex 术语词典，每个词都是小白能看懂的大白话
- 基础概念（代理循环、上下文窗口、token）一次说清，它们是其它所有概念的地基
- Codex 专有的那批词（`AGENTS.md`、`codex exec`、沙箱、审批、推理强度、`service_tier`、Chronicle）集中查
- 扩展能力五件套（MCP、子代理、Skill、Hook、Plugin）一句话区分，不再混
- 模型体系（`gpt-5.5` 这一串）的定位区分、「研究预览」什么意思、哪两个已弃用别再用

> ⚠️ 本篇的命令、配置键、默认行为以 Codex [官方文档](https://developers.openai.com/codex) 为准；模型名、套餐范围这类会随版本变的东西，看到时一律以你本地 `/model` 面板、`codex --help` 实际显示为准，别背名字。

---

## 01 基础概念：所有术语的地基

这一组是「物种级」的概念——不光 Codex，几乎所有 AI 编程工具都绕不开。先把这三个吃透，后面的词才好挂上去。

**代理（Agent，又叫智能体）**

一句话：**能自己拆任务、调工具、看结果、再决定下一步的 AI，不是一问一答的聊天框。**

在 Codex 里指什么：Codex 就是 OpenAI 的「编程代理」，它能自己读代码、改文件、跑命令、跑测试，全程你看着就行。这跟你平时用的聊天机器人是两个物种——聊天框只会回你一段文字，代理会把整件事干完。

**代理循环（Agentic Loop）**

一句话：**代理干活的基本节奏——想 → 做 → 看，一轮不行再来一轮。**

**类比：修水管的师傅。** 他不是看一眼就报价走人——先「想」（哪儿漏了），再「做」（拧一下、换个垫片），然后「看」（开水试试还漏不漏），不行就回头再拧。Codex 干活就是这个循环：读文件、改代码、跑检查，验证没过就再来一轮，直到搞定。这套机制和 Claude Code 一模一样，换了个壳。

**上下文窗口（Context Window）**

一句话：**模型一次能「同时看到」的信息总量，有上限，塞满了早先的内容就会被挤掉。**

**类比：一张办公桌的桌面。** 桌子就这么大，你能摊开的文件有限。新文件铺上来，最早那几张就被推到边上、甚至掉地上——模型「忘了」前面说过啥，多半就是这么回事。所以聊太久、塞太多无关内容，它反而会变笨。这也是子代理存在的理由：把吵闹的中间产物搬出主桌面。

**token（词元）**

一句话：**模型处理文本的最小计价单位，大致是「一个词或半个词」，你的输入输出都按它计数。**

在 Codex 里指什么：两件事跟它直接挂钩——**额度和钱**。订阅套餐按 token 用量给你额度，API key 直接按 token 烧钱；旗舰模型的单价是轻量模型的好几倍。上下文窗口的「大小」也是用 token 量来衡量的。

| 术语 | 一句话记住 |
| --- | --- |
| 代理 | 会自己动手的 AI，不只是回你话 |
| 代理循环 | 想 → 做 → 看，不行再来一轮 |
| 上下文窗口 | 它一次能看到的信息总量，有上限 |
| token | 计量文本的最小单位，关乎额度和钱 |

> 💡 一句话总结：这四个是地基——代理会自己干活、循环是它的节奏、上下文窗口是它的桌面大小、token 是计价的尺子。

---

## 02 Codex 专有概念：这套工具的独门词

这一组是 Codex 自己的料，也是新手最容易「时灵时不灵」的来源。搞懂它们，你就不会再觉得 Codex 行为飘忽了。

**`AGENTS.md`（项目说明书）**

一句话：**放进项目里的一个 markdown 文件，写下你这个项目的规矩，Codex 每次开工前先读。**

**类比：贴在工位上的便利贴。** 你不会每天追着同事念「咱们用 pnpm 不用 npm」，写张便利贴贴那儿，他自己看。`AGENTS.md` 就是给 Codex 的便利贴：构建怎么跑、测试怎么跑、命名怎么取，写一次，它每次先读。它能放全局（`~/.codex/AGENTS.md`）也能放项目根目录，离工作目录越近的越优先（它约等于 Claude Code 的 `CLAUDE.md` 换了个名）。

**`codex exec`（非交互命令）**

一句话：**不进交互界面、直接「给一句话、拿一个结果」的运行方式，专门给脚本和自动化用。**

**类比：自动售货机。** 普通交互模式像跟柜员聊天——你问一句它答一句，来回好几轮。`codex exec` 像投币买水：投钱、按键、出货，一步到位、不寒暄。写进 CI、定时任务、批处理脚本里的，基本都是它。

**沙箱（Sandbox）**

一句话：**给 Codex 画的一道边界，圈内的事它自己干，要出圈得先问你。**

**类比：游乐场的护栏。** 护栏里的滑梯随便玩，不用你盯；想翻出去跑到马路上，就得拦一下。沙箱管两样东西——**它能改哪些文件、能不能联网**。常见三档：`read-only`（只读，啥都不许动）、`workspace-write`（工作区可写，日常默认，只能改你启动 Codex 那个目录里的东西、默认不许联网）、`danger-full-access`（完全访问，名字带 danger 不是吓你的，慎用）。

**审批（Approval，审批策略）**

一句话：**Codex 要「出圈」时，停不停下来问你——这是和沙箱并排的另一个旋钮。**

**类比：门口保安的脾气。** 沙箱是那道门，审批是保安松还是紧。`untrusted` 只拦陌生命令，`on-request` 默认在圈里干、要出圈才问你（最常用的平衡档），`never` 闷头干不打扰你。记住：**沙箱管「能不能」，审批管「问不问」，两个维度别混。**

**推理强度（Reasoning Effort，配置键 `model_reasoning_effort`）**

一句话：**让模型「动手前想多久」的旋钮，想得越久通常越准、但越慢。**

**类比：考试时给的答题时间。** 同一个学霸，让他扫一眼就答、跟让他打草稿反复验算再答，质量天差地别，但后者明显更慢。五档：`minimal`（几乎不想，秒答）、`low`、`medium`、`high`、`xhigh`（顶格，看模型支不支持）。结果不满意先别急着换模型——往上提一档常常就解决了；嫌慢就降一档。

**推理摘要（配置键 `model_reasoning_summary`）**

一句话：**你想看多少它的「思考过程」。**

在 Codex 里指什么：取值 `auto` / `concise` / `detailed` / `none`。想看它怎么一步步想的，调 `detailed`；觉得刷屏碍事，调 `none` 直接关。纯体验开关，跟结果质量无关。

**服务层级（`service_tier`）**

一句话：**给你的请求排个优先级——是优先省钱还是优先快。**

**类比：快递的标快和特快。** `fast`（快速）官方明确是「加 credit 把模型提速 1.5x」，像特快加钱保时效；`flex`（弹性）更偏常规档、不额外加速。赶时间且不在乎那点 credit 消耗，可以试 `fast`，否则默认就好。

**`config.toml`（配置文件）**

一句话：**Codex 的总配置文件，放在 `~/.codex/config.toml`，TOML 格式。**

在 Codex 里指什么：上面这些旋钮——默认模型、推理强度、沙箱模式、审批策略、MCP server——想让它每次启动都生效，就写进这个文件。临时改用斜杠命令，永久改写这里。

**Chronicle / 记忆（Memory）**

一句话：**让 Codex 记住你早先聊过的偏好和项目惯例，省得每次重新交代。**

在 Codex 里指什么：**记忆默认是关的**，要在设置里或 `config.toml` 的 `[features]` 段写 `memories = true` 才开，且有地区限制、存在本地。**Chronicle 是实验性的研究预览**，更进一步——用你屏幕上的内容帮它理解你最近在忙啥，目前只对 ChatGPT Pro、且只在 macOS 上可用。一句忠告：真正必须每次生效的规矩，写进 `AGENTS.md`，别指望记忆兜底。

我自己刚上手 Codex 那会儿，最先被绊住的就是沙箱——让它批量重命名文件，桌面上那两个纹丝没动，我还以为它挑食，翻文档才知道是 `workspace-write` 把它们圈在了我项目目录之外。**这一组里最该先记牢的就是沙箱和审批这对兄弟**，它俩解释了 Codex 八成的「为啥它不肯动」。

> 💡 一句话总结：Codex 专有词里，沙箱 + 审批管权限、`AGENTS.md` 管规矩、推理强度管「想多久」、`codex exec` 管自动化，全写进 `config.toml` 永久生效。

---

## 03 扩展能力：把 Codex 的本事接出去

基础和专有概念是 Codex 的「本体」，这一组是给它「加装备」的——五个词长得有点像，最容易混，我用一句话各自钉死。

**MCP（Model Context Protocol，模型上下文协议）**

一句话：**一套统一标准，让 Codex 能接上各种外部工具——数据库、设计稿、浏览器、第三方服务。**

**类比：USB 接口。** Codex 默认只够得着本地文件和命令，够不着你的 Figma、最新文档、线上数据库。MCP 就是那个统一接口：**接一次，一堆外部工具就全摆到它面前。** 不用为每个工具单独写对接代码，这正是「标准」的价值。

**子代理（Subagent）**

一句话：**主对话临时派出去、并行干专项活的小代理，各干各的、只把摘要汇总回来。**

**类比：分头办事的几个跑腿。** 你（主线）要把一次改动从安全、性能、测试三个角度都审一遍，犯不着自己顺着查三趟——派三个跑腿同时出门，回来各递一份摘要。关键点：**Codex 绝不自动拆活，得你在话里明说「开几个 agent 并行、等齐、回汇总」它才动**。它的核心价值是把吵闹的中间产物搬出你的主桌面（还记得上下文窗口吗）。

**技能（Skill，Agent Skills）**

一句话：**把一套固定步骤打包成一身本事，写一次，之后 Codex 随手就能照着做。**

**类比：菜谱卡。** 「总结未提交的改动并标出风险」这种你反复要它做的活，与其每次重打一遍指令，不如写成一张菜谱卡（`SKILL.md`），里头写清 `name`、`description` 和步骤。之后点名就能调，或者它根据你的话自动匹配。手机上的「快捷指令」也是这个味儿。

**钩子（Hook）**

一句话：**挂在 Codex 干活生命周期某个时机上的自动脚本，事件一发生它必然触发。**

**类比：自动感应灯。** 它不关心你是谁、要去哪，只要「有人经过」这个事件发生，灯就必然亮。Hook 就是这样——在「调工具前」「调工具后」「答完话」「会话开场」这些时机，自动跑你指定的脚本。它和 `AGENTS.md` 的差别在于：手册是「请求」，Hook 是「必然兑现的保证」。

**插件（Plugin）**

一句话：**把若干 Skill、MCP server、集成打成一个套装盒，一次装齐、整体管、整体撤。**

**类比：装修的「整套样板间」。** 散件买，你得逐个找货号、对尺寸、自己拼；打成套装，一个订单到手就是样板间那样。单条工作流自用，写个 Skill 就行；**要跨项目复用、团队共享、统一发版本，才值得打成插件**。

| 术语 | 一句话区分 | 你什么时候碰它 |
| --- | --- | --- |
| MCP | 接外部工具的统一接口 | 想让它连数据库 / 设计稿 / 浏览器 |
| 子代理 | 并行干专项活、回汇总 | 一件事要从多个角度同时审 |
| Skill | 把固定步骤打包成一招 | 同一套流程你反复要它做 |
| Hook | 特定时机自动触发的脚本 | 想强制「每次都自动跑某件事」 |
| Plugin | 一堆能力打成套装一键装 | 要团队共享、统一管理一整套配置 |

> 💡 一句话总结：MCP 接工具、子代理分活、Skill 打包流程、Hook 卡时机、Plugin 装整套——五个词，记住「各自解决什么问题」就不会混。

---

## 04 模型相关：派谁去干活

最后这组关乎「敲下回车那一刻，背后是哪个模型在帮你」。模型名会随版本变，这里讲的是定位和概念，具体有哪些一律看你本地 `/model` 面板。

**`gpt-5.5`（旗舰、默认）**

一句话：**当前推荐的旗舰模型，最强也最贵，不设置就默认用它。**

在 Codex 里指什么：复杂编程、跨模块重构、难缠 bug、研究类工作流，派它准没错。多数情况这就够用，你从没设过就是它。

**`gpt-5.4-mini`（轻量、快而省）**

一句话：**轻量模型，跑得快、花得少，适合又多又简单的活儿，也常给子代理用。**

在 Codex 里指什么：改小 bug、调格式、补注释、批量清理这类「体力活」，派它比派旗舰省钱省时间。

**`gpt-5.4`（正式版，区别于 mini）**

一句话：**介于旗舰和 mini 之间的正式模型，也在用、没被淘汰，和 `gpt-5.4-mini` 是一组，别把两者搞混。**

在 Codex 里指什么：「名字一样但没有 mini」——它比 mini 更强，但比 `gpt-5.5` 旗舰省钱省时间；要平衡质量和成本时可以考虑它。`gpt-5.4-mini` 是它的轻量档，两者不是同一个模型。

**`gpt-5.3-codex-spark`（即时型，研究预览）**

一句话：**为「秒回」优化的即时型模型，适合连珠炮式的高频迭代。**

在 Codex 里指什么：它是研究预览，目前只对 ChatGPT Pro 开放，**没看到它很正常，不是你装错了**。需要它问一句你秒答一句的现场结对时才用得上。

**研究预览（Research Preview）**

一句话：**官方放出来给小范围用户先试的「提前体验版」，功能可能随时变、范围常受限。**

在 Codex 里指什么：像 `gpt-5.3-codex-spark`、Chronicle 这些标着「研究预览」的东西，共同点是——**可能只对某套餐 / 某平台开放、随版本说没就没**。看到这四个字，就当它是「尝鲜功能，别拿来扛生产」。

**已弃用模型（Deprecated）**

一句话：**官方已经标为淘汰、不再推荐的旧模型，别再写进配置。**

在 Codex 里指什么：`gpt-5.2` 和 `gpt-5.3-codex` 在 ChatGPT 登录方式下已被官方标为弃用。**如果你的脚本、`config.toml` 或 `codex exec --model` 里还写着它们，趁早换成最新的。** 我自己上个月就栽过——一个半年前写的自动化脚本里硬编码了老模型名，跑起来直接报模型不可用，翻了半天才想起是这茬。

| 模型 | 定位 | 最适合 |
| --- | --- | --- |
| `gpt-5.5` | 旗舰、默认 | 复杂编程、重构、难缠 bug、研究 |
| `gpt-5.4` | 正式版（中间档） | 平衡质量与成本 |
| `gpt-5.4-mini` | 轻量、快省 | 简单批量活、给子代理用 |
| `gpt-5.3-codex-spark` | 即时型（研究预览） | 高频实时迭代，求秒回 |
| `gpt-5.2` / `gpt-5.3-codex` | 已弃用 | 别再用，换成最新的 |

> 💡 一句话总结：旗舰 `gpt-5.5` 啃硬活、`gpt-5.4` 中间档、`gpt-5.4-mini` 跑快省、`gpt-5.3-codex-spark` 求秒回；「研究预览」=尝鲜版，弃用的两个名字别再写进配置。

---

## 05 怎么用好这本词典

词典这东西，放着不用就是摆设。给你三个我自己实测有效的用法：

**第一，读其它篇卡住时，回这儿搜词、看完就走。** 别在术语上死磕，这一篇就是给你随时打断、随时回查的——这正是它和其它篇的区别：其它篇从头读，这篇 Ctrl+F 着用。

**第二，把「最容易混的几对」单独记牢。** 我自己最初栽过跟头的就那么几对，列出来你照着核对：

| 容易混的一对 | 怎么区分 |
| --- | --- |
| 沙箱 vs 审批 | 沙箱管「能不能」，审批管「问不问」 |
| 推理强度 vs 模型 | 强度是「想多久」，模型是「派哪个人」 |
| `AGENTS.md` vs 记忆 | 手册是必然生效的规矩，记忆是概率性的回忆 |
| Skill vs Plugin | Skill 是一招，Plugin 是一堆招打的套装 |
| 子代理 vs Hook | 子代理你开口才拆，Hook 到点必触发 |

**第三，动手验一遍最快记牢。** 拿你最常忘的那个概念，去对应章节跑一遍它的动手环节——比如对沙箱没感觉，就回〔[02 核心概念](02-core-concepts.md) 〕跑那个「只读模式下建文件被拦」的小实验。我带过几个完全不懂命令行的朋友入门 Codex，**凡是亲手跑过一遍沙箱拦截的，没一个再问我「它为啥不肯改文件」**——亲眼见一次，顶看十遍解释。

> 💡 一句话总结：这本词典是用来「随时查」的——卡住就搜词、混淆的几对单独记、最不熟的那个概念回去动手跑一遍。

---

## 小结

这一篇把全书的术语收成了一本随身词典，分四组钉死：

- **基础概念**：代理、代理循环、上下文窗口、token——所有概念的地基。
- **Codex 专有**：`AGENTS.md`、`codex exec`、沙箱、审批、推理强度、`service_tier`、Chronicle——这工具的独门词，也是「时灵时不灵」的来源。
- **扩展能力**：MCP、子代理、Skill、Hook、Plugin——五件套各解决一个问题，记「干啥用的」不混。
- **模型相关**：`gpt-5.5` 这一串的定位、研究预览是啥、哪两个已弃用。

**你现在应该能**：再看到任何一篇里冒出的术语，知道回这儿哪一组找；把最容易混的几对一眼分清；碰到没感觉的概念，知道回对应章节动手验一遍。

说到底，**术语从来不是用来背的，是用着用着就刻进肌肉的**。这本词典的作用，就是在它还没刻进去之前，给你一个随时能查的兜底。

---

下一篇〔[39 企业管理与治理](39-enterprise.md) 〕，咱们把镜头从「一个人怎么用 Codex」拉到「一家公司怎么把 Codex 管起来」：权限怎么统一发、合规怎么兜底、几十上百号人用同一套工具怎么不乱套。留个小思考——你回头看这一篇里的沙箱和审批，**当只有你一个人用时它们是「自己给自己设的安全带」，那当一个团队几十人共用时，这条安全带该由谁来系、能不能让人随手解开？** 这正是下一篇要解的题。
