Codex CLI 安裝現在比早期簡單很多。macOS、Linux 和 Windows 都有官方獨立安裝器，不一定要先裝 Node.js，也可以直接用 ChatGPT 帳號登入。這篇會從安裝、登入、第一次進入專案一路講到常用指令，並補上我實際遇到的 stdin is not a terminal 排除方法。
Codex CLI 不是單純幫你補幾行程式碼。它會在你指定的專案目錄裡讀檔案、修改程式、執行測試、檢查 Git diff，所以安裝完成後，第一件事不是叫它重寫整個專案，而是先確認目錄、權限與版本控制。
Codex CLI 是什麼？適合拿來做什麼？
Codex CLI 是 OpenAI 推出的本機終端機 coding agent。你可以直接用中文描述任務，讓它閱讀專案、找錯誤、修改檔案、執行指令與測試，再把修改結果整理給你確認。
- 快速理解陌生的程式碼專案。
- 修正錯誤並執行相關測試。
- 開發 WordPress 外掛、PHP、JavaScript 或前端功能。
- 檢查 Git diff 與程式碼風險。
- 建立可重複執行的指令、工作流程與 CI 任務。
如果你想用圖形介面管理多個任務，可以接著看我的 Codex App GUI 功能整理；這篇先專心把 CLI 裝好。
安裝 Codex CLI 前要準備什麼？
使用官方獨立安裝器時，不需要先安裝 Node.js。你只需要一個可使用 Codex 的 ChatGPT 帳號、終端機，以及準備交給 Codex 操作的專案資料夾。各 ChatGPT 方案的可用額度不同，登入畫面會顯示你帳號目前可用的方式。
| 安裝方式 | 適合對象 | 是否需要 Node.js |
|---|---|---|
| 官方獨立安裝器 | 大多數 macOS、Linux、Windows 使用者 | 不用 |
| npm | 原本就有 Node.js 開發環境 | 需要 |
| Homebrew | 習慣用 brew 管理 macOS 工具 | 不用 |
macOS 與 Linux 安裝 Codex CLI
打開 Terminal，執行官方安裝指令：
curl -fsSL https://chatgpt.com/codex/install.sh | sh安裝完成後確認版本：
codex --version看到 codex-cli 與版本號就代表安裝成功。之後更新也可以直接執行：
codex updatemacOS 也可以用 Homebrew
brew install --cask codex如果你平常所有開發工具都交給 Homebrew 管理，這條路會比較順手。
Windows 安裝 Codex CLI
Windows 請開啟 PowerShell，執行官方安裝器：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"安裝後關閉並重新開啟 PowerShell，再確認版本：
codex --version一般 Windows 專案可以直接使用原生 CLI。若你的工作大量依賴 Ubuntu、Linux Shell、PHP CLI 或其他 Linux 工具鏈，再考慮 WSL2。更完整的環境差異與 Sandbox 說明，可以參考 Codex on Windows 完整教學。
已經有 Node.js？也能用 npm 安裝
如果電腦原本就有 Node.js 與 npm，也可以使用套件管理器：
npm install -g @openai/codex更新到最新版：
npm install -g @openai/codex@latest新手我會優先建議官方獨立安裝器，少一層 Node.js 版本與全域套件權限問題。npm 比較適合原本就熟悉 nvm、npm global path 的人。
第一次登入 Codex CLI
安裝後執行：
codex第一次啟動時選擇 Sign in with ChatGPT，瀏覽器會開啟登入與授權頁面。完成後回到終端機，就能使用 ChatGPT 方案提供的 Codex 額度，不需要另外建立 API Key。
也可以先單獨執行登入：
codex login
codex login status遠端主機沒有方便開啟瀏覽器時，可以改用：
codex login --device-authAPI Key 也是可用的登入方式，但 API 用量會走 API 帳務，和 ChatGPT 方案額度是兩套計算方式。一般個人使用先選 ChatGPT 登入最直覺。
如何在專案中開始使用 Codex CLI？
先切換到專案根目錄，再啟動 Codex：
cd ~/projects/my-project
git status
codex第一次不要直接叫它「幫我把整個網站做好」。先用一個範圍清楚的任務測試：
先閱讀這個專案，整理使用的技術、主要目錄、啟動方式與測試方式。
這一步先不要修改任何檔案。確認它理解專案後，再給可以驗證的工作：
找出聯絡表單送出失敗的原因，只修改相關檔案。
完成後執行測試，並列出修改檔案與驗證結果。AI 修改速度很快，更需要留下版本紀錄。建議搭配 GitHub 管理 vibe coding 程式碼，畫面功能則交給 Playwright 自動化測試驗證。
Codex CLI 新手最常用的指令
| 指令 | 用途 |
|---|---|
/init | 替目前專案建立 AGENTS.md 操作規範 |
/status | 查看模型、目錄、權限與工作階段狀態 |
/permissions | 調整 Codex 可讀寫與執行指令的範圍 |
/model | 選擇目前可用模型與推理強度 |
/review | 檢查修改內容與潛在問題 |
codex resume | 接續先前工作階段 |
codex exec "任務" | 非互動方式執行一次性任務 |
我最推薦先執行 /init，讓 Codex 根據專案建立 AGENTS.md。你可以在裡面寫清楚測試指令、程式風格、哪些檔案不能碰，以及完成任務前必須做哪些驗證。
出現 stdin is not a terminal 怎麼辦？
如果安裝畫面顯示以下訊息：
Codex CLI installed successfully.
Start Codex now? [y/N] y
Error: stdin is not a terminal這通常不是安裝失敗。因為安裝腳本透過 curl | sh 執行，腳本結束時的標準輸入仍是 pipe，不是真正可互動的終端機，所以無法直接開啟 Codex 介面。
回到終端機提示符後重新執行即可：
codex --version
codex若還是找不到指令，可以重新開啟終端機，或重新載入 Shell 設定：
# Bash
source ~/.bash_profile
# Zsh
source ~/.zshrc
hash -r
command -v codex其他常見安裝問題
輸入 codex 顯示 command not found
先重新開啟終端機，再用 command -v codex 檢查路徑。若安裝器已經把路徑寫入 .bash_profile 或 .zshrc，重新載入對應設定檔即可。
npm 安裝出現 EACCES 權限錯誤
不建議直接用 sudo npm install 硬壓過去。可以改用官方獨立安裝器，或使用 nvm 管理 Node.js，避免 npm 全域套件寫入系統目錄。
Codex 可以直接操作正式網站嗎？
技術上可以，但新手不應一開始就把正式站權限全部開放。先在 Git branch、測試站或本機環境工作，檢查 diff 與測試結果後再部署，會比讓 AI 直接在正式環境一路修改可靠很多。
我的建議：先學會控制，再追求全自動
Codex CLI 真正好用的地方，不只是它會寫程式，而是它能在你的開發工具旁邊完成讀檔、修改、測試與檢查。但這也代表你要知道它目前在哪個目錄、有哪些權限、改了哪些檔案，以及測試到底有沒有通過。
- 先用唯讀任務確認 Codex 理解專案。
- 一個任務只處理一個清楚範圍。
- 修改前後建立 Git 檢查點。
- 要求它執行測試並回報證據。
- 正式上線前由人檢查 diff 與關鍵流程。
常見問題 FAQ
Codex CLI 一定需要 API Key 嗎？
不一定。第一次執行 Codex 時可以選擇 Sign in with ChatGPT，使用帳號方案提供的 Codex 額度。API Key 主要適合需要走 API 帳務或自動化整合的情境。
安裝 Codex CLI 一定要先裝 Node.js 嗎？
不用。macOS、Linux 與 Windows 都有官方獨立安裝器。只有選擇 npm 安裝方式時，才需要先準備 Node.js 與 npm。
Codex CLI 支援哪些作業系統？
官方目前提供 macOS、Linux 與 Windows 安裝方式。Windows 可以直接使用 PowerShell 安裝器；需要 Linux 工具鏈時，也可以在 WSL2 裡使用。
stdin is not a terminal 代表安裝失敗嗎？
通常不是。這表示安裝腳本結束後嘗試直接啟動 Codex，但輸入仍來自 pipe。回到正常終端機提示符後重新執行 codex 即可。
第一次使用 Codex CLI 應該下什麼指令？
先請它只讀專案並整理技術架構、啟動方式與測試方式，不要立刻修改檔案。確認理解正確後，再交付範圍清楚、能執行測試驗證的小任務。
