Codex App 是一个高度聚焦的桌面体验，适合并行处理多个 Codex 线程，并内置了工作树支持、自动化和 Git 功能。
跨项目多任务处理
你可以在一个 Codex App 窗口中跨多个项目运行任务。为每个代码库添加一个项目，并在需要时随时切换。
如果你用过 Codex CLI，这里的“项目”大致相当于“在某个特定目录里启动一次会话”。
如果你在一个仓库里同时维护两个或更多应用或包，建议把它们拆成多个独立项目，这样沙箱只会覆盖该项目相关文件。
技能支持
Codex App 支持与 CLI 和 IDE 扩展相同的智能体技能。你还可以通过点击侧边栏中的 Skills（技能），查看并探索团队在不同项目中创建的新技能。
自动化
你还可以把技能和自动化结合起来，处理那些例行任务，例如评估遥测中的错误并提交修复，或为最近的代码库改动生成报告。
运行模式
每个线程都会运行在某个选定模式中。创建线程时，你可以选择：
- Local（本地模式）：直接在你当前项目目录中工作。
- Worktree（工作树）：在 Git worktree（工作树）中隔离改动。参见了解更多。
- Cloud（云端模式）：在已配置好的云端环境中远程运行。
其中 Local（本地） 和 Worktree（工作树） 线程都会在你的电脑上运行。
完整术语和概念可参见概念章节。
内置 Git 工具
Codex App 直接在应用内提供了常见的 Git 功能。
差异面板会展示你在本地项目或工作树检出中的 Git 差异。你还可以给 Codex 添加行内评论，并对特定块或整份文件做暂存或还原。
对于 Local（本地）和 Worktree（工作树）任务，你也可以直接在 Codex App 中提交、推送并创建拉取请求。
对于更高级的 Git 操作，请使用集成终端。
工作树支持
创建新线程时，可以选择 Local（本地） 或 Worktree（工作树）。Local（本地） 会直接在当前项目中工作；Worktree（工作树） 则会创建一个新的 Git worktree（工作树），让改动与日常项目状态隔离。
当你想在不碰当前工作的前提下尝试新思路，或者希望 Codex 在同一个项目中并行运行多个独立任务时，就使用 Worktree（工作树）。
对于 Git 仓库中的自动化，Codex 会在专用后台工作树中运行；对于不受版本控制的项目，则直接在项目目录中运行。
集成终端
每个线程都带有一个作用于当前项目或工作树的内置终端。你可以点击应用右上角的终端图标，或按 Cmd+J 来切换它。
使用终端可以在不离开应用的情况下验证改动、运行脚本和执行 Git 操作。Codex 也可以读取当前终端输出，因此它能在与你协作时检查正在运行的开发服务器状态，或引用失败构建的输出。
常见任务包括：
git statusgit pull --rebasepnpm test或npm testpnpm run lint或类似的项目命令
如果你会反复运行某个任务，可以在本地环境中定义一个 动作（action），把它作为快捷按钮放到 Codex App 窗口顶部。
注意，Cmd+K 会打开 Codex App 的命令面板，并不会清空终端。清空终端应使用 Ctrl+L。
原生 Windows 沙箱
在 Windows 上，Codex 可以直接在 PowerShell 中以原生 Windows 沙箱运行，而不必依赖 WSL 或虚拟机。这让你可以留在原生 Windows 工作流中，同时仍然保持受限权限边界。
语音输入
你可以直接用语音向 Codex 下指令。当输入框可见时，按住 Ctrl+M 并开始说话，你的语音会被转写。你可以先编辑转写后的提示词，或直接发送让 Codex 开始工作。
浮动弹出窗口
你可以把一个活动会话线程弹出成独立窗口，并移动到你当前工作的区域。这对于前端工作尤其理想，因为你可以把线程放在浏览器、编辑器或设计预览附近，快速迭代。
如果你希望它始终可见，还可以把弹出窗口切换为置顶。
与 IDE 扩展同步
如果你在编辑器中安装了Codex IDE 扩展，当应用和 IDE 指向同一个项目时，它们会自动同步。
同步后，你会在 Codex App 的输入框中看到 IDE context（IDE 上下文） 选项。开启 “Auto context（自动上下文）” 后，Codex App 会跟踪你正在查看的文件，因此你可以间接引用它们，例如“这个文件是做什么的？”。你也可以在 IDE 扩展中看到 Codex App 里正在运行的线程，反之亦然。
如果你不确定应用是否带上了这些上下文，可以先关闭它，再问一次相同问题，对比结果。
审批与沙箱
你的审批策略和沙箱设置，决定了 Codex 可以在多大范围内自行操作：
- 审批策略控制 Codex 在运行命令前何时需要停下来征求你的许可。
- 沙箱则规定它可以访问哪些目录，以及是否允许网络访问。
当你看到 “approve once（本次批准）” 或 “approve for this session（本次会话期间批准）” 这类提示时，实际上是在授予不同范围的工具执行权限。如果你不确定，应优先批准范围最小的那个选项，再继续迭代。
默认情况下，Codex 只在当前项目范围内工作。大多数情况下，这正是合适的约束。
如果任务确实需要跨多个仓库或目录工作，优先考虑打开多个项目，或使用工作树，而不是直接让 Codex 越过项目根目录随意游走。
高层说明参见沙箱机制，配置细节参见 智能体审批与安全文档。
MCP 支持
Codex App、CLI 和 IDE 扩展共用模型上下文协议（MCP）设置。如果你已经在其中一个入口配置过 MCP 服务端，其他入口会自动采用这些设置。若要新增服务端，请在应用设置中的 MCP 部分启用推荐服务端，或手动把新服务端加入配置。
Web 搜索
Codex 自带第一方 Web 搜索工具。对于 Codex App 中的本地任务，默认会启用 Web 搜索，并从 Web 搜索缓存提供结果。如果你把沙箱配置成完全访问，Web 搜索默认会切到实时结果。要关闭 Web 搜索，或切换到获取最新数据的实时结果，请参见基础配置。
图片输入
你可以把图片拖放进提示词输入框，把它们作为上下文。拖放图片时按住 Shift，可以把图片加入上下文。
你也可以让 Codex 查看系统中的图片。通过提供截图工具，让 Codex 能对你正在处理的应用截图，它就可以验证自己正在完成的工作。
通知
默认情况下，当应用在后台运行时，如果任务完成或需要审批，Codex App 会发送通知。
在应用设置中，你可以选择永不发送通知，或即便应用正处于焦点状态也始终发送通知。
保持电脑唤醒
由于任务可能需要一段时间才能完成，你可以在应用设置中启用 “Prevent sleep while running（运行期间阻止休眠）”，让 Codex App 在运行任务时阻止电脑休眠。