全站内容规划
教程版本基线Codex CLI v0.147.0本站的目标不是做一个“Codex 功能介绍站”,而是做一个可以照着操作、照着验证、照着交付的 Codex 喂饭级教程站。
本站的品牌口号是:让 vibe coding 更专业和更高效。
- 快速开始
- 入口地图
- 安装与环境
- Codex 工作方法
- CLI 实战
- IDE、App 与 Cloud
- 配置大模型
- 高级配置与扩展
- 安全、权限与边界
- 项目实战
- 常见任务实战
- 模板库与排障手册
可操作教程至少包含:教程目标、适合对象、开始前准备、逐步操作、预期结果、失败分支、可复制提示词、## 验收结果 和下一篇入口。
2026 年 8 月补齐了测试、Playwright、PR/代码审查、codex exec、GitHub Action、定时任务、Plugins、Worktree 并行、Vue/Nuxt、Spring Boot/MyBatis 与 Maven/JDK 排障教程,并纳入导航和离线 Word 版。
概念说明、模块索引、FAQ 与路线图可以不机械套用全部步骤,但必须做到:信息边界清楚、术语有解释、结论有依据、站内入口可用。
涉及 Codex 当前能力时,以官方 OpenAI 文档和本地实测为准;涉及第三方模型或工具时,同时记录服务商依据、协议兼容性、安全风险和回滚方法。
维护时必须通过构建、站内链接、frontmatter、重复 H1 和空图片替代文字检查。
当前优先建设顺序
Section titled “当前优先建设顺序”- Codex 是什么
- Codex 桌面版、CLI、IDE、Cloud 怎么选
- 什么时候优先用桌面版
- 什么时候优先用 CLI
- 什么时候优先用 IDE 或 Cloud
- Windows 安装与准备
- Codex CLI 安装与登录
- Codex 桌面版安装与登录
- Codex 桌面版第一次选择项目
- Codex IDE 扩展安装与登录
- IDE 里第一次解释当前文件
- IDE 里第一次做局部修改
- IDE、CLI、桌面版怎么配合
- Codex Cloud 适合什么场景
- Codex Cloud 使用前准备
- 第一次创建 Codex Cloud 任务
- Cloud 结果怎么带回本地
- 配置大模型总览
- 国内大模型配置方案
- 具体国内模型服务商配置
- 配置后验证当前模型
- 第一次让 Codex 阅读项目
- 第一次让 Codex 修改代码
- 让 Codex 完成任务验收
- Git 提交前检查
- 怎样写一个合格的 Codex 任务
- 修 Bug 任务模板
- 常见问题排障
- 常见任务实战:优化首页
- 常见任务实战:修复前端 Bug
- 常见任务实战:排查构建失败
- 常见任务实战:新增一个简单页面
- 常见任务实战:补 README 或使用说明
- 常见任务实战:修改一段接口逻辑
- 高阶入门:AGENTS.md 是什么
- 高阶入门:第一次给项目添加 AGENTS.md
- 高阶入门:config.toml 是什么
- 高阶入门:用户级和项目级配置怎么选
- 高阶实战:MCP 是什么
- 高阶实战:什么时候应该配 MCP
- 高阶实战:第一次配置只读文档 MCP
- 高阶实战:Skills 是什么
- 高阶实战:什么时候应该做 Skill
- 高阶实战:第一次做 instruction-only Skill
- 高阶实战:Hooks 是什么
- 高阶实战:什么时候应该用 Hooks
- 高阶实战:第一次查看和审查 Hooks
- 高阶实战:第一个低风险 Hook
- 高阶入门:Subagents 是什么
- 高阶实战:第一次使用 Subagents 做只读评审
- 高阶入门:什么时候需要自定义 Subagents
- 高阶实战:第一次创建自定义 Subagent
- 高阶实战:团队工作流
- 高阶实战:提交前审查工作流
常见任务实战不算高阶,它是用户真正开始使用 Codex 后每天都会遇到的基本操作。参考站点里的复杂工作流、自动化、多代理和团队沉淀会放到后面的 高阶实战,必须建立在用户已经会选入口、会配置模型、会做小任务、会看验收结果之后。
完整规划见项目文档:docs/SITE_CONTENT_PLAN.md。