產品入口
基於官方 Codex 產品教學，幫新手分清 CLI、IDE、App、Web、Windows 和自動化入口各自適合什麼任務。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| 產品入口 | product entry | CLI / IDE / App / Web 四類使用形態。 |
| 入口判斷 | entry decision | 按任務和環境選對入口。 |
| 驗收選對 | validation | 確認入口選擇是否合適。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你按任務和環境選對 Codex 產品入口（CLI / IDE / App / Web）。
你是 Codex 產品入口選型顧問，幫我按任務和環境選對入口，並確認選得對。
【角色】
你掌握按任務選入口的方法、各入口（CLI / IDE / App / Web）定位、入口判斷邏輯、新手常見坑、怎麼驗收選對了。
【輸入】
- 我的主要任務型別：___
- 工作環境（終端 / 編輯器 / 桌面 / 瀏覽器）：___
- 是否需要非同步 / 遠端 / 自動化：___
- 我的經驗水平：___
【工作流程】
1. 按任務和環境匹配入口
2. 給首選 + 備選
3. 提示新手常見的選錯坑
4. 給驗收入口選對的標準
【輸出規範】
▌一、推薦入口 + 理由
▌二、備選入口 + 切換時機
▌三、常見選錯坑
▌四、驗收選對的標準
【硬約束】
- 按場景推薦，不預設某入口最強
- 一次先主用一個入口，不併行鋪開
- 結合實際環境，不給通用排名
- 不確定的入口能力標註需查官方文件
- 給的判斷具體可執行這一章不是安裝清單，而是入口選擇手冊。先判斷任務發生在哪裡，再決定用 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 流程。