Codex
Codex CLI Custom API 接入教程
通过简单的配置，即可让本机的 Codex CLI 通过 OurToken API 调用模型，并使用你在 OurToken 账户中的额度。全程大约需要 3 分钟。
准备工作：你需要的两个配置项
| 配置项 | 值 | 获取方式 |
|---|---|---|
OPENAI_BASE_URL | https://api.ourtoken.ai/v1 | 直接复制即可 |
OPENAI_API_KEY | 你的 OurToken API Key | 前往 https://ourtoken.ai/zh/api-keys 创建 |
重要提醒
OPENAI_BASE_URL只需要填写到：texthttps://api.ourtoken.ai/v1不需要在后面添加
/responses，Codex 会自动补全请求路径。在
auth.json中填写 API Key 时，不需要添加Bearer前缀。
第一步：安装 Codex CLI
Mac 用户
打开「终端」，粘贴并执行：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
安装完成后，需要将 Codex 添加到系统环境变量。继续执行：
p="$HOME/.local/bin"; grep -qxF 'export PATH="$HOME/.local/bin:$PATH"' "$HOME/.zshrc" 2>/dev/null || echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$HOME/.zshrc"; export PATH="$p:$PATH"; codex --version
Windows 用户
从开始菜单搜索并打开 PowerShell，粘贴并执行：
powershell -ExecutionPolicy Bypass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
安装完成后，需要将 Codex 添加到系统环境变量。继续执行：
$p="$env:USERPROFILE\.local\bin"; $u=[Environment]::GetEnvironmentVariable("Path","User"); if (($u -split ";") -notcontains $p) {[Environment]::SetEnvironmentVariable("Path",$u.TrimEnd(";")+";"+$p,"User")}; $env:Path+=";$p"; codex --version
运行以下命令：
codex --version
能够看到 Codex 版本号，即表示安装成功。
Codex CLI version screenshot
常见问题
如果无法运行 codex 命令，请检查是否已经将 Codex 的安装目录添加到系统环境变量。
⚠️ 安装后请不要登录 OpenAI 账号。下一步将直接使用 OurToken API Key 完成接入。
第二步：配置 OurToken 凭据
Codex 安装完成后，需要配置以下两个文件：
config.tomlauth.json
如果文件或目录不存在，请手动新建。
Codex configuration directory screenshot
1. 配置 config.toml
文件路径：
Mac：
~/.codex/config.toml
Windows：
C:\Users\<username>\.codex\config.toml
其中，<username> 需要替换为你的 Windows 用户名。
将以下内容复制到 config.toml 文件中：
model = "gpt-5.5"
model_provider = "ourtoken"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.ourtoken]
name = "OurToken"
base_url = "https://api.ourtoken.ai/v1"
wire_api = "responses"
2. 配置 auth.json
文件路径：
Mac：
~/.codex/auth.json
Windows：
C:\Users\<username>\.codex\auth.json
将以下内容复制到 auth.json 文件中：
{
"OPENAI_API_KEY": "你的 OurToken API Key"
}
请将 你的 OurToken API Key 替换为你在 OurToken 创建的真实 API Key。
例如：
{
"OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxx"
}
第三步：验证是否配置成功
打开终端或 PowerShell，在任意目录运行：
codex
进入 Codex 交互界面后，可以发送一条简单的消息，例如：
你好
如果 Codex 能够正常回复，并且可以在 OurToken Dashboard 中查看对应的 API 使用记录，即表示配置成功。
- ✅ Codex 能正常回复
- ✅ OurToken Dashboard 中出现调用记录
- ✅ 账户余额产生相应变化
至此，Codex 已成功接入 OurToken API，可以开始使用。