（完整版.pdf ）
以下仅展示部分内容



    
下载方式见文末

非官方开源指南，编著/泊舟。本文基于《ChatGPT橙皮书：从安装到实战案例的全链路使用指南（2026年）》整理，产品更新极快，具体功能、价格、入口请以OpenAI官方和账号实际显示为准。

如果你还把AI编程理解成“帮我写个函数”“帮我补段代码”，可能已经落后一个版本。

泊舟编著的《ChatGPT橙皮书》讲得很透：Codex真正重要的地方，不是它能不能写代码，而是它代表了AI编程工具的一次角色变化——从“坐在你旁边补代码的人”，变成“可以进入项目、接受任务、推进到可review状态的工程执行者”。

一句话：
以前AI是输入法，后来是问答伙伴，再后来是结对编程助手，现在Codex更像工程Agent。

01 先搞懂：Codex到底是什么？

文档里把AI编程工具进化分成四次：

1. 1. 2021年：Copilot补全时代——你写开头，它补后面，像更聪明的输入法。
2. 2. 2022年：ChatGPT对话时代——问报错、问优化、问写法，但通常不在真实项目里。
3. 3. 2023—2024年：Cursor项目协作时代——AI进入编辑器，能看文件、改函数、跨文件重构。
4. 4. 2025年：Codex工程Agent时代——读项目、定计划、改代码、跑命令、做测试、看diff、整理PR。

Codex能做的事，可以浓缩成一条链路：

读项目 → 定计划 → 改代码 → 跑命令 → 做测试 → 看diff → 可review。

它不是“代码生成按钮”，而是可以进入项目现场的AI工程助手。

和ChatGPT、Cursor、Claude Code怎么区分？

• • ChatGPT：适合“帮我想”。问答、解释、讨论、出方案。
• • Codex：适合“帮我改、帮我跑、帮我交付”。进入项目，给任务、给边界、给验收标准。
• • Cursor：更像AI编辑器，适合陪你写代码、局部修改、边写边协作。
• • Claude Code：更像终端里的长期工程搭档，偏长任务、复杂代码理解、持续协作。
• • Codex：更偏OpenAI生态里的多端工程Agent，CLI、App、IDE、Web、GitHub、Skills都能串起来。

专业解读：
Codex的护城河不只是模型，而是“项目上下文 + 工具调用 + 权限边界 + 验证闭环”。
能读、能改、能跑、能看diff，才叫工程Agent。只会在聊天框里生成代码，那还是顾问。

02 四大入口怎么选？

Codex不只有一种用法。文档给了四个入口：

新手建议：
本地练习优先Codex App；熟悉终端后再上CLI；日常写代码用IDE插件；项目上了GitHub再玩Web/Cloud。

03 安装与安全：先画好“围栏”

文档反复强调：Codex不是聊天工具，它能读文件、改文件、运行命令。
所以安装前要准备：ChatGPT账号、网络、系统环境、Git、VS Code/Cursor、终端、Node.js/Python、GitHub账号。

更重要的是权限与安全：

• • 不要一上来就操作最重要真实项目，先用练习目录。
• • 不要把密码、API Key写进代码，用 .env。
• • 操作前先Git提交，方便回滚。
• • 看不懂的命令先让Codex解释。
• • 不要给它整个C盘权限，只选择具体项目文件夹。

Codex App里有“沙盒（Sandbox）”概念：
Codex可以在围栏里干活，但不能随便跑到围栏外乱动你的电脑。

三大权限：

1. 1. 请求批准：有沙盒限制，越界先问你。
2. 2. 替代审批：系统自动判断一部分审批。
3. 3. 完全访问权限：放开沙盒，风险最高。

新手建议：
保持“请求批准”或自动审批类选项，不要一开始就开完全访问权限。
推荐组合：workspace-write + on-request。
意思是：可以在当前项目里工作，但敏感操作要先问我。

04 核心功能：Codex真正强在哪里？

1. 自动化

让Codex按计划或按需运行聊天，像给项目请了一个“AI值班工程师”。
比如每周自动复盘Codex会话，沉淀工作流、个人偏好和可复用规则。

2. 插件、Skill、MCP

这三个最容易混，文档给了很清楚的区分：

