Codex CLI
配置 Codex CLI 使用 Essevin 的 OpenAI Responses 相容介面。
Codex CLI 是 OpenAI 的官方編程代理。首次接入建議使用控制台「一鍵接入」;手動接入需要配置 config.toml 和 OPENAI_API_KEY。
推薦:控制台一鍵接入
選擇 Codex 分組金鑰
登入控制台,在「API 金鑰」找到 Codex Plus 或 Codex Pro 分組的金鑰。
生成接入命令
點金鑰旁的「一鍵接入」,再選擇 Codex CLI 和目前使用的作業系統。
執行並驗證
將命令貼到終端機執行;完成後重新開啟終端機,輸入 codex。
偏好圖形介面時,按CC Switch 指南從金鑰選單點「導入 CCS」,再選擇 Codex CLI。
手動配置
| 系統 | config.toml 位置 |
|---|---|
| macOS / Linux | ~/.codex/config.toml |
| Windows | C:\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 = true 加 auth.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)的金鑰。卡住了?看報錯速查。