Codex零基础学习手册：从第一次使用到项目实战与交付落地

版本与使用说明 修订原则 完整保留V2.0-F已经通过Review的正文、代码示例、章节结构和教学结论，仅调整配套资料、外部依赖和综合案例的定位话术；未列入修订范围的内容不压缩、不改写。 使用提示 产品界面、命令参数和第三方工具版本可能随时间更新，实际操作时以正文标注日期及对应官方文档为准。 配套资料说明 本书大部分练习由读者按照正文，从空白项目或自己的现有项目逐步完成。随书轻量配套资料包括一份《Codex实用提示词与模板合集》，以及第17—36章持续使用的team-task-board基础练习项目。第1—16章按照正文逐步创建项目；第19章使用正文提供的固定错误示例完成调试训练；第37—40章为企业工单系统综合案例拆解，不要求下载或运行同名项目。 目录 第1章：Codex是什么，它能帮你完成什么 一、起始语 你可能已经习惯用AI回答问题： 帮我写一段网页代码。解释一下这个报错。给我一个任务管理工具的制作方案。 在普通聊天模式中，AI通常先给出文字、建议或代码片段。接下来，你还要自己创建文件、找到代码应该放置的位置、运行项目、处理报错，再确认结果是否符合要求。 Codex把这件事向前推进了一步。 它可以围绕一个真实项目查看文件、搜索内容、修改代码、运行命令和检查结果，再把实际变化交给你审查。OpenAI将Codex定义为帮助用户编写、审查和交付代码的编码智能体。OpenAIHelpCenter 本章暂时不讲下载安装，也不要求你编写代码。我们先解决三个最基础的问题： Codex是什么？它适合完成什么任务？哪些决定仍然必须由人负责？ 二、主体 1.1 Codex是什么 Codex是OpenAI的编码智能体。 “编码”说明它主要面向软件、网页、脚本和其他技术成果；“智能体”说明它不只生成一段回答，还可以围绕一个目标连续采取行动。 例如，你想修改一个已有网页的搜索功能。Codex可以先查看项目结构，找到相关文件和现有逻辑，再完成修改、运行检查，并汇报改动和仍未验证的部分。 理解Codex时，可以先记住这句话： Codex能够进入被授权的工作环境，围绕真实项目完成一组可以检查的技术动作。 它最终交付的通常不只是一段回答，还可能包括： 创建或修改后的文件；项目的实际运行结果；测试和检查记录；修改前后的代码差异；可以继续审查的候选成果。 1.2它和普通AI对话有什么区别 Codex与普通AI对话并非互相替代，它们适合处理的问题不同。 可以用一句话概括： 普通AI对话更擅长帮助你思考和获得答案；Codex更擅长在项目中推进任务并交付实际变化。 当前ChatGPT桌面应用在ChatGPT下提供Chat和Work，并将Codex作为并列的独立视图：Chat用于快速交流，Work用于较长的研究和成品任务，Codex专门面向软件开发与技术工作。OpenAIHelpCenter 1.3Codex通常怎样完成一项任务 一项Codex任务通常会经历这样的过程： 理解目标→查看项目→找到相关内容→修改或创建文件→运行检查→汇报结果以本书后面要制作的“AI学习导航页”为例，Codex可能会： 1.查看当前文件夹里已经有什么；2.判断需要创建哪些页面文件；3.写入页面内容和样式；4.检查文件之间的引用是否正确；5.根据你的反馈继续修改；6.告诉你实际改变了哪些内容。 这里展示的是整体过程，不要求你现在记住一套复杂的操作方法。怎样描述任务、怎样要求Codex先查看项目、怎样检查修改证据，会在后面的相应章节中分别学习。现在只需要建立一个认识： Codex的价值来自围绕真实对象持续行动，而不只是生成一段看起来合理的内容。 1.4Codex最适合完成哪些任务 Codex最典型的应用集中在软件开发和技术执行领域。 理解已有项目 它可以帮助查找项目入口、主要模块、功能位置和数据流，让使用者更快进入陌生代码库。 开发或修改功能 例如： 创建一个页面；为工具增加搜索；调整表单和页面交互；修改接口返回结果；在多个关联文件中完成一致的变化。 定位和修复问题 Codex可以结合报错、日志、代码和测试寻找原因，完成候选修复，再通过运行结果检查修改是否有效。 重构和迁移 当项目需要替换旧接口、升级依赖、清理重复代码或批量修改文件时，Codex可以承担大量重复且需要保持一致的工作。 它可以根据现有逻辑补充测试、检查边界条件、审查修改差异，并指出潜在风险。 自动化重复的技术工作 当一套流程已经稳定后，Codex还可以参与定期检查、批量维护和持续集成辅助。 这些能力与OpenAI目前对Codex的官方定位一致：它可以围绕代码库执行开发、调试、测试、审查和交付工作。OpenAIHelpCenter 1.5哪些事情不一定需要Codex 并不是所有问题都要进入Codex项目。 下面这些任务，普通AI对话通常更加直接： 解释一个概念；修改一句文案；比较两个简单方案；讨论一个尚未形成明确成果的想法；回答一个不需要查看或操作文件的问题。 当一项任务既没有真实工作对象，也不需要修改、运行或验证结果时，使用Codex未必能够带来额外价值。 反过来，当任务同时具备以下特征时，Codex通常更加合适： 存在一个项目、一组文件或一个可以运行的成果；需要连续完成读取、搜索、修改、运行或测试；最终结果可以通过页面、文件、差异或测试进行检查。 1.6不会编程，也能使用Codex吗 可以。 零基础读者不需要先学会独立编程，才能开始使用Codex。你可以从自己能够理解和判断的结果出发，例如： 一个可以打开的网页；一个整理资料的本地工具；一个批量处理文件的小程序；一个已有项目中的明确功能修改。 但“可以开始使用”并不代表完全不需要学习。 随着任务变复杂，你需要逐步掌握三类基础能力： 7.说清楚希望得到什么结果；8.看懂Codex准备操作哪些文件；9.判断最终成果是否真的可用。 这正是本书前半部分要解决的问题。我们不会先用大量代码语法和技术术语把你挡在门外，而是先让你完成真实成果，再在使用过程中理解文件、终端、项目和版本。 1.7人仍然需要负责什么 Codex能够执行很多动作，但不会替你承担最终责任。 你仍然需要决定： 目标是否清楚；哪些文件和数据可以访问；哪些内容允许修改；哪些操作需要批准；什么结果才算完成；成果能否提交、发布或交付。 例如，Codex可以修改网页，但页面是否符合业务要求，需要你判断。 它可以补充测试，但测试是否覆盖了真实风险，需要你确认。 它可以准备一个PullRequest，但是否合并到正式项目，仍然由人决定。 因此，本书会始终坚持一条基本原则： Codex负责在明确边界内推进任务，人负责目标、授权和最终验收。 三、总结 本章建立了对Codex的第一层认识： Codex是能够操作真实项目的编码智能体；它可以读取文件、修改内容、运行工具并交付可检查的结果；它适合理解项目、开发功能、修复问题、补充测试和处理重复技术任务；零基础读者可以从自己看得懂的成果开始使用；目标、权限和最终判断仍然由人负责。 本章掌握检查 []我能用自己的话说明Codex是什么；[]我能区分“获得回答”和“在项目中完成实际修改”；[]我能说出三类适合交给Codex的任务；[]我知道哪些简单问题不一定需要使用Codex；[]我知道最终验收不能交给Codex自行决定。 四、结束语与引导 现在，你已经知道Codex适合处理什么类型的任务，也理解了它与普通AI对话的主要区别。 下一步要解决的是一个现实选择： 第一次使用Codex，应该从哪个入口开始？ 第2章：访问和下载Codex，找到适合自己的使用入口 一、起始语 上一章解决了“Codex是什么”。 接下来会遇到一个更实际的问题： Codex在哪里？第一次使用应该下载什么？命令行、编辑器和云端是不是都要同时学习？ Codex目前可以通过ChatGPT桌面应用、Codex CLI、IDE扩展和Codex云端等形态使用。它们适合的任务不同，零基础读者没有必要一次全部安装。OpenAIDevelopers 本书选择的第一条路线是： ChatGPT桌面应用 →Codex视图 → 本地项目文件夹。 这一章只负责帮助你认清入口、选定第一条路线并找到官方下载位置。具体安装和配置放在第3章。 二、主体 2.1 Codex有哪些主要入口 ChatGPT桌面应用中的Codex 桌面应用适合： 打开本地文件夹；管理项目和聊天；查看创建或修改的文件；审查实际差异； 推进持续时间较长的任务。 CLI是在终端中使用Codex的方式。 它更适合已经理解终端、目录和命令的使用者。当前不需要安装，第26章会在具备相关基础之后再正式学习。OpenAIDevelopers Codex IDE扩展 IDE扩展让Codex出现在代码编辑器旁边，可以利用当前打开的项目、文件和代码上下文完成解释、修改和调试。OpenAIDevelopers Codex云端 Codex云端用于在独立云端环境中运行代码仓库任务。它适合后台执行较长任务、并行比较多个方案，或者在离开本地开发电脑时继续推进工作。OpenAIDevelopers 本章只帮助你认识这些入口，不进行CLI、IDE或云端配置。 2.2为什么零基础读者先从桌面应用开始 零基础读者目前还没有系统学习： 终端；工作目录；Git；代码编辑器；项目依赖；远程代码仓库。 如果一开始就使用CLI，会同时遇到Codex和终端两套新知识。 如果一开始就使用IDE扩展，还需要先熟悉代码编辑器和项目界面。 桌面应用可以先把这些复杂度降下来。第一次使用时，你主要完成三件事： 打开Codex→选择一个文件夹→描述希望得到的成果 等到后面理解文件、终端和Git之后，再进入其他入口会更加自然。 2.3现在应该下载哪个应用 截至2026年7月，新的ChatGPT桌面应用在Windows和macOS上整合了Chat、Work和Codex。 在桌面应用中： 在ChatGPT下可以选择Chat或Work；Codex仍然是单独的工作视图；Codex的聊天历史与ChatGPT历史分开。 OpenAI此前的独立Codex应用在更新后会转为新的ChatGPT桌面应用；旧版ChatGPT桌面应用可能继续显示为“ChatGPT Classic”。OpenAIHelpCenter 因此，第一次安装时应寻找： OpenAI官方提供的ChatGPT桌面应用。 不要根据旧教程去寻找来源不明的“独立Codex安装包”。 2.4下载前需要准备什么 一台Windows或macOS电脑 官方桌面应用提供Windows和macOS版本。具体系统版本、处理器和安装要求可能随产品更新变化，应以官方下载页面当时显示的信息为准。OpenAIDevelopers 本书默认演示环境是： Windows电脑＋ChatGPT桌面应用。 macOS读者沿用相同学习路线。只有操作存在明显差异时，正文才会单独说明。 一个可以登录的ChatGPT账号 Codex可以使用ChatGPT账号登录，不需要另外注册一个“Codex账号”。使用额度会因计划和工作空间设置而有所不同。OpenAIHelpCenter 当前不需要： 创建API密钥；注册服务器；配置云环境；购买开发者工具。 能够访问OpenAI官方服务的网络环境 下载、登录和应用更新需要连接官方服务。 不要从以下位置获取安装包： 第三方软件下载站； 不明网盘；群聊转发文件；所谓修改版或增强版；无法确认发布方的镜像文件。 2.5怎样找到正确的下载入口 推荐按照下面的顺序操作： 10.打开OpenAI官方的ChatGPT桌