---
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="/zh-Hant/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 的任務、上下文和改動放到一個更容易管理的介面裡。
