Tutorials › Basics

Codex tutorial (Chinese)

From what Codex is and installing it to AGENTS.md, permissions, MCP, skills, automation and enterprise rollout. 39 lessons.

By stormzhang, republished from the open-source project stormzhang/ai-coding-guide (MIT license). The lessons are in Chinese.

Start with lesson 1 →

Basics5 lessons

  1. 01认识 Codex 与四种入口Codex 桌面 App、CLI、IDE 扩展和云端 Web 四种入口的运行位置、能力差异与适用场景，帮助新手判断从哪里开始。
  2. 02Codex 核心概念速览代理循环、上下文、工具、沙箱、审批和 Git 工作区等核心概念，建立理解 Codex 后续功能所需的完整基础模型。
  3. 03安装与登录（Mac / Windows / Linux）Codex CLI 在 Mac、Windows、Linux 和 WSL 上的安装、升级、登录与验证步骤，并整理网络和权限相关的常见问题。
  4. 04订阅与计费ChatGPT 套餐中的 Codex 权益、使用额度、API 计费和不同入口的成本差异，帮助你按使用强度选择合适方案。
  5. 05接入 DeepSeek 等国产模型通过 OpenAI 兼容接口为 Codex CLI 配置第三方模型的基本方法、配置字段、验证步骤和能力差异，避免误解官方支持范围。

Getting started by entry point6 lessons

  1. 06跑通第一个任务进入项目、授权工作区、描述任务、审查差异和运行验证的完整流程，用最小案例帮助新手完成第一次 Codex 代理任务。
  2. 07桌面 App 全景Codex 桌面 App 的项目管理、线程、Worktree、Review、自动化和本地环境能力，并说明它与 CLI、IDE 的选择差异。
  3. 08命令行 CLI 上手Codex CLI 的启动方式、交互界面、模型和权限选择、文件引用、差异审查与会话恢复，带你跑通终端主流程。
  4. 09IDE 扩展（VS Code 等）Codex IDE 扩展的安装、登录、上下文引用、编辑模式、差异查看和常用命令，说明编辑器与 CLI 如何协同使用。
  5. 10云端 Codex Cloud：把活丢上云，喝着咖啡等结果Codex Cloud 的仓库连接、云端环境、任务委派、结果审查和网络访问配置，帮助你判断哪些工作适合放到云端执行。
  6. 11项目说明书 AGENTS.md：把规矩焊进 Codex 的开工流程AGENTS.md 的发现范围、层级覆盖、推荐内容、反模式和维护方法，帮助 Codex 在每次任务开始前读懂项目规范。

Core interaction6 lessons

  1. 12斜杠命令与快捷键：会话里的「快捷操作面板」Codex CLI 的内置斜杠命令、键盘快捷键、Shell 模式和使用时机，覆盖会话、模型、权限、上下文与诊断操作。
  2. 13提示词（Prompt）写法：把话说到 Codex 心坎里如何向 Codex 说明目标、提供必要上下文、限定修改范围和写清验收标准，并用可复用结构减少猜测与返工。
  3. 14四类日常工作流：探索、修 bug、重构、写测试探索代码库、定位并修复 Bug、控制重构和补写测试四类高频任务的标准步骤、提示方式与结果验收方法。
  4. 15权限、沙箱与审批：放多松、收多紧，自己拧Codex 文件系统和网络沙箱、审批策略、权限模式与命令规则，帮助你根据任务风险选择正确的执行边界。
  5. 16安全与风险边界：到底该不该放手让它碰你的代码提示词注入、恶意仓库、命令执行、网络访问、敏感信息和供应链风险，并给出隔离、审查与最小授权原则。
  6. 17电脑操控与浏览器（Computer Use）：让 Codex 长出手Computer Use 的工作方式、启用条件、可操作对象、网站审批和隐私风险，说明什么时候该用、什么时候不该交给代理。

