# CodexGuide

> 面向中文读者的 Codex 实战手册。每个入口都直接进入可阅读正文，不经过中间目录。

## 内容入口
- [Codex 总入口](/codex): 按安装、入口、认证、权限、验证和工作流直接选择专题。
- [怎么选](/compare): 按任务、人群、权限和环境选择 App、CLI、IDE 或 Cloud。
- [入门教程](/guides): 基础概念、安装、任务方法与验证。
- [快速上手](/quickstarts): 可在 15-30 分钟完成的操作流程。
- [进阶教程](/advanced): 配置、AGENTS.md、权限安全、MCP、自动化和 Windows。
- [故障排查 FAQ](/guides/faq): 权限、登录、Git、验证和 Windows 问题。
- [验证流程](/codex/validation): 从 diff、测试到页面检查的证据顺序。
- [实战案例](/cases): 真实任务复盘与可验证结果。

## Codex 专题
- [安装 Codex：先完成第一次启动](https://codexguide.io/codex/install): 从 App、CLI 或 IDE 入口开始安装 Codex，完成登录、打开项目和第一次只读检查。
- [Codex 从哪里进入：App、CLI、IDE 与 Cloud](https://codexguide.io/codex/entry-points): 按任务类型、运行位置和权限边界选择 Codex 入口，直接进入下一篇对应教程。
- [登录与认证：先确认账号和凭据边界](https://codexguide.io/codex/auth): 理解 ChatGPT 登录、API Key 和本地凭据的使用边界，定位认证失败而不泄露敏感信息。
- [权限与安全边界：先限制影响面](https://codexguide.io/codex/permissions): 掌握 Codex 的工作区、网络、审批和敏感信息边界，用最小权限完成可回滚任务。
- [修改后如何验证：从 diff 到回归检查](https://codexguide.io/codex/validation): 建立 Codex 修改后的验证顺序，覆盖 Git diff、测试、构建、页面检查和无法验证的部分。
- [Codex 工作流：从任务到可回滚结果](https://codexguide.io/codex/workflows): 用目标、上下文、约束、计划、最小修改和验证组成一条可重复的 Codex 工作流。

## 故障排查问题
### 登录与认证
- [Codex 登录失败怎么办？](https://codexguide.io/guides/faq#auth-login-failed): 先保留完整错误、当前入口和操作系统，确认网络、系统时间与账号状态，再重新完成认证。
- [ChatGPT 登录和 API Key 应该怎么选？](https://codexguide.io/guides/faq#auth-login-method): 按当前入口和账号能力选择。Cloud 使用 ChatGPT 登录；本地脚本或可信 CI 才考虑 API Key，并单独确认计费与权限。
- [auth.json、Token 或 .env 可以发给 Codex 吗？](https://codexguide.io/guides/faq#auth-credentials): 不要把凭据放进提示词、截图、Issue 或 Git 提交。只让 Codex 检查凭据是否存在，不要输出真实值。
- [登录成功后第一步应该做什么？](https://codexguide.io/guides/faq#auth-after-login): 先只读检查项目、工作目录和 Git 状态，确认入口和环境正确后，再进入权限设置或修改任务。

### 权限与审批
- [Codex 没有权限修改文件怎么办？](https://codexguide.io/guides/faq#permissions-file-denied): 先确认文件是否在工作区内、任务是否需要写入范围外，再检查审批策略；不要为了绕过错误直接切换到 Full access。
- [为什么 Codex 要求网络或命令审批？](https://codexguide.io/guides/faq#permissions-network-approval): 网络、工作区外写入和高风险命令会扩大影响面。先确认用途、目标和读写范围，再逐项批准。
- [sandbox 限制和 approval policy 有什么区别？](https://codexguide.io/guides/faq#permissions-sandbox-policy): sandbox 决定执行环境能访问什么，approval policy 决定哪些动作需要人工确认；两者共同构成任务边界。
- [什么时候可以使用 Full access？](https://codexguide.io/guides/faq#permissions-full-access): 只有在任务明确需要更大范围，并且已经确认目标、备份、凭据和回滚方式时才考虑扩大权限。

### Git 与工作区
- [Codex 修改后 Git diff 看不到怎么办？](https://codexguide.io/guides/faq#git-diff-missing): 先运行 git status --short --branch，确认当前目录、分支和文件是否正确，再排查是否修改了另一个工作区。
- [已有未提交修改时能让 Codex 开始吗？](https://codexguide.io/guides/faq#git-existing-changes): 先确认这些修改是谁做的、是否需要保留以及是否会与任务冲突；不要为了得到干净状态而删除或覆盖它们。
- [如何避免 Codex 把无关文件一起改了？](https://codexguide.io/guides/faq#git-unrelated-files): 在任务中限定允许修改的目录，执行中查看 diff，结束后检查未跟踪文件、锁文件和配置文件是否超出范围。
- [多个 worktree 或分支导致结果不一致怎么办？](https://codexguide.io/guides/faq#git-worktree-mismatch): 分别记录当前路径、分支和提交，确保 Codex 与你查看 diff 使用的是同一个工作区。

### 测试与验证
- [测试通过了，为什么还不能算完成？](https://codexguide.io/guides/faq#validation-tests-pass): 还要确认 diff 范围、页面行为、构建结果和未验证部分；Codex 的完成提示不是验收证据。
- [验证失败后应该先做什么？](https://codexguide.io/guides/faq#validation-failed): 保留失败命令、完整错误、路径和当前分支，先区分环境、权限、依赖、Git 和代码问题。
- [项目修改前就已经测试失败怎么办？](https://codexguide.io/guides/faq#validation-baseline-failed): 先记录基线错误，不要把它和本次修改混在一起；修改后用同一条命令比较结果。
- [构建通过但页面仍然不对怎么办？](https://codexguide.io/guides/faq#validation-page-mismatch): 补做浏览器或页面行为检查，确认路由、交互、移动端布局和控制台错误，而不是只依赖构建退出码。

### Windows 与 WSL
- [Windows 和 WSL 路径不一致怎么办？](https://codexguide.io/guides/faq#environment-windows-wsl-path): 统一 Git、Node、包管理器和 Codex 的运行环境，确认工作目录、换行符、编码和执行权限。
- [命令在终端可用，在 Codex 中却找不到怎么办？](https://codexguide.io/guides/faq#environment-command-missing): 确认 Codex 使用的终端、PATH 和项目目录与人工验证时一致，再记录版本和完整命令。

## 实战案例
- [Codex 新手第一个任务：修改本地网页并检查结果](https://codexguide.io/cases/wan-cheng-di-yi-ge-zhen-shi-ren-wu): 适合已经安装并登录 Codex App 或 CLI 其中一种、能够访问练习文件夹，但还没有独立完成过一次可核对修改的读者。不要求同时安装两种入口，也不声称所有系统和客户端都已实测。
- [用一个 Skill 做出可发布的食物广告](https://codexguide.io/cases/yong-skill-zuo-shi-wu-guang-gao): 这次实战从一杯还没有名字的概念奶茶开始。我想先把广告图做出来，再回头看这件事能不能整理成一套下次还用得上的 Skill。
- [用 HIAPI 中文图标 Skill，做一套真正统一的产品图标](https://codexguide.io/cases/hiapi-zhong-wen-tu-biao-skill): 单独做一枚图标不算难，难的是让一组图标看起来像同一套。主体大小、视角、材质和留白只要有一项没对齐，摆在一起就容易显得散。
- [Codex 协助客座文章外链实验](https://codexguide.io/cases/codex-guest-post-case): 这篇记录一次由 Codex 协助完成的客座文章外链实验，重点是它怎样整理筛选条件、检查提交字段和复核发布结果。
- [在 Codex 中连接 Notion：把调研结果写入数据库](https://codexguide.io/cases/codex-notion-plugin-workflow): 这篇教程适合已经能在 Codex 桌面端创建任务，并希望把调研结果直接整理到 Notion 的读者。完成后，你会连接 Notion 插件、验证页面读取权限，并把一组结构化资料写入两个数据库。
- [用开源 img-convert Skill 批量压缩图片](https://codexguide.io/cases/img-convert-pi-liang-ya-suo-tu-pian): 整理文章配图时，我经常重复做几件事。限制图片宽度，转成 WebP，控制文件大小，最后确认原图没有被覆盖。这个流程已经有人做成了开源工具和 Skill，没必要从零写一套。

## 进阶专题
- [config.toml 配置指南：exec、沙箱与审批策略](https://codexguide.io/advanced/config-toml): 从默认配置到项目级覆盖，理解 Codex 的 config.toml 如何影响模型、沙箱、审批策略和命令行工作方式。
- [AGENTS.md 项目协作规则](https://codexguide.io/advanced/agents-md): 用 AGENTS.md 给 Codex 提供可检查、可继承的项目上下文，让修改范围和验收标准保持一致。
- [权限与安全边界](https://codexguide.io/advanced/permissions-security): 掌握 Codex 的工作区、网络、审批和敏感信息边界，降低自动化修改带来的误操作风险。
- [MCP 外部工具接入](https://codexguide.io/advanced/mcp): 理解 MCP 服务器、工具权限和数据边界，安全地把外部资料或服务接入 Codex 工作流。
- [自动化与定时任务](https://codexguide.io/advanced/automation): 把重复的 Codex 工作拆成有边界的自动化任务，设计触发条件、日志、失败处理和人工闸门。
- [Windows 与 WSL 使用要点](https://codexguide.io/advanced/windows): 在 Windows 和 WSL 环境中配置 Codex 的路径、终端、Git 与权限，减少跨系统命令和文件编码问题。

## 快速上手
- [修改本地网页并检查结果](https://codexguide.io/quickstarts#quickstart-first-local-web-task): 用独立的 HTML/CSS 练习完成首个小修改，保留按钮链接与样式，再查看 diff 和浏览器页面。
- [首次安装、登录并打开项目](https://codexguide.io/quickstarts#quickstart-install-login-open-project): 用最少的配置完成第一次 Codex 本地启动，确认账号、工作目录和 Git 状态都可用。
- [完成一个可回滚的真实任务](https://codexguide.io/quickstarts#quickstart-complete-reversible-task): 从清晰目标开始，经过读取上下文、最小修改、验证和 diff 审查，走完一次完整闭环。
- [排查权限、Git 或验证失败](https://codexguide.io/quickstarts#quickstart-troubleshoot-permission-git-verification): 遇到批准弹窗、工作区冲突、命令失败或测试不稳定时，按证据定位问题，不靠重复重试。

## 入门教程
- [Codex 是什么：能力、工作方式与使用边界](https://codexguide.io/guides/codex-shi-shen-me): 如果你刚接触 Codex，还不确定它和普通 AI 对话有什么区别，可以从这里开始。
- [Codex 适合哪些人：判断标准、典型场景与学习起点](https://codexguide.io/guides/codex-shi-he-na-xie-ren): 这篇文章写给正在判断“我有没有必要学 Codex”的读者。
- [Codex 能做什么和不能做什么：能力边界、使用条件与验证方法](https://codexguide.io/guides/codex-neng-zuo-shen-me): 这篇文章写给准备把真实任务交给 Codex 的读者。
- [Chat、ChatGPT Work 和 Codex 怎么选：按任务与交付物判断](https://codexguide.io/guides/chat-work-he-codex-zen-me-xuan): 这篇文章写给已经打开 ChatGPT 或 Codex，却不确定应该选择 Chat、ChatGPT Work 还是 Codex 的读者。
- [Codex App、CLI、IDE 和 Cloud 怎么选：按工作环境与任务方式判断](https://codexguide.io/guides/app-cli-ide-he-cloud-zen-me-xuan): 这篇文章写给已经决定使用 Codex，却被 App、CLI、IDE extension 和 Cloud 几个入口弄糊涂的读者。
- [第一次使用 Codex 前要准备什么：账号、入口、练习目录与验收清单](https://codexguide.io/guides/di-yi-ci-shi-yong-qian-yao-zhun-bei-shen-me): 这篇文章写给准备第一次打开 Codex，却不知道应该先准备账号、入口、练习目录还是开发环境的读者。
- [Codex 新手第一个任务：修改本地网页并检查结果](https://codexguide.io/guides/wan-cheng-di-yi-ge-zhen-shi-ren-wu): 适合已经安装并登录 Codex App 或 CLI 其中一种、能够访问练习文件夹，但还没有独立完成过一次可核对修改的读者。不要求同时安装两种入口，也不声称所有系统和客户端都已实测。
- [Codex 新手常见误区：哪些做法最容易让任务失控](https://codexguide.io/guides/codex-xin-shou-chang-jian-wu-qu): 这篇文章写给已经开始使用 Codex，却经常遇到下面情况的读者：
- [登录 Codex：选择 ChatGPT 或 API Key 并确认本地入口](https://codexguide.io/guides/deng-lu-codex): 安装好 ChatGPT 桌面应用里的 Codex、Codex CLI 或 IDE 扩展后，下一步就是登录。
- [打开第一个本地项目：确认目录、权限与起始状态](https://codexguide.io/guides/da-kai-di-yi-ge-ben-di-xiang-mu): 登录后，先别让 Codex 改代码。第一次使用，可以准备一个随时能恢复的练习项目，或者先复制一份项目再操作。本文以 VS Code 为主，也会介绍 Codex 桌面端和 CLI 的入口。
- [完成第一次修改并检查结果：本地网页练习与历史案例](https://codexguide.io/guides/wan-cheng-di-yi-ci-xiu-gai-bing-jian-cha-jie-guo): 本文首期使用独立的本地静态网页练习：只修改 index.html 的主标题和一段简介，保留按钮链接、其他 HTML 内容和全部 CSS。练习材料在 [练习材料/首次任务-本地网页/](../练习材料/首次任务-本地网页/)；不要直接操作 CodexGuide 正式网站或私人仓库。
- [用 Codex 批量压缩图片并转换为 WebP](https://codexguide.io/guides/codex-batch-image-conversion-skill): 文章配图经常需要限制宽度、转换格式和控制文件大小。img-convert Skill 可以让 Codex 按固定规则检查图片，再调用命令行工具批量处理。
- [Codex 做上线前端到端验收](https://codexguide.io/guides/codex-browser-e2e-acceptance): 最近不停在上一些小功能，就需要验收。
- [Codex 在任务结束时捕捉可复用素材](https://codexguide.io/guides/codex-capture-reusable-content): 一个任务刚结束时，操作步骤、失败原因和取舍还在当前上下文里。等到几天后再整理，很多细节已经需要重新查。可以给 Codex 增加一条任务结束规则，只在确实出现可复用经验时生成素材候选。
- [Codex 跨会话协作功能](https://codexguide.io/guides/codex-cross-session-collaboration): Codex 的跨会话协作功能，我已经用了一段时间。它帮我省掉了很多来回搬运信息的时间。
- [Codex 远程连接支持移动端与 Windows 主机](https://codexguide.io/guides/codex-remote-control-mac): Codex 的远程连接适合把一台持续在线的电脑作为主机，在另一台设备上发任务、看进度和检查结果。代码、命令和桌面操作仍然发生在主机上。
- [Codex 浏览器操作与登录态功能](https://codexguide.io/guides/codex-browser-login-state): Codex 现在可以通过浏览器扩展、内置浏览器和 Computer Use 操作网页或桌面应用。这几种入口的登录态、操作范围和限制不同，选错入口容易在任务中途卡住。
- [在 Codex 中连接 Notion：把调研结果写入数据库](https://codexguide.io/guides/codex-notion-plugin-workflow): 这篇教程适合已经能在 Codex 桌面端创建任务，并希望把调研结果直接整理到 Notion 的读者。完成后，你会连接 Notion 插件、验证页面读取权限，并把一组结构化资料写入两个数据库。
- [Codex 桌面端协作设置，从入口到权限与任务纠偏](https://codexguide.io/guides/codex-desktop-collaboration-settings): 这篇文章写给已经安装 ChatGPT 桌面端，准备让 Codex 读取项目、修改文件并运行命令的读者。
- [Codex 长任务工作流，分开讨论、执行、审查与交接](https://codexguide.io/guides/codex-long-task-collaboration-workflow): 这篇文章适合已经能用 Codex 完成小修改，但在长任务中遇到上下文混乱、讨论打断执行、审查缺少独立视角或跨聊天交接困难的读者。
- [Codex 任务收尾系统，用 Markdown 保存状态、决策与可复用流程](https://codexguide.io/guides/codex-task-closeout-memory-system): 这篇文章写给需要长期维护多个项目，已经发现“任务做完了，下一次还要重新解释”的读者。
- [Codex 视频工作流，4 个第三方 Skill 的用途、依赖与限制](https://codexguide.io/guides/codex-video-workflow-skills): 这篇文章写给希望用 Codex 处理视频生成、素材粗剪、字幕动画和发布前转码的读者。
- [Codex 是如何工作的](https://codexguide.io/guides/codex-shi-ru-he-gong-zuo): 第一次看 Codex 工作，很容易把它理解成“会写代码的 ChatGPT”。你输入一句话，等一会儿，它就改好了几个文件。
- [Codex 安全与风险边界：什么时候该收紧权限](https://codexguide.io/guides/codex-an-quan-yu-feng-xian-bian-jie): 如果你还不熟悉 Codex 接收任务和执行命令的方式，可以先读《别再把 Codex 当成“会写代码的 ChatGPT”：一文看懂它到底怎么工作》；已经上手的读者直接进入下面的止损步骤即可。
- [Codex 权限、沙箱与审批的放行与收紧](https://codexguide.io/guides/codex-quan-xian-sha-xiang-yu-shen-pi): Codex 有时只能读，不能写；有时访问网络或工作区外的文件会停下来询问。遇到这些提示，先分清权限、沙箱和审批，再决定是否放行。
- [Codex 从目录到入口：找到真正需要修改的代码](https://codexguide.io/guides/codex-cong-mu-lu-dao-ru-kou): 拿到一个需求，最费时间的往往不是改代码，而是回答一个问题：真正需要动的文件是哪几个。范围圈大了，Codex 会在无关目录里反复翻找；范围圈错了，改完才发现入口在别处。
- [给 Codex 多大上下文才够用：三组实验的结果](https://codexguide.io/guides/codex-shang-xia-wen-gei-duo-shao): 用 Codex 处理任务时，上下文给多少，直接决定它先做什么。给少了，它反复追问；给多了，它要在噪声里翻找目标；给到刚好，它能直接定位问题。
- [Codex 只读调查：先把项目摸清楚再改代码](https://codexguide.io/guides/codex-zhi-du-diao-cha-xian-ba-xiang-mu-mo-qing-chu-zai-gai-dai-ma): 面对复杂或高风险的任务，直接让 Codex 动手是最贵的做法。改错了要回滚，改多了要排查，而它本来可以先只做一件事：把项目摸清楚，把证据交给你，再由你决定改不改。
- [Codex 如何从报错反推影响范围](https://codexguide.io/guides/codex-cong-bao-cuo-huo-xu-qiu-fan-tui-ying-xiang-fan-wei): 拿到一条报错，最直接的反应是找到出错的那一行改掉。很多时候这一改确实能修好。过几天，另一个页面、另一份导出或定时任务可能暴露新的问题，原因仍然是同一个函数。
- [Codex 读懂配置、环境变量和启动脚本](https://codexguide.io/guides/codex-du-dong-pei-zhi-huan-jing-bian-liang-he-qi-dong-jiao-ben): 很多项目第一次启动失败，表面上是端口占用、数据库连不上，或者页面拿不到接口地址。真正的原因往往藏在几层配置之间：package.json 调了哪个脚本，脚本又传了什么参数，程序从哪些文件读取环境变量，最后哪个值覆盖了哪个值。
- [Codex 阅读大仓库、多模块与历史代码](https://codexguide.io/guides/codex-yue-du-da-cang-ku-duo-mo-kuai-yu-li-shi-dai-ma): 大仓库最容易把人带偏的地方，是目录很多、同名模块很多、旧实现也一直留在仓库里。让 Codex 直接“把项目看懂”通常只会得到一份泛泛的目录摘要。更稳的做法是把调查拆成几次只读动作，每次都留下路径、证据和仍未确认的边界。
- [Codex 追踪依赖调用链与数据流](https://codexguide.io/guides/codex-zhui-zong-yi-lai-diao-yong-lian-yu-shu-ju-liu): 改一个接口之前，先回答一个问题。这个请求从哪里进来，经过了哪些判断，最后读了什么数据、调用了什么适配层？只看函数名通常不够，真正影响结果的前缀、依赖注入、缓存和异常处理，往往分散在几个文件里。
- [Codex 把调查结果整理成项目理解报告](https://codexguide.io/guides/codex-ba-diao-cha-jie-guo-zheng-li-cheng-xiang-mu-li-jie-bao-gao): 只读调查结束后，终端里通常已经积了一屏命令，聊天里也有不少结论。问题是，换一个人接手，他还是不知道从哪里改、判断依据是什么、还缺哪条证据。
- [Codex 修复可复现 Bug：让补丁只解决当前问题](https://codexguide.io/guides/codex-xiu-fu-ke-fu-xian-bug): 示例问题是订单列表偶尔显示 NaN。复现输入包括一个缺少金额字段的订单，期望界面显示占位符，实际结果是 NaN。没有复现步骤前，不要让 Codex 直接“修金额格式化”。
- [Codex 多文件改动：接口、类型和界面如何保持同步](https://codexguide.io/guides/codex-duo-wen-jian-gai-dong-jie-kou-lei-xing-jie-mian): 接口、共享类型和界面一起变化时，最容易漏掉的是契约。后端已经返回新字段，类型文件还没更新，组件只能靠猜；类型更新了，旧数据又可能在运行时变成 undefined。这类问题通常要改四个文件，排查却不能按文件名挨个改。
- [Codex 升级依赖：从 package 文件到兼容性确认](https://codexguide.io/guides/codex-sheng-ji-yi-lai-package-jian-rong-xing): 依赖升级的命令通常只有一行，影响却会落到导入路径、运行时版本、锁文件和下游调用方。把 date-fns 从 v2 升到 v3，当作一次小型变更来处理，能更早发现问题，也更容易回滚。
- [从零创建 Codex Skill](https://codexguide.io/guides/create-codex-skill): 如果一段提示词需要反复复制，或者同一项工作每次都要重新说明步骤、输入和验收条件，可以把这套做法整理成 Skill。Codex 会先读取 Skill 的名称和描述，任务匹配后再加载完整说明，需要时继续读取参考资料或运行脚本。
- [Codex 处理 GitHub Issue 并创建 Pull Request](https://codexguide.io/guides/codex-github-issue-to-pr): 这篇教程写给已经使用 GitHub Issue 和 Pull Request 管理开发任务的读者。你需要先把目标仓库连接到 Codex cloud，并且拥有查看代码、创建分支和提交 Pull Request 所需的权限。
- [Codex 如何读懂 Git，status、diff、log 与 blame](https://codexguide.io/guides/codex-git-status-diff-log-blame): 代码审查的第一步是先把比较范围说清楚。不要直接让 Codex 总结“这个提交做了什么”，因为当前工作区、暂存区、某个提交和远程分支可能是四个不同的现场。
- [Codex Goal 模式：运行长任务](https://codexguide.io/guides/codex-goal-mode-long-running-work): 如果你已经会让 Codex 修改代码，但任务一长就容易失去方向，可以学习 Goal 模式。它适合有明确交付物、能够持续验证的迁移、重构、排错和发布前检查。
- [Codex 使用 Subagents 并行处理任务](https://codexguide.io/guides/codex-subagents-parallel-work): 如果一个任务可以拆成几块互不修改同一文件的工作，可以让 Codex 把其中一部分交给 Subagents。它适合代码库探索、测试检查、日志分析和安全审查，也适合需要多个独立结论的调研。
- [Codex 使用 Computer Use 操作桌面应用](https://codexguide.io/guides/codex-computer-use-desktop-apps): 当任务只能通过桌面应用完成，或者命令行和结构化插件拿不到所需信息时，可以考虑 Computer Use。它能看屏幕、点击窗口、输入文字并在多个应用之间完成一段流程。
- [Codex 连接 Sentry 排查线上错误](https://codexguide.io/guides/codex-sentry-error-triage): 如果线上错误已经进入 Sentry，而你还要在日志、Issue、代码和测试之间来回切换，可以把 Sentry 接入 Codex，让它读取错误上下文，再回到代码仓库分析原因。
- [Codex Record & Replay：生成可复用 Skill](https://codexguide.io/guides/codex-record-replay-skill): 如果你有一套重复做、步骤稳定、但很难完整写成说明的桌面流程，可以用 Record & Replay 让 Codex 观察一次操作，再生成一个可复用的 Skill。
- [Codex 模型与推理强度怎么选](https://codexguide.io/guides/codex-model-reasoning-effort): 打开 Codex 的模型菜单，先分清模型、推理强度和速度三个设置。模型决定能力与基础消耗区间，推理强度决定当前任务投入的计算量，速度选项则用更多额度换更快返回。
- [Codex CLI 管理多条任务线：命名、切换与 fork](https://codexguide.io/guides/codex-cli-manage-multiple-sessions): 当你同时处理重构、排错和测试时，不必为每条任务线开一个终端窗口。Codex CLI 可以保存会话、给会话命名、在会话之间切换，并从已有会话 fork 出一条独立分支。
- [Codex CLI 长任务如何恢复：保存、继续与检查会话](https://codexguide.io/guides/codex-cli-resume-long-task): 长任务中断后，最重要的不是让 Codex“接着猜”，而是恢复原会话并重新确认目标、修改范围和验证状态。会话历史不能替代 Git、测试和人工检查。
- [Codex 创建自定义桌宠，从参考图到动画精灵图](https://codexguide.io/guides/codex-create-custom-pet): Codex 桌面应用支持 Pets。你可以先启用内置宠物，也可以通过设置页里的自定义入口安装 hatch-pet Skill，再用一张参考图制作自己的动画角色。
- [Codex Automations 定时执行任务，创建、检查与运行条件](https://codexguide.io/guides/codex-automations-scheduled-tasks): Automations 可以让 Codex 桌面应用按计划重复运行任务。它适合检查最近提交、汇总 Git 活动、整理 CI 失败和生成周期性报告。每次运行仍然需要明确的数据来源和完成标准。
- [Codex 处理文档、表格、幻灯片和 PDF 的完整工作流](https://codexguide.io/guides/codex-document-delivery-workflow): Codex 的文档类工具可以把同一批材料整理成文档、电子表格、幻灯片和 PDF。稳定的做法是先确定事实与数据，再依次生成各类交付物，最后检查内容是否一致。
- [在 Zed 中通过 ACP 使用 Codex CLI](https://codexguide.io/guides/codex-zed-acp-integration): Zed 可以通过 Agent Client Protocol 运行 Codex CLI。这样可以保留 Codex 的认证、模型和工具配置，同时使用编辑器里的文件树、差异预览和审批界面。
- [Codex 使用 Archify 生成可验证的代码架构图](https://codexguide.io/guides/codex-archify-architecture-diagrams): Archify 是第三方 Agent Skill。Codex 可以先读取代码仓库，整理系统边界和主调用路径，再让 Archify 把这些信息渲染成技术图。
- [Codex 使用 Text-to-Lottie 制作界面动效](https://codexguide.io/guides/codex-text-to-lottie-animation): Text-to-Lottie 是第三方 Skill。它让 Codex 根据文字要求创建或修改 Lottie 动画，并用预览项目检查运动、循环和透明背景。
- [Codex 连接 ChatCut 完成视频粗剪、字幕与导出](https://codexguide.io/guides/codex-chatcut-video-editing): ChatCut 是第三方视频编辑服务。通过它提供的插件和 MCP 工具，Codex 可以分析素材、修改时间线、生成字幕并导出视频。账号、素材和编辑操作仍在 ChatCut 的权限范围内。
- [Codex 移动端远程协作](https://codexguide.io/guides/codex-mobile-remote-collaboration): 早高峰的地铁上，你掏出手机，点开 ChatGPT。
- [Codex 桌面端任务工作流](https://codexguide.io/guides/codex-desktop-task-workflow): Sam Altman 昨天在 X 上宣布 Codex 桌面版正式上线 Mac 平台。也是立马试用了一下，可视化界面操作起来确实方便，多个线程可以独立工作互不影响，Skill 管理也比较直观，还新增了定时任务功能。
- [Codex 接入 ACP：连接兼容开发工具](https://codexguide.io/guides/codex-acp-integration): 现在 AI 编程工具越来越多，但有一个问题一直没解决：它们之间不互通。
- [Codex CLI 安装、登录与多入口排查](https://codexguide.io/guides/codex-cli-multi-entry-setup): 现在三大主流的编程工具分别是 Codex、Claude Code 以及 Gemini。Claude Code 的综合能力很强，也是我的主力编程工具，但它封号太严重了，对国内极其不友好，使用门槛比较高，要找到靠谱的渠道。
- [Codex 使用 Remotion 和 HyperFrames 制作视频](https://codexguide.io/guides/codex-remotion-hyperframes-video): Remotion 和 HyperFrames 都能把视频写成代码，Codex 可以读取脚本与素材，生成项目文件，启动预览并根据检查结果修改。它们是第三方工具，工作方式和适用场景不同。视频仍要经过人工审片，工具也不会自动解决素材版权、节奏和事实准确性。
- [Codex 内容生产工作流](https://codexguide.io/guides/codex-content-production-workflow): Codex 可以把内容生产拆成一组可检查的任务。调研留下来源，写作读取事实表，配图说明用途，发布后的数据再回到下一轮选题。这样做适合需要持续更新教程、博客或社交内容的人，也适合多人协作的内容团队。
- [给 Codex 写一个专属 Skill：从重复提示词到可复用工作流](https://codexguide.io/guides/codex-zhuan-shu-skill): 用 Codex 久了，发现自己攒了一堆万能咒语。
- [GitHub Issue 到 Pull Request：让 Codex 跑完整协作流程](https://codexguide.io/guides/codex-github-issue-pr-workflow): 之前，我拿一个积压了很久的小 Issue 做了个实验，不打开编辑器，全程只在 GitHub 的 Issue 和 PR 评论区里 @codex 给它派活，看它能把这条 Issue 推进到什么程度。
- [Codex 任务总跑偏？先检查这 5 个设置](https://codexguide.io/guides/codex-settings-checklist): 忙了一圈，使用体验还是别扭。
- [Codex 插件安全检查：用 HOL Guard 评估第三方工具风险](https://codexguide.io/guides/codex-plugin-security-hol-guard): 现在装一个 AI 编程插件有多容易？一行命令的事。
- [Codex 自动化与定时任务：从手动流程到 CI 执行](https://codexguide.io/guides/codex-automation-ci-scheduled-tasks): 用 Codex 的人，绝大多数都是这么用的：打开终端，输 codex ，进到那个交互界面，然后跟它一来一回地聊，你说要求，它改代码，看一眼再说下一句。
- [Codex 协助出海 SEO：第一次购买客座文章的核验流程](https://codexguide.io/guides/codex-chu-hai-seo-shi-zhan): 继续给网站做 SEO 外链实验。
- [Codex 沙箱与主机权限：一次权限边界风险复盘](https://codexguide.io/guides/codex-sha-xiang-yu-zhu-ji-quan-feng-xian): 用 Codex、Cursor、Gemini CLI 这些 AI 编程工具的人，心里多少都揣着一个默认的安心，反正它有沙箱。
- [Codex 接入飞书：从群聊指令到本地任务执行](https://codexguide.io/guides/codex-feishu-ji-cheng-shi-zhan): 用 Codex 有个一直没解决的别扭，它跑在我电脑的终端里，可我人不总在电脑前。
- [Codex 与其他编程模型比较：模型选择与实际工作流](https://codexguide.io/guides/codex-yu-qita-biancheng-moxing-bijiao): 两大模型同一天发布新版本，这是要直接PK的意思啊，AI圈又热闹起来了。
- [Codex 常用功能清单：把容易漏掉的能力补齐](https://codexguide.io/guides/codex-changyong-gongneng-qingdan): 很多人第一次用 Codex，会把所有事情都扔进同一个任务。
- [Codex 插件入口：安装、调用与权限边界](https://codexguide.io/guides/codex-chajian-rukou-yu-gongzuoliu): 这两天 OpenAI 发了三个教育插件，K–12 老师、大学老师、大学生各一个。