简体中文 · English · 在线阅读 · 学习路线 · 入口地图 · 配置专题 · 实践方法 · 实战案例 · 官方资料 · 共建路线图
> 从第一次上手，到把 Codex 接入真实工作流；帮助不同背景的人用 Codex 完成开发、创作、研究、自动化与团队协作。 > 如果这个项目帮你节省了摸索时间，欢迎点亮 Star，让更多人看到它。 ## 在线网站 **CodexGuide 的在线阅读地址是 [codexguide.ai](https://codexguide.ai/)。**
| 感谢 Unity2.ai 赞助了本项目！Unity2.ai 是面向个人开发者、团队和企业的高性能 AI 模型 API 中转平台，长期服务国内头部企业，日均承载超 300 亿 token 调用，支持 5000 RPM 级高并发。支持余额计费、首充赠额、组合订阅、企业开票和专属对接。通过此[链接](https://unity2.ai/register?source=canghe)注册可领取 $2 余额，加入官方群再送 $10 余额，最高可领 $12 免费额度。 |
| 
| PayForChat 支持 ChatGPT、Claude 会员开通与充值：微信直付、无需海外信用卡，官方渠道为你自己的账号充值，不成功全额退款，中文售后、可开收据。点击[这里](https://payforchat.com/register?ref=XJKHTC7N)注册体验。 |
| 
| GetGPT Pro 提供 ChatGPT、Claude 等 AI 订阅开通与充值服务，支持自助下单、快速到账与售后支持。 |
| 
| 项目赞助。PPToken 提供 ChatGPT、Claude、Gemini 等主流 AI 模型 API 中转与密钥分发服务，支持低延迟、高可用、按量计费与订阅套餐灵活选择。 |
| 
| 项目赞助。词元 API 致力于成为开发者的一站式 AI 接口平台，提供稳定、低延迟、高可用的大模型 API 服务，让 AI 应用开发更简单。 |
## 你会在这里看到什么
| 内容 | 说明 |
| --- | --- |
| 入门路线 | 从安装、登录、订阅、设置、手机协同、API 连接到第一个低风险任务 |
| 入口地图 | 解释桌面 App、CLI、Cloud、IDE、ChatGPT 和集成生态该怎么选 |
| 配置专题 | 覆盖 CLI 选项、`config.toml`、MCP、Skills、Subagents、安全审批 |
| 工作流方法 | 任务设计、验证方式、非开发工作流、团队 playbook |
| 实战案例 | PPT、Draw.io、浏览器、Obsidian、临床文献综述、飞书、Figma、Notion、CI 修复等场景 |
| 官方资料索引 | 汇总 OpenAI 官方资料、GitHub 仓库和关键事实来源 |
## 推荐阅读路径
### 1. 第一次上手
先读 [学习路线](./docs/guide/00-overview.md)，再完成 [桌面 App 下载与安装](./docs/guide/01-app-installation.md)、[订阅 Plus / Pro](./docs/guide/02-subscribe-plus.md)、[桌面 App 总览](./docs/guide/03-app-overview.md)、[连接第三方 API](./docs/guide/05-third-party-api.md) 和 [第一个任务](./docs/guide/06-app-first-task.md)。
### 2. 想用 Codex 改真实项目
从 [CLI 安装与登录](./docs/guide/12-cli-installation.md) 开始，接着看 [第一次让 Codex 改代码](./docs/guide/13-cli-first-run.md)、[AGENTS.md](./docs/guide/15-agents-md.md)、[沙盒与审批](./docs/guide/16-sandbox-approvals.md)。
### 3. 想把 Codex 放进团队
先看 [团队 playbook](./docs/practice/team-playbook.md)，再补齐 [配置与扩展](./docs/configuration/index.md)、[安全管理](./docs/configuration/security-admin.md)、[排障手册](./docs/guide/18-troubleshooting.md) 和 [实战案例库](./docs/recipes/index.md)。
## 快速入口
| 模块 | 适合解决什么问题 |
| --- | --- |
| [学习路线](./docs/guide/00-overview.md) | 从入门、进阶到团队化的阅读顺序 |
| [入口地图](./docs/platform/index.md) | CLI、桌面 App、Cloud/Web、IDE、ChatGPT 的选择方法 |
| [桌面 App 下载与安装](./docs/guide/01-app-installation.md) | Codex 桌面 App 下载、安装、登录和基础准备 |
| [手机端协同桌面任务](./docs/guide/04-mobile-control-desktop.md) | 用 ChatGPT 手机 App 中的 Codex 入口跟进桌面任务 |
| [连接第三方 API](./docs/guide/05-third-party-api.md) | 比较手动配置、Codex++、CCX 与 CC Switch 三种接入方式 |
| [第一次使用 Codex](./docs/guide/06-app-first-task.md) | 选择低风险任务，并完成一次可验证修改 |
| [CLI 安装与登录](./docs/guide/12-cli-installation.md) | 在本地终端安装 Codex CLI 并完成登录 |
| [第一次让 Codex 改代码](./docs/guide/13-cli-first-run.md) | 用 CLI 进入真实仓库，完成一次可检查的代码任务 |
| [配置与扩展](./docs/configuration/index.md) | CLI 选项、config.toml、MCP、Skills、Subagents、安全审批 |
| [实践方法](./docs/practice/index.md) | 任务设计、非开发工作流和团队实践 |
| [AGENTS.md](./docs/guide/15-agents-md.md) | 给 Codex 编写项目级规则和协作边界 |
| [沙盒与审批](./docs/guide/16-sandbox-approvals.md) | 文件、命令、网络、凭据和生产资源的安全边界 |
| [Cloud、IDE 与桌面 App](./docs/guide/17-cloud-ide-app.md) | 不同 Codex 使用入口的适用场景 |
| [实战案例库](./docs/recipes/index.md) | 可复制到真实项目的任务模板和复盘结构 |
| [官方资料索引](./docs/reference/index.md) | OpenAI 官方资料、GitHub 仓库和关键链接 |
## 内容框架
```text
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 22.12+，且低于 25
- pnpm 10.33.0
```bash
pnpm install
pnpm dev
```
构建静态站点：
```bash
pnpm build
```
默认开发服务会启动 VuePress 文档站。线上版本会发布到 [codexguide.ai](https://codexguide.ai/)。
## 设计原则
- **官方优先**：功能、价格、可用性、安全策略以 OpenAI 官方资料为准。
- **小白友好**：每个入门章节尽量说明“为什么这样做”和“什么时候不要这样做”。
- **真实任务导向**：减少抽象概念堆砌，多给可复制的任务流程、输入、输出和验证方式。
- **安全边界清晰**：涉及文件写入、命令执行、联网、凭据、浏览器和电脑操控时明确风险。
- **可沉淀**：鼓励把一次成功任务整理成 AGENTS.md、模板、案例、复盘和团队规范。
## Star 趋势图
[](https://www.star-history.com/#freestylefly/CodexGuide&Date)
## 公众号
微信搜索 **苍何** 或扫描下方二维码关注公众号。关注后回复 **codex交流群**，即可进入群交流。
