Codex 桌面端接入 TonyAI

先准备 TonyAI Key，以及分组里明确支持 Codex 的完整模型 ID。 本教程对应的接口格式叫 Responses，选择分组时核对这个名称。 还没创建？先看 创建 API Key 与服务地址。

本篇用于桌面端的本地任务。终端使用请看 Codex CLI。

1. 打开配置文件

从 官方下载入口 安装 Codex 桌面端。如果已经登录 ChatGPT，先从账号菜单退出登录，再完全退出应用。随后编辑用户目录下的配置文件：

系统	默认位置
macOS	~/.codex/config.toml
Windows	%USERPROFILE%\.codex\config.toml

找不到这个文件？ 按 打开 Codex 配置文件 中的系统步骤操作，就会在编辑器里打开它。

文件空白时，可以复制下一步整段配置。已有内容时先备份，再按 已有配置的修改方法 修改。下面的配置粘贴到文件中，不是在终端执行。

2. 配置 TonyAI

只把 YOUR_MODEL_ID 换成你从 TonyAI 复制的完整模型 ID，保留两边的英文引号。其他内容照抄：

model = "YOUR_MODEL_ID"
model_provider = "tonyai"

[model_providers.tonyai]
name = "TonyAI"
base_url = "https://tonyai.link/v1"
wire_api = "responses"
requires_openai_auth = true

model 和 model_provider 放在文件顶部、任何 [分节] 之前；已有同名字段就修改，避免重复。[model_providers.tonyai] 可放在文件末尾。

地址到 /v1 为止，Codex 会使用 Responses 接口。不要填完整的 /v1/responses。

3. 用 TonyAI Key 登录

保存配置，完全退出并重新打开应用。在登录界面选择 API Key 登录，填入 TonyAI Key。新版官方文档将此入口称为 Sign in another way。

这里的 requires_openai_auth = true 表示使用 Codex 的登录凭证机制；请求地址仍由上面的 TonyAI 配置决定。接入 TonyAI 时，使用自己的 TonyAI Key 完成这一步。

这套配置使用登录时保存的 Key，不要再添加 env_key。桌面端和 CLI 若使用同一个配置目录，修改会同时影响它们。

4. 确认接入成功

在电脑上新建空文件夹 TonyAI-Test，在 Codex 中把它添加或打开为项目，再新建本地任务。确认选择了配置的模型，输入「只回复 OK」。收到回复后，打开 TonyAI 使用记录，核对本次用量。然后按 文件操作测试 创建一个测试文件，确认它也能执行操作。

如果提示模型不存在，核对模型 ID 和分组；如果提示未授权，重新检查登录时填写的 Key。API Key 接入不等于开通 ChatGPT 订阅，依赖云端账号的功能仍受工具自身限制。

依据：官方自定义提供商配置、官方登录说明。核对日期：2026-09-07。