OpenAI Codex CLI 是一款強大的 AI 編程工具，讓你直接在終端機內用自然語言與 AI 協作開發。本篇教學會帶你完成安裝，並說明如何用 ChatGPT Plus 帳號直接登入，不需要另外申請或支付 API Key 費用。
什麼是 OpenAI Codex CLI？
OpenAI Codex CLI 是 OpenAI 推出的終端機 AI 助理，功能包括：
- 用自然語言下指令，讓 AI 幫你讀取、編輯、執行程式碼
- 支援多輪對話，理解專案脈絡
- 本機執行，有沙箱保護（macOS 使用 Seatbelt）
- 支援 ChatGPT Plus／Pro 帳號直接登入，免 API Key
安裝前準備
安裝 Codex CLI 需要以下條件：
- Node.js 18 以上版本（建議使用 v22 或 v24 LTS）
- npm（隨 Node.js 一起安裝）
- ChatGPT Plus、Pro、Team 或 Enterprise 訂閱（用於免 API Key 登入）
確認 Node.js 版本
node --version如果版本低於 18，請先升級。推薦使用 nvm（Node Version Manager） 管理版本：
# 安裝 nvm（如果尚未安裝）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# 重新載入 shell 設定
source ~/.nvm/nvm.sh
# 安裝最新 LTS 版本
nvm install --lts
nvm use --lts
# 確認版本
node --version # 應顯示 v24.x.x 或以上安裝 Codex CLI
Node.js 版本確認正確後，執行以下指令安裝：
npm install -g @openai/codex安裝完成後確認版本：
codex --version看到類似 codex-cli 0.117.0 的輸出就代表安裝成功。
用 ChatGPT 帳號登入（免 API Key）
Codex CLI 支援直接用 ChatGPT 訂閱帳號登入，用量計入你的 ChatGPT Plus／Pro 方案，不另外收費。
步驟 1：啟動 Codex CLI
codex
步驟 2：選擇登入方式
第一次啟動時會出現登入提示，選擇 「Sign in with ChatGPT」。
步驟 3：瀏覽器 OAuth 授權
系統會自動開啟瀏覽器，導向 OpenAI 的授權頁面。用你的 ChatGPT 帳號登入並授權後，CLI 會自動取得 session token，完成認證。
登入狀態會儲存在 ~/.codex/auth.json，之後重新啟動不需要再次登入。
常見問題
Q：輸入 codex 顯示找不到指令
如果你的系統同時安裝了多個 Node.js 版本（例如同時使用 nvm 和 Homebrew），可能會發生路徑衝突。請確保 terminal 使用的 node 版本是 18 以上：
source ~/.nvm/nvm.sh
nvm use --lts
codex如需永久生效，在 ~/.zshrc 加入：
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
nvm use --lts --silentQ：ChatGPT Plus 和 API Key 有什麼差別？
| 項目 | ChatGPT 帳號登入 | API Key |
|---|---|---|
| 費用計算 | 計入 ChatGPT 訂閱用量 | 按 token 另外計費 |
| 適合對象 | 個人開發者 | 自動化 CI/CD、商業用途 |
| 設定難度 | 簡單（瀏覽器授權） | 需要建立 API Key |
Q：在遠端伺服器（無瀏覽器）如何登入？
可以先在本機完成登入，再將 ~/.codex/auth.json 複製到伺服器上；或是使用 SSH port forwarding：
ssh -L 1455:localhost:1455 user@your-server常用 Slash 指令一覽
在 Codex CLI 介面中輸入 / 開頭的指令可以控制對話、切換模型、管理檔案等。以下是完整指令分類表：
📁 Session 管理
| 指令 | 說明 |
|---|---|
/help | 顯示所有可用指令 |
/new | 開始一段新對話 |
/clear | 清除目前對話，重新開始 |
/resume | 恢復上一個 session |
/fork | 複製目前對話到新分支繼續 |
/history | 查看對話紀錄 |
/exit / /quit | 退出 Codex CLI |
/copy | 複製最後一則回覆到剪貼簿 |
/feedback | 回報問題給 OpenAI |
✏️ 程式碼與編輯
| 指令 | 說明 |
|---|---|
/diff | 顯示目前工作目錄的 Git diff |
/undo | 撤銷 Codex 上一次對檔案的修改 |
/compact | 壓縮對話紀錄以釋放 token 用量 |
/plan | 切換到計劃模式，先規劃再執行 |
/init | 在專案根目錄建立 AGENTS.md 設定檔 |
🤖 模型與權限
| 指令 | 說明 |
|---|---|
/model | 切換 AI 模型（如 gpt-5.4、gpt-4.1-mini） |
/mode | 切換執行模式（Auto / Read Only / Full Access） |
/permissions | 調整 Codex 可自動執行的操作範圍 |
/experimental | 開啟/關閉實驗性功能 |
/personality | 設定 AI 回覆風格（簡潔、詳細、協作） |
/status | 顯示目前 token 用量與 session 狀態 |
🔗 整合與工具
| 指令 | 說明 |
|---|---|
/mcp | 列出已設定的 MCP（外部工具整合） |
/agent | 切換 agent 線程（多 agent 工作流） |
/logout | 登出並清除本機 session 憑證 |
鍵盤快捷鍵
| 快捷鍵 | 功能 |
|---|---|
Ctrl + C | 取消目前操作（按兩次退出） |
Ctrl + D | 退出 Codex CLI |
Ctrl + L | 清除終端畫面 |
Ctrl + G | 在外部編輯器編輯目前提示詞 |
Tab | AI 執行中時預先排隊下一個提示 |
@ | 模糊搜尋並附加檔案到對話 |
! | 直接在本地 shell 執行指令（繞過 AI） |
↑ / ↓ | 瀏覽歷史輸入紀錄 |
Esc | 關閉選單或取消目前操作 |
開始使用
登入完成後，直接在 Codex CLI 輸入自然語言指令即可：
codex小結
OpenAI Codex CLI 讓 AI 輔助開發直接整合進你的工作流程。對於已有 ChatGPT Plus 訂閱的開發者來說，安裝後直接用帳號登入即可使用，不需要額外申請 API Key 或支付費用，是非常划算的選擇。
如果你正在尋找深度整合 GitHub 的 AI 終端工具，也可以參考 GitHub Copilot CLI，兩者各有適合的使用情境。