Codex App | 桌面端多线程与工作树协作
Codex App
你的 Codex 指挥台
Codex App 是一个高度聚焦的桌面端工作台，适合并行处理多个 Codex 线程，并内置了工作树支持、自动化和 Git 功能。
ChatGPT Plus、Pro、Business、Edu 和 Enterprise 计划都包含 Codex。更多信息见 包含内容。
开始使用
先完成安装、登录和项目选择，再让 Codex 以 Local 模式在你的机器上开始工作。
1. 下载并安装 Codex App
Codex App 支持 macOS 和 Windows。
大多数 Codex App 功能都可在两个平台上使用；相关文档会说明平台特有的例外。
下载 macOS 或 Windows 版本。如果你使用的是 Intel 芯片的 Mac，请选择 Intel 构建版本。
2. 打开 Codex 并登录
安装完成后，打开 Codex，并使用你的 ChatGPT 账号或 OpenAI API key 登录。
如果你使用 OpenAI API key 登录，某些功能可能不可用。
3. 选择项目
选择一个希望 Codex 参与工作的项目文件夹。
如果你以前已经用过 Codex App、CLI 或 IDE 扩展，这里也会显示你过去处理过的项目。
4. 发送第一条消息
选好项目后，确认已选中 Local（本地模式），让 Codex 在你的机器上工作，然后发送第一条消息。
你可以询问 Codex 关于项目的问题，也可以让它帮你处理电脑上的一般性开发任务。下面是一些示例：
- 告诉我这个项目是做什么的
- 在这个仓库里实现一个经典 Snake 游戏
- 以最小且高置信度的改动修复我代码库里的 bug
如果你需要更多灵感，可以查看 Codex 用例；如果你刚开始使用 Codex，建议先读 最佳实践指南。
使用 Codex App
从并行线程、Git 评审到工作树、自动化和本地环境，这些都是 Codex App 中最常用的核心能力入口。
- 跨项目多任务处理 — 并排运行项目线程，并在它们之间快速切换。
- 工作树 — 通过内置 Git worktree 支持，让并行代码改动彼此隔离。
- 远程连接 — 使用 ChatGPT mobile app 在已连接主机上启动、引导、审批和检查 Codex 工作。
- 计算机操作 — 让 Codex 操作 macOS 应用，处理 GUI 任务、浏览器流程和原生应用测试。
- 应用截图 — 把最前方的 Mac 应用窗口连同截图和可用文本发送给 Codex。
- 评审并交付改动 — 检查 diff、处理 PR 反馈、暂存文件、提交并推送。
- 终端与动作 — 在每条线程中运行命令，并启动可重复的项目动作。
- 内置浏览器 — 打开渲染后的页面、留下评论，或让 Codex 操作本地浏览器流程。
- Chrome 扩展 — 添加 Chrome 插件，让 Codex 在你管理网站审批的前提下处理已登录浏览器任务。
- 图片生成 — 在线程中生成或编辑图片，同时处理周边代码与素材。
- 自动化 — 安排重复任务，或唤醒同一线程执行持续检查。
- 技能 — 在 App、CLI 和 IDE 扩展之间复用指令与工作流。
- 侧边栏与 artifact — 跟踪计划、来源、任务摘要和生成文件预览。
- 插件 — 连接应用、技能和 MCP server，扩展 Codex 能做的事。
- Sites — 使用 Sites 插件构建并部署托管网站、web app 和游戏。
- 与 IDE 扩展同步 — 当应用和 IDE 指向同一个项目时，共享 Auto Context 和活动线程。
需要帮助？参见 故障排查指南。