Codex CLI 登入要選 ChatGPT 還是 API 金鑰？2026 實查：指令怎麼下、差在哪、金鑰明文存檔怎麼修

裝好 OpenAI 的 Codex CLI，第一個畫面就要你做一個選擇：用 ChatGPT 帳號登入，還是用 API 金鑰登入。很多人隨手選了其中一個，後面才發現「怎麼 GitHub 自動審查不見了」、或是「這個月 API 帳單怎麼有數字」。

這篇把兩種登入的指令、實際差異、以及一個大多數人不知道的憑證存放位置，照官方文件逐條攤開。所有指令與句子都出自 OpenAI 官方文件與官方 GitHub 儲存庫的原文（最後查核 2026-09-06）。

先把 Codex CLI 裝起來（三種方式擇一）

官方 README 給的安裝方式有三種，Mac / 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、Homebrew 二選一）：

npm install -g @openai/codex
brew install --cask codex

官方另外註明：獨立安裝程式預設從 https://releases.openai.com/codex 下載，抓不到 metadata 或檔案時會退回 GitHub Releases；想強制走 GitHub Releases，把環境變數 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM 設成 false 即可。裝完直接輸入 codex 就能開始。

兩種登入的指令，其實只差一行

一、用 ChatGPT 訂閱登入（多數人該選這個）

codex login

跑下去會開瀏覽器，登入完瀏覽器把憑證送回 Codex。官方文件寫得很直白：這是「沒有有效工作階段時的預設認證路徑」。官方 README 也直接建議一般使用者走這條——你的 Plus、Pro、Business、Edu、Enterprise 訂閱本來就含 Codex 用量，不必另外付 API 費用。

二、用 API 金鑰登入（自動化、CI 才需要）

官方給的寫法是把金鑰用管線餵給 CLI，不要把金鑰打在指令列參數上：

printenv OPENAI_API_KEY | codex login --with-api-key

金鑰去 OpenAI 後台（platform.openai.com 的 API keys 頁）拿。官方明講：「當你用 API 金鑰登入，Codex 用的是標準 API 計價，而不是 ChatGPT 方案內含的額度。」也就是說，這條路是按用量真的會出帳的。

官方對這條路的定位也寫得很清楚：適合「程式化的 Codex CLI 工作流程，例如 CI/CD 作業」，並提醒不要把 Codex 的執行暴露在不受信任或公開的環境裡。

忘記自己現在是哪一種？

codex login status   # 看目前用哪一種認證
codex logout         # 清掉目前憑證

一個容易踩的細節：CLI 和 IDE 擴充共用同一份快取登入資訊，你在其中一邊登出，另一邊下次啟動也要重新登入。

選 API 金鑰，你會失去哪些功能？

這是最多人事後才發現的部分。官方的方案功能對照表裡，「API Key」這一欄有一串是 unavailable（不支援），整理成人話：

另外有幾項官方標的是「limited（受限）」而不是完全不能用：瀏覽器 Computer Use、Chrome 整合、Record & Replay（macOS）、Plugins、Memories。官方沒有逐項說明受限的細節，我們就不替它補完——這格照原文寫「受限」。

反過來說，API 金鑰這欄也有一項是 available 而訂閱方案要看方案：「預設不用 API 或商業資料做訓練」。

結論很單純：你是一個人在本機寫程式 → 走 codex login；你要在 CI、排程機器、共用環境裡跑 → 才用 API 金鑰，並且接受它沒有雲端那一整排功能。

大多數人不知道的一件事：憑證預設是明文

官方文件在「Login caching」這段寫得很清楚：Codex 會把登入資訊快取在本機的一個純文字檔 ~/.codex/auth.json，或是放在作業系統的憑證儲存區。

也就是說，如果你沒動過設定，你的 Codex 憑證可能就以明文躺在家目錄裡。共用電腦、會被同步到雲端硬碟的家目錄、或是會被打包進備份的機器，這都是實實在在的風險。

官方有給開關，在設定檔 config.toml 裡加一行：

# file | keyring | auto
cli_auth_credentials_store = "keyring"

三個值的差別：

• file：存進 CODEX_HOME（預設 ~/.codex）底下的 auth.json，也就是明文那條路。
• keyring：存進作業系統的憑證儲存區（macOS 鑰匙圈、Windows 認證管理員這類）。
• auto：有 OS 憑證儲存區就用，沒有才退回 auth.json。

建議動作：裝完 Codex CLI，第一件事就是把這行設成 keyring（或至少 auto），然後檢查一下 ~/.codex/auth.json 還在不在、權限對不對。這是一分鐘的事，但漏掉的話，外洩的是可以直接花你錢的憑證。

順帶一提，用 ChatGPT 登入的工作階段，官方說 Codex 會在到期前自動更新 token，所以正常使用不太需要重新開瀏覽器登入。

額度用完了怎麼辦？官方給的三條路

用訂閱登入的人遲早會撞到用量上限。官方文件給的處理方式有三個，順序值得記：

1. 換小一點的模型——官方直接建議「接近用量上限時，可以切換到較小的模型讓額度撐更久」。
2. 加購 credits——Plus 與 Pro 的使用者撞到上限後可以買額外 credits 繼續做，不必升級方案。
3. 用 API 金鑰跑額外的本機對話——這是官方原文寫的：所有使用者都可以用 API 金鑰執行額外的本機對話，費用按標準 API 計價。

想知道自己還剩多少，在 Codex CLI 的對話中直接輸入 /status；完整數字則在 chatgpt.com 的 Codex 用量儀表板。官方也提醒：任務長得像不代表吃掉一樣多額度，模型選擇、上下文、推理、工具使用與快取都會影響用量，「單看提詞長度不是可靠的估算方式」。

方案價目（官方 Codex 定價頁當日牌價）

（Pro 的 5x／20x 兩檔、以及各方案每五小時的訊息估算值，官方明說「不是固定的訊息上限」，要以自己帳號的用量儀表板為準，我們不做推估。）

三十秒重點

• 個人在本機寫程式：codex login，用訂閱額度，功能最完整。
• CI／排程／共用機器：printenv OPENAI_API_KEY | codex login --with-api-key，但雲端功能（GitHub 審查、Slack、Codex cloud）全數不支援，而且會真的出帳。
• 不管選哪一種，先在 config.toml 設 cli_auth_credentials_store = "keyring"，別讓憑證以明文躺在 ~/.codex/auth.json。
• 忘記現在是哪種：codex login status。額度剩多少：對話中打 /status。

本文指令與引述查核於 2026-09-06，來源為 OpenAI 官方文件 Codex 認證說明、Codex 定價與功能對照 與官方儲存庫 openai/codex README。方案與功能隨時可能變動，請以官方頁面為準。想知道 Codex 為什麼「買不到單獨方案」，看我們的 Codex 方案拆解；用量與計費怎麼算，見 GPT-6 Astra 在 Copilot 的計費實查；完整方案資料在 Codex 工具頁。