Codex App 是专为并行处理多个 Codex 线程设计的桌面客户端，内置 Git 工具、Worktree 支持、自动化任务（Automations）、本地环境配置等功能。支持 macOS 和 Windows，需要 ChatGPT Plus/Pro/Business/Edu/Enterprise 订阅。本文覆盖安装登录步骤和所有核心功能的简介。

Codex App 桌面客户端

Codex App 是一个专注的桌面体验，专为并行处理多个 Codex 线程而设计，内置 Worktree 支持、Automations 和 Git 功能。

ChatGPT Plus、Pro、Business、Edu 和 Enterprise 套餐均已包含 Codex App。详细定价参考 Codex 定价。

---

安装与上手

Codex App 支持 macOS 和 Windows。

1. 下载安装

前往 developers.openai.com/codex 下载适合你系统的版本。

• Mac Intel 用户请选 Intel 版本
• Linux 版本暂未发布，可以订阅通知

2. 打开并登录

安装后打开 Codex App，用 ChatGPT 账户或 OpenAI API key 登录。

用 API key 登录时，部分功能（如云端线程）可能不可用。

3. 选择项目

选择一个你想让 Codex 工作的项目文件夹。如果之前用过 Codex App、CLI 或 IDE 扩展，会看到历史项目列表。

4. 发送第一条消息

选好项目后，确认选中 Local（本机运行），然后发送指令：

Tell me about this project

Build a classic Snake game in this repo.

Scope & constraints:
- Implement ONLY the classic Snake loop: grid movement, growing snake, food spawn, score, game-over, restart.
- Reuse existing project tooling/frameworks; do NOT add new dependencies unless truly required.

Find and fix bugs in my codebase with minimal, high-confidence changes.

Method:
1) Reproduce: run tests/lint/build
2) Localize: identify the smallest set of files/lines involved
3) Fix: implement the minimal change that resolves the issue
4) Prove: add/update a focused test that fails before and passes after

更多使用场景参考：工作流示例 | 最佳实践

---

核心功能

多任务并行

同时运行多个任务，在它们之间快速切换。Codex App 的 UI 让你可以置顶线程、在多个项目间管理进行中的任务，而不是一次只做一件事。

内置 Git 工具

直接在 App 里完成 Code Review：查看 diff、内联评论、暂存或撤销特定代码块、提交——不需要切换到命令行。切换 diff 面板实时查看 Codex 的改动，点击具体行提供反馈，反馈会作为上下文传入下一个 Codex 回合。

Worktree 并行隔离

多个 Codex 线程同时修改同一个仓库时，Worktree 为每个线程提供独立的工作空间，避免相互干扰。详见 Worktree 使用指南。

Skills 支持

为 Codex Agent 添加额外能力。Skills 跨 App、CLI 和 IDE 扩展通用——在一个地方创建的 Skill，其他地方也能用。详见 Skills 指南。

Automations 自动化

把稳定的工作流变成定期运行的后台任务：选择项目、Prompt（可以调用 Skills）和执行频率。Codex 把结果放进收件箱，如果没有需要汇报的内容就自动归档。适合的任务：汇总 commits、扫描 Bug、起草 Release notes、检查 CI 失败等。详见 Automations 指南。

内置终端

每个线程都可以开一个独立的终端，用来测试改动、运行开发服务器、执行脚本和自定义命令，和 Codex 的工作在同一个上下文里。

本地环境配置

为 Worktree 定义配置脚本和常用项目操作，让每次新开任务时环境都能快速就绪。详见 本地环境配置。

与 IDE 扩展同步

在 App 和 IDE 扩展之间共享 Auto Context 和活跃线程，在不同工作界面之间无缝切换。

MCP 支持

通过 MCP 把 Codex Agent 接入更多外部服务。在 Settings → MCP servers 里管理连接。详见 MCP 配置。

---

常见问题

Q: Codex App 和 IDE 扩展有什么核心区别？

A: Codex App 更适合并行处理多个任务、需要专注于 Codex 工作的场景，内置了 Git 工具、Worktrees、Automations 等桌面专有功能。IDE 扩展则集成在你的编辑器里，更适合在写代码的同时随时调用 Codex。两者都能互相看到线程和 Skills，可以配合使用。

Q: 在 App 里用 API key 登录和用 ChatGPT 账户登录有什么区别？

A: API key 方式只支持本地任务，云端线程（Cloud Threads）、GitHub 自动 Code Review、Slack 集成等云端功能需要 ChatGPT 账户登录。

Q: Codex App 有 Linux 版本吗？

A: 目前还没有。可以在 openai.com/form/codex-app/ 提交邮箱，Linux 版发布时会收到通知。在 Linux 上可以使用 Codex CLI 代替。