Codex CLI

配置 Codex CLI 使用 Essevin 的 OpenAI Responses 相容介面。

Codex CLI 是 OpenAI 的官方編程代理。首次接入建議使用控制台「一鍵接入」;手動接入需要配置 config.tomlOPENAI_API_KEY

推薦:控制台一鍵接入

選擇 Codex 分組金鑰

登入控制台,在「API 金鑰」找到 Codex Plus 或 Codex Pro 分組的金鑰。

生成接入命令

點金鑰旁的「一鍵接入」,再選擇 Codex CLI 和目前使用的作業系統。

執行並驗證

將命令貼到終端機執行;完成後重新開啟終端機,輸入 codex

偏好圖形介面時,按CC Switch 指南從金鑰選單點「導入 CCS」,再選擇 Codex CLI

手動配置

系統config.toml 位置
macOS / Linux~/.codex/config.toml
WindowsC:\Users\你的使用者名稱\.codex\config.toml

如果檔案不存在,請建立檔案並填入以下內容:

# config.toml
model_provider = "essevin"
model = "gpt-5.6-sol"

[model_providers.essevin]
name = "Essevin"
base_url = "https://api.essevin.com/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

不要混用兩種金鑰寫法

手動配置用 env_key 從環境變數讀金鑰;一鍵接入用的是 requires_openai_auth = trueauth.json。不要把 requires_openai_auth = true 和環境變數寫法混在同一份配置裡:Codex 0.153 實測這種組合不發送金鑰,網關返回 401 missing_api_key

設定 OPENAI_API_KEY 後啟動 Codex:

臨時設定:只在當前終端機視窗有效。

export OPENAI_API_KEY=sk-你的金鑰
codex

永久設定:寫入 shell 啟動檔,之後新開終端機即可使用。

# zsh(macOS 預設)
echo 'export OPENAI_API_KEY=sk-你的金鑰' >> ~/.zshrc
source ~/.zshrc

# bash(Linux 常見;與上面 zsh 二選一)
echo 'export OPENAI_API_KEY=sk-你的金鑰' >> ~/.bashrc
source ~/.bashrc

聯網搜索與遠端壓縮暫不支援

Codex 的聯網搜索會請求 /v1/alpha/search,遠端上下文壓縮會請求 /v1/responses/compact,這兩個接口目前都不支援,會返回 404。聯網搜索的 404 不影響普通對話;不想看到這條報錯,在 Codex 中關閉聯網搜索即可。

必須用 Codex 分組的金鑰

請使用 Codex 分組(Codex Plus / Codex Pro)的金鑰。卡住了?看報錯速查

本頁目錄