使用桌面版 Codex

Codex App 是桌面端 Codex 工作台，适合管理项目、threads、worktrees、diff review、automations 和本地/云端任务。第一次使用时，不要急着并行多个 agent，先完成一个可审查的小任务闭环。

第一条任务闭环

flowchart LR
    Install["安装 App"] --> Login["登录"]
    Login --> Project["选择项目"]
    Project --> Read["只读了解项目"]
    Read --> Small["限定一个小任务"]
    Small --> Verify["运行验证"]
    Verify --> Review["审查 diff"]

这个闭环能证明三件事：

• App 能正确访问你的项目。
• Codex 理解当前 repo 的上下文和规则。
• 你能审查并控制它的改动。

安装和登录

从官方 Quickstart 下载当前平台版本。

登录方式通常有两类：

• ChatGPT 登录：适合日常交互、App、Cloud 和 workspace 权限场景。
• API key 登录：适合某些本地或程序化场景，但功能和计费路径可能不同。

如果你在企业 workspace 中使用 Codex，登录方式和可用功能可能由管理员控制。

选择项目

选择项目目录时要保守：

• 只选择本次要处理的 repo 或子项目。
• 大型 monorepo 可以拆成多个 App projects。
• 不要把无关目录放进同一个工作边界。
• 进入项目后先看当前工作树状态。

Project 边界会影响上下文、sandbox、diff review 和任务管理。

第一条只读 prompt

先让 Codex 只读分析：

请只读分析这个项目，不要修改文件。
输出：
- 项目用途
- 技术栈
- 主要目录职责
- 启动和测试命令
- 你确认的事实和仍然不确定的点

如果它能正确描述项目，说明上下文和项目边界基本有效。

第一条修改 prompt

再做一个小而可验证的任务：

请修复一个很小的问题或整理一处文档格式。

约束：
- 只改你列出的 1-2 个文件。
- 不新增依赖。
- 不做无关重构。
- 改完说明验证方式。

不要第一天就让它重构模块、升级依赖或批量改全站。

审查 diff

App 的价值之一是 diff review。

审查时看：

• 是否只改了约定范围。
• 是否有无关格式化。
• 是否触碰配置、依赖、凭据或生成物。
• 是否有测试或验证证据。
• 是否还有未验证风险。

对具体 diff 写反馈，比重新发一段泛泛 prompt 更有效。

Local、Worktree、Cloud 怎么选

Local：

• 直接在当前 project directory 中工作。
• 适合简单、本地、可快速验证的任务。

Worktree：

• 把任务放到 Git worktree 中隔离。
• 适合并行任务、实验性改动或避免污染当前工作树。

Cloud：

• 在远程 environment 中执行。
• 适合异步任务、GitHub workflow 或不依赖本机的长任务。

第一天建议从 Local 的只读和小改动开始。熟悉后再用 Worktree 和 Cloud。

App 中的常用能力

常用能力包括：

• 多 project 和多 thread 管理。
• Worktree 隔离。
• Integrated terminal。
• Diff review、stage、commit、push。
• In-app browser。
• Automations。
• Skills。
• Artifacts preview。
• IDE extension sync。

每个能力都要配合任务边界使用。尤其是 browser、computer use、automations 和 cloud tasks，不应在还没理解权限边界时默认打开。

新手不要做什么

不要：

• 一上来同时开多个大任务。
• 让 Codex 自动处理不可逆 Git 操作。
• 把 App 当作生产后台操作工具。
• 忽略当前已有未提交改动。
• 不看 diff 就提交或推送。
• 把 API key、token、账号信息贴进任务。

Codex App 的正确起点是一个小任务闭环，而不是大规模自动化。

下一步

完成第一天闭环后，继续学习：

• Worktrees：隔离并行任务。
• App core：掌握工作台能力。
• Automations：把稳定重复任务放到后台。
• Security：理解 sandbox、approval 和 cloud environment。

App 不是替代工程审查的工具，而是把 Codex 的任务、上下文和改动放到一个更容易管理的界面里。