AGENT CLIENTS

Agent 客户端接入

不需要编写程序。为 Agent 配置 LLMRouter 接口地址、API Key 和模型名称，即可使用可用的兼容模型。

Claude Code

在终端设置 Anthropic 接口地址和 API Key，再启动 Claude Code。所选模型需要支持 Messages、工具调用和流式输出。

在控制台创建独立 API Key，并确认目标模型支持 Anthropic Messages。
在启动 Claude Code 的终端执行下面的命令。
发送一条简单消息，确认模型可以回复和调用工具。

export ANTHROPIC_BASE_URL=https://api.llmrouter.pro/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-lr-your-key

claude --model your-model

Codex

在启动 Codex 的同一个终端设置 OpenAI 接口地址和 API Key。Codex 使用 Responses API，请在模型目录中选择支持该协议的模型。

创建 API Key，并选择支持 Responses API 的模型。
在终端执行下面的命令，将模型 ID 替换为实际值。
让 Codex 读取当前目录，确认鉴权、模型和工具调用都正常。

export OPENAI_BASE_URL=https://api.llmrouter.pro/v1
export OPENAI_API_KEY=sk-lr-your-key

codex --model your-model

Hermes

运行 hermes model，选择自定义接口并填写地址、密钥和模型。也可以编辑 ~/.hermes/config.yaml：

运行模型配置命令并选择 Custom Endpoint。
填写 OpenAI 兼容地址、API Key 和目标模型 ID。
保存后启动 Hermes，发送一条简单任务完成验证。

model:
  default: your-model
  provider: custom
  base_url: https://api.llmrouter.pro/v1
  api_key: sk-lr-your-key

OpenClaw

在 OpenClaw 配置中添加 LLMRouter 自定义模型提供方，并将它设为默认模型。把 your-model 替换为模型目录中展示的模型 ID。

打开 OpenClaw 配置文件，添加 llmrouter Provider。
设置接口地址、API Key 环境变量和可用模型。
将默认模型设置为 llmrouter/your-model，重启后验证。

{
  "env": {
    "LLMROUTER_API_KEY": "sk-lr-your-key"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "llmrouter/your-model"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "llmrouter": {
        "baseUrl": "https://api.llmrouter.pro/v1",
        "apiKey": "${LLMROUTER_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "your-model",
            "name": "Your model"
          }
        ]
      }
    }
  }
}

其他 Agent

如果 Agent 支持自定义接口地址，先确认它兼容哪一种协议，再填写对应地址：

OpenAI 兼容: https://api.llmrouter.pro/v1
Anthropic 兼容: https://api.llmrouter.pro/anthropic

Cline

打开 VS Code 中的 Cline 面板，进入设置页面并填写以下内容：

API Provider: OpenAI Compatible
Base URL: https://api.llmrouter.pro/v1
API Key: sk-lr-your-key
Model ID: your-model

点击 Cline 面板中的设置图标。
选择 OpenAI Compatible，按上表填写四项配置。
保存后发送一条测试消息，确认连接成功。

Roo Code

打开 Roo Code 的 Provider 设置，使用 OpenAI 兼容配置：

API Provider: OpenAI Compatible
Base URL: https://api.llmrouter.pro/v1
API Key: sk-lr-your-key
Model ID: your-model

在 Roo Code 侧边栏打开设置。
选择 OpenAI Compatible，填写接口地址、密钥和模型 ID。
保存配置，使用 Ask 或 Code 模式发送测试任务。

Continue

Continue 可以通过 OpenAI Provider 的 apiBase 连接兼容接口。在 config.yaml 中加入以下模型配置：

name: LLMRouter
version: 0.0.1
schema: v1

models:
  - name: LLMRouter Model
    provider: openai
    model: your-model
    apiBase: https://api.llmrouter.pro/v1
    apiKey: sk-lr-your-key
    roles:
      - chat
      - edit
      - apply

建议为每个 Agent 创建独立 API Key，并设置可用模型和额度限制。可以先创建 API Key，再到模型目录确认模型 ID 与兼容协议。

接入排查顺序

确认 API Key 状态和余额。
确认模型已经发布且允许当前密钥调用。
确认 Agent 选择的协议和接口地址匹配。
在控制台查看请求 ID、错误码和提供方状态。