Codex App 完整使用说明

Codex App 是桌面工作台，不是聊天框。它把项目、线程、Local / Worktree、Review Pane、Browser、Computer Use、Automations、Skills 和 MCP 放在一个界面里，让你用 agent 完成开发任务。

先看这张关系图

用户目标
  ↓
Codex App
  ├─ Local：直接在当前项目目录工作
  ├─ Worktree：隔离一个并行任务
  ├─ Review Pane：看 diff、评论、保留或回退
  ├─ Browser：打开本地网页做交互验收
  ├─ Computer Use：操作目标应用，风险更高
  ├─ Automations：定时检查或复测
  ├─ Skills：复用稳定工作流
  └─ MCP：连接外部工具和上下文

App、CLI、IDE、Cloud 怎么选

场景	选什么	原因
第一次打开本地项目	Codex App + Local	方便看线程、diff、浏览器和设置
只想在终端快速处理任务	Codex CLI	键盘优先，适合熟悉命令行的人
正在编辑器里看代码	IDE Extension	适合边看文件边让 Codex 解释或修改
想让任务在远端跑	Cloud	适合远端仓库和云环境，但要确认环境配置
当前分支有未完成改动	Worktree	避免并行任务互相覆盖
要做网页真实验收	Browser 或 Computer Use	让 Codex 看实际界面，但要设置边界

第一次打开项目

先不要让 Codex 改文件。复制这段：

这是我第一次在 Codex App 里打开这个项目。请先不要修改文件。

请只读摸底：
1. 这个项目做什么
2. 入口文件和主要目录
3. 本地运行方式
4. 当前是否适合用 Local，还是应该用 Worktree
5. 哪些配置会影响本次任务
6. 第一个适合新手的小任务
7. 哪些操作必须等我确认

成功标志：

Codex 能说出入口文件。
Codex 没有直接修改文件。
它能说明 Local / Worktree 的选择理由。
它能指出要先确认的权限或配置。

Settings 先查什么

设置	新手要确认什么	风险
项目路径	当前打开的是练习项目，不是生产项目	中
Editor	Codex 打开的编辑器是不是你能看懂的工具	低
Git	项目是不是 Git 仓库，Review Pane 能不能显示 diff	中
Agent configuration	是否继承 CLI/IDE 配置、权限和 sandbox	中
Browser	本地 dev server 是否允许打开，外部站点是否被 block	中
Computer Use	是否授权目标应用，是否涉及账号或敏感信息	高
Integrations / MCP	是否连接外部服务、token、费用账户	高

什么时候停下来

出现这些情况，让 Codex 停：

它要读取用户目录、SSH key、浏览器 cookie、云服务 token。
它要登录真实账号。
它要执行未知来源的一键安装脚本。
它要改全局配置，但没说明为什么。
它要把项目从 Local 切到 Worktree，但没说明改动在哪里。

失败叫停句

先停。不要继续修改文件。请只基于当前 git diff 和你已经执行过的命令，说明现在发生了什么，以及如何回退。

下一步

第一次完整练习：Codex 新手第一小时
并行任务：Worktree 到 PR
桌面和浏览器验收：Computer Use 安全指南
复用流程：Codex Skills 入门

来源与日期

访问日期：2026-06-17。Codex App 功能属于高变动内容，发布前需要重新复测。