跳轉到主要內容
使用本指南可讓您將 Codex CLI 搭配 CometAPI 作為 model provider 執行。 官方參考資料：
Model 可用性經常變動。以下範例使用 your-model-id —— 請將其替換為來自 CometAPI Models page 的目前可用、適合編碼的 model ID。

​
先決條件

RequirementDetails
作業系統macOS 12+、Linux（Ubuntu 20.04+ / Debian 10+），或透過 WSL2 執行的 Windows 11
Node.js22+（建議使用 LTS）
Git建議 2.23+
CometAPI key可從 CometAPI Dashboard 取得（以 sk- 開頭）

​
安裝 Codex CLI

npm i -g @openai/codex
或透過 Homebrew： 
brew install --cask codex
驗證安裝： 
codex --version

​
設定 CometAPI

有兩種方式可讓 Codex 指向 CometAPI。請選擇最符合您工作流程的方式。
最簡單的選項——只需一行即可將內建的 OpenAI provider 重新導向至 CometAPI。 無需定義自訂 provider。建立 ~/.codex/config.toml：
model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

​
儲存您的 API key

建立 ~/.codex/auth.json： 
{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
請將 sk-your-cometapi-key 替換為您實際的 CometAPI key。
此檔案為必填。 若 auth.json 中沒有有效的 OPENAI_API_KEY 項目， Codex 會以 API key auth is missing a key 結束。

​
啟動 Codex

cd your-project
codex
首次啟動時，Codex 會提示您選擇主題並確認安全性設定。

​
依工作階段覆寫 model

若想在單次執行中切換到不同的 model，而不編輯 config.toml： 
codex --model your-model-id

​
替代方式：環境變數

除了使用 auth.json，您也可以直接匯出 key： 
export OPENAI_API_KEY="sk-your-cometapi-key"
codex
這只會為目前的終端機工作階段設定 key。若要持久化，請將 export 這一行加入 ~/.zshrc 或 ~/.bashrc。

​
疑難排解

SymptomFix
API key auth is missing a key確認 ~/.codex/auth.json 包含 "OPENAI_API_KEY": "sk-..."
意外出現登入提示刪除舊的 ~/.codex/auth.json，並使用您的 CometAPI key 重新建立
找不到 model請查看 Models page 以確認目前可用的 model
連線逾時確認 config.toml 中的 openai_base_url 或 base_url 為 https://api.cometapi.com/v1
Windows 問題Codex 在 Windows 上需要 WSL2——不支援原生 CMD/PowerShell