OpenAI Codex CLI 安裝教學｜用 ChatGPT 帳號登入免 API Key

504 瀏覽

2026-04-26 更新

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 --silent

Q：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`	關閉選單或取消目前操作