macOS CLI 安裝與排錯

返回 Codex 教學總目錄

目標與準備

按 Command＋Space 開 Spotlight，搜尋 Terminal 並開啟。視窗尾端通常顯示提示符號；把安裝指令貼在這裡，不是 ChatGPT 或 Codex 對話方塊。你只需一個可寫入的新練習資料夾和可登入的帳號；獨立安裝版不要求先裝 npm。圖中 1 是確認安裝來源，2 是啟動正確工作目錄，3 是比對檔案。

步驟一：先查有沒有已安裝的 CLI

command -v codex
type -a codex

在 Terminal 逐行執行。command -v 用來看目前 shell 會選哪個 codex；type -a 協助發現多個來源或同名 alias／function。沒有安裝時可能沒有路徑或顯示找不到，先不要接著執行模型任務。若已找到，跑 codex --version，記錄版本及原安裝管道，再跳到建立練習資料夾；不要為了跟文章一致而重灌。

官方獨立安裝路線

需要新裝時，從文末官方 CLI 頁核對下列命令。它會下載官方安裝指令碼並交給 sh 執行，因此先確認來源，等待完成後閱讀安裝位置與 PATH 提示。出現連線或憑證錯誤時保留原訊息，先解決網路或受管理憑證，不要把網址換成陌生映象或略過 TLS 檢查。

curl -fsSL https://chatgpt.com/codex/install.sh | sh

結束後開新的 Terminal 視窗，重新執行 command -v codex、codex --version 和 codex --help。前者指向已確認的安裝，後兩者顯示版本與說明，才算可以進到下一步。Terminal 內成功不代表你先前已開啟的編輯器也立即取得新環境；若 IDE 終端機仍找不到，完整退出編輯器再開啟，用相同命令比較。

已使用 Homebrew 或 npm 時

已用 Homebrew 管理工具的人可以選下面的 cask 路線，先跑 brew --version 確認 brew 可用，再安裝。未裝 Homebrew 的新手可直接使用上一段獨立版，不必為了 Codex 多裝一套管理工具。官方命令使用 --cask，請保留它；更新時也要使用相同 cask 管道。

brew --version
brew install --cask codex

已具備 Node.js 與 npm，且想沿用 npm 的讀者，先確認 node --version、npm --version，再用 npm install -g @openai/codex。若 npm 回報 EACCES，先檢查目前 Node.js 管理方式和 npm 全域目錄擁有者；不要直接在所有命令前加 sudo。若改選獨立版，先記錄原來源並檢查重複命令，避免之後更新到另一份。

步驟二：建立、定位與備份練習檔

在 Finder 選一個自己可寫入的位置，建立全新的 codex mac lab 資料夾。用純文字編輯器建立 note.txt，只有 MAC-CLI-01 一行，再另存 note.original.txt。若用 TextEdit，選「格式 > 製作純文字」（Format > Make Plain Text），存檔時核對名稱與 .txt 副檔名；按住 Option 再選「檔案 > 另存新檔」（File > Save As）可儲存原始副本；不要把 RTF 檔案只改名成 .txt。已有同名資料夾時另取新名稱，保留舊練習。

在 Terminal 先輸入 cd 和一個空格，再把 Finder 的練習資料夾拖進視窗，確認產生的是它的路徑後按 Return。這樣可使用自己的真實路徑，不需猜使用者名稱。也可以自行輸入 cd 加上引號括住的完整路徑。先執行 pwd 與 ls，再讀檔；看到 RTF 控制字元或多出 .txt.txt 時回編輯器修正，不能繼續假定資料正確。

pwd
ls
cat note.txt
shasum -a 256 note.txt note.original.txt

預期目前目錄是你的練習資料夾，有兩個文字檔，內容為 MAC-CLI-01。兩份檔案的 SHA-256 應相同；若不同，先查是否多了空格、不同換行或編碼，不要叫 Codex 猜哪一份才正確。記錄本機算出的值即可，本文不提供固定雜湊，因為不同編輯器的換行可能不同。

步驟三：登入與唯讀任務

codex login
codex login status
codex --sandbox read-only

逐行執行並等待完成。瀏覽器登入確認帳號和工作區，回到 Terminal 看 login 是否結束，再查 status。若系統有憑證儲存確認，先核對是此次 Codex 登入；不要把認證檔內容放進需求或截圖。帳號限制與 API 計費差異見帳號教學。第三行啟動後，以下自然語言才貼進 Codex。

Inspect note.txt and note.original.txt in the current folder. Report the current directory, exact content of each file, and whether they match. Do not edit files or use external services. If the folder or files are wrong, stop and report the mismatch.

檢查回覆有無 MAC-CLI-01、兩個檔名和正確路徑，並看讀檔工具記錄。用 /exit 回到 Terminal，重跑 cat 和 shasum，確認前後內容、雜湊和檔案數量未變。若 Terminal 自己讀得到、Codex 讀不到，記錄沙盒訊息再查權限；這是不同執行範圍，不是檔案突然消失。

補做一次缺檔與恢復練習

確認已回到 Terminal 的系統提示符號；若仍在 Codex 內才輸入 /exit。接著用 Finder 把練習副本的 note.original.txt 暫改名為 note.reference.txt；已有後者時先停止，避免覆蓋。在同一個練習資料夾執行 codex --sandbox read-only 重新啟動，再送出同一個讀檔提示詞。預期它能讀 note.txt，卻明確回報 note.original.txt 不存在，不能憑另一份內容宣稱兩份已比對。結束後退出，把檔名恢復成 note.original.txt，再以 cat、ls、shasum 重驗；兩份檔案應回到原來的相同雜湊。這一步只改練習檔名，不更動登入或 shell 設定。

步驟四：重開終端機仍然有效

關閉 Terminal 視窗再開啟，先查 command -v codex 和版本，再重新 cd 進練習資料夾，執行 codex resume 並核對剛才那筆任務的目錄與時間。新 shell 不一定從上一個工作目錄開始；找不到 note.txt 時先看 pwd，不要重新建立另一份同名檔案。接續對話不會自動把 Finder 的位置、終端機位置或檔案內容都恢復。

若新視窗才找不到 CLI，通常要查 shell 啟動環境：把安裝程式最後的 PATH 說明和 command -v 結果對照。只修改自己實際使用的 shell 設定檔，先備份原檔並保留原 PATH。不要把網路上的固定 /opt/homebrew 或 /usr/local 路徑當成每臺 Mac 都適用，也不要同時把設定複製進多個啟動檔來碰運氣。

更新與錯誤對照

先退出工作階段並儲存摘要，更新完成才重新啟動。若更新後版本沒變，先用 type -a 查重複來源。若已能顯示 help，卻無法登入，安裝通常已過第一關，應記錄瀏覽器回呼、帳號或網路錯誤；若只在特定資料夾失敗，則比較該資料夾的存取權限與目前位置。把不同層級的問題分開，才能知道下一個修正會驗證什麼。

完成後回CLI 共用入門練習指定一行的修改與還原，或進常用指令瞭解斜線指令和工作階段。不必完成 Windows 篇才能學本篇；也不要用 Windows 路徑或 PowerShell 命令替代 macOS 操作。保留自己的版本、安裝來源、前後雜湊與錯誤紀錄，才是這次安裝可重現的交付。

返回 Codex 教學總目錄

閱讀完整文字說明

Three numbered stages: identify the starting point, perform the exercise, and verify the result. Original illustration, not a product screenshot.

• AI 工具
• 教學
• Codex