建立 2026-09-15 更新 2026-09-15

安裝與登入

先決定你主要從哪裡用 Codex，再安裝對應的客戶端。CLI 與 IDE 共用同一組登入快取：在其中一邊登入，另一邊通常就能沿用。

官方步驟見 Codex CLI 與 Authentication。

你需要什麼帳號

ChatGPT 登入（建議日常使用）：Plus、Pro、Business、Edu、Enterprise 包含 Codex。Cloud、GitHub 審查、Slack 等雲端整合需要這條路。
API key：適合 CLI／IDE 的腳本與 CI。按 token 計費，沒有雲端那套 GitHub／Slack 整合。

Cloud 只能用 ChatGPT 登入。CLI 與 IDE 兩種都可以。

安裝 Codex CLI

在專案目錄外先裝好 CLI，之後進任何 repo 執行 codex 即可。

macOS / Linux 官方安裝程式：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

同一條指令也可拿來更新。其他平台可用官方文件列出的 Windows 安裝程式、npm 或 Homebrew。npm 寫法是：

npm install -g @openai/codex

裝好後進一個 Git 專案：

cd ~/code/your-project
codex

第一次啟動會請你選擇登入方式。選 Sign in with ChatGPT 會開瀏覽器完成授權。無瀏覽器的機器可用裝置碼：codex login --device-auth。

安裝 IDE 擴充套件

VS Code、Cursor、Windsurf、VS Code Insiders 到擴充套件市集搜尋 Codex，確認發行者是 OpenAI 再安裝。JetBrains（IntelliJ、PyCharm、WebStorm、Rider 等）走官方的 JetBrains 整合，在 AI Chat 裡選 Codex。

打開側欄後用同一個 ChatGPT 帳號或 API key 登入。細節見 IDE 擴充套件。

設定 Codex Cloud

開啟 chatgpt.com/codex 並用 ChatGPT 登入。
連接 GitHub（或 GitLab Beta），只授權 Codex 真的要碰到的 repo。
為該 repo 建立 environment（雲端環境）：安裝依賴、環境變數、密鑰、setup 指令。
選環境、描述任務，讓它在隔離容器裡跑。

環境怎麼配、網路何時開，見 Codex Cloud。

登入後先做這三件事

用 /status（CLI）或 IDE 狀態列確認模型、工作目錄與權限。
用 /permissions 看目前沙盒：日常互動建議 workspace-write + on-request。
在乾淨的 Git 狀態下開始；任務前後留 checkpoint，改壞才回得去。

不要把密鑰寫進 prompt 或 repo

API key、.env、雲端 secrets 都不要貼進對話。Cloud 的密鑰只在 setup 階段可用，代理開始跑之前會被移除。