在 macOS、Linux 與 Windows 安裝 Codex CLI

安裝 Codex CLI、驗證可執行檔、登入，並在專案目錄中從小型任務開始。 官方安裝程式目前涵蓋 macOS、Linux 與 Windows；npm 和 Homebrew 仍是替代方案。請在下方選擇一種途徑。可正常運作的安裝是第一步；帳戶存取與 API 計費是分開的選擇。

1. 選擇一種安裝方式

這些指令來自官方 Codex CLI 安裝指南。請使用您將執行代理程式的環境所適用的安裝程式。安裝 Windows 可執行檔不會在 WSL 內另外安裝 Linux 副本，而在筆記型電腦上安裝，也不會在您之後連線的遠端伺服器上安裝。

macOS 或 Linux：官方獨立安裝程式

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

Windows：官方獨立安裝程式

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

如果您已使用套件管理器管理開發工具，請使用其替代方案，而不要同時執行兩種安裝程式：

方式	安裝	更新
npm	`npm install -g @openai/codex`	`npm install -g @openai/codex`
Homebrew	`brew install --cask codex`	`brew upgrade --cask codex`
獨立安裝程式	執行適用於您作業系統的安裝程式	再次執行相同的安裝程式

npm 途徑需要可正常運作的 npm 安裝；請先檢查 npm --version。如果您不需要 Node 工具，獨立安裝程式會很實用。在受管理的裝置上，請使用管理員支援的安裝方式，讓後續更新保持可預測。

2. 驗證實際執行的可執行檔

如果找不到指令，請在安裝後啟動新的終端機。在 macOS 或 Linux 上，command -v codex會顯示 shell 選取的可執行檔。在 PowerShell 中，請使用Get-Command codex。重新安裝前，請將該路徑與您選擇的安裝方式比對。安裝兩個副本可能導致您更新其中一個，卻持續啟動另一個。

驗證、登入並執行第一項任務

codex --version
codex --help

# Open your own project directory before starting
cd /path/to/your/project
codex login
codex login status
codex --sandbox read-only "Explain this project's structure and how its tests run. Do not modify files."

請將範例專案路徑替換為您自己的路徑。最後一個指令會使用唯讀沙箱進行初步說明。這是很好的第一次檢查，因為您可以在要求代理程式進行變更前，確認正確的儲存庫與模型存取權。如果想查看可用旗標，請使用已安裝 CLI 的說明或指令參考。

3. 選擇正確的帳戶途徑

codex login會啟動帳戶登入流程。完成前請確認瀏覽器中的帳戶與工作區。若要直接使用 OpenAI API 計費，文件所述的替代方式會透過標準輸入接受 Platform 金鑰：

選用：OpenAI Platform API 驗證

# After supplying OPENAI_API_KEY through your credential setup:
printenv OPENAI_API_KEY | codex login --with-api-key

此 API 指令適用於 OpenAI Platform 金鑰。它不是第三方閘道的完整設定。自訂提供者需要自己的設定、端點、憑證來源與支援的模型。驗證文件說明各種途徑，而我們的 Codex API 金鑰指南涵蓋更深入的提供者設定。

4. 將第一個回應轉化為有用的第一項任務

詢問相關原始碼與測試所在的位置，然後根據儲存庫檢查答案。
選擇一項小型變更，並說明其預期行為。
使用乾淨的分支或檢查點，並選擇適合該變更的權限。
讓 Codex 執行相關檢查，然後檢閱其差異與說明。

例如，從一項失敗的測試或小型文件修正開始。避免讓第一項任務成為整個應用程式重寫：安裝、憑證、本機相依套件與任務品質都會同時變得更難評估。短迴圈運作後，再加入專案指示並擴大範圍。

如果設定中止，請修正相應的層級

「找不到指令」表示安裝或 PATH 有問題。401 表示驗證問題。模型錯誤表示所選的提供者與模型有問題。限制警告表示使用量或計費問題。保留正常運作的層級，並視情況遵循401 檢查清單或使用量限制指南；重新安裝可執行檔不會補充帳戶額度。

若要評估 Kunavo 用於本機 Codex 工作的效果，請建立帳戶並遵循Codex 整合。它使用相容於 Responses 的提供者設定。在為大型專案依賴新的計費途徑前，請先驗證一項小型任務。

常見問題

如何安裝 Codex CLI？

請使用適用於您作業系統的官方獨立安裝程式，或 npm、Homebrew 替代方案。必要時開啟新的終端機，檢查 codex --version，然後從專案目錄啟動 Codex 並選擇驗證方式。

npm install -g @openai/codex 仍受支援嗎？

是。2026 年 9 月 17 日查閱的官方安裝文件將 npm 與獨立安裝程式及 Homebrew 並列。請選擇一種安裝方式，並使用其更新路徑，以避免副本互相衝突。

需要 ChatGPT 訂閱才能安裝 Codex 嗎？

安裝與模型存取是分開的。請選擇可用的 ChatGPT 登入途徑，或為受支援的本機工作另行使用按 API 計費的存取方式。選擇付款方式前，請查看目前的帳戶選項；安裝 CLI 不會增加模型額度。

可以在 Windows 上安裝 Codex 嗎？

可以。OpenAI 提供 Windows 獨立安裝程式。如果您選擇改在 WSL 內工作，請在該環境中安裝並執行 Linux 版本，並留意其獨立的專案路徑與環境變數。

官方安裝文件與本機 CLI 說明於 2026 年 9 月 17 日查閱。