Appearance
Codex App 是 OpenAI 官方桌面客户端，专为多任务并行工作设计。它把 Skills、Automations、Git diff 面板、集成终端、Worktree 隔离全整合进一个界面，让你在不离开应用的情况下完成从提任务、Review 改动到提交 PR 的完整工作流。本文覆盖所有主要功能模块。
Codex App 功能详解
Codex App 是针对 Codex 线程并行工作优化的桌面客户端，内置 Worktree 支持、Automations 和 Git 功能。
多项目管理
在单个 Codex App 窗口里跨项目运行任务。为每个代码库添加一个项目，按需切换。
如果你用过 Codex CLI，一个"项目"就相当于在指定目录里启动一个会话。
如果你在一个包含多个应用或包的 monorepo 里工作，把不同子项目拆成独立的 App 项目，这样沙箱只包含该项目的文件。
Skills 支持
Codex App 支持与 CLI 和 IDE 扩展相同的 Skills 系统。你还可以通过侧边栏的 Skills 入口，浏览和探索你团队在各项目中创建的所有 Skills。
Automations
将 Skills 与 Automations 结合，执行例行任务——比如自动评估遥测中的错误并提交修复，或者生成代码库近期变更报告。
线程模式
每个线程在选定的模式下运行。启动线程时可选择：
| 模式 | 说明 |
|---|---|
| Local | 直接在当前项目目录下工作 |
| Worktree | 在独立的 Git worktree 里隔离改动，详细了解 |
| Cloud | 在配置好的云端环境里远程运行 |
Local 和 Worktree 模式都在你的本地电脑上运行。
内置 Git 工具
Codex App 在应用内直接提供常用 Git 功能：
- Diff 面板：查看本地项目或 Worktree checkout 的 Git diff，可以为特定行添加内联注释让 Codex 处理，也可以按 hunk 或整个文件进行 Stage/Revert
- 提交与推送：直接在应用内提交、推送、创建 PR
更复杂的 Git 操作使用下方的集成终端。
Worktree 支持
新建线程时选择 Worktree 模式，Codex 会创建一个新的 Git worktree，让改动完全独立于当前工作目录。
适合场景：
- 想试验新想法但不影响当前工作
- 让 Codex 在同一项目里并行运行独立任务
Automations 在 Git 仓库中运行于专用的后台 Worktree，非版本控制项目则直接在项目目录运行。
集成终端
每个线程都包含一个作用域限定在当前项目或 Worktree 的内置终端。通过右上角终端图标或 Cmd+J 切换显示。
用终端来验证改动、运行脚本、执行 Git 操作，无需离开应用。Codex 还可以读取当前终端输出——比如检查正在运行的 Dev Server 状态，或在工作时参考失败的构建日志。
常用命令示例：
bash
git status
git pull --rebase
pnpm test
pnpm run lint如果有定期运行的任务，可以在本地环境配置中定义 Action，在 Codex App 顶部栏添加快捷按钮。
注意：
Cmd+K打开命令面板，不会清空终端。清空终端请用Ctrl+L。
Windows 原生沙箱
在 Windows 上，Codex 可以在 PowerShell 中原生运行，使用 Windows 原生沙箱，无需 WSL 或虚拟机。保持 Windows 原生工作流的同时，保留权限边界控制。
语音输入
用语音向 Codex 发送指令。在 Composer 可见时长按 Ctrl+M 开始说话，语音会被自动转录。编辑转录结果或直接发送即可。
浮动弹出窗口
把活跃的对话线程弹出到独立窗口，移动到你正在工作的位置。前端开发时特别好用——可以把线程窗口靠近浏览器、编辑器或设计预览，快速迭代。
也可以设置弹出窗口"置顶"，让它在整个工作流中保持可见。
与 IDE 扩展联动
安装了 Codex IDE 扩展 后，Codex App 和 IDE 扩展在同一项目下会自动同步。
同步后：
- Composer 里出现 IDE context 选项
- 开启"Auto context"后，Codex App 会追踪你正在查看的文件，支持间接引用（如"这个文件是做什么的？"）
- IDE 扩展里能看到 Codex App 正在运行的线程，反之亦然
审批与沙箱
审批和沙箱设置约束 Codex 的行为范围：
- 审批：决定 Codex 在运行命令前何时暂停等待许可
- 沙箱：控制 Codex 可访问的目录和网络范围
看到"approve once"或"approve for this session"时，你在授予不同范围的工具执行权限。不确定时选最小范围，继续迭代。
默认情况下 Codex 把工作限定在当前项目内，大多数情况下这是正确的约束。跨多个仓库或目录的任务，优先开多个独立项目或使用 Worktree，而不是让 Codex 跑到项目根目录之外。
MCP 支持
Codex App、CLI 和 IDE 扩展共享 MCP（Model Context Protocol） 配置。已在任一客户端配置的 MCP Server，其他客户端会自动使用。要配置新 Server，在应用设置的 MCP 区域启用推荐 Server 或添加自定义 Server。
常见问题
Q: Codex App 和 Codex CLI 有什么区别？
A: 功能上两者基本对等，但 Codex App 提供图形界面，更适合多任务并行（多线程同时可见）、需要直观查看 diff、或者想用鼠标操作 Git 的场景。CLI 更适合纯终端工作流或脚本化集成。
Q: 如何防止任务运行时电脑休眠？
A: 在 Codex App 设置里开启"Prevent sleep while running"开关，任务运行期间会阻止电脑进入睡眠。
Q: 通知怎么配置？
A: 默认在应用后台时任务完成或需要审批会发送通知。在设置里可以改为"从不发送"或"始终发送（包括在前台时）"。