02 · 裝在哪、怎麼登入

裝 Codex CLI

四種裝法，裝出來是同一個 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 --version

管道裝指令碼這件事

curl ... | sh 是官方給的方式，但把遠端指令碼直接餵給 shell 終歸是要信任對面。 在意的話就用 npm 或 Homebrew，或者先把指令碼存下來看一眼再跑： curl -fsSL https://chatgpt.com/codex/install.sh -o install.sh。

Windows 上還有一條路是在 WSL 裡裝，官方有單獨的說明； 原生 Windows 沙盒的行為和 macOS/Linux 不完全一樣，見 Windows 沙盒。

裝別的介面

• IDE 擴充功能：在編輯器的擴充功能市場裡搜 Codex 安裝。
• 桌面應用：macOS / Windows / Linux 都有，從官方快速入門頁下載。 Linux 支援哪些發行版、用什麼包，看 Linux 桌面應用。

裝哪個不衝突，CLI 和桌面應用可以同時用，登入狀態各自獨立。

登入：兩種方式，差別不只是計費

codex login

會開一個瀏覽器視窗，登完把憑據傳回 CLI。這是預設方式。

另一種是 API 金鑰：

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

看著只是計費方式不同——訂閱 vs 按量——但登入方式還決定了哪套管理規則和資料處理政策適用於你：

	用 ChatGPT 賬號登入	用 API 金鑰登入
計費	走訂閱額度	按用量計費
管理控制	受 ChatGPT 工作區權限和 RBAC 約束	受你所屬 API 組織的設定約束
資料保留 / 駐留	走 ChatGPT Enterprise 的設定	走 API 組織的保留與共享設定
Codex 雲端	可用	不可用，雲端必須用 ChatGPT 登入
功能完整性	完整	部分功能可能不可用

所以在公司環境裡，這一步基本是被替你決定好的：如果團隊的權限、審計、資料駐留 都掛在 ChatGPT 工作區上，那就得用 ChatGPT 賬號登入，API 金鑰那條路會繞開這些控制。

檢查當前登入狀態：

codex login status

第一次進去會看到什麼

在專案目錄裡敲 codex，它會先看這個目錄是不是 Git 倉庫，然後給出不同的預設建議：

• 已納入版本控制 → 建議 Auto（工作區可寫 + 按需核准）
• 沒納入版本控制 → 建議 read-only（只讀）

這個預設值不是隨便定的：有 Git 在，你隨時能 git diff 看它改了什麼、 git checkout 撤回；沒有 Git，改錯了就是真沒了。

先 git init

在沒有版本控制的目錄裡讓智慧體寫檔案，等於取消了你的撤銷鍵。 花十秒 git init && git add -A && git commit -m "before codex"，之後每一步都能回退。

下一步

03 · 跑通你的第一個任務。

相關官方文件

• 快速入門
• 身份驗證
• 定價與功能可用性
• Linux 桌面應用 · WSL