App 功能

Codex 桌面应用是一个专注于并行处理 Codex 线程的桌面体验，内置 worktree 支持、自动化任务和 Git 功能。

大多数 Codex 桌面应用功能在 macOS 和 Windows 上均可使用。以下部分会注明平台特定的例外情况。

多项目任务管理

使用一个 Codex 应用窗口跨项目运行任务。为每个代码库添加一个项目，并根据需要切换。

在 Codex 桌面应用中，你可以让 Codex 管理本地项目或 worktree 中的线程。例如，让它查找相关线程、继续现有线程，或固定/归档线程。要创建独立的后台线程，请明确说明：在这个项目的 worktree 中创建一个独立的后台线程来更新测试。

如果你使用过 Codex CLI，项目就像在特定目录中启动会话。如果你在单个仓库中有两个或多个应用或包，请将不同的项目拆分为独立的应用项目，这样沙箱只包含该项目的文件。

Skills 支持

Codex 桌面应用支持与 CLI 和 IDE 扩展相同的 Agent Skills。你还可以通过点击侧边栏中的 Skills 来查看和探索团队在不同项目中创建的新 Skill。

自动化任务

你可以将 Skills 与自动化任务结合，执行常规任务，例如评估遥测中的错误并提交修复，或生成关于最近代码库变更的报告。对于应在单个线程中持续进行的工作，请使用线程自动化。

模式

每个线程以选定的模式运行。启动线程时，你可以选择：

• 本地（Local）：直接在当前项目目录中工作
• Worktree：在 Git worktree 中隔离更改
• 云（Cloud）：在配置的云环境中远程运行

本地和 Worktree 线程都在你的计算机上运行。

内置 Git 工具

Codex 桌面应用直接提供常用的 Git 功能。diff 面板显示本地项目或 worktree 中的 Git diff，你还可以添加内联评论让 Codex 处理，以及暂存或还原特定的代码块或整个文件。你还可以直接从 Codex 桌面应用内为本地和 worktree 任务进行提交、推送和创建 Pull Request。对于更高级的 Git 任务，请使用集成终端。

Worktree 支持

创建新线程时，选择 Local 或 Worktree。Local 直接在项目中工作。Worktree 创建一个新的 Git worktree，使更改与常规项目隔离。当你想要尝试新想法而不影响当前工作，或希望 Codex 在同一项目中并行运行独立任务时，使用 Worktree。自动化任务在 Git 仓库的专用后台 worktree 中运行，对于非版本控制项目则直接在项目目录中运行。

集成终端

每个线程包含一个内置终端，限定在当前项目或 worktree 中。通过点击应用右上角的终端图标或按 Cmd+J 切换。使用终端验证更改、运行脚本和执行 Git 操作，而无需离开应用。Codex 也可以读取当前的终端输出，因此它可以在与你协作时检查正在运行的开发服务器状态或参考失败的构建。

常见任务包括：

• git status
• git pull --rebase
• pnpm test 或 npm test
• pnpm run lint 或类似的项目命令

如果你经常运行某个任务，可以在本地环境中定义一个操作，为 Codex 应用窗口顶部添加一个快捷按钮。

原生 Windows 沙箱

在 Windows 上，Codex 可以在 PowerShell 中本机运行，使用原生的 Windows 沙箱，无需 WSL 或虚拟机。这让你留在 Windows 原生工作流中，同时保持有边界的权限。

语音输入

使用语音向 Codex 发出提示。按住 Ctrl+M 并在 composer 可见时开始说话。你的声音将被转录。编辑转录后的提示或发送让 Codex 开始工作。

浮动弹出窗口

将活动对话线程弹出到单独的窗口中，并移动到当前工作位置。这对于前端工作非常理想，你可以将线程保持在浏览器、编辑器或设计预览附近，同时快速迭代。你还可以切换弹出窗口的置顶显示，使其在工作流中始终保持可见。

应用内浏览器

使用应用内浏览器预览、审查和评论本地开发服务器、文件支持的预览以及不需要登录的公共页面，同时迭代 Web 应用。应用内浏览器不支持认证流程、已登录页面、常规浏览器配置文件、Cookie、扩展或现有标签页。使用浏览器评论标记页面上的特定元素或区域，然后让 Codex 处理该反馈。

Computer Use

Computer Use 帮助 Codex 通过查看、点击和键入来操作 macOS 或 Windows 应用。这对于测试桌面应用、检查浏览器或模拟器流程、处理没有可用插件的数据源、更改应用设置以及复现仅 GUI 的 Bug 非常有用。由于 Computer Use 可能影响项目工作区之外的应用和系统状态，请保持任务范围狭窄，并在继续前审查权限提示。

与 IDE 扩展同步

如果你在编辑器中安装了 Codex IDE 扩展，当两者处于同一项目时，Codex 桌面应用和 IDE 扩展会自动同步。同步后，你会在 Codex 应用 composer 中看到 IDE 上下文选项。启用"自动上下文"后，Codex 桌面应用会跟踪你正在查看的文件。

线程自动化

自动化任务也可以附加到单个线程。这些线程自动化是定期唤醒调用，保留线程的上下文，以便 Codex 检查长时间运行的工作、轮询新信息源或继续后续循环。当下一次运行依赖于当前对话时，使用线程自动化。

审批与沙箱

你的审批和沙箱设置约束 Codex 的操作。审批决定 Codex 在运行命令前何时暂停等待权限。沙箱控制 Codex 可以访问的目录和网络。默认情况下，Codex 将工作范围限定在当前项目。

MCP 支持

Codex 桌面应用、CLI 和 IDE 扩展共享模型上下文协议（MCP）设置。如果你在其中之一配置了 MCP 服务器，其他组件会自动采用。

网络搜索

Codex 内置了第一方网络搜索工具。对于本地任务，Codex 默认启用网络搜索并提供缓存结果。

图片生成

让 Codex 在线程中直接生成或编辑图像。这对于 UI 资源、横幅、背景、插图和占位图非常有用。内置图片生成使用 gpt-image-2。

聊天

聊天是当任务不需要特定项目文件夹或 Git 仓库时可以启动的线程。用于研究、分类、规划、插件工作流等场景。