书名：Codex从入门到精通
ISBN：978-7-115-70738-3
本书由人民邮电出版社发行数字版。版权所有，侵权必究。
您购买的人民邮电出版社电子书仅供您个人使用，未经授权，不得以任何方式复制和传播本书内容。
我们愿意相信读者具有这样的良知和觉悟，与我们共同保护知识产权。
如果购买者有侵权行为，我们可能对该用户实施包括但不限于关闭该帐号等维权措施，并可能追究法律责任。
著 苍 何
责任编辑 贾 静
人民邮电出版社出版发行 北京市丰台区成寿寺路11号
邮编 100164 电子邮件 315@ptpress.com.cn
网址 http://www.ptpress.com.cn
读者服务热线：(010)81055410
反盗版热线：(010)81055315
这是一本围绕日常工作展开讨论的Codex实践指南，能帮助读者判断哪些任务适合交给Codex，并掌握任务描述、权限控制、结果检查和失败处理的方法。
全书分为4个部分。第一部分介绍Codex的常见入口，并展示如何通过ChatGPT桌面App完成第一个任务；第二部分展示如何通过内容创作、连接外部工具、知识管理与文献研究案例，将Codex应用到日常工作中；第三部分介绍如何用AGENTS.md保存项目规则、用Skill保存工作方法、用插件打包和共享能力，并用Automation定期执行稳定任务；第四部分介绍如何根据任务特点选择Codex CLI、Visual Studio Code和Codex Cloud，并结合案例讨论复杂任务拆解、子代理协作、权限控制、CI验证、Hooks检查和团队协作等内容，有助于读者将习得的方法逐步应用到项目中。
本书采用案例驱动的写作方式，重点讲解可复用的任务描述、结果检查和人工确认等人机协作工程方法，适合所有希望使用Codex提高效率、减少重复劳动并逐步建立稳定人机协作方式的读者阅读。
这些年在WaytoAGI社区，我看到越来越多人开始使用AI，也看到很多人安装了不少AI工具，但真正用来完成工作的不多。本书从完成第一个任务开始，用案例说明如何描述任务、控制权限、检查结果等，并将有效经验沉淀为可复用的工作流程。
我尤其推荐本书给希望将Codex用好的创作者和开发者。
——AJ，WaytoAGI社区发起人
作为一个每天都在大量使用Codex的用户，我深知真正的难点是如何把它放入已有工作流程。本书内容涉及任务描述、权限控制、结果检查等，以及AGENTS.md、Skill、Automation、选择入口和团队协作等，这些都是实际使用Codex时需要面对的问题。对于刚开始接触Codex的读者，可以跟着书中的案例逐步掌握基本的使用方法；对于已经有使用经验的读者，可以借此重新梳理人机协作方式。
——卡兹克，微信公众号“数字生命卡兹克”主理人，
杭州虚实传媒有限公司CEO
跟苍何认识了很长时间，他是我见过的比较擅长把“AI如何落地”讲清楚的人之一。本书没有刻意制造“AI将取代人”的焦虑，也没有把复杂工作简单归结为“用一条提示词解决一切”，而是从实际工作出发，说明哪些事情适合交给Codex，如何描述任务，如何检查结果，以及如何根据结果不断改进人机协作方式。对于希望真正把AI应用到工作中的读者，本书提供了一条清晰的实践路径。
——摸鱼小李，AI科技博主
不少读者初次接触Codex时，最难的是把它用于一项具体工作。本书先帮助读者识别适合交给Codex的任务，再从使用ChatGPT桌面App的Codex完成第一个任务讲起，逐步进入日常工作、方法沉淀和复杂项目等场景。即使没有编程背景，读者也可以从可控的小任务开始，建立任务描述、结果检查和人工确认的习惯。
——王照华（甲木），元智图灵创始人，LangGPT社区联合创始人，
《智能体设计指南》作者
市面上有很多讲Codex的内容，但真正把“怎么用好、怎么落地”讲明白的并不多。本书的难得之处在于，它不仅介绍Codex的基础用法，还带领读者一步步把Codex应用到日常工作中，使其成为提高工作效率的工具。
——袋鼠帝，微信公众号“袋鼠帝”主理人，
WorkAgent社区联合创始人
这是一本帮助读者把Codex从“新鲜工具”逐步用成“可靠工作伙伴”的实践指南。本书先帮助读者识别适合交给Codex的任务，并完成第一个任务；再通过日常工作案例拓展使用场景，将有效做法沉淀为可复用的工作方法；最后介绍如何为复杂项目选择合适的Codex入口，并讨论权限、验证和团队协作。
——刘聪，南京逐悟智能科技有限公司创始人，知乎2024年度新知答主，
《大型语言模型实战指南》作者
很多人第一次接触Codex时，希望它帮助自己提高效率、节省时间。而真正开始使用后，很快就会遇到新的问题：输入同样一条提示词，有时能够一次完成任务，有时却需要反复修改；对有些任务很快能得到满意结果，有些任务虽然已经执行完成，却难以评估执行结果是否真正符合要求。
很多时候，这些差异不仅取决于工具本身，还与任务描述是否完整、权限控制是否得当，以及结果检查是否充分等有关。把一项工作交给Codex，并不只是输入一条提示词、等待一个结果。随着任务变得复杂，我们还需要考虑材料怎么准备，权限开放到什么程度，执行过程中需关注哪些信息，出现失败时怎样处理，以及最后依据什么判断任务已经完成。这也是使用Codex时需要建立任务协作方式的原因。
对于许多没有编程背景的读者来说，学习使用Codex，更重要的是学会逐步建立一种稳定的协作方式：知道什么任务适合交给Codex，怎样把需求说清楚，怎样限定任务范围，怎样检查执行结果，以及对哪些操作必须保留人工确认。
本书结合日常工作，以“从提出任务到交付结果”的过程组织内容，按照明确目标、限定范围、观察执行、检查结果、处理失败、沉淀方法的思路展开讨论。在内容组织上，本书从容易上手的使用方式和日常任务开始，帮助读者完成文档与图表处理、视频生成、知识整理、文献研究等实际工作，并逐步接触Skill、模型上下文协议（Model Context Protocol，MCP）、插件（Plugin）等扩展能力；随后进一步介绍如何保存项目规则、复用成熟工作方法、自动执行稳定任务，以及如何在更复杂的项目中选择合适的Codex入口（指使用Codex完成任务的不同界面或运行环境，例如ChatGPT桌面App、Codex CLI、Visual Studio Code和Codex Cloud），处理任务拆解、权限控制、结果验证、自动检查和团队协作等问题。这些内容最终都指向同一个目标：让Codex完成的工作可检查、可复用，也可以在出现问题时找到原因。
因此，书中的案例不仅会展示Codex“做出了什么[1]”，还会关注任务开始前需要准备什么，执行过程中应该观察什么，任务失败时怎样处理，以及完成以后如何判断结果能否使用。对于复杂任务，本书会反复强调权限边界、验证证据和人工确认，因为自动化程度越高，越需要清楚哪些环节可以交给Codex，哪些判断仍然应该由人完成。
[1] 为方便观察Codex的执行过程和执行结果，书中展示了一些截图。对于图中不影响观察的部分表述不规范问题，并未逐一修改。
Codex仍在持续更新，其界面、配置方式及第三方工具可能随着版本变化而调整。书中涉及的具体界面和操作步骤等内容，均以出版前最终核验结果为准；本书的配套网站（https://codexguide.ai）将同步更新版本变化、案例补充和实践经验，读者可结合配套网站继续学习。
本书主要面向希望借助Codex提高工作效率的读者。无论是整理资料、撰写内容、制作演示文稿、管理知识、开展研究，还是处理重复性的工作流程，都可以按照书中的案例逐步实践，并结合自己的工作形成稳定的人机协作方式。
建议第一次阅读时按章节顺序学习。先完成第一部分，建立任务描述、权限控制和结果检查的基本习惯；再从第二部分选择一个与自己工作最接近的案例进行实践。当某项任务已经能够稳定完成并且输入、输出和验收标准都比较明确时，再学习第三部分的方法，将工作方法沉淀下来。随着任务的变化，逐步学习第四部分介绍的Codex CLI、Visual Studio Code、Codex Cloud和团队协作。
无论使用哪一种入口，都应保留人工复核和结果检查环节。对于生成的内容需要由人工核查事实、格式是否符合预期；修改文件或项目内容后，需要检查改动范围和执行结果；对于涉及外部平台的操作，需要返回对应系统确认最终状态。对于删除、发布等不可逆或影响范围较大的操作，以及涉及账号权限、密钥、账单、医学判断和生产数据等的高风险任务，应提前限定任务范围、设置权限边界，并在关键步骤上保留人工确认。
本书并不要求读者掌握Codex的所有使用方式。对于大多数人来说，找到适合特定任务的使用方式，能够稳定完成工作，并逐步形成可以长期复用的人机协作方式，就是阅读本书最大的收获。
感谢OpenAI及Codex团队，持续提供并完善相关工具和资料，为AI参与真实工作提供了重要支持。感谢开源社区中的开发者和维护者，他们分享的Skill、插件、MCP工具和案例，为本书的案例部分提供了重要参考。感谢廖信同和颜永文对本书内容的审阅与修改。
感谢参与案例测试、内容审阅和结构讨论的编辑与同行，他们提出的许多关于如何理解任务边界、如何检查结果及哪些步骤容易受到版本变化影响的建议，帮助本书不断优化讲解顺序和表达方式。
AI工具仍在快速更新，本书难免存在需要继续验证和完善之处。感谢各位读者的信任，也期待大家在实际使用中提出反馈，并通过本书配套网站（https://codexguide.ai）或微信公众号“苍何”与我交流。大家的反馈和建议，也将帮助本书持续补充和完善相关实践方法。
苍何
2026年8月
第一部分 快速开始第一次接触Codex时，读者可能会关注它能够完成哪些事情，却不清楚它与普通聊天工具有什么区别，也不知道应该从哪个入口开始使用。
本章首先介绍Codex的基本概念，帮助读者理解它的定位和工作方式；随后介绍ChatGPT桌面App中的Codex、Codex CLI（Command Line Interface，命令行接口）、IDE（Integrated Development Environment，集成开发环境）插件和Codex Cloud等常见入口，说明不同入口适用的场景；最后结合具体任务类型，帮助读者判断哪些工作适合交给Codex。
Codex是OpenAI推出的一种AI Agent。它可以在用户授权的范围内读取项目材料、修改文件、调用工具并执行命令，参与一项任务所涉及的材料处理、内容修改、工具调用和结果检查等多个环节。
与普通聊天工具相比，Codex更强调围绕具体任务开展连续操作。用户需要提供任务背景、相关材料和目标要求，以帮助Codex理解需要完成的工作。例如，用户提出“整理这个文件夹中的会议记录”后，Codex可以读取相关文件，按照要求提取关键信息，生成任务清单或报告，并将结果保存到指定位置。用户可以查看结果，提出修改要求，继续完善结果。
Codex和Claude Code都属于面向任务执行的Agent，在代码处理、文件操作和自动化执行等方面在功能上有一定重合。两者的区别主要体现在使用入口和面向用户的工作方式上。
Claude Code以终端为主要入口，更适合已经习惯命令行交互模式，并经常围绕代码仓库、脚本和开发工具开展工作的用户。除了Codex CLI和IDE等开发入口外，Codex还提供了基于ChatGPT桌面App的使用方式，用户可以通过图形界面管理任务、查看执行过程和检查结果。
对本书的目标读者来说，Codex提供了较直观的学习路径：可以从ChatGPT桌面App开始完成简单任务，再根据实际需要逐步学习Codex CLI、IDE和Codex Cloud等更深入的使用方式。
第一次使用Codex时，很多人会直接提出一个较大的任务目标，例如“帮我修改这个项目”“帮我开发一个网站”或“帮我解决这个报错问题”，这类任务能否顺利完成，与任务本身的复杂程度高低、提供的信息是否充分以及选择的入口是否匹配有关。
Codex提供了多个使用入口。不同入口面向的工作环境不同，适合处理的任务类型也有所区别。选择合适的入口，可以帮助用户更方便地提供上下文、调用工具、查看执行过程和检查结果。
目前，可以通过ChatGPT桌面App、Codex CLI、Codex Cloud和IDE（如Visual Studio Code）插件等多个入口使用Codex。下面分别介绍这些入口及其适用场景。
（1）通过ChatGPT桌面App使用Codex，适合管理日常任务，并通过图形界面查看执行过程和交付结果。在ChatGPT桌面App界面，通过选择图1-1左上角箭头指向的位置，可以在ChatGPT和Codex间进行切换。
对于第一次接触Codex的读者，建议优先从ChatGPT桌面App开始：需要讨论问题、解释概念或生成初稿时，可以直接使用ChatGPT；当任务需要读取项目文件、调用工具、修改内容并验证结果时，可以切换到Codex完成。
（2）通过Codex CLI使用Codex（见图1-2），适合围绕本地代码仓库完成开发任务，如执行命令、修改文件、运行测试和验证结果。Codex CLI的优势在于可以帮助用户快速形成“修改→验证→再修改”的循环。
图1-1 通过ChatGPT桌面App使用Codex
图1-2 通过Codex CLI使用Codex
（3）通过Codex Cloud使用Codex（见图1-3），适合围绕远程代码仓库执行持续时间较长的任务，例如分析仓库、定位问题、修改代码并生成可供审核的修改结果。
图1-3 通过Codex Cloud使用Codex
（4）通过IDE插件使用Codex，适合围绕当前文件完成代码解释、局部修改、补充测试和代码审查等工作。
此外，Codex还可以与GitHub、Slack、Linear等代码托管、协作和项目管理平台集成，也可以通过MCP连接更多第三方工具，扩展与现有工作流程的连接方式。
选择入口时，应结合任务所在位置、执行方式和结果检查需求进行判断。如果是第一次接触Codex，建议先完成一个能够独立验证结果的小任务（详见第2章），建立从提出任务到检查结果的基本使用流程。本书也是按照这一学习顺序组织内容的：前三部分主要以ChatGPT桌面App作为入门和日常入口来使用Codex，帮助读者逐步建立稳定的人机协作方式；第四部分再介绍Codex CLI、Visual Studio Code等IDE插件和Codex Cloud等入口，帮助读者处理真实项目中的复杂任务。
了解Codex的使用入口后，还需要进一步判断哪些任务适合交给Codex执行。Codex可以处理多种类型的任务，例如修改代码、整理文档、检查结果、分析项目、生成报告、调用工具以及处理本地文件、项目目录或远程代码仓库中的任务，但并不是所有问题都适合交给Codex完成。
一个重要的判断标准是：如果某项任务需要读取材料、处理文件或调用工具，并最终产出可检查的结果，就交给Codex完成。如果该项任务只需要一句解释、一个概念定义或一段临时改写，使用普通聊天工具通常更高效。适合Codex执行的任务，至少要具备如下6个特征。
第一，目标要明确。任务应当能够明确说明最终要完成什么。例如，不要只说“优化一下网站”，而可以说“修复登录页面刷新后状态丢失的问题”。
第二，背景要清晰。任务应当说明为什么要做这件事、基于什么上下文、面向谁解决什么问题。例如，不要只说“完善文档”，而可以说“由于新成员登录时频繁询问项目定位，需要补充项目介绍并统一术语表述”。背景描述得越清晰，Codex越容易判断优先级、取舍方案和识别潜在风险。
第三，范围要明确。应明确告诉Codex可以修改什么，以及不能修改什么。例如，可以告诉Codex“允许读取整个仓库，但只允许修改README.md文档”，或者“可以查看所有会议纪要，但只允许更新项目周报”。范围界定得越明确，越容易得到可控结果。
第四，约束要清晰。约束用于限定执行边界，帮助Codex把注意力集中在正确的边界内。例如，不新增第三方依赖、不读取敏感数据、不修改业务逻辑、不调整视觉样式。对于团队环境中的任务，约束通常与代码规范、安全要求和发布流程直接相关。
第五，验证方式要提前给出。验证是任务闭环中的重要组成部分。如果没有预先定义验证方式，即使Codex声称任务已经完成，用户也无法确认Codex的执行结果是否正确。以下是几类任务的验证方式。
• 代码修改任务，可以通过运行测试、执行构建来验证。
• 文档整理任务，可以通过检查修改记录来验证。
• 知识库更新任务，可以通过核对引用来源来验证。
• 数据统计任务，可以通过核对统计口径来验证。
• 内容汇总任务，可以通过抽样检查事实准确性来验证。
第六，交付结果要可复核。完整的交付结果不仅包括最终产出的文件或内容，还应包括必要的执行说明，例如修改了哪些文件、为什么这样修改、是否通过检查、是否存在其他风险，以及是否需要人工确认等。这些说明能够帮助用户复盘执行过程，也便于后续审核、采用和经验沉淀。
如果是第一次接触Codex，建议优先选择低风险、易验证的任务。例如，更新README文档、整理项目文档、为现有代码补充注释、检查测试失败的原因、分析目录结构、生成实现计划，以及审查配置文件。这些任务通常具有明确的输入和输出，即使执行结果不符合预期，也容易检查、调整和复盘。
