Aller au contenu
claude-code-router

claude-code-router via Tokonomix

Routez Claude Code vers Tokonomix avec un seul provider block — envoyez vos tours difficiles vers le consensus et votre code standard vers un modèle économique, par règle.

Provider block (config.json)Proxy / routeur Claude CodeMIT · open sourceNode.js · toutes plateformes
claude-code-router — acheminez Claude Code vers n'importe quel backend, via Tokonomix

Qu'est-ce que claude-code-router ?

claude-code-router est un proxy qui s'intercale devant Claude Code et achemine chaque requête vers le backend de votre choix selon des règles — coût, capacité, longueur de contexte. Pointez un Provider vers Tokonomix et vous pouvez piloter Claude Code avec plus de 130 modèles, ou avec le consensus, sans rien changer à votre usage du CLI.

  • Intercepte les requêtes de Claude Code et les transmet au backend configuré.
  • Règles Router par scénario : default, think, background, longContext.
  • Chaque backend est un Provider avec une URL complète de chat-completions, une clé et une liste de modèles.
  • Open source ; configuré depuis ~/.claude-code-router/config.json.

Pourquoi router via Tokonomix ?

  • Envoyez les tours think vers tokonomix-consensus et les tours background vers un slug direct économique — automatiquement.
  • Une seule entrée Provider débloque 130+ modèles pour Claude Code.
  • Les plafonds de dépenses par appel et le routage par région / origine s'appliquent à chaque appel routé.
  • Continuez à utiliser Claude Code exactement comme avant — le routage est invisible.

Connecter Tokonomix dans config.json

Ajoutez un Provider Tokonomix avec l'URL complète de chat-completions (/chat/completions), votre clé et la liste des modèles, puis pointez les règles Router vers ce provider (provider et modèle sont séparés par une virgule).

{
  "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"
  }
}
Deux détails qui surprennent

api_base_url est le endpoint complet incluant /chat/completions (pas seulement la base), et les valeurs Router sont provider,model — une virgule, pas un slash.

Vérifier le fonctionnement

  • Sauvegardez config.json, démarrez claude-code-router, puis exécutez Claude Code via ce proxy.
  • Déclenchez une tâche à fort raisonnement et vérifiez que la règle think l'a routée vers le consensus.
  • Consultez les appels et l'usage en tokens dans votre tableau de bord Tokonomix.

Sélection du modèle

Quel modèle et quel endpoint mon agent doit-il utiliser ?

Choisissez selon ce que fait votre agent, puis changez l'identifiant du modèle à tout moment — chaque modèle du catalogue fonctionne avec la même clé.

Ce que fait votre agentUtilisez ceci
Modifie des fichiers / appelle des outils et diffuse les réponses (la plupart des agents de codage)Un modèle Anthropic via l'endpoint Anthropic (outils + streaming fonctionnent tous les deux)
Appelle des outils mais n'a pas besoin du streaming (n'importe quel modèle)L'endpoint compatible OpenAI avec un identifiant de modèle unique
Veut des outils et du streaming sur un modèle non-AnthropicUtilisez le non-streaming pour l'instant — le streaming des appels d'outils sur d'autres fournisseurs n'est pas encore activé
Chat simple, sans outilsN'importe quel endpoint ; le streaming convient
Veut un verdict multi-modèles (consensus) sur une réponse à enjeu élevéDéfinir le modèle sur tokonomix-consensus sur l'endpoint compatible OpenAI — remarque : le consensus rejette les appels d'outils (pas de tool-calling)
Endpoint & référence API (technique)

anthropic-messages → https://tokonomix.ai/api/anthropic — tools ✓, streaming ✓ (utiliser un modèle Anthropic). openai-completions → https://tokonomix.ai/api/v1 — tools ✓ (passthrough modèle unique), streaming avec outils pas encore disponible. Chat simple : le streaming fonctionne sur les deux. Consensus : openai-completions, modèle tokonomix-consensus, sans outils. Remplacez l'identifiant de modèle par n'importe quel slug renvoyé par GET /api/v1/models.

Parcourir tous les modèles →

Related agents