• • 插件Plugin：能力安装包，可打包Skill和MCP，普通用户也能一键安装。
• • Skill：一套固定工作方法，解决“怎么做”。比如README Skill、代码Review Skill。
• • MCP：连接外部工具的接口，解决“连接什么工具或数据”。比如数据库MCP、文档MCP、Figma MCP。

一句话：
插件是工具箱，Skill是说明书，MCP是给工具箱接电的插座。

3. Work

ChatGPT Work是面向研究、分析和内容交付的工作型Agent。
它擅长把资料变成可直接使用的成果：报告、表格、PPT、研究成果。

4. Sites

Codex负责把网站做出来，Sites负责把网站变成可访问和分享的线上成果。
适合落地页、内部工具、数据看板、交互式报告、产品原型、轻量Web应用。
但Sites不是完全替代Vercel/Netlify，复杂生产项目仍要专业部署平台。

5. Git与GitHub工作流

用Codex做真实项目，一定要懂一点Git。
没有Git，Codex改错了你很难回退；有了Git，Codex可以放心试，你随时检查和恢复。

标准流程：
初始化Git → 写.gitignore → 先commit → 新建分支 → 让Codex修改 → 看diff → 运行构建 → 满意后commit → push到GitHub → 创建PR。

6. 云端运行

本地Codex在你电脑上干活；Codex Web/Cloud在云端帮GitHub仓库干活。
适合修bug、改功能、写文档、代码review、处理issue，不占用本地电脑。

7. 记忆系统

文档把记忆分成六层：

1. 1. 当前Prompt/Thread：临时要求。
2. 2. Memories：个人偏好。
3. 3. AGENTS.md：项目规则。
4. 4. Skills：可复用流程。
5. 5. Automations：定时跟进。
6. 6. MCP：外部知识。

AGENTS.md是最推荐新手先用的一层。
它像写给Codex看的项目规则说明书：技术栈、常用命令、目录结构、代码规范、禁止事项、完成任务后输出什么。

8. Chrome插件

Chrome插件让Codex可以使用现有登录状态、跨多个标签页、处理下载和文件上传。
但要注意：使用登录状态不等于把所有密码直接交给Codex。
网站权限和敏感操作仍受确认机制控制。

05 标准工作流：六步法，别让AI乱改

文档最值钱的部分之一，是“从需求到交付的完整链路”。
核心是六步：

1. 1. 需求拆解：先让Codex知道要做什么，避免不了解结构就乱改。
2. 2. 制定计划：先列计划，确认后再动手。
3. 3. 小步实现：一次只改一小块，降低出错和回滚成本。
4. 4. 测试：单元测试、类型检查、lint、构建、手动测试、浏览器测试、回归测试。
5. 5. 代码审查：看diff，检查改得对不对、有没有风险。
6. 6. 提交与复盘：生成commit、写PR、记录问题、总结Prompt、更新AGENTS.md。

专业解读：
AI编程最大的风险不是“不会写”，而是“改太多、改错地方、删了不该删的、跑不通还说完成了”。
六步法的本质，是给AI加上“计划—执行—验证—审查”的工程闭环。

尤其记住几句话：

• • 先不要写代码，先制定计划。
• • 一次只改一个功能点。
• • 不要顺手重构无关代码。
• • 修改完成后总结diff。
• • 不确定先停下来问。
• • 看不懂的改动不要合并。

06 任务模板库：直接复制就能用

文档给了一堆模板，适合公众号读者收藏：

• • 读项目模板：先读项目，输出技术栈、目录结构、启动方式、测试命令、核心模块、修改风险。
• • 修Bug模板：现象、复现步骤、期望结果、实际结果、相关文件，先定位原因，不要直接修改。
• • 加功能模板：功能描述、入口位置、交互流程、视觉要求、数据来源、验收标准。
• • 前端页面模板：页面用途、目标用户、视觉风格、模块结构、中文文案、响应式要求。
• • 代码审查模板：潜在bug、边界条件、安全风险、类型问题、性能问题、无关修改、测试是否充分。
• • 重构模板：提高可读性、减少重复、保持行为不变、不改公共API、不引入新依赖。
• • 写测试模板：不改业务逻辑，覆盖正常路径、异常路径、边界条件。
• • 写文档模板：项目简介、安装方式、启动方式、环境变量、常用命令、目录结构、开发注意事项、常见问题。

这些模板的价值是：
不用每次重新想Prompt，直接按场景复制，填入自己的需求。

