Codex 中文教程
0 基础入门到工程实战
一套面向 0 基础学习者的 Codex 中文指南。内容覆盖桌面 App、CLI、IDE 和 Cloud 四种入口，并深入 AGENTS.md、沙箱审批、MCP、Skills、子代理与自动化，共 39 篇，按学习路线循序渐进。
↓学习路线
第一次接触 AI 编程工具：从第一组开始，按编号顺序学习。已经会基础操作：直接进入第三、四组，补齐工作流、权限与扩展能力。只想快速查资料：从第七组的速查、排错和术语进入。
一基础入门先认识 Codex 的四种入口，完成安装、登录、计费和模型配置。
01Codex 是什么：四种入口与使用场景认识 Codex 的桌面 App、CLI、IDE 扩展和云端 Web 四种入口，搞清楚各自该在什么时候用。
02核心概念：代理循环、沙箱与审批建立理解 Codex 后续所有功能所需的底层模型：代理循环、上下文、工具、沙箱、审批与 Git 工作区。
03安装与登录：Mac、Windows、LinuxCodex CLI 在三大平台上的安装、升级、登录与验证步骤，以及网络和权限相关的常见问题。
04订阅与计费：套餐、额度与 API 成本ChatGPT 套餐中的 Codex 权益、使用额度、API 计费和不同入口的成本差异，帮你按使用强度选方案。
05接入第三方模型（如 DeepSeek）通过 OpenAI 兼容接口给 Codex 配置第三方模型的方法、字段、验证步骤和能力差异。
二各入口怎么上手分别跑通桌面 App、CLI、IDE、Cloud，并写好 AGENTS.md。
06第一个任务：从启动到检查修改用最小案例走完一次完整流程：进入项目、授权、描述任务、审查差异、运行验证。
07桌面 App 完整使用指南桌面 App 的项目管理、线程、Worktree、Review、自动化和本地环境能力，以及它与 CLI、IDE 的取舍。
08CLI 入门：安装、会话与常用操作CLI 的启动、交互界面、模型和权限选择、文件引用、差异审查与会话恢复。
09IDE 扩展指南：VS Code 与兼容编辑器IDE 扩展的安装、登录、上下文引用、编辑模式、差异查看和常用命令，以及编辑器与 CLI 如何协同。
10Cloud 云端任务使用指南Cloud 的仓库连接、云端环境、任务委派、结果审查和网络访问配置，帮你判断哪些工作适合放到云端。
11AGENTS.md 完整指南：给 Codex 写项目规则AGENTS.md 的发现范围、层级覆盖、推荐内容、反模式和维护方法，让 Codex 每次任务前读懂项目规范。
三核心交互与操作掌握命令、提示词、常见工作流、沙箱审批与安全边界。
12斜杠命令与快捷键完整指南CLI 的内置斜杠命令、键盘快捷键、Shell 模式和使用时机，覆盖会话、模型、权限、上下文与诊断操作。
13提示词写法：目标、上下文与验收如何向 Codex 说明目标、提供上下文、限定修改范围、写清验收标准，用可复用结构减少返工。
14常见工作流：探索、修 Bug、重构与测试探索代码库、定位修复 Bug、控制重构、补写测试四类高频任务的标准步骤与验收方法。
15权限、沙箱与审批配置指南文件系统和网络沙箱、审批策略、权限模式与命令规则，帮你按任务风险选对执行边界。
16安全指南：提示词注入与权限边界提示词注入、恶意仓库、命令执行、网络访问、敏感信息和供应链风险，以及隔离、审查与最小授权原则。
17Computer Use：电脑与浏览器操作指南Computer Use 的工作方式、启用条件、可操作对象、网站审批和隐私风险，以及什么时候该用、什么时候不该交给代理。
四高级功能扩展用 config.toml、记忆、MCP、子代理、Skills、插件和 Hooks 扩展能力。
18config.toml 配置详解config.toml 的文件位置、优先级、模型、推理、沙箱、审批、MCP 和界面等常用字段，以及可复制的配置思路。
19Memories 与 Chronicle 记忆系统Memories 和 Chronicle 如何从会话与屏幕上下文形成长期记忆、如何查看管理，以及隐私边界和适合保留的信息。
20MCP 教程：连接外部工具与数据配置 MCP 服务器的文件格式、命令、认证、作用域与安全边界，并用实际流程说明如何接入外部服务。
21子代理教程：配置与并行协作子代理的创建、角色说明、模型和工具配置、调用方式与上下文隔离，帮你把复杂任务拆成专项工作。
22Agent Skills 教程：安装、触发与创建Agent Skills 的目录结构、SKILL.md、安装位置、自动触发与手动调用，说明如何把重复流程沉淀为可复用能力。
23插件指南：安装一整套能力插件如何打包 Skill、MCP、应用连接和工作流，覆盖安装、启用、权限、目录结构与适用场景。
24Rules 与 Hooks：命令规则和生命周期自动化Rules 如何控制沙箱外命令，Hooks 如何在生命周期节点运行确定性脚本，以及两者的配置、边界和组合方式。
五工程化与自动化把 Worktree、GitHub、CI/CD、codex exec 和外部集成接入团队流程。
25Worktrees 并行隔离指南Git Worktree 在 Codex 并行任务中的作用、创建和合并流程，以及避免文件覆盖与分支混乱的方法。
26Git 与 GitHub 集成：提交和 PR 审查Codex 参与本地 Git 差异审查、提交准备和 GitHub PR Review 的工作流，说明本地检查与远端协作的区别。
27自动化与 CI/CD 完整指南Codex GitHub Action、云端自动化和脚本任务的配置、认证、触发与审查流程，帮你安全地把代理接入持续集成。
28codex exec 非交互模式：脚本与 CI 用法codex exec 的输入输出、常用参数、结构化结果、恢复会话和退出码，说明如何把 Codex 稳定接入脚本和 CI。
29Slack、Linear 与 SDK 集成指南在 Slack 和 Linear 中委派 Codex 任务，以及通过 SDK 把本地代理嵌入产品的入口、流程、认证与适用场景。
六实战与进阶学习模型选择、提速、迁移、Windows 使用与完整项目实战。
30模型怎么选：能力、速度与推理强度可用模型、推理强度、速度和任务复杂度之间的关系，帮你为探索、编码、审查和轻量任务选择合适档位。
31提速指南：上下文、模型与并行策略通过减少无关上下文、改善任务拆分、选择模型、复用规则和并行隔离来提升速度，同时保持结果可验证。
32从 Claude Code 迁移到 Codex把 CLAUDE.md、Skill、MCP、Hook、权限和日常工作流迁移到 Codex 的对应方式，指出可复用与必须重写的部分。
33Windows 使用指南：原生环境与 WSLCodex 在 Windows 原生沙箱、PowerShell 和 WSL 中的安装、路径、权限与常见错误，帮你选择更稳定的运行方式。
34综合实战：从需求到 Git 提交用一个 TODO 工具功能需求，串起项目规则、计划、编码、测试、差异审查和 Git 提交，展示完整可复用的交付流程。
七收尾与查阅用速查表、最佳实践、故障排查、术语表和企业治理完成收尾。
35命令与 config.toml 配置速查表汇总 CLI 参数、斜杠命令、权限模式、config.toml 字段和常用文件路径，方便日常使用时快速定位。
36最佳实践：稳定交付的工作方法任务拆分、上下文控制、项目规则、计划确认、最小修改和验证闭环等最佳实践，帮你减少误改与无效等待。
37常见问题排查：安装、登录与权限安装失败、无法登录、不修改文件、沙箱报错、网络和配置异常的定位顺序与解决方法，按现象快速排查。
38术语表：Agent、沙箱、Skill 与 MCP解释 Agent、Thread、Context、Sandbox、Approval、MCP、Skill、Subagent、Worktree 等高频术语的实际作用。
39企业管理与治理完整指南企业部署 Codex 时的管理员设置、身份、权限、托管配置、数据治理和审计要求，说明个人使用与组织治理的关键差异。