Codex 应用是一个专注于并行处理 Codex 线程的桌面体验环境，具有内置的工作树（worktree）支持、自动化任务和 Git 功能。
大多数 Codex 应用功能在 macOS 和 Windows 上均可用。以下部分标注了特定平台的例外情况。
跨项目多任务处理
使用一个 Codex 应用窗口即可跨项目运行任务。为每个代码库添加一个项目，并根据需要随时切换。
如果你使用过 Codex CLI，那么项目就像是在特定目录中启动会话一样。
如果你在单个代码仓库中处理两个或更多应用或包，请将不同的项目拆分为独立的 Codex 应用项目，以便沙盒仅包含该项目所需的文件。
技能支持
Codex 应用支持与 CLI 和 IDE 扩展相同的智能体技能 (Agent Skills)。你还可以通过点击侧边栏中的“技能”，查看并探索团队在不同项目中创建的新技能。
模式
每个线程都在选定的模式下运行。启动线程时，你可以选择：
- 本地 (Local)：直接在当前项目目录中工作。
- 工作树 (Worktree)：在 Git 工作树中隔离更改。了解更多。
- 云端 (Cloud)：在配置的云环境中远程运行。
本地和工作树线程都将在你的电脑上运行。
有关术语表和概念的完整内容，请浏览概念部分。
内置 Git 工具
Codex 应用在应用内直接提供了常见的 Git 功能。
差异 (Diff) 面板会显示本地项目或工作树检出中的 Git 差异。你还可以添加内联评论供 Codex 处理，并暂存或撤销特定的代码块或整个文件。
你还可以直接在 Codex 应用内为本地和工作树任务提交 (commit)、推送 (push) 和创建合并请求 (pull request)。
对于更高级的 Git 任务，请使用集成终端。
工作树支持
创建新线程时，请选择本地或工作树。本地直接在你的项目中工作。工作树会创建一个新的 Git 工作树，从而使更改与你的常规项目保持隔离。
当你想要尝试新想法而不触及当前工作，或者想要 Codex 在同一个项目中并排运行独立任务时，请使用工作树。
对于 Git 仓库，自动化任务将在专用的后台工作树中运行；对于非版本控制的项目，则直接在项目目录中运行。
集成终端
每个线程都包含一个针对当前项目或工作树的内置终端。使用应用右上角的终端图标或按下 Cmd+J 可切换显示。
使用终端来验证更改、运行脚本和执行 Git 操作，无需离开应用。Codex 还可以读取当前的终端输出，因此它可以在工作时查看正在运行的开发服务器状态，或参考之前失败的构建。
常见任务包括：
git statusgit pull --rebasepnpm test或npm testpnpm run lint或类似的项目命令
如果你有定期运行的任务，可以在本地环境中定义一个操作 (Action)，以便在 Codex 应用窗口顶部添加一个快捷按钮。
请注意，Cmd+K 会在 Codex 应用中打开命令面板，它不会清空终端。要清空终端，请使用 Ctrl+L。
原生 Windows 沙盒
在 Windows 上，Codex 可以使用原生的 Windows 沙盒在 PowerShell 中运行，无需 WSL 或虚拟机。这让你可以在保持 Windows 原生工作流的同时，实施受限的权限控制。
语音听写
使用语音向 Codex 发送提示。在编辑器 (composer) 可见时按住 Ctrl+M 并开始说话。你的语音将被转换为文字。编辑转换后的提示或点击发送，让 Codex 开始工作。
浮动弹出窗口
将活动的对话线程弹出到单独的窗口中，并将其移动到你实际工作的地方。这对于前端开发非常理想，你可以将线程放在浏览器、编辑器或设计预览旁边，以便快速迭代。
你还可以切换弹出窗口，使其在整个工作流中保持可见（置顶）。
应用内浏览器
在迭代 Web 应用时，使用应用内浏览器来预览、检查和评论本地开发服务器、基于文件的预览以及无需登录的公共页面。
应用内浏览器不支持身份验证流程、已登录页面、常规浏览器配置文件、Cookie、扩展程序或现有标签页。
使用浏览器评论来标记页面上的特定元素或区域，然后要求 Codex 解决该反馈。
当你希望 Codex 直接操作页面时，请为本地开发服务器和基于文件的页面使用浏览器使用 (browser use)。你可以在设置中管理浏览器插件、允许访问的网站和禁止访问的网站。
计算机使用
电脑使用 (Computer use) 通过查看、点击和键入操作帮助 Codex 运行 macOS 应用。这对于测试桌面应用、检查浏览器或模拟器流程、处理不可作为插件使用的数据源、更改应用设置以及重现纯 GUI 错误非常有用。
由于“电脑使用”功能可能会影响项目工作区之外的应用和系统状态，请确保任务范围明确，并在继续前审阅权限提示。
此功能在发布时不支持欧洲经济区、英国或瑞士。
处理非代码制品
当任务生成非代码制品时，侧边栏可以预览 PDF 文件、电子表格、文档和演示文稿。将源数据、预期的文件类型、结构和你在意的审查标准提供给 Codex。
对于电子表格和演示文稿，请描述你需要的工作表、列、图表、幻灯片分区和检查点。要求 Codex 说明它将输出保存到了哪里以及如何检查结果。
使用任务侧边栏来跟踪线程运行时的进度。它会显示智能体的计划、来源、生成的制品和任务摘要，以便你可以引导工作、检查生成的文件，并决定哪些部分需要重新审阅。
与 IDE 扩展同步
如果你在编辑器中安装了 Codex IDE 扩展，当 Codex 应用和 IDE 扩展处于同一项目中时，它们会自动同步。
同步后，你会在 Codex 应用编辑器中看到一个 IDE 上下文选项。开启“自动上下文”后，Codex 应用会跟踪你正在查看的文件，因此你可以间接引用它们（例如：“这个文件是关于什么的？”）。你还可以在 IDE 扩展中看到 Codex 应用中正在运行的线程，反之亦然。
如果你不确定应用是否包含了上下文，可以将其关闭并再次询问相同的问题以进行对比。
线程自动化
自动化任务也可以附加到单个线程。这些线程自动化是重复性的唤醒调用，用于保留线程的上下文，以便 Codex 可以检查长时间运行的工作、轮询新信息或继续后续循环。将它们用于需要按计划持续返回同一对话的“心跳式”自动化任务。
当下一次运行依赖于当前对话时，请使用线程自动化。当你希望 Codex 为一个或多个项目启动全新的重复性任务时，请使用独立的或项目自动化。
批准和沙盒
你的批准和沙盒设置会限制 Codex 的操作。
- 批准决定了 Codex 在运行命令前何时暂停以请求权限。
- 沙盒控制了 Codex 可以使用的目录和网络访问权限。
当你看到“批准一次”或“为本次会话批准”等提示时，你是在授予工具执行的不同权限范围。如果不确定，请批准最窄的选项并继续迭代。
默认情况下，Codex 将工作范围限定在当前项目。在大多数情况下，这是合理的约束。
如果你的任务需要跨越多个代码库或目录，建议打开单独的项目或使用工作树，而不是要求 Codex 在项目根目录之外漫游。
如果你的工作区支持自动审核，你可以从权限选择器中进行选择。它将保持相同的沙盒边界，但会通过已配置的审核策略处理符合条件的批准请求，而不是等待你手动确认。
如需宏观概述，请参阅沙盒说明。有关配置详情，请参阅智能体批准和安全文档。
MCP 支持
Codex 应用、CLI 和 IDE 扩展共享模型上下文协议 (MCP) 设置。如果你已经在其中一个中配置了 MCP 服务器，它们会自动被其他组件采用。要配置新服务器，请打开应用设置中的 MCP 部分，启用推荐服务器或添加新服务器到你的配置中。
网络搜索
Codex 附带一个第一方网页搜索工具。对于 Codex 应用中的本地任务，Codex 默认启用网页搜索并提供来自搜索缓存的结果。如果你将沙盒配置为完全访问权限，网页搜索将默认为实时结果。请参阅配置基础以禁用网页搜索或切换到获取最新数据的实时结果。
图像生成
让 Codex 直接在线程中生成或编辑图像。这对于你希望与代码一起创建的 UI 资源、横幅、背景、插图、精灵表 (sprite sheets) 和占位符非常有用。如果你希望 Codex 转换或扩展现有资源，请添加参考图像。
您可以用自然语言提问，也可以通过在提示词中包含 $imagegen 来显式调用图像生成技能。
内置图像生成功能使用 gpt-image-2，会计入您的通用 Codex 使用限制，且根据图像质量和大小，其消耗速度平均比没有图像生成的同类任务快 3-5 倍。有关详情，请参阅定价。有关提示技巧和模型详细信息，请参阅图像生成指南。
如需批量生成更多图像，请在环境变量中设置 OPENAI_API_KEY，并要求 Codex 通过 API 生成图像，这样将适用 API 定价。
图像输入
你可以将图像拖放到提示编辑器中，将其作为上下文包含在内。在拖放图像时按住 Shift 键，可将图像添加到上下文中。
你还可以要求 Codex 查看你系统上的图像。通过为 Codex 提供截取你正在处理的应用的工具，它可以验证其正在进行的工作。
聊天 (Chats)
聊天是当你不需要特定项目文件夹或 Git 仓库时可以启动的线程。将它们用于研究、分类、计划、插件密集型工作流以及其他 Codex 应该使用已连接工具而非编辑代码库的对话。
聊天使用位于你 Codex 主目录下的 threads 目录作为工作位置。默认情况下，该位置为 ~/.codex/threads。
记忆
记忆 (Memories)（若可用）允许 Codex 将过去任务中的有用上下文带入未来的线程。它们对于稳定的偏好设置、项目规范、重复的工作模式以及已知的易错点非常有用，否则这些内容需要反复强调。
通知
默认情况下，当任务完成或应用处于后台时需要批准，Codex 应用会发送通知。
在 Codex 应用设置中，你可以选择从不发送通知或始终发送通知（即使应用处于焦点状态）。
保持电脑唤醒
由于你的任务可能需要较长时间才能完成，你可以通过启用应用设置中的“运行时防止睡眠”开关，让 Codex 应用阻止电脑进入睡眠状态。