---
title: "使用桌面版 Codex"
description: "从安装、登录、选择项目、启动本地线程到审查 diff，完成 Codex App 的第一天使用闭环。"
verifiedAt: "2026-05-06"
---

import { Cards, Card } from 'fumadocs-ui/components/card';

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

> [!TIP]
> 新手第一天的目标不是“跑大任务”，而是确认安装、登录、项目边界、只读分析、限定修改、验证和撤销都能走通。

<Cards>
  <Card title="Quickstart" href="https://developers.openai.com/codex/quickstart">
    查看当前 App 下载、安装和登录入口。
  </Card>
  <Card title="App features" href="https://developers.openai.com/codex/app/features">
    查看 projects、threads、terminal、browser、artifacts 等官方功能说明。
  </Card>
  <Card title="App core" href="/docs/codex/official/01-products/33-app-core">
    继续学习 App 的核心工作台能力。
  </Card>
</Cards>

## 第一条任务闭环

```mermaid
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 只读分析：

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

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

## 第一条修改 prompt

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

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

约束：
- 只改你列出的 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 的任务、上下文和改动放到一个更容易管理的界面里。
