產品入口
基於官方 Codex 產品教程，幫新手分清 CLI、IDE、App、Web、Windows 和自動化入口各自適合什麼任務。
這一章不是安裝清單，而是入口選擇手冊。先判斷任務發生在哪裡，再決定用 CLI、IDE、App、Cloud、Windows 還是自動化入口。
Codex 有多個產品入口：CLI、桌面 App、Web / Cloud、IDE 擴充套件、Windows 入口，以及 Worktrees、App Server、Automations、Computer Use 等配套能力。新手不要按“哪個功能最多”選擇，而要按執行位置、審查方式和許可權邊界選擇。
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]按任務選入口
終端和指令碼
本地儲存庫、命令列工作流、codex exec、CI 前置實驗，優先從 CLI 開始。
編輯器現場
邊讀程式碼邊改區域性檔案，優先看 IDE 安裝、功能、設定和命令。
多工視覺化
需要 review、worktree、automations、內建瀏覽器和任務面板，優先看 Codex App。
非同步遠端任務
長任務、雲端執行、GitHub 觸發或不佔用本機資源，進入 Cloud / Web 章節。
Windows 環境
在 Windows 上使用 Codex 時，重點檢查 shell、路徑、sandbox 和許可權差異。
自動化與工作樹
需要定時、並行、可回復分支或 app server，再看 Automations、Worktrees 和 App Server。
章節速查
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。
配套從原理到實戰
接下來去哪
CLI 功能
先理解終端入口能做什麼，再決定是否進入非互動任務。
IDE 功能
檢視編輯器裡可用的上下文、命令、審查和互動方式。
Codex App 核心
理解桌面 App 的任務面板、review、automation 和多專案工作流。
非互動任務
把人工對話改成可指令碼化、可記錄、可失敗處理的 codex exec 流程。