本文基于泊舟编著的非官方开源指南《Codex橙皮书：从安装到实战案例的全链路使用指南（2026年）》精华总结。
若仍将 Codex 视为“会写代码的 ChatGPT”，则低估了其真正价值。Codex 的核心演进在于从“代码补全”走向“工程执行”：它能够独立进入项目、读取上下文、制定计划、修改代码、运行命令并输出可 Review 的改动状态。以下为核心内容的全链路专业解读。
一、Codex 的核心定位与演进
AI 编程工具经历了四次迭代：
- Copilot 补全时代：智能代码补全。
- ChatGPT 对话时代：问答与方案构思。
- Cursor 协作时代：跨文件修改与局部重构。
- Codex 工程 Agent 时代：深入真实项目，执行“读、改、跑、查”全链路任务。
核心差异：ChatGPT 侧重“辅助思考”，Codex 聚焦“代码修改、命令执行与工程交付”。
适用场景：目标明确、范围可控、上下文清晰的任务（如修 Bug、加功能、写文档、代码审查等）。
避坑指南：切勿将生产数据库、核心支付逻辑、无备份项目及超大规模架构迁移交由其处理。
专业解读：Codex 的本质是“工程任务执行器”。其核心价值在于将 AI 从“提供答案”推向“交付结果”，这要求开发者具备明确任务边界、提供充足上下文及设定验收标准的能力。
二、Codex 与主流 AI 编程工具对比
| 对比项 | ChatGPT | Codex |
|---|---|---|
| 核心定位 | 对话助手 | 工程 Agent |
| 主要方式 | 问答、解释、讨论 | 读项目、改代码、跑命令 |
| 适合场景 | 想方案、学概念、问问题 | 修 bug、加功能、跑测试、整理 PR |
| 项目上下文 | 需用户手动提供 | 可自动进入项目读取 |
| 交付结果 | 答案、建议、代码片段 | 可检查的工程改动 |
最佳实践：用 ChatGPT 构思方案，用 Cursor 辅助编写，用 Codex 推进任务执行与最终交付。
三、四大入口与场景选择
- Codex App：桌面版，适合新手、图形化交互及并行任务查看。
- Codex CLI：命令行版，适合开发者处理真实项目及自动化脚本。
- Codex IDE Extension：VS Code/Cursor 侧边栏插件，适合边看边改。
- Codex Web / Cloud：网页云端版，对接 GitHub，适合团队协作与 PR 处理。
选型建议：新手建议从 Codex App 入手进行本地练习，熟悉后逐步过渡到 CLI、IDE 插件及 Web 云端版。
四、环境安装与安全配置
1. 基础准备
准备包含 Codex 权限的 OpenAI 账号及网络环境。基础工具需配备 Git、VS Code/Cursor、Node.js 及 GitHub 账号。支持 macOS、Windows 及 Linux 系统。
2. 项目隔离
切勿直接操作核心项目。建议创建独立的练习目录（如 D:\AI-Codex-Projects），并初始化 Git 版本控制以确保操作可回滚。
git init
git add .
git commit -m "initial commit"3. 权限与沙盒管理
- 敏感信息处理：禁止将密码/API Key 写入代码，使用
.env文件并加入.gitignore。 - 沙盒机制：分为“请求批准”、“自动审批”与“完全访问”三级。
专业解读：AI 编程的最大风险在于“盲目修改”。沙盒机制与权限审批是保障安全底线的基础，缺乏安全边界的自动化等同于风险赌博。
五、核心功能生态：插件、Skill 与 MCP
1. 自动化与插件
自动化：设定规则让 Codex 定期巡查并处理项目问题。
插件：扩展 Codex 的能力包，支持 Chrome、GitHub、Figma、Slack 等第三方服务集成。
2. Skill 与 MCP
- Skill：预设的固定工作方法，适用于写 README、代码审查等重复性任务。
- MCP（模型上下文协议）：连接外部工具与数据源的标准接口，按需开启。
3. Git/GitHub 与云端运行
遵循“初始化 -> 提交 -> 新建分支 -> Codex 修改 -> 查看 diff -> 测试 -> 提交 PR”的标准流程。Codex Web/Cloud 适合远程团队协作，但不适用于本地私密文件处理。
4. 记忆系统
分为六层：临时 Prompt、个人偏好（Memories）、项目规则（AGENTS.md）、可复用流程（Skills）、定时跟进（Automations）及外部知识（MCP）。
专业解读：AI 编程的长期效能取决于上下文管理的精细度。将项目规则与个人偏好分层管理，确保上下文纯净，是提升 Codex 稳定性的关键。
六、标准工作流：从需求到交付
1. 需求拆解
明确项目背景、解决痛点、相关文件、不可变功能及验收标准。
2. 制定计划
复杂任务使用 /plan 指令，先输出执行方案再动手。
3. 小步实现
单次只修改一个功能点，避免大范围重构或引入不必要的依赖。
4. 全面测试
通过单元测试、类型检查、构建及手动测试验证结果，拒绝盲目信任。
5. 代码审查
执行“AI 自审 + 人工审查”，重点排查边界条件、安全隐患及业务逻辑漏洞。
6. 提交复盘
生成 Commit 与 PR，更新 AGENTS.md 及项目文档。
专业解读：Codex 工作流的核心在于“AI 负责执行，人类负责判断”。小步实现、审查 diff、运行测试是掌控 AI 的关键。
七、实战案例：宠物零食全链路开发
本指南通过五个连贯案例展示全链路交付能力：
- 前端售卖网站：从零创建、计划预览、Git 管理及 GitHub Pages 部署。
- 功能扩展与优化：新增登录注册、分类管理及购物车模块。
- 管理后台开发：完成数据管理后台的构建与提交。
- 品牌招商 PPT：调用 PPT Skill 自动生成专业演示文稿。
- 宣传视频制作：利用 HyperFrames 插件生成产品宣传视频。
八、附录：第三方模型接入
可通过 CC Switch 等第三方开源工具接入 DeepSeek 等非 OpenAI 官方模型。流程包括：创建 API Key、配置 CC Switch 路由映射、启用本地路由并重启 Codex。
注意：非官方接入需自行评估兼容性、稳定性及数据隐私风险，重要项目务必先在测试环境验证。
九、新手常用命令与标准工作流
CLI 终端与斜杠命令
# 基础终端命令
codex login # 登录
codex doctor # 环境检查
codex resume --last # 恢复上次会话
codex exec "任务" # 非交互模式执行
# 核心斜杠命令
/plan # 生成执行计划
/diff # 查看代码改动
/permissions # 管理沙盒权限
/compact # 压缩长对话上下文推荐新手工作流
cd 项目目录并执行git status确认环境。- 启动
codex输入任务，使用/plan确认计划。 - 执行后通过
/diff与git diff双重审查改动。 - 确认无误后执行
git add .与git commit保存成果。
总结：Codex 的正确打开方式
Codex 的应用分为三个阶段：初级辅助写代码，中级重构与跑测试，高级作为工程 Agent 配合自动化与团队流工作。
无论处于何种阶段，请牢记三大原则：
- 先读项目，再动手。
- 先出计划，再执行。
- 每次改完，先看 diff，再决定接受。
免责声明：本文基于《泊舟：Codex橙皮书（2026年）》整理。Codex 迭代迅速，具体安装方式、模型名称及参数请以 OpenAI 官方文档及当前版本为准。