在 Codex 上安裝並登入，把 AI 跑起來

這一卷處理各平台的安裝與設定。先下載 App、登入帳號、跑完 onboarding；CLI 只要設定到能登入，之後才拿來做跨平台調用。

30分鐘內完成 App、登入與第一次測試

1先設定 Codex，不同時碰三套工具

5App、CLI、登入、onboarding、權限

先把工具裝到能跑

setup path

這一卷不教你寫任務卡，也不急著做產品。目標只有一個：讓你選的 AI 工具在你的電腦上可以登入、可以讀資料夾、可以建立檔案、可以請你確認命令。

這一卷的完成標準很簡單：你可以打開你選的 AI 工具，登入自己的帳號，讓它在一個安全的測試資料夾裡讀檔、建立檔案，並在需要動到電腦時向你詢問確認。

先不要把真專案丟進去，也不要急著開自動權限。第 01 卷只是在你的電腦上建好入口，讓第 02 卷開始能把「一句聊天需求」變成 agent 接得住的任務。

鍵盤快捷鍵

本課的快捷鍵以 Mac 為主。Windows 使用者：把 Cmd 換成 Ctrl（例如 Cmd+N 就是 Ctrl+N）、Option 換成 Alt；其他像 Ctrl+C、Esc 兩邊一樣。內文的快捷鍵滑上去也會顯示 Windows 對照。

先搞清楚兩個入口

如果你平常已經在用 ChatGPT，這一卷可以走 Codex。第一件事不是打指令，而是先認識兩個入口：桌面 App 是主入口，CLI 是輔助入口，兩者共用同一個 ChatGPT 帳號。

產品入口：Codex 官方頁。先從這裡認識 Codex 的定位，不用一開始就鑽進終端。

帳號提醒

Codex 已包含在 ChatGPT 各方案裡，免費版、Go、Plus、Pro、Business、Enterprise 都能用，直接用你平常的 ChatGPT 帳號登入就好，不用另外付費或申請。免費版就能先上手；付費方案（Plus 每月 20 美元起）給你更多用量、更快的模型。

Windows：到 Codex 官網或 Microsoft Store 下載桌面 App。
macOS：先裝好 CLI，再用一行指令把桌面 App 抓下來（下一步會做）。
Linux 或手機：沒有原生桌面 App，直接用 CLI。

下載並打開 Codex App

這一卷以桌面 App 為主。先把 App 裝起來、能打開、看得到主畫面，這一步就完成了。

Windows：到 Codex 官網或 Microsoft Store 下載安裝，打開後用 ChatGPT 帳號登入。
macOS：到官網下載安裝；已經在用終端的人，也可以裝好 CLI 後輸入 codex app 讓它自動把 App 抓下來。
Linux 或手機：沒有原生桌面 App，改用 CLI 或雲端網頁版。

想用終端的人（選用）

之後想用終端、或做跨工具調用，可以另外裝 CLI：npm install -g @openai/codex（或 brew install codex；Windows 建議在 WSL2 裡裝）。裝好用 codex --version 檢查、codex login 登入。新手先用 App 就好，這一段可以先跳過。

用 ChatGPT 帳號登入

App 和 CLI 都用同一個 ChatGPT 帳號登入，額度、權限與工作紀錄才不會搞混。先選你現在要走的入口，看對應分頁即可。

打開 Codex App，用你平常登入 ChatGPT 的帳號授權。登入後會看到三欄畫面：左邊是對話列表、中間是對話、右邊是檔案變更，這就是 App 端的 agent 入口。

Codex 開始使用畫面，中央有「使用 ChatGPT 登入」按鈕 — codex appsign in

Codex App 主畫面，標出輸入框、專案、本機作業、模型四個位置 — main screencodex app

登入用的是 ChatGPT 帳號（瀏覽器授權），不需要另外申請工程帳號或金鑰。Codex 已包含在 ChatGPT 各方案裡，免費版就能登入開始用；要更多用量再升級方案。

開一個安全資料夾，先讀先回報

第一次用 Codex，不要直接丟到重要專案。先準備一個乾淨的測試資料夾（在桌面新增一個空資料夾、放一兩個測試檔就行），讓它練習讀取、回報、提計畫。熟悉它怎麼要求權限，再讓它進更重要的資料夾。

在 Codex App 裡，先選這個測試資料夾當工作目錄，並確認左下角的模式是「在本機運作」，代表它只在你這台電腦、你選的資料夾裡做事，不會跑到雲端。

Codex 開始模式選單，箭頭指向「在本機運作」 — start modelocal first

