---
title: "產品入口"
description: "基於官方 Codex 產品教程，幫新手分清 CLI、IDE、App、Web、Windows 和自動化入口各自適合什麼任務。"
verifiedAt: "2026-05-06"
---

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

> [!NOTE]
> 這一章不是安裝清單，而是入口選擇手冊。先判斷任務發生在哪裡，再決定用 CLI、IDE、App、Cloud、Windows 還是自動化入口。

Codex 有多個產品入口：CLI、桌面 App、Web / Cloud、IDE 擴充套件、Windows 入口，以及 Worktrees、App Server、Automations、Computer Use 等配套能力。新手不要按“哪個功能最多”選擇，而要按執行位置、審查方式和許可權邊界選擇。

```mermaid
flowchart TB
  Task[當前任務] --> Where{任務在哪裡發生}
  Where --> Terminal[終端和本地儲存庫]
  Where --> IDE[編輯器現場]
  Where --> App[多工審查和視覺化工作流]
  Where --> Cloud[非同步遠端環境]
  Where --> Windows[Windows 開發環境]

  Terminal --> CLI[CLI / codex exec]
  IDE --> Extension[IDE extension]
  App --> Desktop[Codex App]
  Cloud --> Web[Codex Cloud]
  Windows --> Win[Windows App / Windows CLI]
```

## 按任務選入口

<Cards>
  <Card title="終端和指令碼" description="本地儲存庫、命令列工作流、codex exec、CI 前置實驗，優先從 CLI 開始。" href="/zh-Hant/docs/codex/official/01-products/26-cli-features" />
  <Card title="編輯器現場" description="邊讀程式碼邊改區域性檔案，優先看 IDE 安裝、功能、設定和命令。" href="/zh-Hant/docs/codex/official/01-products/20-ide-install" />
  <Card title="多工視覺化" description="需要 review、worktree、automations、內建瀏覽器和任務面板，優先看 Codex App。" href="/zh-Hant/docs/codex/official/01-products/04-app" />
  <Card title="非同步遠端任務" description="長任務、雲端執行、GitHub 觸發或不佔用本機資源，進入 Cloud / Web 章節。" href="/zh-Hant/docs/codex/official/05-cloud-remote" />
  <Card title="Windows 環境" description="在 Windows 上使用 Codex 時，重點檢查 shell、路徑、sandbox 和許可權差異。" href="/zh-Hant/docs/codex/official/01-products/120-windows-codex" />
  <Card title="自動化與工作樹" description="需要定時、並行、可回復分支或 app server，再看 Automations、Worktrees 和 App Server。" href="/zh-Hant/docs/codex/official/01-products/35-app-automation" />
</Cards>

## 章節速查

CLI 相關：使用命令列版、CLI 斜槓命令、CLI 功能、CLI 引數、非互動任務。

IDE 相關：安裝 IDE 擴充套件、IDE 功能、IDE 設定、IDE 命令、IDE 斜槓命令。

桌面 App 相關：桌面版、App Server、App 核心、App 設定、Automations、內建瀏覽器、App 命令、Computer Use、本地執行環境、App Review、App 排障、Worktrees。

Web / Windows 相關：網頁版、Windows 版 App、Windows 上使用 Codex。

## 入口判斷

如果你每天都在終端裡開發，先用 CLI。它最接近儲存庫現場，也最容易和已有指令碼、測試、CI 思維銜接。

如果你主要在 VS Code、Cursor、Windsurf 或同類編輯器裡讀寫程式碼，先用 IDE 擴充套件。它適合區域性上下文和邊看邊改。

如果你要同時跟進多個任務、看 diff、用 worktree、跑 automations，先用桌面 App。它的價值在任務管理和審查面，不只是“另一個聊天視窗”。

如果任務很長、可以非同步等待、適合雲端環境，先用 Web / Cloud。涉及本機金鑰、本機 GUI、本機未提交狀態時要重新評估。

如果要接 CI、定時任務或指令碼，直接看 non-interactive mode、GitHub Action 和 CI/CD auth，不要把互動式 prompt 硬塞進無人值守環境。

## 新手常見坑

- 一次裝太多入口，哪個都沒跑通。
- 用 Cloud 處理必須依賴本機金鑰和本機狀態的任務。
- 用 CLI 做需要大量視覺化 review 的任務。
- 用 App automations 處理還沒手動驗證過的 prompt。
- 忽略入口背後的執行環境：本機、雲端、遠端、worktree 的檔案狀態可能不同。

## 怎麼驗收入口選對了

- 能說清 Codex 在哪裡讀檔案、在哪裡執行命令、在哪裡產生 diff。
- 能在該入口裡完成一次只讀理解專案任務。
- 能完成一個小改動，並找到 diff 和驗證結果。
- 能知道任務失敗時該查本地環境、IDE 整合、App 設定、Cloud 環境還是 CI runner。

## 配套從原理到實戰

- [App、IDE、CLI、Cloud 怎麼選](/zh-Hant/docs/codex/understanding/cli-app-ide-cloud)

## 接下來去哪

<Cards>
  <Card title="CLI 功能" description="先理解終端入口能做什麼，再決定是否進入非互動任務。" href="/zh-Hant/docs/codex/official/01-products/26-cli-features" />
  <Card title="IDE 功能" description="檢視編輯器裡可用的上下文、命令、審查和互動方式。" href="/zh-Hant/docs/codex/official/01-products/21-ide-features" />
  <Card title="Codex App 核心" description="理解桌面 App 的任務面板、review、automation 和多專案工作流。" href="/zh-Hant/docs/codex/official/01-products/33-app-core" />
  <Card title="非互動任務" description="把人工對話改成可指令碼化、可記錄、可失敗處理的 codex exec 流程。" href="/zh-Hant/docs/codex/official/01-products/28-non-interactive" />
</Cards>

## 官方資料

- [Codex CLI features](https://developers.openai.com/codex/cli/features)
- [Codex App features](https://developers.openai.com/codex/app/features)
- [Codex IDE extension](https://developers.openai.com/codex/ide)
- [Codex Web environments](https://developers.openai.com/codex/cloud/environments)
