AgentRouter Codex 接入指南

本文介绍如何将 OpenAI Codex 接入 AgentRouter，通过其 OpenAI Chat Completions 兼容接口，在 Codex 中切换使用 gpt-5、glm-4.6、deepseek-v3.1 等多种模型，无需为每个模型单独配置环境。

什么是 AgentRouter

AgentRouter 是一个统一的 AI 模型 API 路由服务，对外提供 OpenAI 兼容接口。借助它，你可以在同一个客户端（如 OpenAI Codex）中接入多家模型厂商，只需维护一个 API Key 即可按需切换模型。本指南以 Codex CLI 为例，演示从安装到启动的完整流程。

安装 Codex

Codex 是 OpenAI 提供的命令行编码智能体，需要先在本地全局安装。支持 pnpm、npm、yarn 三种方式：

# 使用 pnpm（推荐）
pnpm install -g @openai/codex

# 或使用 npm
npm install -g @openai/codex

# 或使用 yarn
yarn global add @openai/codex

配置环境变量

配置分为四步：获取 API Key、设置环境变量、写入 config.toml、写入 auth.json。

1. 获取 API Key

访问 AgentRouter 控制台 https://agentrouter.org/console/token，登录后申请你的 API Key。

2. 设置环境变量

将申请到的 Key 写入系统环境变量，变量名为 AGENT_ROUTER_TOKEN：

# macOS / Linux (~/.zshrc 或 ~/.bashrc)
export AGENT_ROUTER_TOKEN="你申请的 API Key"

# Windows (PowerShell)
$env:AGENT_ROUTER_TOKEN="你申请的 API Key"

修改完 shell 配置文件后，记得执行 source ~/.zshrc 使其立即生效。

3. 创建 config.toml

新建 ~/.codex/config.toml 文件，填入以下配置：

model = "gpt-5" # 也可以改为 glm4.5、glm-4.6 或 deepseek-v3.1
model_provider = "openai-chat-completions"
preferred_auth_method = "apikey"

[model_providers.openai-chat-completions]
name = "OpenAI using Chat Completions"
base_url = "https://agentrouter.org/v1"
env_key = "AGENT_ROUTER_TOKEN"
wire_api = "chat"
query_params = {}
stream_idle_timeout_ms = 300000

4. 创建 auth.json

新建 ~/.codex/auth.json 文件，写入你的 Key：

{
  "OPENAI_API_KEY": "这里替换为你申请的 KEY"
}

直接启动使用

配置完成后，在终端进入你要操作的项目目录，直接运行 codex 即可启动：

# 进入项目目录
cd my-project

# 启动 OpenAI Codex
codex

启动后，Codex 会通过 AgentRouter 路由到你在 config.toml 中指定的模型。

在 VSCode 中的 Codex 中使用

如果你更习惯在 VSCode 中使用，按以下步骤配置。

1. 安装 Codex 扩展

先按上文安装 Codex CLI，并完成环境变量与配置文件的设置。然后在 VSCode 扩展市场搜索并安装 Codex 扩展。

2. 切换为 JSON 配置模式

打开 VSCode 设置，点击右上角的图标，将可视化设置切换为 JSON 配置模式。

3. 添加配置项

在 settings.json 中加入以下配置：

{
  "chatgpt.apiBase": "https://agentrouter.org/v1",
  "chatgpt.config": {
    "preferred_auth_method": "api_key",
    "model_provider": "openai-chat-completions"
  }
}

注：AgentRouter 官方文档中此处字段名写作 pepreferred_auth_method，应为 preferred_auth_method 的笔误，本指南已修正。请按修正后的字段填写，否则鉴权配置不会生效。

4. 开始使用

点击侧边栏的 Codex 图标，即可在 VSCode 中开始使用。

支持的模型

通过 AgentRouter 接入 Codex 后，可以在 ~/.codex/config.toml 的 model 字段中切换以下模型：

切换模型只需修改 config.toml 中的 model 字段，重新启动 Codex 即可生效。

注意事项

• API Key 安全：auth.json 和环境变量中包含敏感信息，切勿提交到公开仓库，建议加入 .gitignore。
• 环境变量生效：修改 shell 配置后需重新加载或新开终端窗口。
• 模型可用性：不同模型的可用性与计费方式以 AgentRouter 控制台为准。