本文介绍两种配置方式：一键脚本（macOS / Linux / Windows）与官网桌面客户端。两者写出的都是同一份 Codex 配置，可以随时切换使用。

一分钟说明

配置 Codex 使用本站中转 API 只需要三步：准备一个 API key（sk- 开头）→ 选择要使用的模型 → 把网关地址与 key 写入 ~/.codex/config.toml。一键脚本和桌面客户端都会自动完成最后一步，保留你原有配置中不冲突的部分，并支持随时重新选择模型或一键还原。

如何获取 API key（sk-）

  1. 打开官网并登录：https://token.dingtaiyunteng.com
  2. 进入控制台左侧的「API 密钥」（API Keys）页面
  3. 点击「新建密钥 / Create API key」，按需命名并选择分组
  4. 创建后复制以 sk- 开头的完整密钥
密钥通常只完整显示一次，请立即保存。如果丢失，删除后重新创建一个即可，旧密钥会立即失效。

方式一：一键脚本

前置条件：已安装 Codex CLI（npm install -g @openai/codex）或 ChatGPT 桌面客户端，并至少运行过一次（让 ~/.codex 目录生成）。

macOS / Linux 复制粘贴以下命令并回车：

bash <(curl -fsSL https://token.dingtaiyunteng.com/scripts/codex-opentokenrouter-setup.sh)

Windows 在 PowerShell 中执行：

irm https://token.dingtaiyunteng.com/scripts/codex-opentokenrouter-setup.ps1 | iex

按提示操作：

  1. 输入 1 开始安装
  2. 粘贴你的 API key（以 sk- 开头）
  3. 从网关返回的可用模型列表中选择编号（选 0 可手动输入，直接回车使用 gpt-5.6）

脚本会先请求 /v1/models 验证 key，验证通过后拉取模型列表供你选择；验证失败时会询问是否继续，确认后才会写入配置（此时需手动输入模型名称）。

方式二：官网桌面客户端

  1. 从官网下载页安装 OpenTokenRouter 桌面客户端
  2. 打开「设置 / Setup」页面，勾选要配置的 Codex 客户端
  3. 填写网关地址（https://token.dingtaiyunteng.com）并粘贴 API key
  4. 点击「测试连接」，成功后从拉取到的模型列表中选择模型
  5. 预览确认后点击「应用」，客户端自动写入 ~/.codex/config.toml

桌面客户端会把 API key 存入系统钥匙串/凭据管理器，配置文件里只写认证命令，比脚本内嵌密钥更安全。

脚本做了什么

  • 把原配置备份到 ~/.codex/backup-opentokenrouter/
  • 在 ~/.codex/config.toml 顶部写入 model 与 model_provider = "opentokenrouter"
  • 追加 [model_providers.opentokenrouter]：base_url = "https://token.dingtaiyunteng.com/v1"、wire_api = "responses"、你的 key
  • 删除旧的 opentokenrouter / profiles 配置块，其余配置原样保留
  • 再次运行即可从模型列表重新选择，随时切换模型

验证是否生效

运行 codex，启动信息中应显示 model: gpt-5.6（或你选择的模型）。也可以直接执行：

codex exec --model gpt-5.6 "你好"

常见问题

API key 在哪里申请？ 登录官网 → 控制台 →「API 密钥」→ 新建密钥 → 复制 sk- 开头的完整密钥。

想换模型或换 key？ 再次运行脚本从模型列表重新选择，或在桌面客户端里重新应用即可；原始备份不会被覆盖。

看到 “Unknown model” 提示？ 这是 Codex 内置目录不包含该模型时的提示，通常不影响请求转发；请求会原样发给网关，以网关侧实际支持的模型为准。

想还原？ 再次运行命令并选择 2，脚本会用备份恢复原配置并清理备份目录。

安全说明

脚本只在本机修改 ~/.codex/config.toml，不会向除本站网关外的任何地址发送你的 key。通过 curl | bash（Windows 为 irm | iex）执行远程脚本前，请确认 URL 与内容来源可信。