一步一步安裝 Codex
用「ChatGPT 桌面 App」就能開始

Codex 是 OpenAI 的 AI 編程助理，能讀你的檔案、幫你寫程式或改文件、還能自己動手執行指令。它有好幾種使用方式，這份只教最適合新手的一種：官方桌面 App。

為什麼選 App？因為它是圖形介面，全程用滑鼠點按就好，不需要打任何終端機指令。你只要會下載軟體、會用滑鼠，就能跟著做完。

補充：你可能會看到別人的畫面跟你不一樣

那是因為 Codex 除了桌面 App，還有終端機版、網頁版等好幾種介面。新手用桌面 App 就好，這一段看不看都不影響你安裝。

哪一種 ChatGPT 方案可以用？

官方在方案說明頁寫得很清楚：Codex 含在 Free、Go、Plus、Pro、Business、Edu、Enterprise 這幾種方案裡。也就是說，免費帳號名義上也能用，這點和很多同類工具不一樣。

下面幾個詞在教學裡會出現，看過有印象就好，遇到再回來查：

下面三個按鈕都是官方下載連結，選你的系統直接點。再提醒一次：你要下載的檔案叫 ChatGPT，不叫 Codex。

裝好、登入之後，你會看到這個畫面。先認得幾個位置就夠了，其他的用到再說。

圖上的紅色數字，對應下面兩張表。

左側：找東西的地方

下方：輸入框那一排（最重要）

ChatGPT 與 Codex：同一個 App 裡的兩個模式

點左上角的 Codex ⌄，就會看到這個 App 其實有兩種模式：

所以第 00 節那句話在這裡得到印證：你裝的 App 叫 ChatGPT，Codex 是它裡面的一個模式。確認左上角顯示 Codex，就是在對的地方了。

Codex 可以切換不同的模型。簡單講：越強的模型越慢、越吃你的用量額度，所以「永遠選最強的」並不是最好的用法。

推理強度：讓它想多久

模型與推理強度都在輸入框右下角，點一下就會展開一個滑桿：

官方給的原則只有一句話：在能得到你要的結果的前提下，用最低的那一檔就好。

告訴 Codex「要處理哪個資料夾」，是開工前最關鍵的一個動作。這個資料夾就是它的活動範圍，官方稱為 workspace（工作區）。

1. 點「新增專案」
   英文介面顯示的是 Add new project，或按 Ctrl ／ Cmd ＋ O，然後選一個資料夾。
2. 第一次請選測試資料夾
   建議先自己新建一個測試用的資料夾，裡面放幾個不重要的檔案。不要一開始就拿重要專案練手。
3. 先看下面「這些資料夾不要選」再決定
   選錯範圍是新手最容易出事的一步。
4. ✅ 怎麼知道加好了
   左側「專案」清單出現你剛加的資料夾名稱，就代表成功了。
5. 確認它的活動範圍
   在輸入框打 /status，看它回報什麼。這個指令桌面 App 與終端機版都有，但兩邊顯示的內容不一樣，詳見下方說明。

你只要記住一件事：送出訊息前，看一眼輸入框左下角是不是寫著「要求核准」。那是三檔裡最安全的一檔，也是官方建議新手用的。其他都不用動。

三檔權限模式，分別是什麼

點一下輸入框左下角的「要求核准」，就會展開這個選單：

選單裡有人三檔都在、有人只看到「要求核准」，兩種都正常，不用糾結。官方也沒有說明這個選擇會不會被記住，所以最保險的是每次送出前瞄一眼，只要一秒。
（官方文件說另外兩檔要先到 Settings ＞ General ＞ Permissions 打開，但本文 2026/09/11 測試的 26.908 版三檔就直接在選單裡。）

它什麼時候會問你、什麼時候不會

這是最多人搞錯的地方。以預設模式來說，界線就在「有沒有跨出你選的資料夾」：

它停下來問你的時候，長這樣

下面是實際觸發核准的畫面。任務是請它連線到 example.com 取得 HTTP 狀態碼，因為需要連網，它就停下來了：

寫下你的工作規則：AGENTS.md

