通用原则

编码 Agent 大体分为三类协议，接入前先确认工具属于哪一类：

  • OpenAI Chat Completions 兼容：绝大多数工具，base URL 填 <你的网关地址>/v1，API Key 填你的 OpenTokenRouter 密钥。
  • OpenAI Responses 协议：Codex CLI，base URL 填 <你的网关地址>/v1。
  • Anthropic Messages 协议：Claude Code，base URL 填 <你的网关地址>（不要加 /v1）。

模型 ID 以首页「实时价格」标记 Live settlement 的模型为准，或在工具里请求 /v1/models 获取。

Codex CLI

使用独立 profile，完整步骤见《客户端配置指南》。核心是创建 ~/.codex/opentokenrouter.config.toml：

model_provider = "opentokenrouter"

[model_providers.opentokenrouter]
name = "OpenTokenRouter"
base_url = "<你的网关地址>/v1"
env_key = "OPENTOKENROUTER_API_KEY"
wire_api = "responses"

启动：export OPENTOKENROUTER_API_KEY=sk-你的密钥 && codex --profile opentokenrouter --model 模型ID。

Claude Code

完整步骤见《客户端配置指南》。核心：

export ANTHROPIC_BASE_URL="<你的网关地址>"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude

Cursor

  1. 打开 Settings → Models。
  2. 在 API Key 区域选择/添加 OpenAI 兼容提供商，填入你的 API Key。
  3. Override OpenAI Base URL 填 <你的网关地址>/v1。
  4. 在模型列表启用你要用的模型 ID（来自 /v1/models）。

提示：Cursor 的部分内置功能仍走官方服务；自定义模型只影响对话与代码生成请求。

Windsurf

  1. 点击左下角模型选择器 → Add custom model。
  2. Provider 选择 OpenAI 兼容，Base URL 填 <你的网关地址>/v1。
  3. 填入 API Key 与模型 ID 后保存并选中。

Cline

  1. 打开 Settings → API Provider。
  2. 选择 OpenAI Compatible。
  3. Base URL 填 <你的网关地址>/v1，API Key 填你的密钥。
  4. 在 Model ID 填入可用的模型 ID。

Roo Code

操作与 Cline 一致（同为 VS Code 扩展）：Settings → API Provider → OpenAI Compatible，Base URL <你的网关地址>/v1，填入密钥与模型 ID。

OpenCode

编辑 ~/.config/opencode/opencode.json，添加 OpenAI 兼容 provider：

{
  "provider": {
    "opentokenrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenTokenRouter",
      "options": {
        "baseURL": "<你的网关地址>/v1",
        "apiKey": "{env:OPENTOKENROUTER_API_KEY}"
      }
    }
  }
}

启动时指定：export OPENTOKENROUTER_API_KEY=sk-你的密钥 && opencode --provider opentokenrouter。

Aider

export OPENAI_API_BASE="<你的网关地址>/v1"
export OPENAI_API_KEY="sk-你的密钥"
aider --model 模型ID

也可以直接传参：aider --openai-api-base <你的网关地址>/v1 --openai-api-key sk-你的密钥。

Continue

编辑 ~/.continue/config.json，添加 OpenAI 兼容模型：

{
  "models": [{
    "title": "OpenTokenRouter",
    "provider": "openai",
    "model": "模型ID",
    "apiBase": "<你的网关地址>/v1",
    "apiKey": "sk-你的密钥"
  }]
}

常见问题

  • 400 协议错误：确认工具类型与协议匹配（Responses 客户端不要指向 chat/completions）。
  • 401：密钥错误或未填写，检查工具里的 API Key 配置。
  • 模型不可用：模型 ID 必须来自 /v1/models 且标记 Live settlement。
  • 流式中断/首字慢：不要在本地代理层缓冲 SSE 响应。