官方教程中文版新手必读
新手术语速查表
这页给第一次使用 Codex 的中文开发者快速查词。先知道这些词在什么场景出现，再去读对应章节，会比一开始背概念更稳。
这页给第一次使用 Codex 的中文开发者快速查词。先知道这些词在什么场景出现，再去读对应章节，会比一开始背概念更稳。
| 术语 | 你可以先这样理解 | 什么时候会遇到 | 继续阅读 |
|---|---|---|---|
| Codex | OpenAI 面向编程任务的 AI coding agent | 让它读项目、改代码、跑测试、解释报错时 | 理解 Codex 定位 |
| Agent | 能根据目标持续执行多步任务的 AI 助手 | Codex 规划步骤、调用工具、等待命令结果时 | 快速上手 Codex |
| Thread | 一次连续任务对话 | App、Cloud 或 IDE 里管理多个任务时 | 掌握 App 核心功能 |
| Local thread | 在本机项目里运行的任务 | 需要读取本地文件、修改本机代码时 | 使用命令行版 Codex |
| Cloud task | 在云端环境执行的任务 | 想把任务交给 Codex 后异步等待结果时 | 配置云端运行环境 |
| Sandbox | 限制 Codex 能访问和能执行什么的安全边界 | 看到文件读写、命令执行、网络访问限制时 | 理解沙箱边界 |
| Approval | Codex 执行敏感操作前向你确认 | 它要联网、写文件、跑有风险命令时 | 设置审批和安全边界 |
| AGENTS.md | 给 Codex 看的项目规则文件 | 想固定项目约定、测试命令、禁止事项时 | 编写项目规则文件 |
| config.toml | Codex 的本地配置文件 | 需要调整模型、审批、沙箱、工具等设置时 | 配置 Codex 基础选项 |
| MCP | 让 Codex 接入外部工具和上下文的协议 | 需要连接 GitHub、文档、数据库、搜索等工具时 | 接入 MCP 工具和上下文 |
| Skill | 可复用的任务能力包 | 想把常用流程沉淀给 Codex 反复使用时 | 用 Skills 复用能力 |
| Subagent | 把大任务拆给更小的专门 agent | 任务很大、需要并行查资料或分模块处理时 | 用 Subagents 拆分任务 |
| Hook | 在特定时机自动执行的检查或命令 | 想在任务前后自动 lint、test、记录日志时 | 用 Hooks 接入自动检查 |
| Workflow | 多步骤任务编排 | 想把固定工作流交给 Codex 按顺序执行时 | 用 Workflows 编排任务 |
| Plugin | 把工具、技能或集成能力打包给 Codex 使用 | 想安装或构建一组可复用扩展时 | 安装和管理插件 |
| Worktree | Git 里的独立工作区 | 想让多个任务并行改代码、减少互相影响时 | 用 Worktrees 并行开发 |
| Computer Use | 让 Codex 操作电脑界面 | 需要它打开 App、点击页面、做人工验收时 | 让 Codex 操作电脑 |
| Prompt | 你给 Codex 的任务说明 | 每次描述目标、边界、交付物时 | 写好 Codex 提示词 |
| Diff | 文件修改前后的差异 | Codex 改完后你审查具体变更时 | 在 App 中审查改动 |
| Validation | 确认改动真的可用的验证步骤 | 跑测试、构建、截图、人工检查时 | 第一次安全使用清单 |
新手判断法
遇到新词时，不要先问“它的定义是什么”，先问三个问题：
- 它是在限制 Codex、扩展 Codex，还是让 Codex 执行任务？
- 它会不会影响本机文件、网络、凭据或代码仓库？
- 我需要现在就配置它，还是等真实场景出现再学？
多数新手第一天只需要掌握 Codex、Thread、Sandbox、Approval、AGENTS.md、Prompt、Diff 和 Validation。MCP、Skills、Subagents、Hooks 可以等你已经能稳定完成小任务后再学。