本文由 莫潇羽@无忆研习社 原创撰写，转载请注明出处：www.wuyi.wiki
2026 年 2 月 2 日，OpenAI 正式发布了 Codex App 桌面应用程序。这款专为 macOS 打造的编程助手应用，被官方定位为"智能编程代理的指挥中心"。与传统的 IDE 插件或终端工具不同，Codex App 提供了一个全新的工作范式——让开发者能够同时调度多个 AI 代理并行工作，每个代理在独立的环境中运行，互不干扰。
作为一名长期关注 AI 编程工具的技术爱好者，莫潇羽（无忆研习社站长）在第一时间体验了这款应用，并整理了这份详尽的使用指南。无论你是刚入门的编程新手，还是经验丰富的资深开发者，相信这篇文章都能帮助你快速上手 Codex App，并充分发挥它的强大潜力。
一、Codex App 是什么？为什么值得关注？
1.1 产品定位与核心理念
Codex App 并非一个简单的代码补全工具，而是 OpenAI 构建的一套完整的"智能编程代理系统"。它的设计理念可以用一句话概括：让 AI 代理像团队成员一样为你工作。
传统的 AI 编程助手（如 GitHub Copilot）主要在代码编辑器内提供实时建议，开发者仍然需要亲自编写和修改代码。而 Codex App 则更进一步——它可以接受自然语言指令，然后独立完成从设计、编码到测试的完整工作流程。
举一个具体的例子：OpenAI 官方展示了一个案例，他们仅用一条初始提示词，就让 Codex 独立完成了一款 3D 赛车游戏的开发。这款游戏包含 8 张地图、多个赛车角色、道具系统等完整功能，整个过程消耗了超过 700 万个 token，而开发者只需要在最后审查结果即可。
1.2 与现有工具的差异化定位
目前市面上的 AI 编程工具可以大致分为几类：
- 代码补全类：如 GitHub Copilot、Tabnine 等，主要提供行级或块级的代码建议
- 对话式编程助手：如 ChatGPT、Claude 等，可以回答编程问题并生成代码片段
- IDE 集成代理：如 Cursor、Windsurf 等，将 AI 能力深度集成到代码编辑器中
- 终端代理工具：如 Codex CLI、Claude Code 等，在命令行环境中运行的编程代理
Codex App 的定位则有所不同。它不是要取代你的 IDE，而是在 IDE 之上提供一个"指挥层"，让你可以同时管理多个长时间运行的编程任务。你可以把它想象成一个项目经理的仪表盘——你下达任务，AI 代理去执行，完成后向你汇报，你负责审核和决策。
无忆研习社（www.wuyi.wiki） 的站长 莫潇羽 认为，这种工作模式特别适合以下场景：
- 需要同时推进多个功能分支的开发
- 有大量重复性的代码重构或迁移任务
- 需要定期执行的自动化检查和报告生成
- 希望在不打断当前工作的情况下探索不同的技术方案
二、Codex App 的技术架构与工作原理
2.1 底层模型：GPT-5.2-Codex
Codex App 的核心驱动力是 GPT-5.2-Codex 模型。这是 OpenAI 在 2025 年 12 月发布的专门针对编程任务优化的大语言模型，相比前代产品有几项关键改进：
上下文压缩技术（Context Compaction）
传统的大语言模型在处理长对话时，随着上下文的累积，会消耗越来越多的 token，而且容易"遗忘"早期的信息。GPT-5.2-Codex 引入了上下文压缩技术，能够在会话进行过程中自动将旧的上下文信息压缩成摘要，在保留关键语义的同时大幅减少 token 消耗。
这项技术使得 Codex 能够处理跨越数小时甚至数天的长时间编程任务，而不会"忘记"项目的整体目标和之前的工作进展。
多步骤推理能力
GPT-5.2-Codex 采用了一种被称为"智能体执行循环"（Agentic Execution Loop）的工作机制。具体来说，它会按照以下四个阶段循环工作：
- 生成候选代码
- 在沙箱环境中执行
- 根据测试结果评估
- 迭代优化直到满足要求
这种工作方式让模型能够自主发现并修复错误，而不需要人工干预每一个步骤。
跨文件项目理解
早期的代码生成模型通常只能处理单个文件或几百行代码。GPT-5.2-Codex 则可以理解和操作整个项目，包括多文件依赖关系。这使得它能够执行复杂的重构操作，比如在不破坏现有功能的前提下，对整个认证系统进行架构调整。
2.2 Worktree 工作树机制
Codex App 的一个核心创新是内置的 Git Worktree 支持。对于不熟悉这个概念的读者，莫潇羽@无忆研习社 来做一个简单的解释：
Git Worktree 是 Git 的一项高级功能，它允许你在同一个仓库中同时检出多个工作目录。每个工作目录可以处于不同的分支上，彼此独立操作，但共享同一份 Git 元数据。
在 Codex App 中，当你启动一个新的编程任务时，应用会自动为这个任务创建一个独立的 worktree。这意味着：
- AI 代理的所有修改都被隔离在这个 worktree 中，不会影响你的主工作目录
- 你可以同时启动多个任务，每个任务在自己的 worktree 中独立进行
- 任务完成后，你可以选择将更改同步回主分支，或者丢弃这个实验性的分支
这种设计解决了一个长期困扰开发者的问题：如何在让 AI 自主工作的同时，保护好自己的代码不被意外破坏？
2.3 沙箱安全机制
安全性是 Codex App 设计中的重中之重。毕竟，让一个 AI 代理在你的电脑上自动执行代码，如果没有适当的防护措施，后果可能是灾难性的。
Codex App 采用了系统级的沙箱隔离技术，具体包括以下几层防护：
文件系统限制
默认情况下，AI 代理只能读写当前项目目录内的文件。任何试图访问项目目录之外文件的操作都会被拦截，需要用户明确授权才能继续。
网络访问控制
代理的网络访问默认受到限制，只能使用缓存的网页搜索结果。如果任务需要实时访问互联网（比如安装依赖包），代理会暂停并请求用户批准。
命令执行审批
对于可能产生系统影响的命令（如修改系统配置、安装全局软件包等），Codex 会在执行前弹出确认对话框，让用户决定是否允许。
可配置的权限级别
用户可以根据自己的信任程度，在以下几种模式之间选择：
- 只读模式：代理只能查看代码，不能进行任何修改
- 工作区写入模式：代理可以修改工作目录内的文件，但不能触及目录外的内容
- 完全访问模式：代理拥有更大的权限，适合有经验的用户在可控环境中使用
三、开源 Skills 系统详解
3.1 什么是 Skills？
Skills（技能）是 Codex 生态系统中最具创新性的概念之一。简单来说，Skill 是一个包含指令、资源和可选脚本的文件夹，它告诉 AI 代理如何完成某类特定任务。
你可以把 Skill 理解为 AI 代理的"工作手册"。就像一个新员工入职时需要阅读操作流程文档一样，AI 代理在执行任务之前，会先阅读相关 Skill 中的说明，了解应该使用什么工具、遵循什么规范、输出什么格式。
每个 Skill 的核心是一个名为 SKILL.md 的 Markdown 文件，其中包含：
- 名称和描述：帮助 Codex 判断何时应该使用这个 Skill
- 详细指令：告诉代理具体应该怎么做
- 参考资源：相关的文档、示例代码等
- 可选脚本：用于执行特定操作的自动化脚本
3.2 Skills 的两种调用方式
显式调用
在输入提示词时，你可以使用 $skill-name 的语法明确指定要使用的 Skill。例如：
$deploy-to-vercel 请把这个 Next.js 项目部署到 Vercel这种方式适合你明确知道需要使用哪个 Skill 的情况。
隐式调用
如果你没有明确指定 Skill，Codex 会根据任务描述自动判断是否需要使用某个 Skill。它会读取所有可用 Skill 的名称和描述，然后选择最匹配的一个（或多个）来执行任务。
例如，当你说"请帮我把设计稿转换成代码"时，Codex 可能会自动调用 Figma 相关的 Skill，即使你没有明确提到这个 Skill 的名字。
3.3 官方开源的 38 个 Skills 详细分类
OpenAI 官方在 GitHub 上开源了一套 Skills 库，目前包含 38 个 Skill，涵盖了软件开发的多个环节。莫潇羽@无忆研习社 为大家整理了完整的分类说明：
3.3.1 系统基础类 Skills
skill-creator（创建 Skill 的 Skill）
这是一个"元技能"，用于帮助你创建新的 Skill。当你想要封装自己的工作流程时，可以调用这个 Skill，它会引导你一步步完成 Skill 的设计和编写。
使用示例：
$skill-creator 创建一个用于生成 API 文档的 Skillskill-installer（Skill 安装器）
用于从官方仓库或其他 GitHub 仓库下载和安装 Skills。这是管理 Skill 生态的核心工具。
使用示例：
$skill-installer 安装 linear skill 从 .experimental 文件夹3.3.2 云部署类 Skills
deploy-to-cloudflare（部署到 Cloudflare）
这个 Skill 封装了将 Web 应用部署到 Cloudflare Pages 或 Workers 的完整流程。它会处理构建配置、环境变量设置、域名绑定等一系列操作。
deploy-to-vercel（部署到 Vercel）
专门针对 Vercel 平台优化的部署 Skill。通过 Vercel CLI 实现自动化部署，支持预览环境和生产环境的区分。
deploy-to-netlify（部署到 Netlify）
与上述类似，针对 Netlify 平台的部署 Skill。
deploy-to-render（部署到 Render）
支持将应用部署到 Render 平台，适合需要后端服务托管的项目。
这些部署类 Skills 的共同特点是：它们不仅仅是简单地执行部署命令，而是会根据项目类型自动选择合适的配置，处理常见的部署问题，并在出错时提供修复建议。
3.3.3 设计工具集成类 Skills
figma-mcp-integration（Figma MCP 服务器集成）
这个 Skill 通过 Model Context Protocol（MCP）与 Figma 建立连接，使 Codex 能够直接访问 Figma 设计文件中的信息。
figma-to-code（Figma 设计转代码）
这是设计师和开发者协作中最有价值的 Skill 之一。它可以：
- 从 Figma 获取设计稿的结构信息、样式参数、资源文件
- 分析设计稿的组件层级和布局关系
- 生成与设计稿像素级一致的前端代码
对于前端开发者来说，这意味着可以大大缩短从设计到代码的转换时间，同时保证实现的准确性。
3.3.4 项目管理类 Skills
OpenAI 提供了 4 个与 Notion 集成的 Skills，这些 Skills 让 Codex 能够与团队的知识库和项目管理系统无缝协作：
notion-spec-to-plan（Notion 规格转实施计划）
将 Notion 中的产品规格文档转换为具体的开发实施计划。这对于需要将产品需求转化为技术任务的团队特别有用。
notion-capture（捕获对话内容到 Notion）
自动将 Codex 的对话内容、决策记录、代码片段等保存到 Notion，便于团队成员回顾和参考。
此外还有 Linear 集成相关的 Skills，支持：
- 问题分类和优先级排序
- 版本发布追踪
- 团队工作量管理
- 自动创建和更新任务卡片
3.3.5 AI 生成类 Skills
这类 Skills 利用 OpenAI 的其他 API 能力，扩展 Codex 的功能范围：
image-generation（图像生成与编辑）
调用 GPT Image 模型生成和编辑图片。典型应用场景包括：
- 为网站生成占位图或正式配图
- 创建 UI 原型中的图标和插画
- 为游戏项目生成素材资源
video-generation（视频生成）
生成短视频内容，可用于产品演示、教程制作等场景。
audio-transcription（音频转录）
将音频文件转换为文字。这对于需要处理会议记录、用户访谈等场景很有帮助。
需要特别说明的是（这点 莫潇羽@无忆研习社 认为很重要）：这些 AI 生成类 Skills 都依赖 OpenAI 的 API，使用时会消耗相应的 API 额度。你需要确保自己的账户有足够的 API 权限。
3.3.6 文档处理类 Skills
pdf-skill（PDF 读写）
支持读取 PDF 文件内容、创建新的 PDF 文档、在现有 PDF 上添加内容等操作。
spreadsheet-skill（电子表格处理）
处理 Excel 和 CSV 格式的电子表格，支持数据分析、格式转换、报表生成等功能。
docx-skill（Word 文档处理）
创建和编辑 Word 文档，适合需要生成规范化文档（如技术文档、报告等）的场景。
3.3.7 Web 游戏开发类 Skills
develop-web-game（Web 游戏开发工作流）
这是 OpenAI 在发布会上重点展示的 Skill。它封装了一套完整的 Web 游戏开发流程，包括：
- 使用 Three.js 等库进行 3D 渲染
- 游戏逻辑设计和实现
- 自动化测试（通过实际运行游戏来验证）
- 截图和录屏用于调试
官方案例中的赛车游戏就是使用这个 Skill 配合图像生成 Skill 完成的。
3.3.8 OpenAI API 开发类 Skills
openai-api-docs（OpenAI API 文档参考）
在使用 OpenAI API 进行开发时，这个 Skill 会自动获取最新的 API 文档作为参考，确保生成的代码符合当前的 API 规范。
3.3.9 安全相关类 Skills
OpenAI 特别强调了 Codex 在安全领域的应用，开源了 3 个安全相关的 Skills：
security-policy-check（安全策略检查）
检查代码是否符合组织的安全策略，识别潜在的安全风险。
screenshot-tool（截图工具）
这个 Skill 可以让 Codex 实时截取应用界面的截图，用于：
- 验证 UI 修改是否正确
- 对比修改前后的界面差异
- 生成视觉回归测试报告
3.3.10 实验性 Skills
官方还提供了 5 个实验性的 Skills，这些功能可能还不够稳定，但展示了 Codex 的发展方向：
create-plan（创建行动计划）
让 Codex 在开始编码之前，先研究问题并制定详细的实施计划。这对于复杂项目特别有用，可以避免"边想边做"导致的返工。
usage-report（扩展使用情况报告）
生成关于 Codex 使用情况的统计报告，帮助团队了解 AI 工具的使用效果。
其他实验性 Skills 涵盖了每日问题分类、悬而未决任务汇总、每日发布简报生成、Bug 检测等功能。这些都是 OpenAI 内部正在使用的工作流自动化实践。
四、Automations 自动化任务系统
4.1 Automations 的概念与价值
除了 Skills，Codex App 的另一个核心功能是 Automations（自动化）。如果说 Skills 定义了"如何做某件事"，那么 Automations 就定义了"什么时候自动做这件事"。
Automations 允许你设置定时任务，让 Codex 在后台按照预设的时间表自动执行。这对于那些重要但重复性高的工作特别有用。
OpenAI 透露，他们内部正在使用 Automations 处理以下工作：
- 每日问题分类：自动扫描新提交的 Issue，根据内容进行分类和优先级标注
- CI 失败汇总：当持续集成管道失败时，自动分析失败原因并生成摘要报告
- 每日发布简报：汇总过去 24 小时内的代码提交，生成可读性强的发布说明
- Bug 检测：定期扫描代码库，查找潜在的问题和改进机会
4.2 如何设置 Automation
设置一个 Automation 的基本流程如下：
第一步：明确任务描述
用自然语言描述你希望自动执行的任务。例如：
扫描所有今天新创建的 GitHub Issue，将它们按照"Bug"、"Feature Request"、"Question"进行分类，并添加相应的标签。第二步：选择关联的 Skills（可选）
如果你的任务需要用到特定的 Skill，可以在设置时明确指定。比如上面的例子可能需要 GitHub 集成相关的 Skill。
第三步：设置执行时间表
你可以设置任务的执行频率，比如：
- 每天固定时间执行
- 每小时执行一次
- 每周执行一次
- 自定义的 Cron 表达式
第四步：配置结果处理方式
Automation 执行完成后，结果会进入一个审查队列（Review Queue）。你可以选择：
- 所有结果都需要人工审查
- 只有失败或异常的结果需要审查
- 无需审查，直接归档
4.3 Automations 的技术实现
从技术角度来看，Automations 的工作机制如下：
基于 Worktree 的隔离执行
对于版本控制的项目，每个 Automation 运行时都会创建一个独立的 worktree。这确保了自动化任务不会干扰你正在进行的手动工作。
沙箱安全限制
Automations 使用与普通任务相同的沙箱设置。如果你的默认沙箱模式是只读的，Automation 同样只能进行只读操作。这是一项重要的安全保障。
结果通知机制
Codex App 会通过以下方式通知你 Automation 的执行结果：
- 桌面通知
- 应用内的收件箱提醒
- 左侧边栏的状态指示
莫潇羽@无忆研习社 在实际使用中发现，这个通知机制设计得非常贴心。即使你离开电脑一段时间，回来后也能快速了解哪些 Automation 需要你的关注。
五、实际操作指南：从安装到上手
5.1 安装与登录
系统要求
目前 Codex App 仅支持 macOS 系统。Windows 版本正在开发中，预计将在后续更新中发布。对于 Windows 用户，现阶段可以通过以下方式使用 Codex：
- 使用 Codex CLI（命令行工具），支持在 PowerShell 中运行
- 使用 WSL2（Windows Subsystem for Linux）环境
- 使用 VS Code 或其他支持的 IDE 的 Codex 扩展
下载与安装
访问 OpenAI 官网（openai.com/codex）或 GitHub Releases 页面下载最新版本的安装包。下载完成后，按照 macOS 标准流程安装即可。
登录账户
启动应用后，你需要使用 ChatGPT 账户登录。支持以下订阅类型：
- ChatGPT Plus
- ChatGPT Pro
- ChatGPT Business
- ChatGPT Enterprise
- ChatGPT Edu
值得注意的是，为了庆祝 Codex App 的发布，OpenAI 宣布限时向免费用户和 Go 订阅用户开放使用权限，同时所有付费用户的速率限制提高一倍，这个优惠将持续两个月。
同步已有配置
如果你之前使用过 Codex CLI 或 IDE 扩展，应用会自动同步你的会话历史和配置信息，无需手动迁移。
5.2 界面概览
打开 Codex App 后，你会看到一个简洁而功能丰富的界面：
左侧边栏
- 项目列表：显示所有已添加的项目
- Skills 入口：查看和管理可用的 Skills
- Automations 入口：设置和查看自动化任务
- 收件箱：接收来自 Automations 的结果通知
中央区域
- 对话窗口：与 Codex 进行交互的主要区域
- 代码差异视图：查看 Codex 所做的修改
- 终端面板：每个线程自带的集成终端
右侧区域
- 快速操作按钮：进入不同的编辑器
- 移动端预览：实时预览应用在移动设备上的显示效果（针对 Web 项目）
5.3 基本工作流程
添加项目
点击左侧边栏的"+"按钮，选择一个本地的代码仓库添加为项目。Codex 会扫描项目结构，并自动检测项目类型。
开始新对话
选择一个项目后，在输入框中输入你的需求。例如：
请分析这个项目的结构，并生成一份技术文档查看执行过程
Codex 开始工作后，你可以实时查看它的执行过程，包括：
- 正在读取哪些文件
- 正在执行哪些命令
- 当前的思考过程
审查与应用更改
任务完成后，Codex 会展示它所做的所有修改。你可以：
- 逐个文件查看差异
- 在内置终端中运行测试验证
- 选择接受全部修改、部分修改或拒绝修改
- 直接创建 GitHub Pull Request
5.4 高级功能使用
Plan 模式
当你面对一个复杂的任务，不确定应该如何拆解时，可以启用 Plan 模式。输入 /plan 命令后，Codex 会在动手写代码之前，先与你讨论实施方案。
这个模式类似于与一位资深工程师进行技术评审。Codex 会提出问题、分析风险、提供建议，帮助你做出更明智的决策。
Personality 设置
Codex 支持两种交互风格：
- 简洁务实型（Terse Pragmatic）：回复简短直接，专注于执行
- 对话共情型（Conversational Empathetic）：回复更详细，有更多解释和建议
使用 /personality 命令可以在两种风格之间切换。这个设置会在 App、CLI 和 IDE 扩展之间同步。
MCP 集成
Codex 支持 Model Context Protocol（MCP），可以连接到各种外部服务。如果你在其他界面（如 CLI）中已经配置了 MCP 服务器，这些配置会自动同步到 App 中。
六、实战案例：从零开始的游戏开发
为了让大家更直观地理解 Codex App 的能力，莫潇羽@无忆研习社 来分享一个完整的实战案例——使用 Codex 开发一个小游戏。
6.1 项目启动
首先，创建一个新的空项目文件夹，并在 Codex App 中添加为项目。
6.2 了解 Skill 能力
在开始之前，先询问 Codex 相关 Skill 的能力范围：
这个游戏开发 Skill 可以帮我做什么？Codex 回复说，它可以：
- 搭建可靠的迭代循环
- 自动试玩游戏进行测试
- 自动截屏进行视觉回归对比
- 抓取控制台的错误和警告信息
- 将画面转换成文字描述用于检查
6.3 创意构思
接下来，让 Codex 发挥创意：
请帮我做一个有创意的小游戏，主题和玩法都由你来设计Codex 开始工作，使用 GPT-5.2 medium 思考模式进行设计。
6.4 迭代修复
第一版游戏生成后，发现一个小问题——刚进入页面就显示"时间已用完"。这是一个典型的初始化顺序问题。
游戏有个 bug，刚进入就显示时间已用完，请修复Codex 很快定位并修复了这个问题。
6.5 最终成果
修复后的游戏是一个时间主题的益智游戏：
- 游戏场景是一个钟表，指针在钟面上绕圈移动
- 玩家通过上下左右方向键控制一个"时间帧"
- 目标是收集时间碎片来得分
- 需要躲避"背离碎片"（障碍物）
- 按空格键可以倒带回到几秒前的状态
整个开发过程从零到可玩版本，只需要几轮对话交互。
6.6 生成文档
游戏完成后，可以让 Codex 生成应用文档：
请总结一下这个应用程序，生成一份 PDF 文档Codex 生成的 PDF 包含：
- 游戏概述和玩法说明
- 技术实现要点
- 修复的问题列表
- 后续改进建议
6.7 制作宣传视频
最后，还可以让 Codex 生成宣传动画：
$motion-best-practice 请为这个游戏生成一个精美的宣传动画，至少 10 秒Codex 使用 motion 相关的 Skill，生成了一个展示游戏画面的宣传视频，视频末尾还贴心地放上了"立即开始游戏"的引导和之前生成的 PDF 文档链接。
七、Skills 的创建与共享
7.1 为什么要创建自定义 Skills
虽然官方提供了丰富的 Skills 库，但每个团队都有自己独特的工作流程和规范。创建自定义 Skills 可以：
- 将团队的最佳实践固化下来
- 确保所有成员都遵循相同的标准
- 减少重复解释同样的规范
- 让新成员更快上手
7.2 Skill 的文件结构
一个标准的 Skill 文件夹包含以下内容：
my-skill/
├── SKILL.md # 核心文件，包含名称、描述和指令
├── SKILL.toml # 可选，定义元数据（图标、颜色等）
├── resources/ # 可选，参考文档和示例
└── scripts/ # 可选，自动化脚本7.3 SKILL.md 的编写要点
一个有效的 SKILL.md 应该包含以下部分：
---
name: my-custom-skill
description: 简短描述，帮助 Codex 判断何时使用这个 Skill
metadata:
short-description: 面向用户的简短说明
---
# 详细指令
这里编写 Codex 在执行任务时应该遵循的具体指令...
## 使用场景
说明这个 Skill 适用于哪些情况...
## 工作流程
描述执行步骤...
## 注意事项
列出需要特别注意的点...7.4 Skill 设计的最佳实践
莫潇羽@无忆研习社 根据官方文档和实践经验，总结了以下 Skill 设计原则：
保持聚焦
每个 Skill 应该专注于解决一类特定的问题，而不是试图涵盖太多功能。如果一个 Skill 变得过于复杂，考虑拆分成多个小的 Skills。
描述要精准
Skill 的描述决定了 Codex 是否会自动选择它。如果两个 Skills 的描述有重叠，可能会导致选择错误。确保每个 Skill 的适用场景描述清晰、独特。
指令要具体
Codex 已经是一个很聪明的模型，但它不了解你团队的特定规范。在指令中，只需要写那些 Codex 不知道但需要知道的信息。
提供示例
在 resources 文件夹中放入示例代码或模板文件，可以帮助 Codex 更准确地理解你期望的输出格式。
控制上下文消耗
记住，Skill 的内容会被加载到上下文中，占用宝贵的 token 空间。避免在 Skill 中放入过多冗余信息。
7.5 团队共享 Skills
创建好的 Skill 可以通过以下方式共享给团队：
检入代码仓库
将 Skill 文件夹放在项目的 .codex/skills/ 目录下，提交到版本控制系统。这样，所有团队成员克隆项目后都能自动获得这些 Skills。
用户级共享
将 Skill 放在用户目录的 ~/.codex/skills/ 下，可以在本机的所有项目中使用。
组织级别配置
对于大型团队，可以通过管理员配置在 /etc/codex/skills/（macOS/Linux）或组策略（Windows）中统一分发 Skills。
八、与其他 Codex 界面的协作
8.1 Codex 生态系统概览
Codex 不仅仅是一个 App，而是一套完整的生态系统，包括：
- Codex App：本文重点介绍的桌面应用
- Codex CLI：在终端中运行的命令行工具
- Codex IDE Extension：VS Code、Cursor 等编辑器的扩展
- Codex Web：在 chatgpt.com/codex 访问的 Web 界面
- Codex Cloud：云端托管的开发环境
8.2 多界面协作
这些不同的界面共享相同的后端，这意味着：
配置同步
在一个界面中修改的设置（如 MCP 配置、Personality 偏好），会自动同步到其他界面。
会话历史共享
你可以在 CLI 中开始一个任务，然后在 App 中继续跟进，所有的对话历史都会保留。
Skills 通用
创建的 Skill 在所有界面中都可以使用。在 App 中创建的 Skill，可以在 CLI 中调用，反之亦然。
8.3 选择合适的界面
不同的界面适合不同的场景：
Codex App 适合：
- 需要同时管理多个任务
- 长时间运行的复杂项目
- 需要可视化地审查代码差异
- 设置和管理 Automations
Codex CLI 适合：
- 快速的命令行操作
- 与 shell 脚本集成
- 远程服务器上的开发
- 喜欢键盘操作的用户
Codex IDE Extension 适合：
- 在编码过程中需要即时帮助
- 希望在不离开编辑器的情况下获得 AI 支持
- 需要实时查看 AI 对当前文件的建议
8.4 IDE 同步功能
如果你同时打开了 Codex App 和 IDE Extension，并且它们指向同一个项目，应用会自动同步。这带来几个便利：
- 在 App 中可以看到 IDE 中正在查看的文件
- 在 App 中启动的任务状态会实时反映在 IDE 中
- 可以使用"Auto Context"功能，让 App 自动跟踪你在 IDE 中的操作
九、常见问题与解决方案
9.1 性能相关问题
问：任务执行得很慢怎么办？
可以尝试以下方法：
- 检查网络连接是否稳定
- 尝试调低推理努力级别（从 high 改为 medium）
- 将大任务拆分成小任务
- 确保项目目录中没有过多的无关文件（使用 .gitignore 排除）
问：Worktree 占用太多磁盘空间怎么办？
Codex App 会自动清理不再使用的 worktrees，但你也可以手动管理：
- 归档不再需要的线程
- 不要随意"固定"worktrees（固定的 worktree 不会被自动清理）
9.2 权限相关问题
问：为什么 Codex 说没有权限执行某个操作？
检查你的沙箱设置。如果设置为只读模式或工作区写入模式，某些操作会被限制。可以：
- 临时批准单个操作
- 修改沙箱设置
- 使用 rules 配置特定命令的例外
问：如何允许 Codex 访问网络？
默认情况下网络访问是受限的。你可以：
- 在弹出的批准对话框中选择"允许"
- 在设置中将沙箱模式改为"完全访问"（需谨慎）
9.3 Skills 相关问题
问：为什么我安装的 Skill 没有生效？
安装新 Skill 后需要重启 Codex 才能生效。另外，检查 Skill 的 SKILL.md 是否有语法错误。
问：如何查看当前可用的所有 Skills？
在 App 中点击左侧边栏的"Skills"可以查看。在 CLI 中使用 /skills 命令。
9.4 Automations 相关问题
问：Automation 运行失败了怎么办？
失败的 Automation 结果会保留在审查队列中。你可以：
- 查看详细的错误信息
- 检查并调整任务描述
- 修改相关的 Skill
- 重新调度执行
问：Automation 可以修改我的代码吗？
这取决于你的沙箱设置。在只读模式下，Automation 只能生成报告，不能实际修改文件。
十、深入理解 Codex 的工作机制
10.1 任务执行的完整生命周期
理解 Codex 如何处理你的请求，有助于更好地与它协作。当你输入一条指令后，Codex 会经历以下几个阶段：
意图解析阶段
首先，Codex 会分析你的输入，理解你想要完成什么任务。这个阶段会考虑对话历史、当前项目上下文、以及可用的 Skills。如果存在歧义，Codex 可能会主动提问来澄清。
计划制定阶段
在开始动手之前，Codex 会在内部制定一个执行计划。对于复杂任务，你可以使用 Plan 模式让 Codex 先展示这个计划，经过你确认后再执行。这个阶段会考虑任务的依赖关系、执行顺序、可能的风险等因素。
代码生成与执行阶段
按照计划，Codex 开始生成代码并执行。这个过程是迭代的——生成一部分代码后，Codex 会通过运行测试、检查输出等方式验证效果，如果发现问题会自动修正。你可以在界面上实时看到这个过程。
验证与报告阶段
任务完成后，Codex 会汇总所有的修改，生成一份变更报告。这份报告包括修改了哪些文件、每个文件的具体变更、执行过程中的关键决策等。你可以在这个阶段审查并决定是否接受这些修改。
10.2 上下文管理的艺术
Codex 的上下文窗口是有限的，如何高效利用这个宝贵的资源是一门学问。莫潇羽@无忆研习社 总结了以下几点经验：
Auto Context 的工作原理
当你启用 Auto Context 功能后，Codex 会自动跟踪你在 IDE 中查看的文件，将相关内容纳入上下文。这样，当你说"修改这个文件"时，Codex 知道你指的是哪个文件。但要注意，打开过多文件可能会稀释真正重要的上下文。
手动控制上下文
有时候，自动上下文可能不是最优的。你可以通过明确引用文件路径、粘贴关键代码片段、或使用 Skill 来精确控制 Codex 关注的内容。
上下文压缩的影响
在长时间运行的任务中，Codex 会自动压缩旧的上下文以节省空间。虽然这个过程会尽量保留关键信息，但不可避免地会损失一些细节。对于特别长的任务，建议适时做阶段性总结，确保重要信息不被遗忘。
10.3 多代理协作的底层逻辑
Codex App 支持多个代理并行工作，这背后的机