接著在中間的輸入框交代第一個任務。第一次不要叫它改任何檔案，只讓它讀資料夾、回報理解、提出下一步計畫。

在輸入框貼給 Codex 的第一個任務

請先閱讀目前資料夾，回報你理解的內容。請先不要修改任何檔案。請回報： 1. 這個資料夾看起來是做什麼的 2. 你建議第一個低風險任務是什麼 3. 如果要執行，你需要哪些權限 4. 哪些地方你不確定，需要我補充

Codex 預設拿到指令會直接開始做，不會先停下來問你。所以第一次更要把話講白：先不要改檔、先回報計畫，把節奏拉回「先理解、再計畫、再執行」。

想用終端的人（選用）

習慣終端的人，也可以在測試資料夾裡輸入 codex 開啟同樣的互動介面。App 和 CLI 做的是同一件事，新手先用 App 即可。

設定核准方式，先保守

權限是 Codex 從聊天工具變成 agent 工作台的分水嶺。在 App 裡，點輸入框上方那顆會顯示目前權限的核准按鈕，會看到三種核准方式：

Codex 核准操作選單，三種模式：要求核准、代我核准、完整存取權 — approvalpermissions

要求核准每次要編輯外部檔案或連網，都先問過你。新手先用這個。

代我核准只有偵測到可能不安全時才問你，其餘它自己做。熟一點再用。

完整存取權不再攔你，網路和整台電腦的檔案都能動。只在你很確定環境安全時才開。

Windows 安全提醒

Windows 用戶絕對不要選「完整存取權」。Windows 沒有原生沙盒，發生過誤刪整台電腦檔案、而且救不回來的真實事故。需要更高權限就改用 WSL2 或雲端；不可逆的操作前先備份。

可以放行：讀測試資料夾、建立測試檔、查看資料夾內容。
要它先問你：安裝套件、寫入設定檔、連網、操作外部工具。
先別開：在重要資料夾、或 Windows 上選「完整存取權」。

你不是永遠不能放寬，而是先建立安全場地與回報節奏，再放手。之後想調整，隨時回到這顆核准按鈕切換。

想用終端的人（選用）

CLI 把權限拆成兩個旗標：--sandbox（能寫到哪：read-only／workspace-write／full-access）和 --ask-for-approval（何時問你）。日常用 codex --full-auto，只讀用 codex --sandbox read-only，會話中用 /permissions 切換。

認得模型、用量與喊停

最後認幾個每天會用到的操作，全部在 App 主畫面點得到：

資料夾與模式左下角顯示目前在哪個資料夾、哪個模式（在本機運作），別誤開到真專案。

模型與推理點右下角的模型按鈕，可以切模型和推理程度（低／中／高／超高）。先用預設就好。

剩餘用量從「本機作業」選單點「剩餘用量」，可以看 5 小時、1 週各還剩多少。任務跑不動時，先看是不是額度快用完。

Codex 模型與推理選單：推理低／中／高／超高，GPT-5.5 — modelreasoning

Codex 剩餘用量：5 小時 98%、1 週 42% — usagequota

兩件常用的事：要 Codex 停下正在做的事，按畫面上的停止（終端裡是 Ctrl+C）；想接回之前的對話，從左邊的對話列表點回去就好。

想用終端的人（選用）

CLI 裡：/model 切模型、/status 看用量、對話太長用 /compact 壓縮或 /clear 開新的、下次用 codex resume --last 接回上一次。

完成標準

你已經能用 ChatGPT 帳號登入 Codex App、在測試資料夾裡讓它讀檔並回報、看得懂三種核准方式，也知道模型、剩餘用量和「怎麼喊停」在哪裡點。到這裡，第 01 卷的 Codex 路線就完成了。

進第 02 卷前，確認三件事

ready check

完成這三件事，下一卷才開始把聊天需求改成任務卡。這裡不追求完美設定，只要你選的工具能安全地讀資料夾、改測試檔、回報結果，並知道權限、模型、額度要去哪裡看。

我已安裝 App，並完成帳號登入

能打開桌面 App，帳號狀態正常；CLI 可選，但建議至少驗一次版本。

required

我知道 CLI 是跨平台調用入口

CLI 只要設定到能登入即可；如果現在只用 App，也要知道後面做跨平台調用時會補 CLI。

required

我完成第一次安全測試，並看懂基本介面

確認在本機工作、選好測試資料夾，讓工具建立一個小檔案，並知道權限、模型、額度在哪裡看。

next tape

第 02 卷：把聊天改成任務交接

下一卷開始，你會把「幫我看看」改成 agent 接得住的任務卡：目標、背景、限制、交付物、驗證方式。

前往第 02 卷