#对零基础学员来说，最容易上手的顺序通常是：先学 Codex IDE 扩展，再学 Cloud 网页，最后再进入 CLI 和高级配置。只要学会"任务、边界、验证、审批、回退"这五个动作，就已经能把 Codex 用起来了。#
为什么称之为"手册"，其实也就是自己一些零零星星的归纳。只是为了努力把"能做什么，不能做什么""如何一步步完成任务""为什么要这样设计""遇到问题怎么办"等等一些问题写的更加结构化一些。
也正如前面提到的：这份手册不是给已经熟悉终端和仓库管理的开发者写的，而是给第一次接触"AI 编码代理"的学员准备的。目标不是把所有高级配置一次讲完，而是让学员在第一次上机时就知道：我该从哪里进入、第一句话怎么说、为什么它会停下来问我、改完以后怎么看、出了问题怎么撤回。
你可以把这份手册作为个人自学的第一份入门资料。正文尽量使用通俗语言，凡是容易把人卡住的地方，都会先给结论，再讲原因。正题开始：
1. ChatGPT 5.2 与 Codex 到底是什么关系
先把最重要的概念说清楚：ChatGPT 5.2 是 ChatGPT 中的核心模型体系，而 Codex 是面向软件开发的编码代理产品。换句话说，前者更像"通用大脑"，后者更像"专门做开发任务的执行代理"。OpenAI 官方把 GPT-5.2 作为登录用户在 ChatGPT 中的默认 GPT-5 代模型体系；当你使用 Codex 时，系统会在不同表面上调用面向编码优化的模型与能力，让它能够读仓库、改文件、运行命令、执行测试、审查代码。
因此，起初不要把"在聊天框里问代码问题"和"真正使用 Codex 代理去做开发任务"混为一谈。前者更多是讨论和解释，后者则已经进入可执行工作流：它会查看文件、生成补丁、提出审批请求，甚至在云端为你跑完整个任务。
截至 2026 年 2 月，OpenAI 官方还在 Codex 体系中持续更新编码模型与产品形态。例如，官方已经发布 GPT-5.2-Codex，并在 Codex 套餐页面说明当前可提供包括 GPT-5.3-Codex 在内的最新模型。要知道：Codex 不是单一模型，而是一套围绕编码代理构建的产品体验。
2. 谁能使用 Codex，以及从哪里进入
根据 OpenAI 官方 Quickstart 与帮助文档，ChatGPT Plus、Pro、Business、Edu、Enterprise 均包含 Codex；同时，官方也说明在限时范围内，Free 与 Go 用户可以试用 Codex，只是额度和能力会更受限制。
|-----------|----------------------|------------------------------------------|----------------|
| 入口 | 适合人群 | 支持情况 | 一句话判断 |
| IDE 扩展 | 零基础到中级用户 | VS Code、Cursor、Windsurf、JetBrains 等 | 最适合第一次真正动项目 |
| CLI | 愿意接触终端的用户 | macOS、Windows、Linux；Windows 最佳体验建议配合 WSL | 控制力最强，最像专业开发流程 |
| Cloud 网页 | 想让任务后台运行的用户 | 浏览器打开 chatgpt.com/codex，并连接 GitHub 仓库 | 适合并行任务与远程处理 |
| Codex App | Apple Silicon Mac 用户 | 截至 2026-02-28 官方仅提供 macOS 版本 | 适合多代理并行和工作树流程 |
3. 零基础应该先走哪条路
从成功率来看，最推荐的路径是"IDE 扩展优先"。原因很简单：能看到代码，也能看到 Codex 的动作，还能立即对照项目目录、修改结果和提示解释，不会像纯终端那样一上来就被黑窗口吓住。
• 如果已经有现成项目文件夹，优先走 IDE 扩展。
• 如果没有本地项目、只想体验'把任务交给代理去做'，再走 Cloud。
• 如果有一点命令行基础，或者课程目标是规范开发流程，再进入 CLI。
• 如果使用的是 Apple Silicon Mac，并且需要多代理并行、工作树和自动化，可增加 Codex App 模块。
无论走哪条路，第一次上手都不应该直接让学员做大功能。最好从"解释项目""定位一个小 bug""补一个单元测试""更新一段文档"这几类风险低、反馈快的任务开始。这样会先建立信心，再进入复杂任务。
4. 第一次上手前的准备清单（这一点尤为重要）
• 一个可登录的 ChatGPT 账号。CLI 和 IDE 扩展都支持用 ChatGPT 账号登录；CLI/IDE 也支持 API key，但零基础培训建议先用 ChatGPT 登录，少一步配置。
• 一个项目文件夹。哪怕只是一个练习仓库，也比空白目录更适合上手，因为 Codex 的优势就在于读取已有上下文。
• 推荐学会最基本的 Git 操作。官方多次提醒：Codex 可能会修改代码，因此建议在任务前后创建 Git checkpoint，方便回退。
• 如果是 Windows 机器，官方建议优先通过 IDE 扩展或 CLI 配合 PowerShell 使用；而更好的 Windows 体验通常是放在 WSL 工作区中运行。
• 如果走 Cloud 路线，需要把仓库推到 GitHub，并在 chatgpt.com/codex 中配置环境。
5. 用 VS Code + Codex 扩展完成第一次任务
5.1 为什么它最适合零基础
OpenAI 官方说明，Codex IDE 扩展可以直接在 VS Code 及其兼容分支中工作，并与 CLI 共用配置。对零基础来说，这意味着他们不需要先理解太多命令行知识，就能在熟悉的编辑器侧栏里与 Codex 交互。
5.2 安装步骤
• 第一步：安装 VS Code，或者使用 Cursor、Windsurf 等兼容编辑器。
• 第二步：安装 Codex 扩展。官方提供 Visual Studio Code Marketplace 入口，也提供适用于 Cursor、Windsurf、JetBrains 等 IDE 的下载方式。
• 第三步：打开你的项目文件夹。第一次建议选一个小型、可回退的练习仓库。
• 第四步：在侧栏找到 Codex 面板，按提示使用 ChatGPT 账号登录。
• 第五步：确认你已经看见项目目录和需要处理的代码文件，再开始发出第一个任务。
5.3 第一次任务怎么做
第一条任务不是让它重构整个系统，而是先让它解释项目。如：Tell me about this project。官方 Quickstart 就把这类提示列为首次消息示例之一。这样做的意义是能直观看到：Codex 确实会基于项目上下文来理解，而不是像纯聊天一样只在抽象讨论。
第二条任务建议选一个很小的 bug。例如官方工作流文档中的范式：找出导致"Saved"出现但实际没有持久化更改的 bug，并在修复后告诉我如何在 UI 中验证。
5.4 学员必须学会看什么
• 看它读取了哪些文件。这样能判断它是否走对方向。
• 看它准备执行什么命令。不要看到提示就一律批准。
• 看改动范围是否过大。零基础容易被'它改好了'的表象迷惑，其实大改动往往更难控。
• 看它是否给出了验证步骤。没有验证步骤的修复，教学上价值会大打折扣。
• 看是否需要创建 Git checkpoint。官方明确建议在任务前后建立检查点，方便撤回。