跳到主要内容

Codex 官方教程与用户案例

这本小册子面向中文用户，整理自 Codex 官方提供的教程、产品说明和用户案例。原始内容覆盖 Codex App、配置、插件、Skills、Subagents、Sites，以及大量真实工作场景；这里把它们重新组织成更适合中文读者学习和推广的结构。

全书分成两大部分：

  1. 第1部分 Codex 使用与扩展：先理解 Codex 怎么用、怎么配置、怎么连接工具、怎么沉淀技能和自动化。
  2. 第2部分 Codex 用户案例：再看 Codex 在真实工作中的典型用法，包括办公协作、产品设计、代码工程、移动开发、数据财务、团队运营、安全评估和科研工作流。

这不是官方文档的逐字搬运，而是忠实保留官方结构和要点后的中文化整理：尽量完整覆盖官方教程和案例中的关键概念、步骤、配置项、适用场景和注意事项，同时加入更适合国内用户理解的提示词示例和实践说明。

第1部分：Codex 使用与扩展​

这一部分对应 Codex 官方教程中的基础使用和能力扩展内容，适合刚开始系统学习 Codex 的用户。它回答的是“Codex 是什么、在哪里配置、怎么和工具连接、怎样把工作流做成长期能力”。

  1. Codex 使用：桌面端功能、设置、Review、自动化、Worktrees、本地环境、内置浏览器、Chrome 扩展、Computer Use、Appshots、Windows 和排错。
  2. Codex 配置：config.toml、高级配置、环境变量、权限、Rules、Hooks、AGENTS.md 和 MCP。
  3. 插件：插件是什么、如何安装使用、如何构建自己的插件。
  4. Sites 发布：如何用 Sites 创建、保存、部署和管理托管网站。
  5. Skills 技能：如何理解、创建和设计可复用技能。
  6. Subagents 子代理：如何并行调用专门代理、管理代理和配置自定义代理。

第2部分：Codex 用户案例​

这一部分对应 Codex 官方用户案例，适合从“我能拿 Codex 做什么”这个问题切入。它把官方案例重新按中文用户更容易理解的工作场景分类：

  1. 日常协作与办公自动化：邮件、消息、会议、长期目标、Computer Use 和自动化助理。
  2. 产品、设计与前端原型：截图到 UI、Figma 到代码、用户故事到 mock、创意到原型、浏览器小游戏。
  3. 代码库工程与交付：PR review、大型代码库理解、API 升级、部署、迁移、重构、文档更新和 CLI。
  4. 移动与桌面原生开发：iOS、macOS、SwiftUI、App Intents、模拟器调试、React Native / Expo。
  5. 数据分析、财务与报告：数据清洗、表格查询、数据报告、现金流、DCF、预算差异复盘。
  6. 团队知识与运营：新员工入职、会议简报、PRD、运营 SOP、内部工具和活动 playbook。
  7. 质量、安全与评估：bug 分诊、Computer Use QA、安全扫描、漏洞修复、依赖事故审计、AI eval。
  8. 科研与生命科学：蛋白质折叠、scRNA-seq、bulk RNA-seq、药物靶点优先级。

推荐阅读路线​

  1. 如果你是新手，先读“Codex 使用”和“Codex 配置”，理解桌面端、权限、模型和项目配置。
  2. 如果你想把 Codex 用在日常办公，读“日常协作与办公自动化”和“团队知识与运营”。
  3. 如果你是开发者，读“代码库工程与交付”“质量、安全与评估”“移动与桌面原生开发”。
  4. 如果你负责产品、设计或增长，读“产品、设计与前端原型”和“数据分析、财务与报告”。
  5. 如果你想把 Codex 变成团队能力，再读“插件”“Skills 技能”“Subagents 子代理”和“Sites 发布”。

使用 Codex 的通用方法​

把任务交给 Codex 时，不要只写一句“帮我做一下”。更好的方式是说明来源、目标、边界和验收方式：

请基于这些资料完成这个任务。
输出：计划、具体产物、需要我确认的问题、验证方式。
不要执行发送、删除、付款、发布、承诺等不可逆动作。
完成后请告诉我改了什么、在哪里验证、还有什么风险。

Codex 最擅长的不是替你拍脑袋做决定，而是把复杂工作拆成可验证步骤，并把结果整理成你能审阅、继续推进的材料。