tidemeet

如何安裝並使用 OpenAI Codex CLI：登入與第一次倉庫任務

安裝 OpenAI Codex CLI，用 ChatGPT 或 API Key 登入，再在真實倉庫裡跑完第一次任務。

你要的是一個能讀本機倉庫、改檔案、跑本機命令的程式代理，而且整段循環留在終端機裡。

這篇依官方文件走完 如何安裝並使用 OpenAI Codex CLI：安裝器、ChatGPT 或 API Key 登入，以及在真實倉庫裡下達第一次任務。步驟以 developers.openai.com/codex/cli 與 developers.openai.com/codex/auth 為準。

安裝 登入 第一次倉庫任務

它適合誰、不適合誰

Codex CLI 在本機倉庫上工作：查看檔案、做修改、跑你已經裝好的工具。互動工作階段用 codex；可重複流水線用 codex exec。它不是網頁聊天視窗，也不是必須先裝 IDE 擴充功能。

01

對著真實倉庫

先 cd 進專案再啟動。官方入門提示是先問 “Tell me about this project”，再做一次可覆核的小改動。

02

兩種登入，兩套帳單

ChatGPT 登入走 Plus / Pro / Business / Edu / Enterprise 的方案額度。API Key 按 OpenAI Platform 價計費，較適合 CI，但依賴工作區的雲端功能會受限。

03

權限要先設

用 /permissions 看沙箱與可寫根目錄。官方還建議在任務前後做 Git 檢查點，改壞了能回溯。

安裝、登入、第一次任務

  1. 1

    安裝 CLI

    macOS / Linux：curl -fsSL https://chatgpt.com/codex/install.sh | sh。Windows：官方 PowerShell 安裝器。也可以 npm install -g @openai/codex 或 brew install --cask codex。同一條安裝命令可用來更新。

  2. 2

    登入

    在專案目錄執行 codex 或 codex login，選 Sign in with ChatGPT，在瀏覽器完成授權。無頭或本機回呼被擋時，用 codex login --device-auth（需在 ChatGPT 安全性設定裡打開裝置碼）。自動化：printenv OPENAI_API_KEY | codex login --with-api-key。用 codex login status 核對，codex logout 登出。

  3. 3

    下達第一次倉庫任務

    進入倉庫，執行 codex。先讓它說明專案結構，再要一次聚焦改動，例如補測試或修一個明確的報錯。提交前可用 /review。需要團隊說明時，可先寫 /init 產生 AGENTS.md。

0
額外 IDE 依賴
2
登入方式
1
第一次提示詞
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Windows: irm https://chatgpt.com/codex/install.ps1 | iex
# npm install -g @openai/codex
# brew install --cask codex

codex login
# printenv OPENAI_API_KEY | codex login --with-api-key
# codex login --device-auth

cd ~/code/your-repo
codex
# Tell me about this project

第一次容易卡住的地方

方式 帳單 更適合
ChatGPT 登入 方案額度 本機日常開發
API Key Platform 價 私有 CI / 指令稿
裝置碼 同 ChatGPT 無頭或 SSH 主機
把 auth.json 當密碼
登入快取在 ~/.codex/auth.json 或系統鑰匙圈。不要提交、不要貼進工單。CLI 與 IDE 擴充共用同一份快取，一邊登出另一邊也要重登。
無頭登入不是同一條瀏覽器流程
遠端機擋了 localhost 回呼時，優先裝置碼。備選是在有瀏覽器的機器登入後安全複製快取，或把 localhost:1455 經 SSH 轉發。
公司代理要帶 CA
TLS 代理或私有根憑證時，先設定 CODEX_CA_CERTIFICATE 再 codex login。未設定時回退 SSL_CERT_FILE。

官方對 API / CI 的提醒：不要在不信任或公開環境裡暴露 Codex 執行。

改完要和人對著看時

代理改完常缺一張圖：動了哪些檔、為什麼能合。不必再裝會議套件。可在tidemeet用瀏覽器開短時空間，或看如何建立空間。畫布用法見共享白板基礎。同站關於 OpenAI 評測事故的筆記見METR 調查。

還有疑問？

必須先裝 IDE 擴充功能嗎？

不必。CLI 可獨立使用。擴充功能與 CLI 共用登入快取，但第一次倉庫任務只需要終端機。

ChatGPT 登入和 API Key 能混用嗎？

一次工作階段只用一種有效登入。ChatGPT 走工作區權限與方案額度；API Key 走 Platform 組織設定與按量價。Codex cloud 必須用 ChatGPT 登入。

第一次該讓它改很大一塊嗎？

不建議。官方入門是先理解倉庫，再做一次聚焦改動。先看 /permissions，並用 Git 檢查點保住回溯路徑。

和臨時協作工具有什麼關係？

沒有產品綁定。只是要對著 diff 講兩句時，臨時會議工具對比說明何時用短時瀏覽器空間即可。

免費建立空間