（完整版.pdf）以下仅展示部分内容
非官方开源指南，编著/泊舟。本文基于《ChatGPT 橙皮书：从安装到实战案例的全链路使用指南（2026 年）》整理，产品更新极快，具体功能、价格、入口请以 OpenAI 官方和账号实际显示为准。
若仍视 AI 编程为“辅助写函数”或“补全代码”，认知可能已滞后。泊舟编著的《ChatGPT 橙皮书》指出：Codex 的核心价值在于角色转变——从“结对编程助手”进化为“可独立推进任务至可 Review 状态的工程执行者（Agent）”。
简言之：AI 已从输入法、问答伙伴，演变为具备工程闭环能力的 Agent。
01 Codex 定位与演进
AI 编程工具历经四次迭代：
-
1. 2021 年：Copilot 补全时代——智能输入法，基于上下文补全代码。 -
2. 2022 年：ChatGPT 对话时代——脱离项目环境的问答与方案讨论。 -
3. 2023—2024 年：Cursor 项目协作时代——嵌入编辑器，支持跨文件重构与局部修改。 -
4. 2025 年：Codex 工程 Agent 时代——全流程自动化：读项目、定计划、改代码、跑命令、测 Diff、提 PR。
Codex 核心链路：读项目 → 定计划 → 改代码 → 跑命令 → 做测试 → 看 Diff → 可 Review。其护城河在于“项目上下文 + 工具调用 + 权限边界 + 验证闭环”。
主流工具差异化对比
-
• ChatGPT：侧重方案构思与逻辑解释。 -
• Codex：侧重工程交付，具备明确的任务边界与验收标准。 -
• Cursor：AI 编辑器，适合实时协作与局部编码。 -
• Claude Code：终端长任务搭档，擅长复杂代码理解。 -
• Codex：OpenAI 生态多端 Agent，串联 CLI、IDE、GitHub 等全链路。
02 四大入口选择策略
|
|
|
|
|
|
|
|
|
|
|
真实项目目录操作、自动化脚本、Git/构建命令集成 |
|
|
|
代码实时预览与修改 |
|
|
|
云端任务执行、PR 生成、代码审查 |
建议路径：本地练习用 App → 熟悉终端用 CLI → 日常开发用插件 → 团队协作用 Web/Cloud。
03 安装部署与安全围栏
Codex 具备读写文件及运行命令权限，部署前需准备：ChatGPT 账号、网络环境、Git、IDE、Node.js/Python 及 GitHub 账号。
安全准则：
-
• 优先使用练习目录，避免直接操作核心生产项目。 -
• 敏感信息（密码/API Key）存入 .env 文件。 -
• 操作前执行 Git Commit 以便回滚。 -
• 限制权限范围，仅授权具体项目文件夹。
权限分级：
-
1. 请求批准：沙盒模式，越界操作需人工确认（推荐）。 -
2. 替代审批：系统自动判断部分低风险操作。 -
3. 完全访问：无沙盒限制，风险最高。
推荐配置：workspace-write + on-request，即在项目内工作，敏感操作需确认。
04 核心功能解析
1. 自动化与值班机制
支持按计划运行会话，自动复盘工作流，沉淀个人偏好与复用规则。
2. 插件生态（Plugin/Skill/MCP）
-
• Plugin：能力安装包。 -
• Skill：固定工作方法（如 Code Review Skill）。 -
• MCP：外部工具接口（如数据库、Figma）。
3. Work 与 Sites
Work：面向研究与内容交付，生成报告/PPT；Sites：快速部署落地页、原型及轻量 Web 应用，但不替代专业部署平台。
4. Git 与 GitHub 工作流
标准流程：初始化 Git → 写.gitignore → Commit → 新建分支 → Codex 修改 → 查看 Diff → 构建测试 → Commit → Push → 创建 PR。
5. 记忆系统六层级
-
1. Prompt/Thread（临时要求） -
2. Memories（个人偏好） -
3. AGENTS.md（项目规则，新手首选） -
4. Skills（复用流程） -
5. Automations（定时跟进） -
6. MCP（外部知识）
6. Chrome 插件
支持跨标签页操作及文件上传，但敏感权限仍受确认机制控制。
05 标准工作流：六步法
为避免 AI 盲目修改，遵循以下工程闭环：
-
1. 需求拆解：明确任务目标与结构。 -
2. 制定计划：先列计划，确认后执行。 -
3. 小步实现：单次仅改一小块，降低回滚成本。 -
4. 测试验证：单元/类型/Lint/构建/回归测试。 -
5. 代码审查：检查 Diff，评估风险。 -
6. 提交复盘：生成 Commit/PR，更新 AGENTS.md。
关键原则：先计划后编码、单点修改、不随意重构、看不懂不改、不确定不问。
06 任务模板库
常用场景模板：
-
• 读项目：输出技术栈、结构、风险点。 -
• 修 Bug：定位原因而非直接修改。 -
• 加功能：明确入口、交互、数据及验收标准。 -
• 代码审查：检查边界、安全、性能及无关修改。 -
• 写文档：涵盖安装、启动、环境变量及常见问题。
07 实战案例：全链路交付
案例涵盖宠物零食网站全流程：
-
1. 前端页面：从建文件夹到 GitHub Pages 发布。 -
2. 功能迭代：登录注册、购物车、地址确认。 -
3. 管理后台：计划模式开发与效果检查。 -
4. 招商 PPT：利用 PPT Skill 生成演示文稿。 -
5. 宣传视频：利用 HyperFrames 插件生成视频。
08 第三方模型接入
附录介绍 CC Switch + DeepSeek 接入方案，用于统一管理 Agent 工具。注意：此为非官方功能，稳定性与隐私需自行评估，严禁直接用于生产环境。
09 新手行动清单
-
1. 安装 Codex App，建立练习目录。 -
2. 从 Hello World 网页开始。 -
3. 熟悉 Review Pane 与 Diff 查看。 -
4. 掌握核心命令：/plan, /diff, /permissions, /init 等。 -
5. 编写项目级 AGENTS.md 规范。 -
6. 严格遵循“计划 - 小步 - 测试 - 审查”流程。
结语
Codex 的核心价值是将明确的软件工程任务，从需求推进至可 Review 的结果。AI 负责执行，人类负责判断与验收，这才是 2026 年 AI 编程的正确范式。
编辑：Zero