【407页】Codex零基础学习手册

Codex 零基础学习手册我的 AI 笔记 | 3我的 AI 笔记 × 前哨科技 · 面向零基础学习者的系统入门指南版本与使用说明版本V2.1-F正文范围第 1—40 章版本状态正式稿出品我的 AI 笔记 × 前哨科技修订原则完整保留 V2.0-F 已经通过 Review 的正文、代码示例、章节结构和教学结论，仅调整配套资料、外部依赖和综合案例的定位话术；未列入修订范围的内容不压缩、不改写。使用提示产品界面、命令参数和第三方工具版本可能随时间更新，实际操作时以正文标注日期及对应官方文档为准。配套资料说明本书大部分练习由读者按照正文，从空白项目或自己的现有项目逐步完成。随书轻量配套资料包括一份《Codex 实用提示词与模板合集》，以及第 17—36 章持续使用的 team-task-board 基础练习项目。第 1—16 章按照正文逐步创建项目；第 19 章使用正文提供的固定错误示例完成调试训练；第 37—40 章为企业工单系统综合案例拆解，不要求下载或运行同名项目。Codex 零基础学习手册我的 AI 笔记 | 4我的 AI 笔记 × 前哨科技 · 面向零基础学习者的系统入门指南目录01 Codex 是什么，它能帮你完成什么521 用`AGENTS.md`建立项目规则与运行边界17002 访问和下载 Codex，找到适合自己的使用入口1122 建立最小项目知识与工作交接17803 安装并配置 Codex，完成第一次运行准备1723 用计划文件和工作树推进长任务18704 第一次使用 Codex，从打开项目到完成真实成果2324 用浏览器、控制台和截图验证候选功能19805 文件、文件夹、路径和扩展名2925 在桌面端组织项目、聊天和运行环境21206 终端、命令和工作目录3826 在命令行中完成小型本地维护任务22007 代码、项目、依赖和运行方式4527 在编辑器中继续审查和完成同一维护分支22808 看懂修改、保存版本与恢复结果5328 使用 Codex 云端完成一次 GitHub 文档任务23609 把模糊想法变成 Codex 能够执行的任务6129 用 Skill 沉淀项目变更审查方法24610 先探索和计划，再决定是否修改6930 用 MCP 连接外部工具和数据25611 读文件、搜内容、改文件和运行命令7331 用子智能体拆分和并行处理任务26612 验证结果、检查证据和控制权限8232 把验证过的只读检查安排为定时试运行27713 从真实问题形成项目需求和第一版范围9033 使用非交互模式完成最小脚本任务28814 创建一个真正可以使用的第一版10034 使用 Codex SDK 构建自己的工作流29715 让搜索、分类和状态交互完整运转11235 把 Codex 接入 GitHub、代码审查和持续集成30716 调试、测试、优化和整理交付文件12036 沙箱、审批、密钥、发布和团队使用规范31817 让 Codex 读懂一个陌生项目13137 企业工单系统综合案例，建立可信基线33218 增加一个新功能并控制修改范围14238 企业工单系统综合案例，开发转派功能并控制跨层修改35019 根据报错和证据定位并修复问题15139 企业工单系统综合案例，根据证据修复统计 Bug 并补回归测试37120 从代码修改到提交和合并请求16040 企业工单系统综合案例，通过 PR、质量链和业务验收完成正式交付386Codex 零基础学习手册我的 AI 笔记 | 5我的 AI 笔记 × 前哨科技 · 面向零基础学习者的系统入门指南第 1 章：Codex 是什么，它能帮你完成什么一、起始语你可能已经习惯用 AI 回答问题：帮我写一段网页代码。解释一下这个报错。给我一个任务管理工具的制作方案。在普通聊天模式中，AI 通常先给出文字、建议或代码片段。接下来，你还要自己创建文件、找到代码应该放置的位置、运行项目、处理报错，再确认结果是否符合要求。Codex 把这件事向前推进了一步。它可以围绕一个真实项目查看文件、搜索内容、修改代码、运行命令和检查结果，再把实际变化交给你审查。OpenAI 将 Codex 定义为帮助用户编写、审查和交付代码的编码智能体。OpenAI Help Center本章暂时不讲下载安装，也不要求你编写代码。我们先解决三个最基础的问题：Codex 是什么？它适合完成什么任务？哪些决定仍然必须由人负责？二、主体1.1 Codex 是什么Codex 是 OpenAI 的编码智能体。“编码”说明它主要面向软件、网页、脚本和其他技术成果；“智能体”说明它不只生成一段回答，还可以围绕一个目标连续采取行动。例如，你想修改一个已有网页的搜索功能。Codex 可以先查看项目结构，找到相关文件和现有逻辑，再完成修改、运行检查，并汇报改动和仍未验证的部分。理解 Codex 时，可以先记住这句话：Codex 能够进入被授权的工作环境，围绕真实项目完成一组可以检查的技术动作。它最终交付的通常不只是一段回答，还可能包括：Codex 零基础学习手册我的 AI 笔记 | 6我的 AI 笔记 × 前哨科技 · 面向零基础学习者的系统入门指南创建或修改后的文件；项目的实际运行结果；测试和检查记录；修改前后的代码差异；可以继续审查的候选成果。1.2 它和普通 AI 对话有什么区别Codex 与普通 AI 对话并非互相替代，它们适合处理的问题不同。任务普通 AI 对话Codex解释概念、讨论方案很适合可以，但通常没有必要生成一段示例代码很适合可以查看一个完整项目依赖你提供材料可以读取被授权的项目修改多个关联文件通常需要你手工衔接可以在项目中连续处理运行命令和测试普通聊天通常不操作本地项目可以在相应环境中执行检查实际差异需要你自行整理可以展示真实修改准备可审查的工程成果需要较多人工衔接是 Codex 的典型用途可以用一句话概括：普通 AI 对话更擅长帮助你思考和获得答案；Codex 更擅长在项目中推进任务并交付实际变化。当前 ChatGPT 桌面应用在 ChatGPT 下提供 Chat 和 Work，并将 Codex 作为并列的独立视图：Chat 用于快速交流，Work 用于较长的研究和成品任务，Codex 专门面向软件开发与技术工作。OpenAI Help Center1.3 Codex 通常怎样完成一项任务一项 Codex 任务通常会经历这样的过程：理解目标 → 查看项目 → 找到相关内容 → 修改或创建文件 → 运行检查 → 汇报结果以本书后面要制作的“AI 学习导航页”为例，Codex 可能会：1.查看当前文件夹里已经有什么；2.判断需要创建哪些页面文件；3.写入页面内容和样式；4.检查文件之间的引用是否正确；5.根据你的反馈继续修改；6.告诉你实际改变了哪些内容。Codex 零基础学习手册我的 AI 笔记 | 7我的 AI 笔记 × 前哨科技 · 面向零基础学习者的系统入门指南这里展示的是整体过程，不要求你现在记住一套复杂的操作方法。怎样描述任务、怎样要求 Codex 先查看项