Codex

Codex CLI 和 Codex IDE 扩展共享 ~/.codex/config.toml。自定义提供商必须使用 OpenAI Responses 协议，猫咖啡 API 的 Base URL 为 https://coffeecatbox.cc/v1。

安装

npm install -g @openai/codex@latest

检查安装：

codex --version

Windows 用户可原生运行；需要 Linux 工具链与沙箱时，建议使用 WSL 2。

设置令牌

macOS / Linux / WSL

export COFFEECAT_API_KEY="sk-你的令牌"

Windows PowerShell

[Environment]::SetEnvironmentVariable(
  "COFFEECAT_API_KEY",
  "sk-你的令牌",
  "User"
)

设置持久环境变量后，请打开新终端。

配置 config.toml

文件位置：

• macOS、Linux、WSL：~/.codex/config.toml
• Windows：%USERPROFILE%\.codex\config.toml

model_provider = "coffeecat"
model = "控制台中的 Responses 编程模型 ID"
model_reasoning_effort = "high"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[model_providers.coffeecat]
name = "猫咖啡 API"
base_url = "https://coffeecatbox.cc/v1"
env_key = "COFFEECAT_API_KEY"
wire_api = "responses"
requires_openai_auth = false

必须是 Responses 模型

Codex 当前自定义提供商只支持 wire_api = "responses"。模型或渠道只支持 /v1/chat/completions 时，可能能普通聊天但无法完成 Codex 的代理工作流。

启动

cd /path/to/your/project
codex

临时指定模型：

codex -m "控制台中的模型 ID"

配置修改后，按 Ctrl+C 完全退出当前 Codex，再重新启动。

IDE 扩展

Codex 的 VS Code 扩展与 CLI 使用相同用户配置。安装扩展后无需复制第二份 provider 配置；确认扩展运行环境能读取 COFFEECAT_API_KEY。

常见问题

Missing environment variable

环境变量未进入启动 Codex 的进程。关闭并重新打开终端或 VS Code，然后检查：

printenv COFFEECAT_API_KEY

PowerShell：

$env:COFFEECAT_API_KEY

404 或 endpoint 错误

base_url 使用 https://coffeecatbox.cc/v1，不要填完整 /responses 路径，也不要重复 /v1。

模型可聊天但不会调用工具

换用控制台中明确支持 Responses、函数/工具调用的编程模型，并保留 wire_api = "responses"。