Codex CLI 接入 TonyAI

本篇是在终端中使用 Codex。 它使用 Responses 接口格式，选择 TonyAI 分组时确认支持 Codex。先准备支持该协议的 TonyAI Key 和模型 ID。

1. 安装 Codex CLI

先打开终端。只执行自己系统对应的一组安装命令，它会从官方站点下载并安装 Codex。

macOS / Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows PowerShell

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

安装完成后，关闭并重新打开终端，再输入：

codex --version

能显示版本号，就可以继续。如果提示「找不到命令」或「不是内部或外部命令」，说明工具还没安装好，或终端尚未识别安装位置；先按安装结果提示处理，详见官方安装说明。

2. 配置 TonyAI

按打开 Codex 配置文件操作。在打开的编辑器中填写下面内容，不要把这段配置粘贴到终端执行。

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

只把 YOUR_MODEL_ID 换成 TonyAI 提供的完整模型 ID，保留英文引号，保存文件。已有文件先备份、再合并：前两行放在任何 [分节] 之前，同名字段修改一次即可。配置写到用户目录，不要写到项目目录。

如果已经按桌面端教程配置过同一个目录，这一步不用重复。

3. 使用 TonyAI Key 登录

把下面的 YOUR_TONYAI_API_KEY 换成自己的 Key，按当前终端类型执行。

macOS / Linux：

export TONYAI_API_KEY="YOUR_TONYAI_API_KEY"
printenv TONYAI_API_KEY | codex login --with-api-key
unset TONYAI_API_KEY

Windows PowerShell：

$env:TONYAI_API_KEY = "YOUR_TONYAI_API_KEY"
$env:TONYAI_API_KEY | codex login --with-api-key
Remove-Item Env:TONYAI_API_KEY

这是将 Key 交给 Codex 保存，后续不需要每次设置变量。命令中的真实密钥可能留在终端历史中，勿分享终端记录。此处不要再配置 env_key，也不要改用 ChatGPT 登录。

4. 开始使用

第一次没有项目也没关系。下面会在你的用户目录创建测试文件夹 TonyAI-Test，进入它，再启动 Codex。命令在终端运行。

macOS / Linux：

mkdir -p ~/TonyAI-Test
cd ~/TonyAI-Test
codex

Windows PowerShell：

New-Item -ItemType Directory -Force "$env:USERPROFILE\TonyAI-Test" | Out-Null
Set-Location "$env:USERPROFILE\TonyAI-Test"
codex

如果工具询问是否信任当前文件夹，确认是刚创建的测试文件夹后再继续。以后在你要处理的文件夹中运行这条命令即可：

codex

工具启动、出现对话输入框后，输入 /status 并回车，检查当前模型与配置；然后输入「只回复 OK」。/status 是发给 Codex 的，不是在启动前当作系统命令执行。收到回复后，打开 TonyAI 使用记录确认请求。接着按文件操作测试检查能否创建测试文件。

如果认证成功但调用失败，优先检查模型 ID、分组是否支持 Responses，以及余额或套餐状态。修改配置后重新启动 CLI，使用新会话验证。

依据：官方 CLI 指南、自定义提供商、API Key 登录。核对日期：2026-09-07。

1. 安装 Codex CLI​

2. 配置 TonyAI​

3. 使用 TonyAI Key 登录​

4. 开始使用​

1. 安装 Codex CLI

2. 配置 TonyAI

3. 使用 TonyAI Key 登录

4. 开始使用