¿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
Routerpor escenario:default,think,background,longContext. - Cada backend es un
Providercon 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
thinkatokonomix-consensusy los turnosbackgrounda 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"
}
}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
thinkla enrutó hacia el consenso. - Revisa las llamadas y el uso de tokens en tu panel de Tokonomix.