AGENTS.md 是你寫給 Codex 的工作規則，它在每個對話開始時會先讀一次。

下面這份可以直接複製，貼進你的 AGENTS.md：

備份：最實際的一道保險

不管權限設定多嚴謹，動重要檔案前先備份永遠是對的。三個選擇，由簡到繁：

1. 最簡單
   把整個資料夾複製一份，改名加上日期。完全不用學新東西。
2. 進階
   用 Git 做版本控制，每次改動前先 commit。好消息是 Codex 預設動不了工作資料夾最上層的 .git（見第 05 節）；但如果你一次加進來的是含多個子專案的母資料夾，子專案各自的 .git 不在保護名單內，備份還是要做。
3. 雲端
   iCloud、Google Drive、Dropbox 這類有版本歷史的同步服務，救得回前幾個版本。

補充：Git 是裝在你電腦上的版本控制工具，離線就能用、不用註冊；GitHub 是放程式碼的網站，需要帳號。這份教學全程不需要 GitHub 帳號。

日常你會反覆用到的操作大概就這幾個，記住前三個就能開始工作了。

⚠️ 資料夾是「開對話時」綁定的。/project 官方定義是「為新對話選擇專案」，在對話進行中打它，設定的是你接下來新開的對話，不會把目前這個對話搬過去。想換資料夾就選好專案再開新對話。（/local 也不是用來換資料夾的，它跟 /cloud、/worktree 同一組。）

⭐ 變更檢視面板：看它改了什麼、把它改回來

這是全篇最該學會的一個功能。它讓你看到 Codex 動了哪些地方，而且可以一鍵還原。

⚠️ 這個面板需要專案在 Git 儲存庫裡。官方明說變更檢視面板與 /review 指令都只有在專案位於 Git 儲存庫內時才會出現；如果還不是，App 會提示你建立一個。Windows 使用者需要先裝 Git（見第 11 節）。官方只提供上面那組快捷鍵，沒說按鈕在畫面哪個位置，請以你的畫面為準。

這一節只有一個重點：不要打開 Full access。

什麼情況下你可能會不小心開到它

• 在設定裡好奇把它打開，之後就在輸入框下方的選單選到了。
• 看到某些教學說「這樣比較不會被打斷」，就照做了。

如果你已經開了：回到 Settings ＞ General ＞ Permissions 把它關掉，選單裡就不會再出現這個選項。

另外提醒：有些舊文章會叫你在設定檔寫 approval_policy = "untrusted"。官方已經不支援這個值，留著有可能導致 App 開不起來，看到就刪掉。（只有這個值被停用；trust_level = "untrusted" 那種寫法官方仍支援，不用跟著刪。）

⭐ 我的檔案會不會被送到 OpenAI？

這是最多人想問、但很多教學避而不談的一題。答案是：會。而且官方講得很直接。

官方在本機安全說明裡寫得毫不含糊：

「本機檔案可以留在裝置上，但相關的檔案片段、提示詞、螢幕截圖、瀏覽器內容或工具執行結果，可能會被送到 OpenAI 的服務以完成任務。本機執行不等於離線，也不等於只在裝置上做模型運算。」（出自官方「ChatGPT Work 本機安全」說明頁）

其他值得留意的三件事

把最容易踩的坑一次講完。看過一遍，遇到的時候就知道那是正常的。

1. 找不到「Codex App」是正常的
   你要找的是 ChatGPT App。這件事第 00 節講過，但它實在太常見了，所以再提一次。
2. Intel Mac 要自己去選單裡挑
   官方下載頁那顆大按鈕給的是 Apple Silicon 版。Intel 機種請點按鈕旁邊的箭頭，展開 Choose another ChatGPT download 選單，選 macOS (Intel)，不要直接按大按鈕。
3. 它在你的資料夾裡改檔案、執行指令都不會問你
   這是設計如此，不是出錯。執行指令包含會刪除、覆蓋檔案的指令，所以選對資料夾才是關鍵的那道防線，重要資料夾請先複製一份備份。
