varun86

CodexGuide

CodexGuide：面向全球初学者、创作者、开发者与团队的 Codex 实践指南

0
0
0
public
Forked
View on GitHubWebsite

CodexGuide

面向全球初学者、创作者、开发者与团队的 Codex 实践指南

Docs Stars Forks Issues License PRs Welcome

简体中文 · English · 在线阅读 · 学习路线 · 入口地图 · 配置专题 · 实践方法 · 实战案例 · 官方资料 · 共建路线图

从第一次上手，到把 Codex 接入真实工作流；帮助不同背景的人用 Codex 完成开发、创作、研究、自动化与团队协作。
如果这个项目帮你节省了摸索时间，欢迎点亮 Star，让更多人看到它。

在线网站

CodexGuide 的在线阅读地址是 codexguide.ai。

CodexGuide 网站首页预览

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 手机端和插件生态的适用场景。

❤️ 赞助商

想出现在这里？ 添加微信时请备注你的产品名和项目赞助说明。

赞助商 介绍
PPToken 项目赞助。PPToken 提供 ChatGPT、Claude、Gemini 等主流 AI 模型 API 中转与密钥分发服务，支持低延迟、高可用、按量计费与订阅套餐灵活选择。
词元 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. 第一次上手

先读 学习路线，再完成 桌面 App 下载与安装、订阅 Plus / Pro、桌面 App 总览、连接第三方 API 和 第一个任务。

2. 想用 Codex 改真实项目

从 CLI 安装与登录 开始，接着看 第一次让 Codex 改代码、AGENTS.md、沙盒与审批。

3. 想把 Codex 放进团队

先看 团队 playbook，再补齐 配置与扩展、安全管理、排障手册 和 实战案例库。

快速入口

模块 适合解决什么问题
学习路线 从入门、进阶到团队化的阅读顺序
入口地图 CLI、桌面 App、Cloud/Web、IDE、ChatGPT 的选择方法
桌面 App 下载与安装 Codex 桌面 App 下载、安装、登录和基础准备
手机端协同桌面任务 用 ChatGPT 手机 App 中的 Codex 入口跟进桌面任务
连接第三方 API 比较手动配置、Codex++、CCX 与 CC Switch 三种接入方式
第一次使用 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、模板、案例、复盘和团队规范。

Star 趋势图

Star History Chart

公众号

微信搜索 苍何 或扫描下方二维码关注公众号。关注后回复 codex交流群，即可进入群交流。

关注苍何公众号后回复 codex交流群 进入群交流

事实来源

本仓库优先引用官方资料，并会在关键页面标注“最后核对日期”。当前骨架参考：

参与贡献

欢迎提交：

  • 新手友好的教程改写。
  • 可复现的真实案例。
  • 常见错误和解决方案。
  • 团队实践、模板和工作流。
  • 官方文档变更同步。

请先阅读 贡献指南。如果你还不确定怎么贡献，可以从 Roadmap 或 good first issue 开始。

开源协议

本项目采用 MIT License 开源。你可以在保留许可声明的前提下自由使用、修改、分发与二次开发。

声明

本项目是社区维护的 Codex 实践知识库，并非 OpenAI 官方项目。涉及功能、计划、价格、可用性和安全策略等时间敏感信息时，请以 OpenAI 官方资料为准。

v0.3.3[beta]