Appearance
Codex App 桌面应用教程：Review、Automations、Worktrees 与 Handoff
Codex App 适合希望用图形界面管理多个项目和开发任务的用户。它把代码工作区、Review、自动化任务、隔离 Worktree 和任务交接放在同一个入口中。本文以实际工作流说明这些功能的用途和边界。
请从 OpenAI Codex 官方页面 获取当前桌面应用，并以 Codex 开发者文档 的版本说明为准。界面名称和功能开关可能随版本调整。
安装和首次打开
从官方来源下载安装包，启动后完成登录。首次打开项目时确认：项目路径、当前分支、未提交修改和 Codex 可用的权限。先让 App 读取项目并总结启动、测试和构建命令，不要马上执行删除、迁移或发布操作。
如果你在终端中配置了第三方 Provider，App 是否继承该配置取决于当前版本和启动方式。Clawsocket 配置可以参考 Codex 接入第三方模型，并在 App 内用一个只读任务验证实际模型和 Provider。
界面中的三种任务模式
不同版本的界面文字可能不同，但常见工作方式包括：
- 普通执行：让 Codex读取、修改文件并运行验证；
- Plan 或分析：先输出计划、影响范围和风险，再开始编辑；
- Review：专注检查 diff、错误处理、边界和测试缺口。
模式不是安全保证。即使选择 Review，也要确认任务范围、权限和最终 diff。复杂任务可以结合 Plan Mode 与 Subagents。
Review 模式：怎样审查一份修改
打开项目的变更或 Pull Request 后，让 Codex按风险排序审查：
请审查当前 diff，重点关注行为回归、边界条件、错误处理、权限、安全风险和测试缺口。只报告能由代码证据支持的问题，并给出文件和行号，不要修改文件。
审查结果需要人工确认。重点看它是否引用真实调用路径，建议是否符合仓库已有约定，以及测试是否覆盖了指出的风险。更多方法见 用 Codex 做代码审查。
Automations：把重复任务固定下来
Automations 适合定期执行低风险、输入明确的任务，例如检查依赖更新、汇总测试状态或生成项目周报。创建自动化时写清：
- 触发时间或事件；
- 允许读取和修改的目录；
- 禁止访问的敏感数据；
- 必须运行的验证命令；
- 失败时如何通知和停止。
不要让自动化直接发布生产、删除数据或修改权限。先在测试仓库运行几次，阅读每次 diff 和日志，再决定是否扩大权限。API 自动化还要设置密钥、超时、重试和限流，参阅 生产环境 API 清单。
Worktrees：隔离多个任务
Worktree 可以为不同任务创建独立工作目录，让主分支、功能开发和审查任务互不覆盖。它适合：
- 同时处理多个功能；
- 让一个任务运行测试，另一个任务继续开发；
- 在隔离目录中试验较大改动；
- 保留主工作区的干净状态。
创建 Worktree 前先确认分支和依赖安装方式。不同目录可能共享 Git 对象，但不会自动共享未提交文件和运行中的进程。合并前检查完整 diff、测试结果和配置文件。
App 界面参考
下面补充 App 中的项目列表、Review、自动化、Worktree 和设置界面截图。截图用于帮助读者定位功能，实际界面会随客户端版本变化。
Handoff：把任务交给另一个工作区
Handoff 适合把已经有清晰计划的任务交给另一个环境或工作区继续。交接说明至少包含：当前目标、已完成修改、未解决问题、运行过的命令、禁止操作和下一步完成标准。
不要只写“继续完成”。更好的交接内容是：
已修改
src/auth，新增两个回归测试；npm test通过，构建尚未运行。请只检查超时错误路径，完成后运行测试和构建，不要改动 API 返回结构。
接收方仍需重新读取适用的 AGENTS.md、检查工作区和 diff。Handoff 不是跳过验证的快捷方式。
本地环境设置脚本
如果项目需要固定 Node.js、环境变量或依赖，可以设置项目启动脚本。但脚本应可审查、可重复，并避免打印密钥。把真实凭据放到密钥管理或系统环境变量中，不要写进脚本和仓库。
常见问题
App 与 CLI 的配置会自动同步吗？
不一定。它们可能共享部分用户配置，也可能使用独立的登录、缓存或进程环境。分别用 /status、只读任务和最小 API 请求验证。
为什么 Worktree 里的代码和主工作区不同？
Worktree 是独立工作目录和分支，不会自动包含其他目录的未提交修改。切换目录后检查分支、依赖和环境变量。
Automation 可以直接改生产代码吗？
不建议。让自动化生成报告、创建分支或提交可审查 diff，再由负责人确认合并和发布。
App 使用第三方 API 是否安全？
取决于 Provider 的协议、权限、数据保留和密钥管理。以 Clawsocket 为例，先阅读 第三方模型接入教程，再做工具调用和数据脱敏验证。
配图来源
本文配图引用自 Runoob Codex 桌面应用，用于说明 App 的界面、Review 和工作区概念。具体功能以当前 Codex App 版本为准。