Codex CLI 要先裝 Node.js 嗎？

用官方的安裝指令不用。它裝的是一個獨立的執行檔，我測試的環境裡打 node 是找不到指令的，照樣裝得起來。只有選 npm 那種裝法才需要，npm 上的套件標示 Node.js 16 以上。

免費的 ChatGPT 帳號可以用 Codex CLI 嗎？

定價頁把終端機版列在 Plus 以上，免費方案列的是桌面 App。我實際看到的登入畫面，第一個選項底下寫的也是 Plus、Pro、Business、Enterprise。拿免費帳號去登入會怎樣，我沒有試。

Windows 一定要裝 WSL 才能用 Codex 嗎？

不用。官方文件有給 PowerShell 的安裝指令，可以直接裝在 Windows 上。想在 WSL 裡用也可以，但要 WSL2，文件寫 WSL1 從 0.115 版起不支援。

Codex CLI 怎麼更新？

官方文件寫，更新就是把安裝的那一行指令再跑一次。另外有 codex update 這個指令，我在測試機上跑過，它做的事就是替你重跑一次安裝腳本。

Codex CLI 安裝教學：怎麼下載、怎麼登入，Mac、Windows、Linux 各一行指令

想試 Codex 的終端機版，第一步是打開終端機，貼一行安裝指令。

貼之前你大概會想先知道：它會在電腦裡放什麼、佔多少空間、要不要先裝別的東西、裝完是不是就能用。

為了回答這幾件事，我開了一台乾淨的 Linux 測試機，照官方的指令實際裝了一次，把畫面和數字記下來。

先交代範圍。安裝、檔案大小、沒登入時會看到的畫面，是我 2026 年 10 月 13 日實際跑的。我沒有登入 ChatGPT 帳號，所以登入完成之後長什麼樣子、用起來如何，這篇沒有。Mac 和 Windows 的指令是照官方文件寫的，我沒有在那兩種系統上裝。

先確認：裝好不等於能用

Codex 沒有單獨賣，跟著 ChatGPT 的方案走。OpenAI 的定價頁把終端機版列在 Plus 以上，每月 20 美元；免費和 Go 方案列的是桌面 App。

不訂閱的另一條路是用 API 金鑰，照實際用量付費。

各方案的額度在Codex 費用怎麼算。還不確定它是什麼的話，先看Codex 是什麼。不想碰終端機，要的是有視窗的桌面程式，看Codex App 是什麼。

Mac 和 Linux：貼一行

官方文件給的指令，Mac 和 Linux 共用：

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

我在測試機上跑，安裝腳本從開始到結束是 3 秒。畫面是這樣：

==> Installing Codex CLI
==> Detected platform: Linux (x64)
==> Resolved version: 0.162.1
==> Downloading Codex CLI
==> Installing standalone package to /vercel/.codex/packages/standalone/releases/0.162.1-x86_64-unknown-linux-musl
==> Current terminal: export PATH="/vercel/.local/bin:$PATH" && codex
==> Future terminals: open a new terminal and run: codex
==> PATH was added to /vercel/.bashrc
Codex CLI 0.162.1 installed successfully.

/vercel 是那台測試機的家目錄，在你的電腦上會是你自己的。

3 秒是機房的網路。它下載的是一個壓縮檔，這一版在 GitHub 發佈頁上標的大小，我裝的 Linux x64 是 155 MB，Apple 晶片的 Mac 是 126 MB，Intel 的 Mac 是 137 MB。在家裡要等多久看你的網速。

Current terminal 和 Future terminals 那兩行是在提醒同一件事：目前這個視窗還不認得 codex 這個指令，要嘛照它給的那一行執行，要嘛開一個新的終端機視窗。

開新視窗之後確認有沒有裝好：

codex --version

我看到的是 codex-cli 0.162.1。

不用先裝 Node.js。它裝的是一個獨立的執行檔，我的測試環境裡打 node 是找不到指令的，照樣裝得起來。

它在電腦裡放了什麼

我把裝完之後多出來的東西找了一遍，一共三處。

程式本體在家目錄的 .codex/packages/standalone/ 底下。

.local/bin/codex 是一個捷徑，指到上面那個位置。你打 codex 的時候，系統找到的是它。

第三處是 shell 的設定檔。測試機用的是 bash，所以它在 .bashrc 的最後加了三行：

# >>> Codex installer >>>
export PATH="/vercel/.local/bin:$PATH"
# <<< Codex installer <<<

我另外把安裝腳本的原文讀了一遍。裡面寫的規則是，Mac 用 zsh 的話，這三行會加在 .zprofile，Linux 用 zsh 則是 .zshrc。

