交流群即将上线
术语表
这一页是我们自己写的
官方也有一份术语表， 但那一页的词条是由前端组件渲染的，Markdown 里没有正文，镜像不过来， 所以这里重写了一份。以官方页面为准。
智能体与运行
智能体（Agent） 会自己读文件、改文件、跑命令、看结果并继续推进的程序。 和补全工具的区别在于它有行动能力，所以「它被允许动什么」和「它写得对不对」同等重要。
子智能体（Subagent） 由 Codex 启动、受委派处理特定任务的智能体。返回摘要而不是原始输出， 用来把容易产生干扰信息的工作移出主线程。→ 进阶 03
智能体线程（Agent thread） 子智能体执行工作的线程。CLI 里用 /agent 查看和切换。
子智能体工作流（Subagent workflow） Codex 并行运行多个智能体并汇总结果的工作流。
上下文污染 / 上下文腐化 前者指有用信息被杂乱的中间输出淹没，后者指聊天被低相关细节填满导致性能逐渐下降。 子智能体和开新会话是主要对策。→ 快速上手 06
推理强度（model_reasoning_effort） 模型在给出答案前投入多少推理。强度高质量好但慢且贵。
权限与安全
沙盒模式（Sandbox mode，--sandbox） Codex 执行命令时技术上能做到什么。三档：read-only、workspace-write、 danger-full-access。→ 快速上手 04
审批策略（Approval policy，--ask-for-approval） 哪些动作必须先停下来问你。三档：untrusted、on-request、never。 注意它和沙盒是两层，never 不等于放开权限。
工作空间（Workspace）workspace-write 下可写的范围：当前目录加上 /tmp 之类的临时目录。 用 /status 看当前会话具体包含哪些目录。
受保护路径（Protected paths） 可写根目录里仍然只读的地方：.git、.agents、.codex，递归生效。 这保证了 Git 这条退路始终有效。
自动审查（approvals_reviewer = "auto_review"） 把符合条件的审批请求先交给一个审查智能体，按策略检查数据外泄、凭据探测、 削弱安全防护、破坏性操作等风险。→ 自动审查
安全监控（Safety monitoring） 异步运行的监控，检测到模型可能存在不安全行为时可以暂停任务。 暂停可能在触发它的活动发生之后才生效，不能替代沙盒、权限控制和结果审查。
受信任的项目（Trusted project） 只有信任某个项目，Codex 才会加载它的 .codex/ 配置层——包括项目本地配置、钩子和规则。 这是一道真实的安全闸，别一路回车过去。
规则（Rules） 控制哪些命令能在沙盒外运行，放在生效配置层旁的 rules/ 目录里， 用 prefix_rule 写。属于实验阶段功能。→ 规则
requirements.toml 管理员下发的强制约束，管本地运行时能做什么。和 ChatGPT 工作空间的角色、群组分开管理。 → 托管配置
指令与扩展
AGENTS.md 项目指令文件。Codex 在执行任何工作前都会读。支持分层：全局 → 项目根 → 子目录， 越靠近当前目录的越晚出现、覆盖前面的。→ 快速上手 05
AGENTS.override.md 同一层里存在时完全取代 AGENTS.md，不是叠加。用来做临时覆盖而不删基础文件。
指令链（Instruction chain） Codex 启动时按优先级构建的一条指令序列，每次运行只构建一次。
技能（Skill） 一项具体任务或工作流所需的指令和配套资源，打包成一个含 SKILL.md 的目录。 采用渐进式披露：先只加载名称和描述，选中了才读完整指令。→ 进阶 01
渐进式披露（Progressive disclosure） 技能的上下文管理机制。初始技能列表最多占模型上下文窗口的 2% （窗口未知时最多 8000 字符）。
插件（Plugin） 可安装的套件，可以包含技能、连接器或两者。ChatGPT 和 Codex 共用同一个插件目录。
连接器（Connector） 由 MCP 服务器提供支持的外部服务连接，可以带自定义 ChatGPT 界面。
MCP（模型上下文协议） 给智能体接外部工具的协议。两种形态：STDIO（本地进程）和 Streamable HTTP（通过地址访问）。 → 进阶 02
钩子（Hooks） 在特定时机（如 PreCompact / PostCompact / SessionStart）触发的自定义动作。 → 钩子
命令与运行方式
codex exec 非交互模式。进度流到 stderr，只有最终消息打到 stdout。 默认在只读沙盒里跑。→ 进阶 04
--ephemeral 这次运行不在磁盘上持久保存会话记录。
--output-schema 要求最终响应符合指定的 JSON Schema，供下游自动化消费。
工作树（Worktree） Git 工作树，把改动隔离在一个单独的检出里，不碰你正在编辑的分支。 桌面应用开 Codex 聊天时可以选这个模式。→ Git 工作树
Codex 云端（Codex cloud） 在 OpenAI 托管的隔离容器里跑。两阶段模型：设置阶段可联网装依赖， 智能体阶段默认离线；给环境配的机密只在设置阶段可用。必须用 ChatGPT 账号登录。
配置方案（Profile） 存成 ~/.codex/profile-name.config.toml 的一组设置，用 --profile profile-name 选。
压缩（Compaction） 上下文逼近阈值时把历史浓缩成摘要。相关配置：model_auto_compact_token_limit、 model_auto_compact_token_limit_scope。
界面
Codex CLI — 终端里的 Codex，也是唯一能直接进脚本和 CI 的形态。
Codex IDE 扩展 — 编辑器里的 Codex。
ChatGPT 桌面应用 — macOS / Windows / Linux；开 Codex 聊天时选本地、工作树或云端。
ChatGPT Work — 要一份能审的成品时用的模式，和「聊天」「Codex」在同一个切换器里。