交流群即將上線
01 · Codex 到底是什麼
一句話：會自己動手的編碼智慧體
Codex 不是「更聰明的自動補全」。它讀你的倉庫、改檔案、跑指令、看結果，然後決定下一步。 你給的是目標，它交回來的是一堆改動加一段說明，你的活變成審這些改動。
這個差別決定了後面所有事情。補全工具最壞的結果是補錯一行，你按 Esc 就沒了； 智慧體最壞的結果是它在你沒提交的目錄裡跑了一條你沒看清的指令。 所以官方文件把「沙盒和核准」放在很靠前的位置， 這本手冊也一樣——04 · 核准與沙盒 建議早點讀。
Codex 和 ChatGPT 是什麼關係
同一個產品家族裡的三種工作方式，在桌面應用和網頁版裡靠頂部的切換器切換：
| 選擇 | 適用場景 | 典型例子 |
|---|---|---|
| 聊天 | 問問題、來回討論 | 搜網頁、比方案、起草訊息 |
| ChatGPT Work | 要一份能審的成品 | 做簡報、分析檔案、起草報告 |
| Codex | 要開發者檢視和技術細節 | 除錯、跑測試、審 PR、實現功能 |
寫程式碼就選 Codex。它給你 diff、指令輸出、測試結果這些你需要核對的東西， 而不是把過程藏起來只給結論。
五個入口，選哪個
Codex 有好幾個介面，跑的是同一套東西，區別在於你人在哪裡、改動落在哪裡。
Codex CLI —— 終端
bash
codex在專案目錄裡敲一下就進去了。適合你本來就在終端裡幹活的時候：探索倉庫、改程式碼、跑本地工具。 它也是唯一能直接進指令碼和 CI 的形態（codex exec，見 04 · 雲端、CI 與非互動模式）。
這本手冊的例子預設用 CLI，因為指令列的行為最容易寫清楚、也最容易復現。
Codex IDE 擴充功能 —— 編輯器裡
在 VS Code 一類編輯器裡，讓 Codex 在程式碼旁邊跟你一起改。 好處是 diff 就在你平時看程式碼的地方，不用來回切視窗。 子智慧體在跑的時候，後臺面板會顯示每個執行緒的狀態。
ChatGPT 桌面應用 —— 專案和長任務
macOS、Windows、Linux 都有。適合同時管幾個專案、任務要跑很久、 或者你需要它順手處理本地檔案的場景。開 Codex 聊天時要先選執行位置：
- 本地：直接在當前專案目錄裡改。
- 工作樹：改動隔離在一個 Git 工作樹裡，不碰你正在編輯的分支（瞭解工作樹）。
- 雲端：在配好的雲端環境裡遠端跑。
前兩種都在你自己電腦上跑。
網頁版 ChatGPT —— 手邊沒有開發環境時
瀏覽器裡就能用，包括聊天和 ChatGPT Work。寫程式碼不如前三個順手， 但臨時要看點東西、或者電腦不在手邊的時候夠用。
Codex 雲端 —— 讓它自己跑一會兒
任務扔到 OpenAI 託管的隔離容器裡跑，跑完你回來看結果。 雲端環境是兩階段的：設定階段能聯網裝依賴，智慧體階段預設離線， 除非你專門為這個環境開了網際網路存取。給雲端環境配的金鑰只在設定階段可用， 進智慧體階段之前就被移除了。
怎麼選
- 改自己電腦上的倉庫 → CLI 或 IDE 擴充功能，看你習慣待在哪。
- 同時管幾個專案 / 任務要跑很久 → 桌面應用。
- 不想讓它碰你正在改的分支 → 桌面應用的「工作樹」模式。
- 要掛在流水線裡自動跑 →
codex exec或 GitHub Action。 - 只是想看看它能幹什麼 → 網頁版最省事。
別在錯的地方使勁
最常見的浪費是在網頁版裡貼一大段程式碼，讓它猜專案結構。 本地的 CLI 和 IDE 擴充功能能直接讀你的倉庫，省掉這一整輪來回。
下一步
02 · 裝在哪、怎麼登入：四種裝法挑一種，五分鐘裝完。