这份 glossary 可作为 Codex 在 app、CLI、IDE extension、cloud、SDK 及相关 integrations 中使用术语的快速参考。
| 术语 | 定义 | 适用范围 |
|---|---|---|
| Agent | Codex worker，会基于 context 进行 reasoning、使用 tools，并完成 task。 | App, CLI, IDE extension, Cloud |
| AGENTS.md | 仓库或用户级 guidance file，为 Codex 提供持久 instructions。 | App, CLI, IDE extension, Cloud |
| Analytics dashboard | 用于查看 Codex usage、adoption 和 code review metrics 的 admin view。 | Enterprise |
| API key sign-in | 使用 OpenAI API key 进行 authentication。 | App, CLI, IDE extension |
| Approval policy | 规定 Codex 在执行 action 前何时必须询问的 rules。 | App, CLI, IDE extension |
| Approval request | Codex 请求允许某个 restricted action。 | App, CLI, IDE extension |
| Apps (connectors) | 让 Codex 访问 external services 的 integration。可通过 plugins 提供，也称为 connectors。 | App, CLI, IDE extension |
| Appshot | 发送到 Codex thread 的 frontmost app window snapshot。 | App |
| Auth cache | Codex 复用的本地 stored login credentials。 | App, CLI, IDE extension |
| Automatic approval review | eligible approval requests 继续前，由 model 执行的 review。 | App, CLI, IDE extension |
| Automation | scheduled 或 recurring 的 Codex task。 | App |
| Automation run | scheduled automation 的一次 execution，可能报告 findings 或 archive itself。 | App |
| Browser use | 让 Codex 直接操作 in-app browser 的 App capability。 | App |
| Chat | 不绑定 project 的 Codex conversation。 | App |
| ChatGPT sign-in | 使用 ChatGPT account 和 workspace permissions 进行 authentication。 | App, CLI, IDE extension, Cloud |
| Chronicle | 从 recent screen context 构建 memories 的 opt-in feature。 | App |
| Cloud | Codex 在 OpenAI-managed environment 中远程工作的 mode。 | App, IDE extension, Web |
| Cloud environment | 用于 Codex cloud tasks 的 configured container setup。 | Cloud |
| Cloud task | 在 cloud environment 中远程执行的 Codex task。 | Cloud |
| Cloud thread | 运行在 Codex cloud environment 中的 thread。 | Cloud |
| Codex | OpenAI 面向 software development tasks 的 coding agent。 | App, CLI, IDE extension, Web, Cloud, SDK |
| Codex app | Desktop app，可并行运行 Codex threads，并内置 worktree support、automations 和 Git functionality。 | Desktop |
| Codex app-server | Local JSON-RPC server，用于在 custom clients 中嵌入 Codex threads、turns、approvals、history 和 streamed events。 | App, IDE extension, SDK |
| Codex CLI | 用于 interactive 或 script 场景运行 Codex 的 terminal client。 | Terminal |
| Codex cloud | OpenAI-managed execution environment，Codex 可在其中远程处理 repository tasks。 | Web, App, IDE extension |
| codex exec | 从 scripts 或 CI non-interactively 运行 Codex 的 CLI command。 | CLI |
| Codex IDE extension | 在 VS Code、JetBrains IDEs、Cursor 和 Windsurf 等 IDE 中使用 Codex 的 editor integration。 | IDE |
| Codex SDK | 用于构建 Codex-powered workflows 或 integrations 的 programmatic interface。 | SDK |
| Codex web | 用于 delegation cloud tasks 的 browser-based Codex surface。 | Browser |
| Codex-managed worktree | Codex 为 thread 创建并管理的 temporary worktree。 | App |
| Compaction | 对 older context 做 summarization，让 long-running work 可以继续。 | App, CLI, IDE extension, Cloud |
| Compliance API | 用于导出 Codex activity 和 audit metadata 的 API。 | Enterprise |
| Computer use | 让 Codex 通过 UI 与 desktop applications 交互的 App capability。 | App |
| config.toml | 本地 Codex configuration files。 | App, CLI, IDE extension |
| Connected host | 为 remote Codex work 提供 files、tools 和 shell access 的 computer 或 development environment。 | App, Mobile |
| Connector | 让 Codex 访问 external services 的 App integration。可通过 plugins 提供，也称为 apps。 | App, Cloud |
| Container cache | 被保存的 cloud container state，用于加速 future tasks。 | Cloud |
| Context | Codex 工作时可使用的信息，例如 files、prior messages、tool output 和 instructions。 | App, CLI, IDE extension, Cloud, SDK |
| Context window | model 一次可以考虑的信息量上限。 | App, CLI, IDE extension, Cloud, SDK |
| Custom agent | 用户定义的 agent role，拥有自己的 instructions 和 settings。 | App, CLI |
| Deny-read rule | 阻止 Codex 读取 sensitive paths 或 glob matches 的 filesystem permission rule。 | App, CLI, IDE extension, Enterprise |
| Diff | 用于 inspection、comments、staging 或 reverting 的 Git file changes 集合。 | App, Git, Review |
| Domain allowlist | agent internet access 启用时，Codex cloud 可以访问的 domains 集合。 | Cloud |
| Environment (local) | 告诉 Codex 如何为 project 设置 worktrees 的 App configuration。 | App, Worktree |
| Environment variable | task execution 期间可用的 runtime configuration value。 | Cloud, CLI, IDE extension |
| Ephemeral session | 完成后跳过保存 session state 的 non-interactive run。 | CLI |
| Fast mode | 让 supported models 以更高 credit cost 更快响应的 speed setting。 | CLI, IDE extension |
| Filesystem permission | 为 paths 授予或拒绝 read/write access 的 permission profile rule。 | App, CLI, IDE extension |
| Finding | automation surfaced 的 notable result 或 issue。 | App |
| Full access | Codex 在没有 normal sandbox restrictions 的情况下运行的 mode。 | App, CLI, IDE extension |
| Git worktree | 同一个 repository 的第二份 checkout，用于 parallel branch work。 | App, Git |
| Handoff | 在线程及其 work 在 Local 和 Worktree 之间移动。 | App |
| Heartbeat | 按 schedule 唤醒现有 thread、让 Codex 回到同一 conversation 的 recurring thread wake-up。也称为 thread automation。 | App |
| Hook | 当 Codex event 匹配时运行的 lifecycle handler，例如 tool use、permission requests 或 turn stops。 | App, CLI, IDE extension |
| Hook event | configured hook handlers 可以运行的 lifecycle point。 | App, CLI, IDE extension |
| Hunk | diff 中可独立 staged、unstaged 或 reverted 的连续 section。 | App, Git, Review |
| Inline comment | 附加到 diff 中具体 line 的 feedback。 | App |
| Live web search | 用于 current information 的 real-time web lookup。 | App, CLI, IDE extension |
| Local | Codex 在用户 computer 上工作的 mode。 | App, CLI, IDE extension |
| Local thread | 在用户 machine 上运行的 thread。 | App, CLI, IDE extension |
| Maintenance script | cached cloud container resumes 时可选运行的 script。 | Cloud |
| Managed configuration | organization-controlled 的 Codex defaults 和 restrictions。 | Enterprise |
| MCP | Model Context Protocol，用于把 Codex 连接到 external tools 和 context 的 standard。 | App, CLI, IDE extension |
| MCP resource | MCP server 暴露给 Codex inspect 的 readable context。 | App, CLI, IDE extension |
| MCP server | 通过 MCP 暴露的 external tool 或 context provider。 | App, CLI, IDE extension |
| MCP tool | MCP server 暴露、Codex 可在 task 中调用的 action。 | App, CLI, IDE extension |
| MDM | 用于分发 device profiles 和 managed Codex settings 的 mobile device management tooling。 | Enterprise |
| Memories | Codex 可跨 sessions 复用的 locally stored context。 | App, CLI, IDE extension |
| Model | Codex 用于 reasoning 和 tool work 的 AI model。 | App, CLI, IDE extension, Cloud, SDK |
| Network access | commands 或 environments 访问 internet 的 permission。 | App, CLI, IDE extension, Cloud |
| Network policy | 基于 domain 的 allow/deny rules，用于约束 sandboxed outbound network traffic。 | App, CLI, IDE extension |
| Non-interactive mode | 从 scripts 或 CI 运行 Codex 的 CLI mode。 | CLI |
| Output schema | 传给 `codex exec`、用于约束 final response 的 JSON Schema。 | CLI |
| Permanent worktree | 作为独立 project 保留的 long-lived worktree。 | App |
| Permission profile | named least-privilege policy，组合 local command execution 的 filesystem 和 network rules。 | App, CLI, IDE extension |
| Plan | Codex 为完成 task 提出的或 tracked 的 steps。 | App, CLI, IDE extension, Cloud |
| Plugin | 可安装的 bundle，可分发 skills、tools 和 integrations。 | App, CLI, IDE extension |
| Plugin manifest | plugin metadata file，用于识别 plugin，并指向 bundled skills、apps、MCP servers、hooks 和 metadata。 | App, CLI, IDE extension, Plugins |
| Prefix rule | 匹配 command prefixes 并允许、提示或禁止的 command-rule pattern。 | App, CLI, IDE extension, Enterprise |
| Profile | Codex 的 named configuration preset。 | CLI, IDE extension |
| Progressive disclosure | 只在需要时加载 skill details，以保留 context。 | App, CLI, IDE extension |
| Project | Codex 工作的 selected codebase 或 folder。 | App |
| Prompt | 发送给 Codex 的 user instruction 或 request。 | App, CLI, IDE extension, Cloud, SDK |
| Pull request review | Codex 对 changes 的 review，或对 pull request 的 feedback。 | App, CLI, GitHub |
| RBAC | 面向 workspace permissions 的 role-based access control。 | Enterprise |
| Read-only mode | Codex 可以 inspect，但未经 approval 不能 modify 的 mode。 | App, CLI, IDE extension |
| Reasoning effort | 控制 model 使用多少 reasoning budget 的 setting。 | App, CLI, IDE extension, SDK |
| Remote connection | 让 Codex 通过 connected host 从另一台 device 工作的 connection。 | App, Mobile |
| requirements.toml | 面向 managed Codex setups 的 admin-enforced requirements file。 | Enterprise |
| Review pane | 用于 inspect diffs、comments 和 Git changes 的 App view。 | App |
| Rules | 允许、提示或拒绝 command prefixes 或 permission exceptions 的 policies。 | App, CLI, IDE extension |
| Sandbox | 限制 Codex commands 可访问或修改内容的 enforced boundary。 | App, CLI, IDE extension |
| Sandbox mode | 定义 Codex filesystem 和 network limits 的 configuration。 | App, CLI, IDE extension |
| Sandbox preset | SDK shorthand，用于 read-only、workspace-write 或 full access 等 common sandbox policies。 | SDK |
| Schedule | automation 的 timing rule。 | App |
| Secret | setup scripts 可用、但在 agent phase 前移除的 encrypted value。 | Cloud |
| Setup script | agent starts 前用于 install dependencies 或 prepare tools 的 script。 | App worktrees |
| Skill | 带有 instructions 和 optional scripts/references 的 reusable workflow package。 | App, CLI, IDE extension |
| Skill invocation | skill 的 explicit 或 implicit activation。 | App, CLI, IDE extension |
| Slash command | 以 slash 开头输入、用于控制或 inspect Codex CLI session 的 command。 | CLI |
| Standalone automation | 独立 scheduled run，会报告 separate findings。 | App |
| STDIO MCP server | 由 configured command 和 arguments 作为 local process 启动的 MCP server。 | CLI, IDE extension |
| Streamable HTTP MCP server | 通过 HTTP 访问的 MCP server，可选 bearer token 或 OAuth authentication。 | CLI, IDE extension |
| Subagent | spawned 出来、负责处理 task 一部分的 specialized child agent。 | App, CLI |
| Subagent workflow | Codex 并行运行 delegated agents 并合并其 results 的 workflow。 | App, CLI |
| Task | Codex 被要求完成的 work unit。 | App, CLI, IDE extension, Cloud, SDK |
| Thread | 包含 prompts、model output 和 tool activity 的单个 Codex session。 | App, CLI, IDE extension, Cloud, SDK |
| Thread automation | 附加到 existing thread 的 recurring wake-up。也称为 heartbeat。 | App |
| Thread fork | 从 existing thread 的 stored history branched 出来的 new thread。 | App-server, SDK |
| Turn | thread 中的一次 exchange，通常包含 user prompt 以及 Codex 的 response 和 actions。 | App, CLI, IDE extension, Cloud, SDK |
| Universal image | 带有 common tools preinstalled 的 default Codex cloud container image。 | Cloud |
| Web search cache | Codex 无需 live browsing 即可使用的 pre-indexed search results。 | App, CLI, IDE extension |
| Worktree | Codex 在 separate Git worktree 中隔离 changes 的 mode。 | App |
| Writable roots | Codex 被允许 modify 的 directories。 | App, CLI, IDE extension |