大小方面，裝完是 432 MB。最大的是主程式，一個檔案就 281 MB，其他是它自己帶的工具，例如搜尋檔案用的 ripgrep。

這個數字後面還會變，下面講。

Windows：在 PowerShell 貼一行

這一段我沒有實測，照官方文件寫。

文件說要開一個新的 PowerShell 視窗，貼這一行：

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

Windows 的版本，文件建議用 Windows 11。Windows 10 要 1809 以上，而且文件把它列為盡量支援，說穩定度不如 Windows 11。另外寫了 winget 要能用。

不一定要裝 WSL。想在 WSL 裡用的話，進到 WSL 之後貼的是上面 Linux 那一行。文件寫要 WSL2，WSL1 從 0.115 版開始不支援。

另外兩種裝法：npm 和 Homebrew

文件還列了這兩種。

npm install -g @openai/codex

brew install --cask codex

這兩種我都沒有裝。我只查了 npm 上的登錄資料，版本同樣是 0.162.1，標示需要 Node.js 16 以上。

挑一種就好。安裝腳本裡有一段是專門處理這件事的：它如果發現電腦上已經有用 Homebrew 或 npm 裝的 Codex，會提醒你兩份並存的時候，實際跑到哪一份要看 PATH 的順序，然後問你要不要把舊的移除。

第一次打開：先選登入方式

官方文件的說法是，進到專案的資料夾，打 codex。

我在測試機上打了，出來的是這個畫面：

Welcome to Codex, OpenAI's command-line coding agent

Sign in with ChatGPT to use Codex as part of your paid plan
or connect an API key for usage-based billing

> 1. Sign in with ChatGPT
     Usage included with Plus, Pro, Business, and Enterprise plans
  2. Sign in with Device Code
     Sign in from another device with a one-time code
  3. Provide your own API key
     Pay for what you use

  Press enter to continue

文字是照我擷取到的內容，行和縮排是我重排的。我停在這裡，沒有往下按。

三個選項對應三種情況。

第一個是用 ChatGPT 帳號登入，走的是訂閱方案裡的額度。文件寫它會開瀏覽器，你在瀏覽器裡登入完，登入資料會傳回終端機。

第二個是給沒有瀏覽器的機器用的，下一段講。

第三個是 API 金鑰，用多少付多少。這條路沒有雲端的功能，差別我寫在Codex 費用怎麼算。

登入之後，文件寫登入資料會存在 .codex/auth.json，或是作業系統自己的密碼庫裡，並且提醒要把這個檔案當密碼看待，不要傳給別人、不要放進版本控制。

在沒有瀏覽器的主機上登入

把 Codex 裝在租來的主機上、用 SSH 連進去操作的人，會遇到這個情況。我的測試機剛好就是。

我在上面打 codex login，它印的是：

Starting local login server on http://localhost:1455.
If your browser did not open, navigate to this URL to authenticate:

https://auth.openai.com/oauth/authorize?（後面一長串參數）

On a remote or headless machine? Use `codex login --device-auth` instead.

意思是它在這台機器上開了一個等待登入結果的小服務。但瀏覽器在你自己的電腦上，登入完傳不回這台主機。最後一行它自己就提示了該改用哪個指令。

照它說的打 codex login --device-auth，畫面變成兩個步驟：用任何一台裝置的瀏覽器打開 https://auth.openai.com/codex/device，登入之後輸入畫面上那組一次性的碼。碼的有效時間寫的是 15 分鐘。下面還有一句提醒：如果這組碼不是你自己在 Codex 裡啟動登入得到的，是別的網站或別人給你的，就取消。

那組碼我沒有拿去輸入。

官方文件對這個方式有兩個補充。它目前標的是測試版；而且要先到 ChatGPT 的安全性設定裡把裝置碼登入打開，才能用。

文件另外給了兩個備案。一個是在有瀏覽器的電腦上先登入，再把 auth.json 複製到主機上。另一個是 SSH 連線的時候加上 -L 1455:localhost:1455，把那個等待登入的服務轉回自己的電腦。

還沒登入就會看到的兩個訊息

這兩個都跟登入無關，是我在測試機上直接撞到的。

第一個出現在 codex exec。這是不開畫面、交代一件事讓它做完就結束的用法，文件說是給腳本和自動化流程用的。我在一個普通的資料夾裡跑，它直接拒絕：

Not inside a trusted directory and --skip-git-repo-check was not specified.

文件的解釋是，Codex 要求在 Git 管理的專案裡執行，為的是避免造成救不回來的更動。我另外開一個資料夾、下了 git init 再跑，這個訊息就沒有了。確定環境沒問題的話，也可以照訊息說的加上 --skip-git-repo-check 跳過，這個我也試了，一樣會放行。

