CODEX DESKTOP

TokenPro 接入 Codex 客户端

在 macOS 或 Windows 的 Codex 桌面版中配置 TokenPro Responses API。已安装 Codex 的用户可直接从“配置 TokenPro”开始。

macOSWindowsResponses API

最后验证：2026-08-12

服务商TokenPro

API 地址https://tokenpro.work/v1

API Key<你的 TokenPro API Key>

下载安装 Codex

只从 OpenAI 官方下载页或系统官方应用商店获取安装包，并核对发布者信息。

系统建议安装方式

macOS Apple SiliconOpenAI 官方 Codex.dmg

macOS IntelOpenAI 官方 x64 安装包

WindowsMicrosoft Store 官方页面

Linux请使用 Codex 命令行版本

不要因为系统出现安全警告就直接忽略。先确认下载域名、代码签名和发布者均为官方来源。

备份并配置 TokenPro

Codex Desktop 与 Codex CLI 共用 ~/.codex/config.toml。先备份，再把下面内容合并到现有配置。

mkdir -p ~/.codex
cp ~/.codex/config.toml ~/.codex/config.toml.backup 2>/dev/null || true

model_provider = "tokenpro"
model = "<控制台中的 GPT 模型 ID>"
model_reasoning_effort = "high"

[model_providers.tokenpro]
name = "TokenPro"
base_url = "https://tokenpro.work/v1"
env_key = "TOKENPRO_API_KEY"
wire_api = "responses"

New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
if (Test-Path "$HOME\.codex\config.toml") {
  Copy-Item "$HOME\.codex\config.toml" "$HOME\.codex\config.toml.backup"
}

不要用整段脚本覆盖配置文件，否则可能丢失已有 MCP、权限和模型设置。

设置 API Key

export TOKENPRO_API_KEY="<你的 TokenPro API Key>"

export TOKENPRO_API_KEY="<你的 TokenPro API Key>"

[Environment]::SetEnvironmentVariable(
  "TOKENPRO_API_KEY",
  "<你的 TokenPro API Key>",
  "User"
)

如需长期生效，请把变量保存到你实际使用的安全环境配置或密钥管理工具，而不是复制进项目仓库。

重启、验证与恢复

1完全退出 Codex 客户端，再重新打开，确保新进程读取到环境变量。
2新建一个小型测试任务，在 TokenPro 控制台确认模型为 <控制台中的 GPT 模型 ID>、协议为 Responses。
3出现 401 时，检查变量名是否与 config.toml 中 env_key 一致。
4需要切回原配置时，用 config.toml.backup 恢复并重新启动 Codex。