Codex Glossary：常见术语速查和中文解释

适用场景

Codex 的文档横跨桌面 App、CLI、IDE Extension、Cloud、SDK、MCP、Plugins 和企业治理。很多词看起来相似，但边界不同。比如 Plugin 和 Skill 都能复用能力，但一个偏安装分发，一个偏工作流说明；Local 和 Cloud 都能执行任务，但运行位置、权限和环境准备不同。

这篇文章用于快速消除这些概念混淆。

核心角色和任务

| 术语 | 中文理解 | 你需要知道的边界 | | --- | --- | --- | | Agent | 执行任务的 Codex 工作单元 | 会读取上下文、调用工具、提出审批或修改文件 | | Thread | 一段 Codex 会话 | 任务、消息、上下文和结果都围绕 thread 组织 | | Turn | 一轮用户请求和 Codex 响应 | 长任务可以由多个 turn 累积完成 | | Context | Codex 可用的信息 | 包括文件、消息、工具输出、截图、规则和配置 | | Compaction | 压缩旧上下文 | 长线程继续工作时，用摘要保留关键历史 |

理解这些词后，你会更容易判断“Codex 现在是在继续同一个任务，还是应该新开线程”。

本地、云端和环境

| 术语 | 中文理解 | 常见位置 | | --- | --- | --- | | Local | 在你的电脑上执行 | App、CLI、IDE | | Cloud | 在 OpenAI 托管环境中执行 | Web、App、IDE | | Cloud environment | 云端任务使用的容器环境 | 依赖安装、环境变量、网络规则都在这里配置 | | Connected host | 为远端任务提供文件或工具的主机 | 远程连接、移动端控制电脑等场景 | | Worktree | Git 的独立工作区 | App 中常用于并行任务和隔离改动 |

本地模式更贴近你的机器和工具链；云端模式更适合把任务交给远端跑，但需要提前准备环境和权限。

权限、安全和审批

| 术语 | 中文理解 | 使用建议 | | --- | --- | --- | | Approval policy | 什么时候需要请求批准 | 不要对不熟悉项目直接开高权限 | | Approval request | Codex 请求允许某个受限动作 | 看清命令、路径、网络目标和原因 | | Sandbox | 限制文件、命令和网络访问的执行边界 | 用来减少误写、误删和越权访问 | | Filesystem permission | 文件系统读写规则 | 对 secrets、私有数据和大目录要谨慎授权 | | Full access | 更少限制的执行模式 | 只在你明确理解风险时使用 |

审批和沙箱不是阻碍效率的按钮，而是让 Codex 可以安全工作的护栏。

自定义和复用

| 术语 | 中文理解 | 适合做什么 | | --- | --- | --- | | AGENTS.md | 项目或用户级长期规则 | 写代码风格、测试命令、目录约定 | | config.toml | 本地 Codex 配置 | 模型、审批、沙箱、MCP、profiles | | Rule | 可复用规则 | 比一次性 prompt 更稳定 | | Hook | 生命周期事件处理 | 在工具调用、审批或任务结束时触发检查 | | Skill | 可复用工作流说明 | 把固定任务沉淀成可调用能力 | | Plugin | 可安装分发的能力包 | 可以包含 skills、MCP、集成和元数据 | | MCP | Model Context Protocol | 连接外部工具、资源和上下文的标准 |

一个实用判断是：只给当前任务看的内容写 prompt；长期适用写 AGENTS.md 或规则；要跨团队分发就考虑 Plugin。

安装和入口相关术语

| 术语 | 中文理解 | 入口 | | --- | --- | --- | | Codex App | 桌面应用 | 适合多线程、worktree、自动化、浏览器和电脑使用 | | Codex CLI | 终端客户端 | 适合命令行、脚本和 CI | | Codex IDE extension | 编辑器扩展 | 适合在代码编辑器中添加上下文和发起任务 | | Codex web | 浏览器入口 | 适合云端任务和远端协作 | | Appshot | 前台应用窗口快照 | macOS App 中把当前窗口作为上下文发送给 Codex |

选择入口时不要只看功能多少，要看你平时在哪里工作。

常见混淆

Plugin 不是 Skill 的同义词。Skill 是工作流说明，Plugin 是安装和分发单位。

Cloud environment 不是你的本地电脑。它需要单独准备依赖、环境变量和网络访问。

Approval request 不是普通提示。它通常意味着 Codex 想执行受限命令、写文件、联网或访问更高权限资源。

小结

学习 Codex 的第一步不是背所有功能，而是建立术语地图。只要你能区分入口、上下文、执行环境、审批、沙箱、MCP、Skill 和 Plugin，就能更准确地阅读后续手册，也能更清楚地给 Codex 分派任务。