Agentes de programación
BasicRouter funciona con agentes de programación y herramientas de desarrollo de IA que soportan endpoints API compatibles con OpenAI o Anthropic. Use alias de enrutamiento como mwf/coding-auto para que BasicRouter pueda enrutar al mejor modelo de programación disponible sin requerir que los desarrolladores cambien la configuración de la herramienta.
Configuración genérica compatible con OpenAI
Use esta configuración para Cursor, Codex, Hermes, OpenClaw, Continue, Aider, Cline, agentes basados en LangChain, agentes basados en LlamaIndex y runtimes de agentes personalizados compatibles con OpenAI.
export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"Configuración genérica compatible con Anthropic
Use esta configuración para clientes y herramientas compatibles con Claude que esperan el 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 |
|---|---|---|
| Programación general | mwf/coding-auto | Llamada a herramientas, streaming, fuerte capacidad de programación. |
| Chat de programación rápido | mwf/coding-fast | Baja latencia y streaming. |
| Análisis de repositorios grandes | mwf/coding-long | Contexto largo y salida estable. |
| Asistente de programación sensible al costo | mwf/low-cost | Precio más bajo y calidad de programación aceptable. |
| Captura de UI / programación con visión | mwf/vision-chat | Entrada de visión y salida de texto. |
Guía rápida de Cursor
Use el endpoint compatible con OpenAI.
Base URL: https://api.basicrouter.ai/api/v1
API Key: BASICROUTER_API_KEY
Model: mwf/coding-autoPasos recomendados:
- Abra la configuración de Cursor.
- Agregue o habilite la configuración de clave API compatible con OpenAI.
- Establezca la URL base de OpenAI en
https://api.basicrouter.ai/api/v1. - Agregue un modelo personalizado como
mwf/coding-auto,mwf/coding-fastomwf/coding-long. - Use un modelo que soporte streaming y llamada a herramientas para el mejor comportamiento del agente.
Solución de problemas:
| Problema | Solución sugerida |
|---|---|
| Modelo no mostrado | Agregue el nombre del modelo manualmente como un modelo personalizado. |
| Falla la llamada a herramientas | Use un modelo con tool_calling: true en la página de Modelos. |
| Streaming interrumpido | Reintente con backoff o use un alias de enrutamiento con respaldo. |
| Error 401 | Verifique la clave API y la URL base. |
| Error 404 de modelo | Confirme que el modelo esté habilitado para la cuenta. |
Guía rápida de Claude Code
Use el endpoint de puerta de enlace compatible con 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 soporta esta ruta compatible con Anthropic para Claude Code y compatibilidad con el SDK de Anthropic:
POST /api/v1/messagesRequisitos recomendados:
| Requisito | Motivo |
|---|---|
| Forma de solicitud compatible con Anthropic Messages | Claude Code espera mensajes estilo Anthropic. |
| Soporte de streaming | Claude Code depende de la UX de streaming. |
| Soporte de llamada a herramientas | Requerido para flujos de trabajo de programación agéntica. |
| Contexto largo | Útil para tareas a nivel de repositorio. |
| Respaldos estables | Útil para sesiones de programación largas. |
Guía rápida de Codex
Use BasicRouter como proveedor de modelos personalizado compatible con OpenAI.
Configuración de proveedor de ejemplo:
[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"Variable de entorno:
export BASICROUTER_API_KEY="br_xxx"Modelos recomendados:
| Modelo | Caso de uso |
|---|---|
mwf/coding-auto | Modelo de agente de programación predeterminado. |
mwf/coding-long | Contexto de repositorios grandes. |
mwf/coding-fast | Iteración rápida y cambios pequeños. |
Solución de problemas:
| Problema | Solución sugerida |
|---|---|
| Error de autenticación | Confirme que env_key apunta a BASICROUTER_API_KEY. |
| Modelo no encontrado | Agregue el alias en la Consola de BasicRouter o use un ID de modelo directo. |
| Error de Responses API | Use wire_api = "responses" solo para modelos y endpoints que soporten Responses. |
| Modelo solo de Chat Completions | Cambie a una wire API compatible con chat si el cliente lo soporta. |
Guía rápida de Hermes
Use el endpoint compatible con OpenAI a menos que su despliegue de Hermes esté configurado para otro 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 trabajo de Hermes | Modelo |
|---|---|
| Generación de código general | mwf/coding-auto |
| Ejecución de tareas de baja latencia | mwf/coding-fast |
| Escaneo de repositorios de contexto largo | mwf/coding-long |
| Tareas en segundo plano sensibles al costo | mwf/low-cost |
Guía rápida de OpenClaw
Use el endpoint compatible con OpenAI para la configuración de runtime de agente 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"Si OpenClaw soporta múltiples proveedores, configure BasicRouter como proveedor compatible con OpenAI y use alias de enrutamiento de BasicRouter para la selección de modelos.
{
"provider": "openai-compatible",
"base_url": "https://api.basicrouter.ai/api/v1",
"api_key_env": "BASICROUTER_API_KEY",
"model": "mwf/coding-auto"
}Lista de verificación de compatibilidad de agentes
| Capacidad | Requerida para |
|---|---|
| Streaming | Buena UX en terminal/editor. |
| Llamada a herramientas | Programación agéntica, ediciones de archivos, ejecución de comandos. |
| Contexto largo | Repositorios grandes y cambios en múltiples archivos. |
| Salidas estructuradas | Planificación, descomposición de tareas, flujos de trabajo automatizados. |
| Entrada de visión | Análisis de capturas de UI y flujos de trabajo de diseño a código. |
| Respaldo | Estabilidad de producción y tareas de larga duración. |