Ir al contenido
claude-code-router

claude-code-router vía Tokonomix

Enruta Claude Code a Tokonomix con un único bloque de proveedor — manda tus turnos difíciles al consenso y el código repetitivo a un modelo económico, por regla.

Bloque de proveedores (config.json)Proxy / enrutador de Claude CodeMIT · código abiertoNode.js · todas las plataformas
claude-code-router — enruta Claude Code a cualquier backend, vía Tokonomix

¿Qué es claude-code-router?

claude-code-router es un proxy que se coloca delante de Claude Code y enruta cada solicitud al backend de tu elección según reglas de coste, capacidad o longitud de contexto. Apunta un Provider a Tokonomix y podrás usar Claude Code con más de 130 modelos —o con consenso— sin cambiar la forma en que usas la CLI.

  • Intercepta las solicitudes de Claude Code y las reenvía al backend configurado.
  • Reglas de Router por escenario: default, think, background, longContext.
  • Cada backend es un Provider con una URL completa de chat-completions, clave y lista de modelos.
  • Código abierto; se configura desde ~/.claude-code-router/config.json.

¿Por qué enrutar a través de Tokonomix?

  • Envía los turnos think a tokonomix-consensus y los turnos background a un slug directo económico — de forma automática.
  • Una sola entrada de Provider desbloquea más de 130 modelos para Claude Code.
  • Los límites de gasto por llamada y el enrutamiento por región u origen se aplican a cada llamada enrutada.
  • Sigue usando Claude Code exactamente igual que antes — el enrutamiento es invisible.

Conectar Tokonomix en config.json

Añade un Provider de Tokonomix con la URL completa de chat-completions (/chat/completions), tu clave y la lista de modelos; luego apunta las reglas de Router hacia él (el proveedor y el modelo se separan con coma).

{
  "Providers": [
    {
      "name": "tokonomix",
      "api_base_url": "https://tokonomix.ai/api/v1/chat/completions",
      "api_key": "tok_live_your-key",
      "models": ["tokonomix-consensus", "anthropic/claude-sonnet-4-6"]
    }
  ],
  "Router": {
    "default": "tokonomix,anthropic/claude-sonnet-4-6",
    "think": "tokonomix,tokonomix-consensus",
    "background": "tokonomix,anthropic/claude-sonnet-4-6"
  }
}
Dos detalles que suelen confundir

api_base_url es el endpoint completo incluyendo /chat/completions (no solo la base), y los valores de Router son provider,model — una coma, no una barra.

Verifica que funciona

  • Guarda config.json, inicia claude-code-router y ejecuta Claude Code a través de él.
  • Lanza una tarea de razonamiento intensivo y confirma que la regla think la enrutó hacia el consenso.
  • Revisa las llamadas y el uso de tokens en tu panel de Tokonomix.

Selección de modelo

¿Qué modelo y endpoint debe usar mi agente?

Elige según lo que hace tu agente y cambia el id de modelo en cualquier momento — todos los modelos del catálogo funcionan con la misma clave.

Lo que hace tu agenteUsa esto
Edita archivos / llama a herramientas y transmite respuestas (la mayoría de agentes de codificación)Un modelo Anthropic a través del endpoint Anthropic (herramientas + streaming ambos funcionan)
Llama a herramientas pero no necesita streaming (cualquier modelo)El endpoint compatible con OpenAI con un único id de modelo
Necesita herramientas y streaming en un modelo no-AnthropicUsa non-streaming por ahora — las llamadas a herramientas con streaming en otros proveedores aún no están disponibles
Chat normal, sin herramientasCualquier endpoint; el streaming está bien
Quiere un veredicto multi-modelo (consenso) sobre una respuesta de alto impactoEstablece el modelo en tokonomix-consensus en el endpoint compatible con OpenAI — nota: el consenso rechaza las solicitudes de herramientas (sin llamadas a herramientas)
Endpoint y referencia de API (técnico)

anthropic-messages → https://tokonomix.ai/api/anthropic — tools ✓, streaming ✓ (usa un modelo Anthropic). openai-completions → https://tokonomix.ai/api/v1 — tools ✓ (passthrough de modelo único), streaming con herramientas aún no disponible. Chat normal: el streaming funciona en ambos. Consenso: openai-completions, modelo tokonomix-consensus, sin herramientas. Cambia el id de modelo por cualquier slug devuelto por GET /api/v1/models.

Ver todos los modelos →

Related agents