07 实战案例：从宠物零食网站到宣传视频

文档第五篇是实战案例库，完整走了一遍：

1. 1. 制作宠物零食售卖前端页面网站：本地建文件夹、计划模式、生成项目、预览、创建Git仓库、优化细节、增加月销量、新增热销榜、推送代码、上传GitHub、用GitHub Pages发布。
2. 2. 给宠物零食网站增加功能和优化页面：新建用户登录注册页面、创建宠物分类、食品分类、加入购物车、购买时确认地址、提交Git保存。
3. 3. 制作宠物零食管理后台：计划模式、检查效果、提交Git。
4. 4. 制作宠物零食品牌招商PPT：安装PPT Skill，用“/”选择Skill，生成完整招商PPT。
5. 5. 制作宠物零食宣传视频：安装HyperFrames插件，计划生成视频，预览成品，在线观看演示视频。

这条实战线很关键：
Codex不只是写代码，它还能串起前端、后台、PPT、视频，变成全链路交付工具。

08 第三方模型接入：CC Switch + DeepSeek

附录A介绍了非官方思路：CC Switch + DeepSeek。
CC Switch是一个第三方开源桌面工具，用来统一管理不同Agent工具，核心功能包括Provider切换、MCP统一管理、Skills管理。

接入DeepSeek的大致流程：
创建API Key → 打开CC Switch → 添加模型 → 复制API Key → 开启本地路由映射 → 设置里打开路由 → 启用。

但文档明确提醒：
这不属于OpenAI官方功能。模型兼容性、稳定性、隐私、费用规则以第三方工具和模型服务商为准。重要项目先用测试仓库验证，不要直接上生产。

09 给新手的行动清单

如果你刚接触Codex，可以按这个顺序：

1. 1. 装Codex App，选一个干净练习目录。
2. 2. 从简单任务开始：做一个Hello网页。
3. 3. 学会看review pane和diff。
4. 4. 每个明确任务开一个thread。
5. 5. 学会/plan、 /diff、/permissions、/model、/status、/init、/compact。
6. 6. 项目先git init和commit。
7. 7. 写一份项目级AGENTS.md。
8. 8. 复杂任务先计划，再小步实现。
9. 9. 测试通过后再代码审查。
10. 10. 提交、写PR、复盘、更新文档。

最后一句

《ChatGPT橙皮书》最核心的一句话是：

Codex能做的事情，不只是写代码。它真正重要的能力是：把一个明确的软件工程任务，从需求推进到可review的结果。

你不是让它随便写点代码。
你是在让它按照你的项目规则、上下文和验收标准，完成一项可控的工程任务。

AI负责执行，人负责判断。
这，才是2026年AI编程的正确打开方式。

【中国风动漫】《雾山五行》大火，却很少人知道它的前身《岁城璃心》一个拿着十米大刀的男主夭折！

如需获取更多报告

扫码加入

“人工智能产业链联盟”

知识星球，任意下载相关报告！

报告部分截图

声明

来源：泊舟，人工智能产业链union（ID:aiyuexingqiu）推荐阅读，不代表人工智能产业链union立场，转载请注明，如涉及作品版权问题，请联系我们删除或做相关处理！

编辑：Zero

文末福利

1.赠送800G人工智能资源。

获取方式：关注本公众号，回复“人工智能”。

2.「超级公开课NVIDIA专场」免费下载

获取方式：关注本公众号，回复“公开课”。

3.免费微信交流群：

人工智能行业研究报告分享群、

人工智能知识分享群、

智能机器人交流论坛、

人工智能厂家交流群、

AI产业链服务交流群、

STEAM创客教育交流群、

人工智能技术论坛、

人工智能未来发展论坛、

AI企业家交流俱乐部

雄安企业家交流俱乐部

细分领域交流群：

【智能家居系统论坛】【智慧城市系统论坛】【智能医疗养老论坛】【自动驾驶产业论坛】【智慧金融交流论坛】【智慧农业交流论坛】【无人飞行器产业论坛】【人工智能大数据论坛】【人工智能※区块链论坛】【人工智能＆物联网论坛】【青少年教育机器人论坛】【人工智能智能制造论坛】【AI/AR/VR/MR畅享畅聊】【机械自动化交流论坛】【工业互联网交流论坛】

入群方式：关注本公众号，回复“入群”