开发工具

Codex

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

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

当前版本

本页按 OpenAI 官方 Codex CLI 文档于 2026-10-12 核验。当前 npm 稳定版为 @openai/codex 0.162.1;安装或升级后运行下面的命令确认本机版本:

Terminal
npm install -g @openai/codex
codex --version

官方也提供 macOS、Linux 和 Windows 的独立安装方式,详见 Codex CLI 官方文档。桌面端 Codex 随 ChatGPT 应用发布,桌面端安装包和版本信息见软件下载中心。

设置密钥

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-6.1-sol"
review_model = "gpt-6.1-sol"

[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
model 和 review_model 默认使用 gpt-6.1-sol。请根据 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,重新启动并新建任务。