开发工具

Codex

通过 Codex 自定义 model provider 连接派拓 Responses API。

Codex 支持在用户级 config.toml 中定义自定义模型提供方。派拓使用 Responses API,密钥通过环境变量提供。

设置密钥

macOS 或 Linux:

Terminal
export PAYTOK_API_KEY="<YOUR_API_KEY>"

PowerShell:

PowerShell
$env:PAYTOK_API_KEY="<YOUR_API_KEY>"

配置 provider

编辑用户级 ~/.codex/config.toml:

~/.codex/config.toml
model_provider = "paytok"
model = "gpt-5.5"

[model_providers.paytok]
name = "PayTok"
base_url = "https://paytok.ai/v1"
env_key = "PAYTOK_API_KEY"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false
gpt-5.5 是示例。请根据 API Key 所属分组的实际模型 ID 进行替换。

启动验证

Terminal
codex

启动后发送一条简单请求,然后在 用量记录 中确认请求已经通过对应密钥记账。

配置说明

  • model_provider 引用下方 model_providers.paytok 的自定义 provider ID。
  • base_url 指向派拓 OpenAI 兼容入口。
  • env_key 是环境变量的名称,不是 API Key 本身。
  • wire_api = "responses" 是 Codex 自定义 provider 支持的协议。
  • requires_openai_auth = false 表示使用派拓 API Key,不要求 ChatGPT 登录。
根据 OpenAI Docs 的 Codex 配置参考,provider 和认证配置应放在用户级 config.toml,项目内 .codex/config.toml 不能覆盖这些键。

故障排查

Missing environment variable

确认启动 Codex 的 shell 能读取 PAYTOK_API_KEY:

Terminal
test -n "$PAYTOK_API_KEY" && echo "PAYTOK_API_KEY is set"

404 或路径错误

确认 base_url 包含 /v1,即 https://paytok.ai/v1。

配置修改后仍使用旧 provider

完全退出 Codex Desktop 或 CLI,重新启动并新建任务。