BasicRouter
控制台

编程智能体

BasicRouter 兼容支持 OpenAI 兼容或 Anthropic 兼容 API 端点的编程智能体和 AI 开发工具。使用 mwf/coding-auto 等路由别名，BasicRouter 即可路由到最佳的可用编程模型，无需开发者更改工具配置。

通用 OpenAI 兼容配置

此配置适用于 Cursor、Codex、Hermes、OpenClaw、Continue、Aider、Cline、基于 LangChain 的智能体、基于 LlamaIndex 的智能体以及自定义 OpenAI 兼容智能体运行时。

export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"

通用 Anthropic 兼容配置

此配置适用于 Claude 兼容客户端以及期望 Anthropic Messages 格式的工具。

export ANTHROPIC_BASE_URL="https://api.basicrouter.ai/api/anthropic"
export ANTHROPIC_API_KEY="$BASICROUTER_API_KEY"
export ANTHROPIC_MODEL="mwf/coding-auto"
使用场景推荐别名要求
通用编程mwf/coding-auto工具调用、流式输出、强编程能力。
快速编程对话mwf/coding-fast低延迟和流式输出。
大型仓库分析mwf/coding-long长上下文和稳定输出。
成本敏感的编程助手mwf/low-cost较低价格且可接受的编程质量。
UI 截图 / 视觉编程mwf/vision-chat视觉输入和文本输出。

Cursor 快速指南

使用 OpenAI 兼容端点。

Base URL: https://api.basicrouter.ai/api/v1
API Key:  BASICROUTER_API_KEY
Model:    mwf/coding-auto

推荐步骤：

  1. 打开 Cursor 设置。
  2. 添加或启用 OpenAI 兼容 API 密钥配置。
  3. 将 OpenAI base URL 覆盖设置为 https://api.basicrouter.ai/api/v1。
  4. 添加自定义模型，例如 mwf/coding-auto、 mwf/coding-fast 或 mwf/coding-long。
  5. 使用支持流式输出和工具调用的模型以获得最佳智能体表现。

故障排查：

问题建议修复
模型未显示手动将模型名称添加为自定义模型。
工具调用失败在模型页面使用 tool_calling: true 的模型。
流式中断使用退避重试或使用带兜底的路由别名。
401 错误检查 API 密钥和 base URL。
404 模型错误确认该模型已为账户启用。

Claude Code 快速指南

使用 Anthropic 兼容网关端点。

export ANTHROPIC_BASE_URL="https://api.basicrouter.ai/api/anthropic"
export ANTHROPIC_API_KEY="$BASICROUTER_API_KEY"
export ANTHROPIC_MODEL="mwf/coding-auto"

BasicRouter 为 Claude Code 和 Anthropic SDK 兼容性提供此 Anthropic 兼容路径：

POST /api/v1/messages

推荐要求：

要求原因
Anthropic Messages 兼容的请求结构Claude Code 期望 Anthropic 风格的消息。
流式支持Claude Code 依赖流式交互体验。
工具调用支持编程智能体工作流所必需。
长上下文对仓库级任务有用。
稳定兜底对长时间运行的编程会话有用。

Codex 快速指南

将 BasicRouter 作为自定义 OpenAI 兼容模型提供商使用。

示例提供商配置：

[model_providers.basicrouter]
name = "BasicRouter"
base_url = "https://api.basicrouter.ai/api/v1"
env_key = "BASICROUTER_API_KEY"
wire_api = "responses"

model_provider = "basicrouter"
model = "mwf/coding-auto"

环境变量：

export BASICROUTER_API_KEY="br_xxx"

推荐模型：

模型使用场景
mwf/coding-auto默认编程智能体模型。
mwf/coding-long大型仓库上下文。
mwf/coding-fast快速迭代和小改动。

故障排查：

问题建议修复
认证错误确认 env_key 指向 BASICROUTER_API_KEY。
未找到模型在 BasicRouter 控制台添加别名或使用直接的模型 ID。
Responses API 错误仅对支持 Responses 的模型和端点使用 wire_api = "responses"。
仅支持 Chat Completions 的模型如果客户端支持，切换为 chat 兼容的 wire API。

Hermes 快速指南

除非你的 Hermes 部署配置了其他协议，否则使用 OpenAI 兼容端点。

export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"

推荐模型策略：

Hermes 工作负载模型
通用代码生成mwf/coding-auto
低延迟任务执行mwf/coding-fast
长上下文仓库扫描mwf/coding-long
成本敏感的后台任务mwf/low-cost

OpenClaw 快速指南

使用 OpenAI 兼容端点进行 OpenAI 风格智能体运行时配置。

export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"

如果 OpenClaw 支持多提供商，请将 BasicRouter 配置为 OpenAI 兼容提供商，并使用 BasicRouter 路由别名进行模型选择。

{
  "provider": "openai-compatible",
  "base_url": "https://api.basicrouter.ai/api/v1",
  "api_key_env": "BASICROUTER_API_KEY",
  "model": "mwf/coding-auto"
}

智能体兼容性检查清单

能力适用场景
流式输出良好的终端/编辑器交互体验。
工具调用编程智能体、文件编辑、命令执行。
长上下文大型仓库和多文件改动。
结构化输出规划、任务分解、自动化工作流。
视觉输入UI 截图分析和设计转代码工作流。
兜底生产稳定性和长时间运行的任务。