Advanced features7 lessons

  1. 18config.toml 配置详解：一个文件管住所有旋钮config.toml 的文件位置、优先级、模型、推理、沙箱、审批、MCP 和界面等常用字段，并提供可复制的配置思路。
  2. 19记忆系统（Memories 与 Chronicle）：让 Codex 跨会话记住你Memories 和 Chronicle 如何从会话与屏幕上下文形成长期记忆、如何查看管理，以及隐私边界和适合保留的信息类型。
  3. 20用 MCP 接外部工具：给 Codex 装上「外接口」Codex 配置 MCP 服务器的文件格式、命令、认证、作用域与安全边界，并用实际流程说明如何接入外部服务。
  4. 21子代理（Subagents）：把活儿拆出去并行跑，但只有「你开口」它才拆Codex 子代理的创建、角色说明、模型和工具配置、调用方式与上下文隔离，帮助你把复杂任务拆成专项工作。
  5. 22Agent Skills 技能：把一套活儿打包，教会 Codex 自己接Agent Skills 的目录结构、SKILL.md、安装位置、自动触发与手动调用，说明如何把重复流程沉淀为可复用能力。
  6. 23插件（Plugins）：一键装一整套能力，别再一个个手配Codex 插件如何打包 Skill、MCP、应用连接和工作流，覆盖安装、启用、权限、目录结构与适用场景。
  7. 24规则与钩子（Rules & Hooks）：给 Codex 装上「卡点」和「扳机」Rules 如何控制沙箱外命令，Hooks 如何在生命周期节点运行确定性脚本，并说明两者的配置、边界和组合方式。

Engineering & automation5 lessons

  1. 25Worktrees 并行隔离：让几个 Codex 各干各的，互不打架Git Worktree 在 Codex 桌面 App 与 CLI 并行任务中的作用、创建和合并流程，以及避免文件覆盖与分支混乱的方法。
  2. 26Git 与 GitHub 集成：让 Codex 在你的 PR 里当审查员Codex 参与本地 Git 差异审查、提交准备和 GitHub PR Review 的工作流，说明本地检查与远端协作记录的区别。
  3. 27自动化与 CI/CD：让 Codex 在你不在的时候自己干活Codex GitHub Action、云端自动化和脚本任务的配置、认证、触发与审查流程，帮助你安全地把代理接入持续集成。
  4. 28非交互模式 codex exec：把它塞进脚本和 CI 里跑codex exec 的输入输出、常用参数、结构化结果、恢复会话和退出码，说明如何把 Codex 稳定接入脚本和 CI。
  5. 29Slack / Linear 与 SDK 集成：在别处召唤 Codex，把它嵌进你自己的产品在 Slack 和 Linear 中委派 Codex 任务，以及通过 SDK 把本地代理嵌入产品的入口、流程、认证与适用场景。

Practice5 lessons

  1. 30怎么选模型：同一句话，到底该派哪个模型去跑Codex 可用模型、推理强度、速度和任务复杂度之间的关系，帮助你为探索、编码、审查和轻量任务选择合适档位。
  2. 31进阶技巧与提速：拖慢你的不是模型，是你给的烂上下文通过减少无关上下文、改善任务拆分、选择模型、复用规则和并行隔离来提升 Codex 速度，同时保持结果可验证。
  3. 32从 Claude Code 迁移：旧地图换个工具，照样能找到家把 CLAUDE.md、Skill、MCP、Hook、权限和日常工作流迁移到 Codex 的对应方式，指出可以复用与必须重写的部分。
  4. 33Windows 使用要点：原生还是 WSL，到底怎么跑才省心Codex 在 Windows 原生沙箱、PowerShell 和 WSL 中的安装、路径、权限与常见错误，帮助你选择更稳定的运行方式。
  5. 34综合实战：从零给一个 TODO 小工具加功能、提交一次用一个 TODO 工具功能需求串起项目规则、计划、编码、测试、差异审查和 Git 提交，展示完整且可复用的交付流程。

Reference5 lessons

  1. 35命令与配置速查表汇总 Codex CLI 参数、斜杠命令、权限模式、config.toml 字段和常用文件路径，适合日常使用时快速定位准确写法。
  2. 36最佳实践：那些「正确的废话」之外，真正能落地的几条任务拆分、上下文控制、项目规则、计划确认、最小修改和验证闭环等最佳实践，帮助你减少误改与无效等待。
  3. 37常见问题排查：装不上、登不了、不肯改文件，挨个拆Codex 安装失败、无法登录、不修改文件、沙箱报错、网络和配置异常的定位顺序与解决方法，按现象快速排查。
  4. 38术语表解释 Agent、Thread、Context、Sandbox、Approval、MCP、Skill、Subagent、Worktree 等高频术语及其实际作用
  5. 39企业管理与治理：一个人玩和一家公司用，是两件事企业部署 Codex 时的管理员设置、身份、权限、托管配置、数据治理和审计要求，说明个人使用与组织治理的关键差异。