Codex App Overview：桌面端入口和第一次使用路线

适用场景

Codex App 是桌面端的 Codex command center。它适合在一个窗口里管理多个项目、多个线程、worktree、自动化任务和 Git 改动。

如果你想让 Codex 帮你做的不只是“当前文件的小修改”，而是跨文件修复、跑测试、审 diff、管理并行任务，Codex App 通常比单纯聊天窗口更合适。

Codex App 的定位

官方页面把 Codex App 描述为一个 focused desktop experience。换成实际使用语言，就是：

• 你可以把一个代码目录作为项目交给 Codex。
• 每个任务可以形成独立 thread。
• App 可以管理本地、worktree 或 cloud 模式。
• 任务完成后可以看 diff、提交、继续下一步。
• 可以结合 automations、skills、plugins、browser 和 computer use。

它更像一个面向工程任务的工作台，而不是普通聊天页面。

步骤 1：安装 App

官方 Codex App 支持 macOS 和 Windows。macOS 用户需要按芯片选择 Apple Silicon 或 Intel 构建；Windows 用户从官方入口安装。

安装完成后打开 Codex App，并准备登录方式：

• ChatGPT 账号：适合使用完整 App、云端任务、工作区和团队能力。
• OpenAI API key：适合个人或 API/CLI 风格使用，但部分功能可能不可用。

团队用户还要确认管理员是否已经启用 Codex。

步骤 2：选择项目

打开 App 后选择一个 project folder。建议第一次不要选特别大的生产仓库，而是选一个你熟悉、能快速验证的小项目。

选择项目时检查：

• 当前目录是否是 Git 仓库。
• 是否有未提交的重要改动。
• 是否存在密钥、客户数据或内部文件。
• 是否知道启动、测试和 lint 命令。

如果一个 monorepo 里有多个应用，建议按应用或包拆成不同 project，减少 sandbox 能访问的范围。

步骤 3：从 Local 模式开始

第一次使用时，建议选择 Local，让 Codex 在你的机器上工作。这样你可以更直接地看到它读取文件、运行命令和修改代码。

第一条消息建议先只读：

请阅读这个项目，告诉我主要目录、启动命令、测试命令和你建议我先补充到 AGENTS.md 的规则。先不要修改代码。

等它理解项目后，再交给它一个小任务：

请修复首页按钮在移动端换行的问题。不要改公共 API。完成后运行 lint。

步骤 4：检查结果

Codex 完成后至少检查：

• 它改了哪些文件。
• 是否运行了你要求的验证命令。
• diff 是否和任务范围一致。
• 是否需要你批准额外权限。
• 是否适合提交，还是需要继续迭代。

Codex App 的优势是把这些工作放在同一个任务线程里，后续你可以继续追问、让它补测试或提交。

什么时候切到其他入口

• 当前编辑器选区很关键：切到 IDE Extension。
• 需要脚本化或 CI：切到 CLI / codex exec。
• 任务很长、希望云端后台跑：切到 Codex Web / Cloud。
• 需要真实浏览器或桌面应用：继续用 App 的 browser、Chrome extension 或 Computer Use。

常见错误

不要把 App 当作无限权限执行器。Local 模式仍然要遵守 sandbox、approval 和文件边界。

不要把多个无关目标塞进一个 thread。每个 thread 应该有清楚的任务边界。

不要第一次就让 Codex “重构全站”。先用小任务建立信任和验证节奏。

小结

Codex App 最适合作为本地工程任务的主控台。正确入门路线是：安装、登录、选择小项目、从 Local 开始、先让 Codex 理解项目，再交付一个可验证的小任务。