OpenAI Codex App 适合在一个桌面窗口里并行处理多个 Codex 线程，常见场景包括多项目切换、Worktree 隔离、Git 操作、终端验证、自动化和浏览器预览。需要注意平台差异：大多数功能支持 macOS 和 Windows，但 computer use 仅在 macOS 可用，Windows 还支持原生 PowerShell sandbox。
OpenAI Codex App 功能与用法
OpenAI Codex App 是一个面向 Codex 线程的桌面工作区，重点覆盖并行任务、Worktree、自动化和 Git 工作流。大多数功能同时支持 macOS 和 Windows，下面会标出平台差异。
多项目并行处理
你可以在一个 OpenAI Codex App 窗口里同时处理多个项目。每个代码库都可以单独添加为一个 project，然后按需切换。
如果你用过 Codex CLI，可以把 project 理解为在某个指定目录里开始一个 session。
如果你在同一个仓库里维护两个或更多 app 或 package，建议把不同项目拆成独立的 app project，这样 sandbox 只会包含该项目的文件。
Skills 支持
OpenAI Codex App 支持和 CLI、IDE Extension 一样的 agent skills。你还可以在侧边栏点击 Skills，查看和探索团队在不同项目里创建的新 skills。
Automations
你可以把 skills 和 automations 结合起来，做例行任务，比如分析 telemetry 里的错误并提交修复，或者生成最近代码库变更的报告。对于需要持续留在同一个线程里的工作，使用 thread automation。
Modes
每个 thread 都运行在选定的 mode 中。新建 thread 时可以选择：
- Local：直接在当前项目目录中工作。
- Worktree：在 Git worktree 中隔离改动。了解更多
- Cloud：在已配置的云环境中远程运行。
Local 和 Worktree 线程都会在你的电脑上运行。
完整术语和概念可以查看 concepts section。
内置 Git 工具
OpenAI Codex App 直接提供常见 Git 功能。
diff 面板会显示你在本地项目或 worktree checkout 中的 Git diff。你也可以给 Codex 添加行内评论，让它处理指定代码块或整份文件，并且对这些内容执行 stage 或 revert。
你还可以直接在 Codex App 里完成 commit、push 和创建 pull request，适用于 local 和 worktree 任务。
更高级的 Git 操作可以使用 integrated terminal。
Worktree 支持
创建新 thread 时，可以选择 Local 或 Worktree。Local 会直接在你的项目里工作，Worktree 会创建一个新的 Git worktree，让改动与常规项目隔离。
当你想先试一个新想法，但不想碰当前工作时，用 Worktree 比较合适。它也适合让 Codex 在同一个项目里并行跑互不干扰的独立任务。
自动化任务在 Git 仓库中会运行在专用的后台 worktree 里；如果是没有版本控制的项目，则直接在项目目录中运行。
了解在 Codex App 中使用 worktree 的更多方式
集成终端
每个 thread 都带有一个内置终端，作用范围是当前 project 或 worktree。你可以通过应用右上角的终端图标切换它，也可以按 Cmd+J。
终端适合用来验证改动、运行脚本和执行 Git 操作，而不用离开应用。Codex 也能读取当前终端输出，所以它可以查看正在运行的开发服务器状态，或者在继续工作时参考失败的 build。
常见任务包括：
git statusgit pull --rebasepnpm test或npm testpnpm run lint或其他项目命令
如果某个任务会经常用到，你可以在 local environment 里定义一个 action，这样就能在 Codex App 窗口顶部添加快捷按钮。
注意，Cmd+K 会打开 Codex App 的 command palette，不会清空终端。要清空终端，请使用 Ctrl+L。
Windows 原生 sandbox
在 Windows 上，Codex 可以直接在 PowerShell 中运行，并使用原生 Windows sandbox，而不是依赖 WSL 或虚拟机。这样可以保持 Windows 原生工作流，同时保留受限权限控制。
语音输入
你可以直接用语音向 Codex 下达提示。只要 composer 可见，按住 Ctrl+M 开始说话，语音会被转写成文本。你可以先编辑转写内容，再发送给 Codex 开始工作。
浮动弹出窗口
你可以把当前活动中的 conversation thread 弹出成单独窗口，并拖到你正在工作的地方。前端工作时尤其方便，可以把 thread 放在浏览器、编辑器或设计预览旁边，边改边看。
如果希望窗口始终可见，也可以把 pop-out window 设为置顶。
In-app browser
使用 in-app browser 可以在迭代 web app 时预览、审查和评论本地开发服务器、文件支持的预览，以及不需要登录的公开页面。
in-app browser 不支持认证流程、已登录页面、你常用浏览器的 profile、cookies、extensions，也不支持已有标签页。
你可以用 browser comments 标记页面上的特定元素或区域，然后让 Codex 根据这些反馈修改。
如果你想让 Codex 直接操作页面，针对本地开发服务器和文件支持页面可以使用 browser use。你可以在 settings 里管理 Browser plugin、允许的网站和阻止的网站。
Computer use
Computer use 可以让 Codex 通过查看、点击和输入来操作 macOS 应用。适合测试桌面应用、检查浏览器或模拟器流程、处理不可作为插件接入的数据源、修改应用设置，以及复现只在图形界面里出现的 bug。
因为 computer use 可能会影响项目工作区之外的应用和系统状态，所以要把任务范围控制得足够窄，并在继续前检查权限提示。
这个功能在欧洲经济区、英国和瑞士上线时不可用。
处理非代码产物
当任务生成的是非代码产物时，侧边栏可以预览 PDF、表格、文档和演示文稿。你需要给 Codex 明确的源数据、期望文件类型、结构，以及你关心的审查标准。
如果是表格和演示文稿，要说明 sheet、列、图表、幻灯片分区，以及需要检查的内容。也要让 Codex 说明它把输出保存到哪里，以及它如何验证结果。
你可以使用 task sidebar 跟踪 thread 运行过程。它会展示 agent 的计划、来源、生成的产物和任务摘要，方便你调整方向、检查生成文件，并决定是否需要再跑一遍。
与 IDE Extension 同步
如果你在编辑器里安装了 Codex IDE Extension，并且它和 OpenAI Codex App 处于同一个 project，二者会自动同步。
同步后，Codex App 的 composer 里会出现 IDE context 选项。开启 Auto context 后，Codex App 会跟踪你正在查看的文件，这样你可以间接提问，比如“这个文件是做什么的？”。你也可以在 IDE Extension 里看到 Codex App 正在运行的线程，反过来也一样。
如果你不确定 App 是否带上了 context，可以先把它关掉，再用同一个问题重新问一次对比结果。
Thread automations
automations 也可以绑定到单个 thread。这样的 thread automation 是一种重复唤醒机制，会保留 thread 的上下文，让 Codex 能检查长时间运行的工作、轮询某个来源有没有新信息，或者继续后续循环。适合需要按计划回到同一段对话的 heartbeat 风格自动化。
如果下一次运行依赖当前 conversation，就用 thread automation。如果你想让 Codex 为一个或多个项目发起全新的周期性任务，就用独立的或 project automation。
Approvals 和 sandboxing
你的 approval 和 sandbox 设置会限制 Codex 的行为。
- Approvals 决定 Codex 在运行命令前，什么时候需要暂停并请求许可。
- Sandbox 控制 Codex 可以访问哪些目录和网络。
当你看到 “approve once” 或 “approve for this session” 之类的提示时，表示你在授予不同范围的工具执行权限。若不确定，先选最窄的权限再继续迭代。
默认情况下，Codex 会把工作范围限制在当前 project。大多数情况下，这个限制是合适的。
如果任务需要跨多个 repository 或 directory，优先开独立 project，或者使用 worktree，不要让 Codex 跑到 project root 之外。
如果你的 workspace 支持 automatic review，可以在 permissions selector 中选择它。它会保持相同的 sandbox 边界，但会把符合条件的 approval 请求交给已配置的 review policy，而不是等待你手动确认。
如果你想看更高层的说明，可以参考 sandboxing。配置细节见 agent approvals & security documentation。
MCP 支持
OpenAI Codex App、CLI 和 IDE Extension 共用 Model Context Protocol (MCP) 设置。如果你已经在其中一个工具里配置了 MCP servers，其他工具会自动采用这些设置。要配置新的 server，请打开 App settings 里的 MCP 部分，然后启用推荐的 server，或者把新的 server 加入配置。
Web search
Codex 自带第一方 web search 工具。对于 Codex App 里的本地任务，Codex 默认会启用 web search，并通过 web search cache 提供结果。如果你把 sandbox 配成 full access，web search 默认会使用 live results。要关闭 web search，或者切换为获取最新数据的 live results，请查看 Config basics。
Image generation
你可以直接在 thread 里让 Codex 生成或编辑图片。这个能力适合 UI 资产、banner、背景、插画、sprite sheet 和 placeholder，也适合和代码一起创建的素材。如果你想让 Codex 改造或扩展已有素材，可以附上一张参考图。
你可以用自然语言请求，也可以在提示里显式加入 $imagegen 来调用 image generation skill。
内置图片生成使用 gpt-image-2，会计入你的常规 Codex usage limits。按平均情况看，在图像质量和尺寸相近时，它比没有 image generation 的类似轮次快 3 到 5 倍，具体取决于图像质量和尺寸。详情见 Pricing。关于提示写法和模型细节，见 image generation guide。
如果你需要更大批量的图片生成，可以在环境变量里设置 OPENAI_API_KEY，然后让 Codex 通过 API 生成图片，这样就按 API pricing 计费。
Image input
你可以把图片拖放到 prompt composer 里，把图片作为上下文的一部分。拖图时按住 Shift，可以把图片加入 context。
你也可以让 Codex 查看你系统里的图片。如果你给 Codex 提供能截取你正在工作的应用截图的工具，它就可以验证自己正在做的工作。
Chats
Chats 适用于不需要特定 project folder 或 Git repository 的任务。可以用于 research、triage、planning、plugin-heavy workflows，以及其他需要 Codex 结合连接工具工作、但不需要直接编辑代码库的对话。
Chats 会使用 Codex home 下由 Codex 管理的 threads 目录作为工作位置。默认路径是 ~/.codex/threads。
Memories
Memories 在可用时，允许 Codex 把过去任务中的有用上下文带到未来的 thread 里。它最适合稳定偏好、项目约定、重复工作模式，以及那些本来每次都要重新说明的已知坑点。
Notifications
默认情况下，当任务完成，或者在后台运行时需要审批，OpenAI Codex App 会发送通知。
你可以在 Codex App settings 里把通知设为从不发送，或者即使 App 处于前台也始终发送。
让电脑保持唤醒
因为任务可能会运行较久，你可以在 App settings 里启用 “Prevent sleep while running” 开关，让 Codex App 在任务运行期间阻止电脑进入睡眠。
常见问题
OpenAI Codex App 支持哪些平台
大多数功能同时支持 macOS 和 Windows。Windows 还支持原生 PowerShell sandbox，不需要依赖 WSL 或虚拟机。computer use 在上线时不支持欧洲经济区、英国和瑞士。
OpenAI Codex App 怎么同时处理多个项目
在一个 App 窗口里为每个 codebase 单独添加 project，然后在它们之间切换即可。如果同一个仓库里有多个 app 或 package，建议拆成独立 project，这样 sandbox 只包含对应文件。
OpenAI Codex App 的 Local、Worktree、Cloud 有什么区别
Local 直接在当前项目目录工作。Worktree 会创建独立的 Git worktree，把改动隔离开。Cloud 则在已配置的云环境里远程运行。Local 和 Worktree 线程都会在你的电脑上执行。