CODEXGUIDE / 学习路径
教程目录
从理解 Codex 到完成一次可验证任务。先按主题找到适合当前问题的入口，也可以继续按原栏目和文章顺序浏览。
按主题查找
先解决眼前的问题
认识、安装与环境
4 篇 · 主题索引任务方法与项目理解
4 篇 · 主题索引01Codex 适合哪些人：判断标准、典型场景与学习起点判断自己是否适合 Codex，不先看职业名称，而看你要完成的任务：它是否依赖真实的代码、文件、配置或仓库，是否需要 AI 在项目里采取行动，以及结果能否被你或团队检查。02Codex 能做什么和不能做什么：能力边界、使用条件与验证方法这篇文章写给准备把真实任务交给 Codex 的读者。前两篇已经解释了 [Codex 是什么](./01-Codex是什么.md)，以及 [哪些人适合使用 Codex](./02-Codex适合哪些人.md)。接下来需要把能力边界讲清楚：它能执行哪些工作，完成这些工作需要什么条件，哪些判断仍然必须由人负责。03Codex 只读调查：先把项目摸清楚再改代码面对复杂或高风险的任务，直接让 Codex 动手是最贵的做法。改错了要回滚，改多了要排查，而它本来可以先只做一件事：把项目摸清楚，把证据交给你，再由你决定改不改。04Codex 协助出海 SEO：第一次购买客座文章的核验流程继续给网站做 SEO 外链实验。之前我对客座文章这种外链方式只停留在概念上，知道它大概是找一个相关网站，发布一篇带链接的文章，用来给目标页面增加相关性和权重。
开发、测试与代码协作
3 篇 · 主题索引配置、模型与权限
1 篇 · 主题索引Skills 与外部工具
1 篇 · 主题索引自动化与多任务协作
1 篇 · 主题索引故障排查与恢复
1 篇 · 主题索引按原栏目浏览
主题索引只负责推荐入口，五课顺序、栏目结构和未纳入映射的文章继续保留。
第一辑 从这里开始
01Codex 是什么：能力、工作方式与使用边界Codex 是面向软件开发任务的 AI 编程助手。它可以在你提供的项目和权限范围内读取文件、理解代码、修改内容、执行命令，并通过测试或其他检查验证结果。02Codex 适合哪些人：判断标准、典型场景与学习起点判断自己是否适合 Codex，不先看职业名称，而看你要完成的任务：它是否依赖真实的代码、文件、配置或仓库，是否需要 AI 在项目里采取行动，以及结果能否被你或团队检查。03Codex 能做什么和不能做什么：能力边界、使用条件与验证方法这篇文章写给准备把真实任务交给 Codex 的读者。前两篇已经解释了 [Codex 是什么](./01-Codex是什么.md)，以及 [哪些人适合使用 Codex](./02-Codex适合哪些人.md)。接下来需要把能力边界讲清楚：它能执行哪些工作，完成这些工作需要什么条件，哪些判断仍然必须由人负责。04Chat、ChatGPT Work 和 Codex 怎么选：按任务与交付物判断这篇文章写给已经打开 ChatGPT 或 Codex，却不确定应该选择 Chat、ChatGPT Work 还是 Codex 的读者。05Codex App、CLI、IDE 和 Cloud 怎么选：按工作环境与任务方式判断这篇文章写给已经决定使用 Codex，却被 App、CLI、IDE extension 和 Cloud 几个入口弄糊涂的读者。06安装与准备：选定一个 Codex 入口选定一个入口，准备同一份本地网页练习副本。07第 4 课：完成第一次网页修改只修改 index.html 的标题和简介，保留按钮、链接和 CSS。08Codex 新手常见误区：哪些做法最容易让任务失控这篇文章写给已经开始使用 Codex，却经常遇到下面情况的读者：
第二辑 安装与首次使用
第三辑 核心概念与任务方法
第四辑 项目理解与上下文
01Codex 从目录到入口：找到真正需要修改的代码拿到一个需求，最费时间的往往不是改代码，而是回答一个问题：真正需要动的文件是哪几个。范围圈大了，Codex 会在无关目录里反复翻找；范围圈错了，改完才发现入口在别处。02给 Codex 多大上下文才够用：三组实验的结果用 Codex 处理任务时，上下文给多少，直接决定它先做什么。给少了，它反复追问；给多了，它要在噪声里翻找目标；给到刚好，它能直接定位问题。03Codex 只读调查：先把项目摸清楚再改代码面对复杂或高风险的任务，直接让 Codex 动手是最贵的做法。改错了要回滚，改多了要排查，而它本来可以先只做一件事：把项目摸清楚，把证据交给你，再由你决定改不改。04Codex 如何从报错反推影响范围拿到一条报错，最直接的反应是找到出错的那一行改掉。很多时候这一改确实能修好。过几天，另一个页面、另一份导出或定时任务可能暴露新的问题，原因仍然是同一个函数。05Codex 读懂配置、环境变量和启动脚本很多项目第一次启动失败，表面上是端口占用、数据库连不上，或者页面拿不到接口地址。真正的原因往往藏在几层配置之间：package.json 调了哪个脚本，脚本又传了什么参数，程序从哪些文件读取环境变量，最后哪个值覆盖了哪个值。06Codex 阅读大仓库、多模块与历史代码大仓库最容易把人带偏的地方，是目录很多、同名模块很多、旧实现也一直留在仓库里。让 Codex 直接“把项目看懂”通常只会得到一份泛泛的目录摘要。更稳的做法是把调查拆成几次只读动作，每次都留下路径、证据和仍未确认的边界。07Codex 追踪依赖调用链与数据流改一个接口之前，先回答一个问题。这个请求从哪里进来，经过了哪些判断，最后读了什么数据、调用了什么适配层？只看函数名通常不够，真正影响结果的前缀、依赖注入、缓存和异常处理，往往分散在几个文件里。08Codex 把调查结果整理成项目理解报告只读调查结束后，终端里通常已经积了一屏命令，聊天里也有不少结论。问题是，换一个人接手，他还是不知道从哪里改、判断依据是什么、还缺哪条证据。
第五辑 代码修改与开发实战
01用Codex修复Bug并补回归测试：从复现到最小补丁这是一篇完成基础课程后的选学教程。你会在一个独立的 JavaScript 练习副本中，复现订单缺少金额字段时出现的 NaN，先用测试固定正确期望，再让 Codex 做最小修改，最后检查差异，并确认新测试确实能抓住旧错误。02Codex 多文件改动：接口、类型和界面如何保持同步接口、共享类型和界面一起变化时，最容易漏掉的是契约。后端已经返回新字段，类型文件还没更新，组件只能靠猜；类型更新了，旧数据又可能在运行时变成 undefined。这类问题通常要改四个文件，排查却不能按文件名挨个改。03Codex 升级依赖：从 package 文件到兼容性确认依赖升级的命令通常只有一行，影响却会落到导入路径、运行时版本、锁文件和下游调用方。把 date-fns 从 v2 升到 v3，当作一次小型变更来处理，能更早发现问题，也更容易回滚。
第六辑 Git 协作与代码审查
第七辑 测试调试与质量保障
第八辑 Skills 实战
01用 Codex 批量压缩图片并转换为 WebP文章配图经常需要限制宽度、转换格式和控制文件大小。img-convert Skill 可以让 Codex 按固定规则检查图片，再调用命令行工具批量处理。02从零创建 Codex Skill如果一段提示词需要反复复制，或者同一项工作每次都要重新说明步骤、输入和验收条件，可以把这套做法整理成 Skill。Codex 会先读取 Skill 的名称和描述，任务匹配后再加载完整说明，需要时继续读取参考资料或运行脚本。03Codex Record & Replay：生成可复用 Skill如果你有一套重复做、步骤稳定、但很难完整写成说明的桌面流程，可以用 Record & Replay 让 Codex 观察一次操作，再生成一个可复用的 Skill。04给 Codex 写一个专属 Skill：从重复提示词到可复用工作流用 Codex 久了，发现自己攒了一堆万能咒语。比如每次让它建新 Python 项目，都得复制粘贴同一大段话，用 uv 管理依赖、目录按 src 布局、必须配 ruff 和 pytest、README 要带徽章……
第九辑 插件工作流
01在 Codex 中连接 Notion：把调研结果写入数据库这篇教程适合已经能在 Codex 桌面端创建任务，并希望把调研结果直接整理到 Notion 的读者。完成后，你会连接 Notion 插件、验证页面读取权限，并把一组结构化资料写入两个数据库。02Codex 处理文档、表格、幻灯片和 PDF 的完整工作流Codex 的文档类工具可以把同一批材料整理成文档、电子表格、幻灯片和 PDF。稳定的做法是先确定事实与数据，再依次生成各类交付物，最后检查内容是否一致。03Codex 内容生产工作流Codex 可以把内容生产拆成一组可检查的任务。调研留下来源，写作读取事实表，配图说明用途，发布后的数据再回到下一轮选题。这样做适合需要持续更新教程、博客或社交内容的人，也适合多人协作的内容团队。04GitHub Issue 到 Pull Request：让 Codex 跑完整协作流程之前，我拿一个积压了很久的小 Issue 做了个实验，不打开编辑器，全程只在 GitHub 的 Issue 和 PR 评论区里 @codex 给它派活，看它能把这条 Issue 推进到什么程度。05Codex 插件入口：安装、调用与权限边界这两天 OpenAI 发了三个教育插件，K–12 老师、大学老师、大学生各一个。
第十一辑 配置模型与权限安全
01Codex 桌面端协作设置，从入口到权限与任务纠偏这篇文章写给已经安装 ChatGPT 桌面端，准备让 Codex 读取项目、修改文件并运行命令的读者。02Codex 模型与推理强度怎么选打开 Codex 的模型菜单，先分清模型、推理强度和速度三个设置。模型决定能力与基础消耗区间，推理强度决定当前任务投入的计算量，速度选项则用更多额度换更快返回。03Codex 任务总跑偏？先检查这 5 个设置忙了一圈，使用体验还是别扭。让它改一个小问题，它顺手碰了旁边几个文件。任务正在执行，临时补一句要求，不知道它会立刻改方向，还是等前面的工作结束。回复有时太长，有时又省掉了想看的解释。权限收得太紧，读文件、改代码、跑命令一路都在等确认。04Codex 沙箱与主机权限：一次权限边界风险复盘用 Codex、Cursor、Gemini CLI 这些 AI 编程工具的人，心里多少都揣着一个默认的安心，反正它有沙箱。05Codex 与其他编程模型比较：模型选择与实际工作流两大模型同一天发布新版本，这是要直接PK的意思啊，AI圈又热闹起来了。Anthropic 放出 Opus 4.6，之后 OpenAI 放出 GPT-5.3-Codex。
第十二辑 自动化与高级工作流
01Codex 在任务结束时捕捉可复用素材一个任务刚结束时，操作步骤、失败原因和取舍还在当前上下文里。等到几天后再整理，很多细节已经需要重新查。可以给 Codex 增加一条任务结束规则，只在确实出现可复用经验时生成素材候选。02Codex 跨会话协作功能Codex 的跨会话协作功能，我已经用了一段时间。它帮我省掉了很多来回搬运信息的时间。03Codex 长任务工作流，分开讨论、执行、审查与交接这篇文章适合已经能用 Codex 完成小修改，但在长任务中遇到上下文混乱、讨论打断执行、审查缺少独立视角或跨聊天交接困难的读者。04Codex 任务收尾系统，用 Markdown 保存状态、决策与可复用流程这篇文章写给需要长期维护多个项目，已经发现“任务做完了，下一次还要重新解释”的读者。05Codex Goal 模式：运行长任务如果你已经会让 Codex 修改代码，但任务一长就容易失去方向，可以学习 Goal 模式。它适合有明确交付物、能够持续验证的迁移、重构、排错和发布前检查。06Codex 使用 Subagents 并行处理任务如果一个任务可以拆成几块互不修改同一文件的工作，可以让 Codex 把其中一部分交给 Subagents。它适合代码库探索、测试检查、日志分析和安全审查，也适合需要多个独立结论的调研。07Codex CLI 管理多条任务线：命名、切换与 fork当你同时处理重构、排错和测试时，不必为每条任务线开一个终端窗口。Codex CLI 可以保存会话、给会话命名、在会话之间切换，并从已有会话 fork 出一条独立分支。08Codex CLI 长任务如何恢复：保存、继续与检查会话长任务中断后，最重要的不是让 Codex“接着猜”，而是恢复原会话并重新确认目标、修改范围和验证状态。会话历史不能替代 Git、测试和人工检查。09Codex 自动化与定时任务：从手动流程到 CI 执行用 Codex 的人，绝大多数都是这么用的：打开终端，输 codex ，进到那个交互界面，然后跟它一来一回地聊，你说要求，它改代码，看一眼再说下一句。
第十三辑 官方工具与集成
01Codex 远程连接支持移动端与 Windows 主机Codex 的远程连接适合把一台持续在线的电脑作为主机，在另一台设备上发任务、看进度和检查结果。代码、命令和桌面操作仍然发生在主机上。02Codex 浏览器操作与登录态功能Codex 现在可以通过浏览器扩展、内置浏览器和 Computer Use 操作网页或桌面应用。这几种入口的登录态、操作范围和限制不同，选错入口容易在任务中途卡住。03Codex 使用 Computer Use 操作桌面应用当任务只能通过桌面应用完成，或者命令行和结构化插件拿不到所需信息时，可以考虑 Computer Use。它能看屏幕、点击窗口、输入文字并在多个应用之间完成一段流程。04Codex 连接 Sentry 排查线上错误如果线上错误已经进入 Sentry，而你还要在日志、Issue、代码和测试之间来回切换，可以把 Sentry 接入 Codex，让它读取错误上下文，再回到代码仓库分析原因。05Codex 创建自定义桌宠，从参考图到动画精灵图Codex 桌面应用支持 Pets。你可以先启用内置宠物，也可以通过设置页里的自定义入口安装 hatch-pet Skill，再用一张参考图制作自己的动画角色。06Codex Automations 定时执行任务，创建、检查与运行条件Automations 可以让 Codex 桌面应用按计划重复运行任务。它适合检查最近提交、汇总 Git 活动、整理 CI 失败和生成周期性报告。每次运行仍然需要明确的数据来源和完成标准。07Codex 移动端远程协作早高峰的地铁上，你掏出手机，点开 ChatGPT。家里书房的 Mac 正在跑一个重构任务，Codex 刚把测试跑完，diff 摆在屏幕上等你审，你扫两眼，批准，顺手又派了个新活：“把昨天那个接口的报错日志也查一下。”08Codex 桌面端任务工作流Sam Altman 昨天在 X 上宣布 Codex 桌面版正式上线 Mac 平台。也是立马试用了一下，可视化界面操作起来确实方便，多个线程可以独立工作互不影响，Skill 管理也比较直观，还新增了定时任务功能。09Codex CLI 安装、登录与多入口排查现在三大主流的编程工具分别是 Codex、Claude Code 以及 Gemini。Claude Code 的综合能力很强，也是我的主力编程工具，但它封号太严重了，对国内极其不友好，使用门槛比较高，要找到靠谱的渠道。10Codex 接入飞书：从群聊指令到本地任务执行用 Codex 有个一直没解决的别扭，它跑在我电脑的终端里，可我人不总在电脑前。11Codex 常用功能清单：把容易漏掉的能力补齐很多人第一次用 Codex，会把所有事情都扔进同一个任务。先讨论方案，接着改文件，测试报错以后继续往里贴，最后还让它留在原任务里审查自己的修改。刚开始没什么感觉，任务一长，讨论过但放弃的方案、终端日志和最后确认的要求就混到了一起。
第十四辑 社区生态与项目评测
01Codex 视频工作流，4 个第三方 Skill 的用途、依赖与限制这篇文章写给希望用 Codex 处理视频生成、素材粗剪、字幕动画和发布前转码的读者。02在 Zed 中通过 ACP 使用 Codex CLIZed 可以通过 Agent Client Protocol 运行 Codex CLI。这样可以保留 Codex 的认证、模型和工具配置，同时使用编辑器里的文件树、差异预览和审批界面。03Codex 使用 Archify 生成可验证的代码架构图Archify 是第三方 Agent Skill。Codex 可以先读取代码仓库，整理系统边界和主调用路径，再让 Archify 把这些信息渲染成技术图。04Codex 使用 Text-to-Lottie 制作界面动效Text-to-Lottie 是第三方 Skill。它让 Codex 根据文字要求创建或修改 Lottie 动画，并用预览项目检查运动、循环和透明背景。05Codex 连接 ChatCut 完成视频粗剪、字幕与导出ChatCut 是第三方视频编辑服务。通过它提供的插件和 MCP 工具，Codex 可以分析素材、修改时间线、生成字幕并导出视频。账号、素材和编辑操作仍在 ChatCut 的权限范围内。06Codex 接入 ACP：连接兼容开发工具现在 AI 编程工具越来越多，但有一个问题一直没解决：它们之间不互通。07Codex 使用 Remotion 和 HyperFrames 制作视频Remotion 和 HyperFrames 都能把视频写成代码，Codex 可以读取脚本与素材，生成项目文件，启动预览并根据检查结果修改。它们是第三方工具，工作方式和适用场景不同。视频仍要经过人工审片，工具也不会自动解决素材版权、节奏和事实准确性。08Codex 插件安全检查：用 HOL Guard 评估第三方工具风险现在装一个 AI 编程插件有多容易？一行命令的事。Codex 有了插件市场，Claude Code 有 skills，Cursor、Gemini 各有各的生态。