AnRouter 接入文档

密钥与身份认证

OpenAI 兼容请求统一使用 Bearer Token。AnRouter 的 Anthropic Messages 路由同时接受 Claude Code 使用的 Bearer 认证，以及 Anthropic SDK 常用的 x-api-key。

端点与 Base URL

Base URL 是客户端继续拼接路径的起点，不是完整请求地址。不同客户端拼接方式不同，不能把一条地址机械复制到所有软件。

AnRouter 支持的主要 API 路由

路由存在不等于任意模型都支持该能力。模型、上游渠道、请求字段三者必须兼容。

协议与请求示例

OpenAI Chat Completions

curl https://api.anrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $ANROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.3","messages":[{"role":"user","content":"你好"}]}'

OpenAI Responses

curl https://api.anrouter.com/v1/responses \
  -H "Authorization: Bearer $ANROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.3","input":"审查这个函数的边界条件。"}'

Anthropic Messages

curl https://api.anrouter.com/v1/messages \
  -H "x-api-key: $ANROUTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"glm-5.3",
    "max_tokens":1024,
    "messages":[{"role":"user","content":"你好"}]
  }'

查询当前模型列表

curl https://api.anrouter.com/v1/models \
  -H "Authorization: Bearer $ANROUTER_API_KEY"

排错指南

Codex CLI / 桌面 App

Codex 的 CLI、IDE 扩展和 ChatGPT 桌面端 Codex 功能共享用户级 ~/.codex/config.toml。AnRouter 应配置为独立 provider；不要修改 auth.json 去伪装 OpenAI 官方登录。

1. 安装并验证

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

# 检查
codex --version

Windows PowerShell：irm https://chatgpt.com/codex/install.ps1 | iex

2. 先验证 Responses 路由

curl https://api.anrouter.com/v1/responses \
  -H "Authorization: Bearer $ANROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.3","input":"只回复 ok"}'

3. 写入用户级配置

# ~/.codex/config.toml
model = "glm-5.3"
model_provider = "anrouter"

[model_providers.anrouter]
name = "AnRouter"
base_url = "https://api.anrouter.com/v1"
env_key = "ANROUTER_API_KEY"
wire_api = "responses"

4. 提供密钥并启动

export ANROUTER_API_KEY="your_anrouter_api_key"
codex --model glm-5.3

# 打开桌面端
codex app

桌面 App 或 IDE 扩展可能不继承 shell 变量，可把 ANROUTER_API_KEY=… 放入 ~/.codex/.env，然后完全重启应用并新建会话。

参考：OpenAI Codex 自定义模型 provider

Claude Code / VS Code

Claude Code 向 Anthropic Messages 端点发送请求，因此 Base URL 必须使用不带 /v1 的域名。AnRouter 可以接收这种协议，但 Anthropic 官方不承诺 Claude Code 对非 Claude 模型的完整兼容性；开始真实项目之前务必验证工具调用与编辑流程。

1. 安装

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

claude --version
claude doctor

Windows PowerShell：irm https://claude.ai/install.ps1 | iex

2. 临时测试

export ANTHROPIC_BASE_URL="https://api.anrouter.com"
export ANTHROPIC_AUTH_TOKEN="your_anrouter_api_key"
export ANTHROPIC_MODEL="glm-5.3"

claude

3. 持久化到 Claude Code 设置

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.anrouter.com",
    "ANTHROPIC_AUTH_TOKEN": "your_anrouter_api_key",
    "ANTHROPIC_MODEL": "glm-5.3"
  }
}

4. VS Code 扩展

1. 安装官方 Claude Code 扩展，并先确认终端中的 claude 可以通过 AnRouter 完成一次请求。
2. 扩展与 CLI 默认共享 ~/.claude/settings.json，优先使用上面的共享配置。
3. 若扩展未读取共享变量或仍弹出登录提示，按 ⌘/Ctrl + Shift + P，运行 Preferences: Open User Settings (JSON)。
4. 修改变量后运行 Developer: Reload Window，再发送短请求验证。

仅在需要扩展专用配置时，把下面字段合并进现有 VS Code 用户设置；不要删除文件里其他设置：

{
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.anrouter.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your_anrouter_api_key" },
    { "name": "ANTHROPIC_MODEL", "value": "glm-5.3" }
  ]
}

5. Claude Desktop：Code 标签

Claude Desktop 的本地 Code 会话可复用 Claude Code 设置。若桌面应用没有继承 shell 变量，可在 Local 环境旁的设置入口补充环境变量；这里仍使用不带 /v1 的 ANTHROPIC_BASE_URL=https://api.anrouter.com。

6. Claude Desktop：第三方推理配置

1. 在 Claude Desktop 打开 Help → Troubleshooting → Enable Developer Mode。
2. 再打开 Developer → Configure Third-Party Inference…，Provider 选择 Gateway。
3. Gateway base URL 填 https://api.anrouter.com，填写 AnRouter API Key；认证方式选 bearer，凭据类型选 Static API key。
4. 测试连接，在 Models 区域填写 AnRouter 模型的准确 ID，然后选择 Apply locally。

参考：Claude Code LLM gateway · VS Code 集成 · Claude Desktop 第三方推理

OpenCode

OpenCode 可通过 @ai-sdk/openai-compatible 连接 Chat Completions。TUI、桌面 App 与 IDE 界面可以复用同一 provider 配置。

1. 桌面 App：添加自定义 provider

