Codex 安裝後不能用,最容易白忙一場的做法,就是刪掉重裝。看到錯誤時,我會先問:是找不到指令、不能登入,還是已經進到專案卻不能修改?這三種狀況走的排查路線完全不同。這篇處理的是「裝完之後卡住」,安裝步驟可以先看Codex CLI 安裝教學。
先分清楚:錯誤發生在哪一層?
| 看到的狀況 | 先檢查什麼 | 先不要做什麼 |
|---|---|---|
| command not found | 目前終端機是否找得到執行檔 | 反覆安裝不同來源的套件 |
| stdin is not a terminal | 是否從管線或沒有互動終端的環境啟動 | 刪掉登入資料 |
| 登入失敗或回呼卡住 | 帳號、瀏覽器回呼與公司網路限制 | 貼上完整驗證資訊求救 |
| 能聊天但不能修改 | 專案路徑與操作授權 | 直接取消所有安全限制 |
先保留完整錯誤訊息與版本,但回報前要遮掉 Token、信箱與使用者目錄。單看「不能用」沒辦法判斷問題;知道哪一層失敗,才知道下一步該查什麼。
command not found:先查 PATH 與執行檔
codex --version
# macOS / Linux
command -v codex
# Windows PowerShell
Get-Command codex
這裡是兩種作業系統的檢查方式,請挑適合自己的指令,不是整段全部執行。安裝程式如果修改了 PATH,先關掉終端機再開一次。macOS 使用 zsh、bash 時,載入的設定檔可能不同,看到安裝訊息寫進 .bash_profile,不代表目前的 zsh 一定讀得到。
如果電腦同時存在多份 Codex,先確認目前跑的是哪一份,再決定更新方式。不要為了解決 PATH 就把來源不明的安裝網址貼進終端機,也不要直接刪整個設定目錄。
stdin is not a terminal:安裝成功不等於啟動環境正確
這個錯誤表示互動程式沒有拿到它需要的終端輸入環境,不一定是 Codex 壞掉。例如安裝器透過管線執行,結束後又接著啟動互動介面,就可能遇到這類情況。先離開安裝流程,自己打開 Terminal 或 PowerShell,再執行:
codex
如果手動開啟能正常使用,就不需要重裝。真正要做無人值守的自動化,則應另行規劃非互動執行方式,不要把需要使用者操作的介面硬接到排程。程式能跑和自動化安全可控,是兩個驗收項目。
Codex 登入失敗,先確認用的是哪種帳號方式
codex login status
codex login
ChatGPT 登入與 API Key 是不同的授權及計費路徑。不要因為 API 能用,就認定訂閱帳號的登入一定正常。遠端主機沒有瀏覽器或 localhost 回呼受阻時,官方文件另提供裝置代碼登入:
codex login --device-auth
這個方式仍受帳號設定、工作區政策與版本支援限制;先用 codex login –help 確認選項。公司電腦若有 TLS 代理,應請管理人員確認信任憑證,不要用停用憑證驗證的方式跳過錯誤。登入代碼及憑證檔都不能貼到公開討論區。
能啟動卻不能改檔,不要直接開最大權限
先確認所在資料夾是不是目標專案,再確認作業系統檔案權限與 Codex 的授權提示。要求它先列出讀得到的檔案、解釋預計修改範圍,通常比直接要求「幫我修好全部」更容易找出卡點。
中央社 2026 年 9 月 10 日報導戴爾企業調查,安全、合規與隱私仍是擴大 AI 應用的限制之一。這是該調查的企業樣本,不是所有台灣使用者的故障統計,也不能拿來推論 Codex 本身不安全。查看中央社報導。
請先診斷,不修改設定。列出 Codex 版本、目前路徑、失敗步驟與可能原因。
不要輸出憑證,不刪除設定目錄,也不要提高權限。
回報時附上作業系統、安裝方式、版本、執行指令及遮罩後錯誤,通常已足夠。準備讓 AI 連接正式網站前,先看Codex 連接電腦的權限說明;如果卡在企業環境與網站流程,可以預約 AI 工作流程與網站導入諮詢。













