Codex CLI 配置
将 OpenAI Codex CLI 切换到 TokenLink，使用任意模型
Codex 是 OpenAI 官方的 AI 编程工具，通过 Responses API 与模型交互。Codex CLI、ChatGPT 桌面端、VS Code 的 Codex 插件共用同一份 ~/.codex/config.toml，配置一次即可在所有形态使用 TokenLink。
方式一：一键配置脚本（推荐）
脚本会自动完成全部配置。运行前请确保已安装 Codex CLI 或 ChatGPT 桌面端，并至少运行过一次（即 ~/.codex 目录已存在）。
macOS / Linux 用户在终端执行：
bash <(curl -fsSL https://tokenlink.stelarx.ai/docs/codex-tokenlink-setup.sh)Windows 用户在 PowerShell 执行：
irm https://tokenlink.stelarx.ai/docs/codex-tokenlink-setup.ps1 | iex启动后选 1 使用 auto（推荐，TokenLink 自动选择最优模型），选 2 指定具体模型 slug，选 9 恢复默认配置。
方式二：手动编辑配置文件
编辑 ~/.codex/config.toml（不存在则新建）：
model = "auto"
model_provider = "tokenlink"
[model_providers.tokenlink]
name = "TokenLink"
base_url = "$BASE_API/openai"
env_key = "TOKENLINK_API_KEY"
wire_api = "responses"export TOKENLINK_API_KEY="YOUR_API_KEY"把 $BASE_API 替换为基础地址（见 快速开始 的基础地址表），YOUR_API_KEY 替换为在 控制台 创建的 Key。
自定义 Provider ID 不能使用保留名称：openai、ollama、lmstudio。
字段说明
| 字段 | 作用 |
|---|---|
model | 默认模型，推荐 auto；也可指定具体 slug（如 gpt-5、deepseek-v4-pro） |
model_provider | 使用的 Provider ID，对应 [model_providers.tokenlink] |
name | Provider 显示名 |
base_url | TokenLink 的 OpenAI 兼容端点 |
env_key | 读取 API Key 的环境变量名 |
wire_api | 与模型通信的协议，"responses" 表示 Responses API |
开始使用
配置完成后，各客户端都读取同一份配置文件：
- Codex CLI：进入项目目录执行
codex，启动信息中显示model: auto（或你指定的 slug）即为生效。 - ChatGPT 桌面端：模型选择器显示「自定义」或所选模型名，都算配置成功；显示模型名时可直接在客户端里切换模型。
- VS Code 的 Codex 插件：与 Codex CLI 共用配置，安装插件后即可使用。
验证
进入项目目录执行 codex，启动信息中显示你配置的模型即为生效；auto 会显示为 TokenLink 实际路由的模型。