在线阅读 · 学习路线 · 入口地图 · 配置专题 · 实践方法 · 实战案例 · 官方资料 · 共建路线图
从第一次上手，到把 Codex 接入真实工作流；帮助不同背景的人用 Codex 完成开发、创作、研究、自动化与团队协作。 如果这个项目帮你节省了摸索时间，欢迎点亮 Star，让更多人看到它。
CodexGuide 的在线阅读地址是 codexguide.ai。
GitHub README 适合快速了解项目，真正学习时更推荐打开网站阅读：网站里有更完整的导航、搜索、侧边栏目录、截图、设置速查图、学习路线和实战案例。每篇关键资料都会尽量标注最后核对日期，方便你判断内容是否需要回到 OpenAI 官方资料重新确认。
如果你正在第一次接触 Codex，可以直接从网站的 学习路线 开始；如果你已经知道自己要用 CLI、桌面 App、Cloud 或 IDE，可以先看 入口地图。
Codex 正在从“帮你写代码的工具”，演进为一套覆盖 CLI、Cloud/Web、IDE extension、桌面 App、移动端协同、浏览器和自动化能力的 AI 工作流系统。
CodexGuide 想做的不是命令速查表，而是一份面向真实任务的实践知识库。它关注三个问题：
- 怎么开始：初学者应该从哪个入口、哪个任务、哪个设置开始。
- 怎么交付：如何把需求讲清楚，让 Codex 读项目、改文件、跑命令、给出可检查结果。
- 怎么沉淀：如何把一次成功任务变成团队可复用的模板、规则、案例和安全边界。
这份教程主要以中文组织内容，但目标并不局限在中文用户或开发者。它也会覆盖创作者、研究者、产品、运营、技术写作者、团队负责人，以及需要把 Codex 接入日常工作的非开发场景。
- 第一次使用 Codex 的小白：跟着桌面 App、订阅、设置、手机协同和第一个任务跑通完整闭环。
- 想把 Codex 用进项目的开发者：学习 CLI、IDE、Git、测试、CI、AGENTS.md、沙盒与审批。
- 内容创作者与知识工作者：把 Codex 用在写作、PPT、资料整理、知识库、浏览器和工作流自动化里。
- 团队负责人和工具建设者：建立团队规则、任务模板、权限边界、复盘结构和可迁移案例库。
- 正在选入口的人：对比桌面 App、CLI、Cloud、IDE、ChatGPT 手机端和插件生态的适用场景。
| 内容 | 说明 |
|---|---|
| 入门路线 | 从安装、登录、订阅、设置、手机协同到第一个低风险任务 |
| 入口地图 | 解释桌面 App、CLI、Cloud、IDE、ChatGPT 和集成生态该怎么选 |
| 配置专题 | 覆盖 CLI 选项、config.toml、MCP、Skills、Subagents、安全审批 |
| 工作流方法 | 任务设计、验证方式、非开发工作流、团队 playbook |
| 实战案例 | PPT、Draw.io、浏览器、Obsidian、飞书、Figma、Notion、CI 修复等场景 |
| 官方资料索引 | 汇总 OpenAI 官方资料、GitHub 仓库和关键事实来源 |
先读 学习路线，再完成 桌面 App 下载与安装、订阅 Plus / Pro、桌面 App 总览 和 第一个任务。
从 CLI 安装与登录 开始，接着看 第一次让 Codex 改代码、AGENTS.md、沙盒与审批。
先看 团队 playbook，再补齐 配置与扩展、安全管理、排障手册 和 实战案例库。
| 模块 | 适合解决什么问题 |
|---|---|
| 学习路线 | 从入门、进阶到团队化的阅读顺序 |
| 入口地图 | CLI、桌面 App、Cloud/Web、IDE、ChatGPT 的选择方法 |
| 桌面 App 下载与安装 | Codex 桌面 App 下载、安装、登录和基础准备 |
| 手机端协同桌面任务 | 用 ChatGPT 手机 App 中的 Codex 入口跟进桌面任务 |
| 第一次使用 Codex | 选择低风险任务，并完成一次可验证修改 |
| CLI 安装与登录 | 在本地终端安装 Codex CLI 并完成登录 |
| 第一次让 Codex 改代码 | 用 CLI 进入真实仓库，完成一次可检查的代码任务 |
| 配置与扩展 | CLI 选项、config.toml、MCP、Skills、Subagents、安全审批 |
| 实践方法 | 任务设计、非开发工作流和团队实践 |
| AGENTS.md | 给 Codex 编写项目级规则和协作边界 |
| 沙盒与审批 | 文件、命令、网络、凭据和生产资源的安全边界 |
| Cloud、IDE 与桌面 App | 不同 Codex 使用入口的适用场景 |
| 实战案例库 | 可复制到真实项目的任务模板和复盘结构 |
| 官方资料索引 | OpenAI 官方资料、GitHub 仓库和关键链接 |
CodexGuide
├─ guide # 从入门到团队化的实践指南
├─ platform # CLI、App、Cloud、IDE、ChatGPT 入口地图
├─ configuration # CLI 选项、config.toml、MCP、Skills、安全审批
├─ practice # 任务设计、非开发工作流、团队实践
├─ recipes # 可复用的真实工程案例
├─ reference # 官方资料索引与事实来源
└─ community # 共建路线图与贡献方向
当前已搭建：
- Codex 桌面 App 入门路径。
- ChatGPT 手机 App 协同桌面任务。
- Codex CLI 和 IDE 使用路径。
- Codex 多入口使用地图和选择建议。
- Codex 配置与扩展专题。
- 任务说明、提示词模板和验证方法。
- 非开发工作流与团队实践方法。
AGENTS.md项目规则模板。- 沙盒、审批和安全边界说明。
- Cloud、IDE、桌面 App、ChatGPT 使用场景对照。
- 内容生产、知识库、浏览器、CI 修复等案例模板。
- 在线文档站、官方资料索引和社区贡献模板。
环境要求：
- Node.js 18+ 或更新版本
- pnpm
pnpm install
pnpm dev构建静态站点：
pnpm build默认开发服务会启动 VuePress 文档站。线上版本会发布到 codexguide.ai。
- 官方优先：功能、价格、可用性、安全策略以 OpenAI 官方资料为准。
- 小白友好：每个入门章节尽量说明“为什么这样做”和“什么时候不要这样做”。
- 真实任务导向：减少抽象概念堆砌，多给可复制的任务流程、输入、输出和验证方式。
- 安全边界清晰：涉及文件写入、命令执行、联网、凭据、浏览器和电脑操控时明确风险。
- 可沉淀：鼓励把一次成功任务整理成 AGENTS.md、模板、案例、复盘和团队规范。
微信搜索 苍何 或扫描下方二维码关注公众号。关注后回复 codex交流群，即可进入群交流。
本仓库优先引用官方资料，并会在关键页面标注“最后核对日期”。当前骨架参考：
- OpenAI Codex 产品页
- Codex in ChatGPT Help Center
- OpenAI Codex CLI Getting Started
- Codex cloud docs
- openai/codex GitHub repository
欢迎提交：
- 新手友好的教程改写。
- 可复现的真实案例。
- 常见错误和解决方案。
- 团队实践、模板和工作流。
- 官方文档变更同步。
请先阅读 贡献指南。如果你还不确定怎么贡献，可以从 Roadmap 或 good first issue 开始。
本项目采用 MIT License 开源。你可以在保留许可声明的前提下自由使用、修改、分发与二次开发。
本项目是社区维护的 Codex 实践知识库，并非 OpenAI 官方项目。涉及功能、计划、价格、可用性和安全策略等时间敏感信息时，请以 OpenAI 官方资料为准。