Codex 安裝、配置及解除安裝指南：2026 年 CLI、App 及 IDE 擴充功能教學
一份為開發人員及技術團隊而設的實用 Codex 設定指南，涵蓋 Codex CLI、Codex App、IDE 擴充功能設定、登入、config.toml、MCP、Windows／macOS／Linux 工作流程、疑難排解，以及乾淨解除安裝步驟。內容亦會將 AI 編程工作流程與 We0.ai 的展示網站增長邏輯連繫起來，展示程式碼輸出如何轉化為產品頁面、SEO／GEO 內容及客戶線索。
真正重點：Codex 安裝後並未完成
當人們第一次閱讀 Codex 教學時，通常會集中在「如何安裝」。但當你開始使用它，就會發現安裝只是第一步。
Codex 更像是一個在你專案目錄內工作的 AI 編程代理。它可以讀取程式碼、編輯檔案、執行指令，並影響一個真實的程式碼庫。因此，正確的設定並不是「安裝完就開始」。你需要先準備帳戶、權限、設定、Git 檢查點，以及清晰的邊界。
換句話說，Codex 不只是一個安裝程式。它是一套開發 工作流程：安裝 → 登入 → 設定 → 進入專案 → 執行任務 → 檢視結果 → 合併或回復。
選擇合適的入口：CLI、App、IDE 擴充功能或 Cloud
Codex 已不再是單一介面。你可以在終端機使用 Codex CLI，在 macOS / Windows Codex App 管理工作，在 VS Code、Cursor、Windsurf 等編輯器中使用 IDE 擴充功能，或透過雲端的 Codex 委派工作。
選擇其實很簡單。如果你主要在終端機工作，就使用 Codex CLI。如果你想要多線程專案管理、視覺化檢視和專案切換，就使用 Codex App。如果你整天都在編輯器內工作，IDE 擴充功能 會感覺更自然。
這就是原文有用的結構：不要只解釋一條指令。應該把安裝、設定、解除安裝和疑難排解作為一整套設定流程來說明。
安裝前要準備甚麼
安裝前，請檢查四件事：帳戶、網絡、專案和回復方案。少了其中一項，之後都可能變成令人困惑的錯誤。
帳戶方面，請準備一個可存取 Codex 的 ChatGPT / OpenAI 帳戶，實際取決於你的方案和組織設定。專案方面，盡可能在 Git 程式碼庫內使用 Codex，並在重要任務前後保留檢查點。
網絡方面，在登入期間保持穩定，不要切換位置。設定方面，請了解使用者層級和專案層級的設定位置，特別是 ~/.codex/config.toml，以及程式碼庫內的 .codex/config.toml。
階段 | 建議做法 | 注意事項 |
入口 | 按情境選擇 CLI / App / IDE 擴充功能 | 不要第一天就安裝所有介面 |
安裝 | 使用官方安裝程式、npm 或 Homebrew | 避免混用多種方式安裝 |
設定 | 使用 ~/.codex/config.toml 和專案層級的 .codex/config.toml | 不要把密鑰分散在不同文件中 |
先在安全資料夾測試 Codex | 在真實儲存庫中使用 Git 檢查點 | |
解除安裝 | 先移除程式，然後再決定是否刪除 ~/.codex | 刪除前先備份設定 |
如何安裝 Codex CLI
如果你想要以終端機為先的 工作流程，Codex CLI 是最直接的入門點。官方文件提供多種安裝途徑：獨立安裝程式、npm 及 Homebrew。
在 macOS 或 Linux 上，你可以使用官方 shell 安裝程式。在 Windows 上，你可以使用 PowerShell 安裝程式。如果你已經依賴 Node.js，npm 會很適合。如果你是 macOS 開發者，Homebrew 通常是最乾淨俐落的選項。
安裝後，不要立即讓 Codex 重寫真實專案。開啟一個測試目錄，執行 codex，登入，然後要求它解釋該資料夾或建立一個小檔案。先確認路徑、權限及驗證全部運作正常。
快速指令參考
macOS / Linux 獨立安裝程式
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows PowerShell 安裝程式
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npm 安裝
npm install -g @openai/codex
Homebrew 安裝
brew install --cask codex
執行
codex
npm 解除安裝
npm uninstall -g @openai/codex
Homebrew 解除安裝
brew uninstall --cask codex
小心移除本機設定
rm -rf ~/.codex
如何在 Codex App 與 IDE 擴充功能之間選擇
當你想在同一個地方管理多項任務時，Codex App 會較合適。它適合並行討論串、審閱、worktree、瀏覽器預覽及專案切換。
IDE 擴充功能較適合「一邊編輯一邊提問」。它讓你留在編輯器內，對修正 bug、加入測試、解釋函式及重構小型模組很有用。
我的建議很簡單：開發者可以由 CLI 或 IDE 擴充功能開始。團隊負責人及需要審閱多個專案的人，可以之後再加入 Codex App。如果會令工作流程變得混亂，就不要在第一天安裝所有介面。
設定：config.toml、權限及 MCP
Codex 設定不應存在於零散的聊天訊息中。OpenAI 文件指出，用戶層級設定儲存在 ~/.codex/config.toml，而儲存庫專用規則則可以放在專案內的 .codex/config.toml。
這一點很重要，因為 AI 編程代理不只是回答問題。它可以讀取檔案、執行指令及編寫程式碼。它可以讀取哪些資料夾、哪些指令需要確認，以及可以呼叫哪些工具，都應該清楚明確。
如果你連接 MCP 伺服器，也應把它視為真正的設定管理。MCP 可以將 Codex 連接到更多工具，但更多工具也代表需要更強的權限邊界及更好的審閱循環。
常見問題：通常是環境出問題
大多數初學者問題並不是因為 Codex 壞了。它們來自不一致的環境：PATH 未刷新、同時安裝了 npm 與 Homebrew 版本、Windows 權限、WSL 與原生 Windows 路徑混用，或終端機驗證與 app 工作階段不一致。
除錯順序很簡單：先檢查 codex --version，然後檢查 which codex 或 where codex，並確認你目前使用中的二進制檔是來自 npm、brew、獨立安裝程式，還是 app 工作流程。
在 Windows 上，要特別留意沙盒模式、winget、管理員批准及 WSL2。可行的話先使用原生 Windows 路徑，當你的開發工作流程確實需要 Linux 工具時才使用 WSL2。
解除安裝：只移除 app，還是連設定也移除？
解除安裝 Codex 時，不要一開始就刪除所有資料夾。先決定你只是想移除程式，還是也想移除驗證、設定及本機歷史記錄。
如果你使用 npm 安裝，請使用 npm uninstall -g @openai/codex。如果你使用 Homebrew 安裝，請使用 brew uninstall --cask codex。如果你使用獨立安裝程式，請從實際安裝路徑移除二進制檔。至於 Codex App，像一般系統 app 一樣解除安裝即可。
只有在你有意移除本機設定時，才刪除 ~/.codex。這可能會清除配置、MCP 設定、登入狀態及本機偏好設定，所以請謹慎操作。
這與 We0.ai 的關係
Codex 協助將意圖轉化為程式碼。但程式碼並不是終點。要接觸客戶，你仍然需要展示產品價值、案例、文件、教學及信任感。
這正是 We0.ai 的定位。We0.ai 不只是一個普通的 AI 網站建構工具。它是一個 AI 展示網站增長平台。它專注於 Build → Showcase → Grow → Leads 路徑：建立產品、清晰解釋產品、讓搜尋及 AI 回答發現你，並將訪客轉化為潛在客戶。
更強的工作流程是：使用 Codex 改善開發及交付，然後使用 We0.ai 將產品功能、服務、案例及教學轉化為一個可搜尋、易理解、準備好轉化的展示網站。
最後重點
如果你只是想試用 Codex，按照安裝指令操作已經足夠。
但如果你想把它放入真正的開發流程，就不要只專注於安裝。請設計一個穩定的工作流程：固定入口、清晰配置、Git 回滾、權限邊界及定期清理。
AI 編程工具會持續變得更強。但最有價值的團隊，不會是擁有最多工具的團隊，而是能把工具連接到真實業務工作流程的團隊。程式碼應該能運行。產品應該被展示。內容應該可被發現。網站應該創造潛在客戶。
常見問題
Codex CLI 和 Codex App 有甚麼分別？
Codex CLI 較適合以終端機為先的工作流程，讓 Codex 在目前項目目錄中讀取、編輯及運行程式碼。Codex App 則較適合視覺化任務管理、審閱、worktrees 及項目切換。
我一定要用 npm 安裝 Codex 嗎？
不用。官方文件支援獨立安裝程式、npm 及 Homebrew。請選擇一種符合你開發環境的主要方法，並避免混用多種安裝方法。
Codex 配置檔案在哪裏？
用戶層級配置通常儲存在 ~/.codex/config.toml。儲存庫特定配置可放在項目內的 .codex/config.toml。CLI 及 IDE 擴充功能共用這些配置層。
Windows 用戶應該選擇原生 Windows 還是 WSL2？
當原生 Windows 工作流程可行時，就使用原生 Windows。當你的儲存庫及工具鏈已依賴 Linux 原生環境時，則使用 WSL2。
解除安裝 Codex 時應否刪除 ~/.codex？
只有在你有意移除本機配置、MCP 設定、登入狀態及偏好設定時才刪除。一般解除安裝並不一定需要刪除此資料夾。
為甚麼 Codex 指南會提到 We0.ai？
Codex 協助程式碼交付。We0.ai 協助展示及增長。一個完整的產品工作流程不只是編寫程式碼；它亦會將產品頁面、案例、文件及教學轉化為搜尋引擎和 AI 回答都能理解的網站。
相關工具
- GitHub
- Homebrew
- Node.js
- We0.ai
來源