1. 打开 OpenCode Desktop 的 provider 设置，选择添加自定义 provider。
2. Provider ID 填 anrouter，显示名称填 AnRouter。
3. Base URL 填 https://api.anrouter.com/v1，API Key 填你的 AnRouter 密钥。

4. 在 Models 中添加模型，模型 ID 必须与 AnRouter 模型页或 GET /v1/models 返回完全一致，例如 glm-5.3。
5. 没有特殊需求时，请求 Headers 留空，然后提交并在模型选择器中选择 anrouter/glm-5.3。

2. TUI / CLI：保存凭据

1. 启动 OpenCode，在 TUI 中输入 /connect。
2. 选择 Other，Provider ID 填 anrouter。
3. 输入 AnRouter API Key。该步骤只保存凭据，还需要下面的 provider 配置。

3. 手动配置 provider

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anrouter/glm-5.3",
  "provider": {
    "anrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AnRouter",
      "options": {
        "baseURL": "https://api.anrouter.com/v1"
      },
      "models": {
        "glm-5.3": {
          "name": "GLM 5.3",
          "attachment": true,
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "glm-5.3-flash": {
          "name": "GLM 5.3 Flash",
          "attachment": true,
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "deepseek-v4-flash-0731": {
          "name": "DeepSeek V4 Flash 0731",
          "attachment": true,
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "kimi-k2.6": {
          "name": "Kimi K2.6",
          "attachment": true,
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "minimax-m3": {
          "name": "MiniMax M3",
          "attachment": true,
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "qwen-3.8-27b": {
          "name": "Qwen3.8 27B",
          "attachment": true,
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        }
      }
    }
  }
}

项目配置放在仓库根目录 opencode.json；个人全局配置可放在 ~/.config/opencode/opencode.json。本示例不硬编码 context/output 上限，避免客户端元数据与服务端实际能力不一致。

4. 验证

opencode auth list
opencode

# 在 TUI 中
/models

参考：OpenCode 自定义 provider

OpenClaw

OpenClaw 的模型 provider 与 Gateway 登录令牌是两件事。AnRouter API Key 只用于模型 provider，不要误填到 gateway.auth.token。

1. 安装与检查

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version
openclaw doctor

2. 把密钥放在全局运行环境

# ~/.openclaw/.env
ANROUTER_API_KEY=your_anrouter_api_key

3. 在不覆盖现有配置的前提下添加 provider

请在实际运行 Gateway 的机器上执行下面的增量命令。OpenClaw 会保护 provider 映射，--merge 会保留现有 channels、tools、skills、其他 providers 与 Gateway 设置。

openclaw config set models.providers.anrouter \
  '{"baseUrl":"https://api.anrouter.com/v1","apiKey":"${ANROUTER_API_KEY}","api":"openai-completions","models":[{"id":"glm-5.3","name":"GLM 5.3"},{"id":"glm-5.3-flash","name":"GLM 5.3 Flash"},{"id":"deepseek-v4-flash-0731","name":"DeepSeek V4 Flash 0731"},{"id":"kimi-k2.6","name":"Kimi K2.6"},{"id":"minimax-m3","name":"MiniMax M3"},{"id":"qwen-3.8-27b","name":"Qwen3.8 27B"}]}' \
  --strict-json --merge

4. 验证并重启 Gateway

openclaw config validate
openclaw models list
openclaw models set anrouter/glm-5.3
openclaw gateway restart
openclaw gateway status

参考：OpenClaw 自定义 provider · 安全的 config set 增量修改

Hermes Agent

Hermes 当前推荐通过 hermes model 配置自定义端点。Hermes 官方现行文档使用顶层 custom_providers 列表定义具名自定义端点；下面的手动配置遵循这一官方结构。

1. Hermes Desktop 图形化配置

1. 首次启动时进入模型/provider 配置；之后可从设置中的模型配置入口重新打开。
2. 选择 Local / custom endpoint，Endpoint 填 https://api.anrouter.com/v1，API Key 填 AnRouter 密钥。
3. 模型填写准确 ID，例如 glm-5.3；若出现 API mode，选择 chat_completions。
4. 保存后新建会话，先发送一条短消息验证。

2. 安装 CLI

# macOS / Linux / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

hermes --version
hermes doctor

Windows PowerShell：iex (irm https://hermes-agent.nousresearch.com/install.ps1)

3. CLI 推荐：交互式配置

hermes model

4. 可选：命名 provider 配置

# ~/.hermes/config.yaml
custom_providers:
  - name: anrouter
    base_url: https://api.anrouter.com/v1
    key_env: ANROUTER_API_KEY
    api_mode: chat_completions

model:
  provider: custom:anrouter
  default: glm-5.3

# ~/.hermes/.env
ANROUTER_API_KEY=your_anrouter_api_key

5. 验证

1. 运行 hermes doctor 检查安装与配置。
2. 启动 hermes，先发送短问题。
3. 会话内使用 /model custom:anrouter:glm-5.3 切换；添加或修改 provider 则退出会话后运行 hermes model。

参考：Hermes Desktop · Hermes 自定义端点

其他兼容客户端

如果客户端明确支持“OpenAI compatible / Custom OpenAI endpoint”，通常可以用下面四项接入。客户端名称相似不代表一定允许自定义 Base URL；没有公开配置入口时，不要使用未经证实的环境变量强行覆盖。

1. 先确认客户端最终调用的是 /v1/chat/completions 还是 /v1/responses。
2. 先做最小文本请求，再测试 streaming、tools、vision、JSON 等高级能力。
3. 如果客户端只允许填写官方供应商 Key、没有 Base URL 字段，不应宣称原生兼容 AnRouter。

安全与生产检查