過了這一關，它印出這次執行的設定，我看到的預設是模型 gpt-6.1-sol、沙盒 read-only，也就是只讀不改。接下來因為我沒登入，連線被拒絕，它自己重試了五次才結束，前後大約 13 秒。

第二個是 Linux 才有的警告：

warning: Codex could not find bubblewrap on PATH. Install bubblewrap with your OS package manager.

bubblewrap 是 Codex 在 Linux 上用來把它執行的指令關在限制範圍裡的工具。文件寫 Linux 和 WSL2 要先裝，沒裝的話會退回用它自己帶的那一份。我照文件裝了之後，警告就沒有再出現：

sudo apt install bubblewrap

Mac 不用裝，文件寫 macOS 用的是系統內建的機制。

開過一次之後，背景多了一個常駐程式

這是我在文件的安裝頁上沒讀到、實際裝了才看到的。

開過一次 codex 的畫面之後，.codex/packages/ 底下多了一個叫 app-server-daemon 的資料夾，裡面是另一份完整的程式，同樣 432 MB。整個 .codex 資料夾從 432 MB 變成 937 MB。

而且畫面關掉之後，背景還留著兩個 codex app-server 的行程，過了兩分多鐘都還在。整台機器用掉的記憶體，裝之前是 197 MB，開完畫面那時候量到 445 MB，兩分鐘後是 330 MB。

codex --help 裡把它叫做共用的背景伺服器。官方的指令說明提到，遠端控制和透過 SSH 連線的用法會用到它。

想關掉的話有指令：

codex app-server daemon stop

我跑了，它回報狀態是 stopped，主要的那個行程也確實不見了；另一個比較小的行程，十秒後還在。

codex --help 裡還有一個 --no-daemon 的選項，說明是不透過背景伺服器執行。這個我沒有試。

要說明一件事：我是用強制結束的方式關掉畫面的，不是正常按 Ctrl+C 離開。正常離開的時候它會不會留在背景，我沒有驗證。

在一般的電腦上，幾百 MB 的記憶體和不到 1 GB 的硬碟不算什麼。裝在只有 1 GB 或 2 GB 記憶體的小主機上，就要把這個算進去。

更新

官方文件寫，更新就是把安裝的那一行再跑一次。npm 也是重跑同一行，Homebrew 是 brew upgrade --cask codex。

另外有一個 codex update 的指令。我在測試機上跑了，第一行印的就是它實際做的事：

Updating Codex via `sh -c 'curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh'`...

也就是替你重跑安裝腳本。當時已經是最新版，它確認完就結束，不到一秒。

裝完想檢查：codex doctor

codex doctor

它會列出一份診斷：版本、是用哪種方式裝的、有沒有登入、磁碟空間、找不找得到 Git。

我沒登入，所以最上面就是一行找不到登入資料、請執行 codex login。安裝那一項顯示的是 consistent，並且列出這份不是由 npm、bun 或 pnpm 管理的。懷疑自己裝了兩份的時候，可以看這一項。

移除

官方文件的安裝頁沒有寫移除的步驟，安裝腳本裡也沒有移除自己的功能。我沒有實際移除過，所以這裡只能告訴你東西放在哪：程式在 .codex/packages/，捷徑是 .local/bin/codex，還有 shell 設定檔裡那三行。

要留意的是，.codex 這個資料夾裡不只有程式。你的設定、登入資料、對話紀錄也都在裡面。

用 npm 或 Homebrew 裝的，移除指令在安裝腳本裡有寫，分別是 npm uninstall -g @openai/codex 和 brew uninstall --cask codex。

裝好之後

常用的指令、沙盒模式實際擋了什麼、怎麼加 MCP 伺服器，我整理在Codex CLI 指令整理。

比較想在 VS Code 裡用的話，Codex 也有編輯器的擴充套件，而且裡面自己帶了一份 CLI，不用先裝終端機版，在 Codex VS Code 教學。

跟 Claude Code 比

Anthropic 的 Claude Code 也是貼一行指令安裝。那個我是在自己的 Mac 上裝的，過程在Claude Code 安裝教學。

兩邊的價格、免費額度、能在哪裡用，我並排在Claude Code 跟 Codex 怎麼選。

這篇沒有測的

登入。三種方式我都只看到第一個畫面，沒有走完。

登入之後的任何操作。

Mac、Windows 和 WSL 上的安裝。

npm 和 Homebrew 這兩種裝法。

正常離開的時候，背景程式會不會留著。

移除。