4. 用量是以「五小時」為一個區間計算的
   另外可能還有每週上限。官方給的數字是估計範圍，不是固定的訊息則數，實際會因模型、任務大小、脈絡長度差很多。要看剩多少，打 /status 或去官方的用量儀表板。
5. 碰到上限時，換小模型是「比較省」，不是「補血」
   官方的說法是切到小模型可以讓額度撐久一點，不是讓已經用掉的額度回來。這兩件事差很多。
6. 圖片生成特別吃額度
   官方的說法是：平均而言，比「同樣一輪但沒有生圖」的對話快 3 到 5 倍消耗掉額度，實際依圖片品質與尺寸而不同。
   ⚠️ 這不等於「生一張圖 = 用掉 3 到 5 則訊息」，官方沒有這樣說。
7. AGENTS.md 超過 32 KiB 會被截斷
   而且越大越吃用量。寫重點就好。
8. 任務可能會被安全監控中途暫停
   使用 GPT-6 Astra 時，官方有一套非同步的安全監控，偵測到疑似不安全的行為會暫停任務，而且暫停可能在觸發它的動作發生之後才出現。看到暫停通知，先讀完再決定要不要繼續。（在終端機版和手機上，遇到這種暫停是直接結束任務，沒有續跑選項。）
9. 版本號有兩套，不要搞混
   桌面 App 的版本號長得像 26.908.31748，終端機版長得像 0.153.4。看別人的教學時，先確認對方講的是哪一個。
10. 網頁版的斜線指令跟 App 不一樣
    官方明說網頁版有自己的一套選單，App 和終端機版的指令不適用於網頁版。

在輸入框打一個 /，就會跳出可用指令的清單。不用背，先記下面五個就夠用了。

以上內容更新至 2026/09/12 的版本。Codex 改版很頻繁，指令的名稱、數量與行為都可能調整，也會依你的方案略有不同。一律以你在輸入框打 / 實際跳出來的清單為準；找不到某個指令、或看到清單上多了新指令，都是正常的。

Mac 使用者：什麼都不用裝

好消息：macOS 上的沙箱是用系統內建的機制（官方稱為 Seatbelt）運作的，開箱即用，不用另外安裝任何東西。

Windows 使用者：幾個建議安裝的工具

Windows 上 Codex 預設是用系統原生的方式執行（走 PowerShell，那是 Windows 內建的一個黑底輸入視窗，按開始鍵打 powershell 就找得到），不需要 WSL。

官方說，先裝好幾個常見的開發工具，Codex 會運作得更好：

官方給的安裝指令，在 PowerShell 裡執行：

裝完 GitHub CLI 後，要再執行 gh auth login，App 裡的 GitHub 功能才會啟用。

常見卡關：PowerShell 說「不能執行指令碼」

如果你在 Windows 上看到類似這樣的錯誤訊息：

這是 PowerShell 的執行原則擋住了。那是 Windows 的一道安全設定，用來決定「哪些指令稿可以執行」。官方給的常見解法是把它改成 RemoteSigned：

這行指令是什麼意思：允許執行你自己電腦上的指令稿，以及有數位簽章的網路指令稿。沒簽章的網路指令稿仍然會被擋。

進階：也可以裝終端機版（Codex CLI）

到這裡你已經有了：一個裝好的 App、一個登入的帳號、一個選好的資料夾，以及對權限的基本理解。剩下的就是開始用。

不寫程式的人，可以拿它來做什麼？

這篇教學的例子多半跟程式有關（官方對 Codex 的定位就是「建置、偵錯與發布」），但它處理的其實是你電腦裡的檔案，所以不寫程式一樣用得上。三個實際的例子：

1. 建一個測試資料夾
   隨便放幾個不重要的檔案，例如幾份筆記、一份 CSV。
2. 加成專案
   在 Codex 裡點 Add project，選這個資料夾。
3. 確認權限
   看一眼輸入框下方，確認顯示 Ask for approval。
4. 問它第一個問題
   打字問：「這個資料夾裡有什麼？幫我整理一份清單。」
5. 觀察它怎麼做
   看它執行了哪些指令、在什麼時候停下來問你。這一步比前面四步都重要，你會真正理解它的邊界在哪。