Integração

Agentes de programação

O BasicRouter funciona com agentes de programação e ferramentas de desenvolvimento de IA que suportam endpoints de API compatíveis com OpenAI ou Anthropic. Use aliases de roteamento como mwf/coding-auto para que o BasicRouter possa rotear para o melhor modelo de programação disponível sem exigir que os desenvolvedores alterem a configuração da ferramenta.

Configuração genérica compatível com OpenAI

Use esta configuração para Cursor, Codex, Hermes, OpenClaw, Continue, Aider, Cline, agentes baseados em LangChain, agentes baseados em LlamaIndex e runtimes de agentes personalizados compatíveis com OpenAI.

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

Configuração genérica compatível com Anthropic

Use esta configuração para clientes compatíveis com Claude e ferramentas que esperam o formato 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"

Modelos de agente recomendados

Caso de uso	Alias recomendado	Requisitos
Programação geral	`mwf/coding-auto`	Chamada de ferramentas, streaming, forte capacidade de programação.
Chat de programação rápido	`mwf/coding-fast`	Baixa latência e streaming.
Análise de repositório grande	`mwf/coding-long`	Contexto longo e saída estável.
Assistente de programação sensível a custos	`mwf/low-cost`	Preço menor e qualidade de programação aceitável.
Captura de tela de UI / programação com visão	`mwf/vision-chat`	Entrada de visão e saída de texto.

Guia rápido do Cursor

Use o endpoint compatível com OpenAI.

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

Passos recomendados:

Abra as configurações do Cursor.
Adicione ou ative a configuração de chave API compatível com OpenAI.
Defina a substituição da URL base do OpenAI para https://api.basicrouter.ai/api/v1.
Adicione um modelo personalizado como mwf/coding-auto, mwf/coding-fast ou mwf/coding-long.
Use um modelo que suporte streaming e chamada de ferramentas para o melhor comportamento do agente.

Solução de problemas:

Problema	Correção sugerida
Modelo não exibido	Adicione o nome do modelo manualmente como um modelo personalizado.
Falha na chamada de ferramentas	Use um modelo com `tool_calling: true` na página de Modelos.
Streaming interrompido	Repita com backoff ou use um alias de roteamento com fallback.
Erro 401	Verifique a chave API e a URL base.
Erro 404 de modelo	Confirme se o modelo está ativado para a conta.

Guia rápido do Claude Code

Use o endpoint do gateway compatível com Anthropic.

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

O BasicRouter suporta este caminho compatível com Anthropic para compatibilidade com Claude Code e SDK Anthropic:

POST /api/v1/messages

Requisitos recomendados:

Requisito	Motivo
Formato de solicitação compatível com Anthropic Messages	O Claude Code espera mensagens no estilo Anthropic.
Suporte a streaming	O Claude Code depende da UX de streaming.
Suporte a chamada de ferramentas	Obrigatório para fluxos de trabalho de programação agentic.
Contexto longo	Útil para tarefas no nível de repositório.
Fallback estável	Útil para sessões de programação demoradas.

Guia rápido do Codex

Use o BasicRouter como um provedor de modelo personalizado compatível com OpenAI.

Exemplo de configuração do provedor:

[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"

Variável de ambiente:

export BASICROUTER_API_KEY="br_xxx"

Modelos recomendados:

Modelo	Caso de uso
`mwf/coding-auto`	Modelo de agente de programação padrão.
`mwf/coding-long`	Contexto de repositório grande.
`mwf/coding-fast`	Iteração rápida e pequenas alterações.

Solução de problemas:

Problema	Correção sugerida
Erro de autenticação	Confirme que `env_key` aponta para `BASICROUTER_API_KEY`.
Modelo não encontrado	Adicione o alias no Console do BasicRouter ou use um ID de modelo direto.
Erro da API Responses	Use `wire_api = "responses"` apenas para modelos e endpoints que suportam Responses.
Modelo apenas para Chat Completions	Mude para uma API wire compatível com chat se o cliente suportar.

Guia rápido do Hermes

Use o endpoint compatível com OpenAI, a menos que sua implantação do Hermes esteja configurada para outro protocolo.

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

Política de modelo recomendada:

Carga de trabalho do Hermes	Modelo
Geração de código geral	`mwf/coding-auto`
Execução de tarefas de baixa latência	`mwf/coding-fast`
Verificação de repositório de contexto longo	`mwf/coding-long`
Tarefas em segundo plano sensíveis a custos	`mwf/low-cost`

Guia rápido do OpenClaw

Use o endpoint compatível com OpenAI para a configuração de runtime de agente no estilo OpenAI.

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

Se o OpenClaw suportar múltiplos provedores, configure o BasicRouter como um provedor compatível com OpenAI e use aliases de roteamento do BasicRouter para seleção de modelo.

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

Lista de verificação de compatibilidade de agentes

Capacidade	Obrigatório para
Streaming	Boa UX de terminal/editor.
Chamada de ferramentas	Programação agentic, edições de arquivo, execução de comandos.
Contexto longo	Repositórios grandes e alterações em múltiplos arquivos.
Saídas estruturadas	Planejamento, decomposição de tarefas, fluxos automatizados.
Entrada de visão	Análise de captura de tela de UI e fluxos de design para código.
Fallback	Estabilidade de produção e tarefas demoradas.