Présentation du projet Claude Code Router

Aperçu du projet

Claude Code Router est un projet open-source qui vise à acheminer les requêtes Claude Code vers différents modèles d'IA, servant de base à l'infrastructure de codage. Il permet aux utilisateurs de décider comment interagir avec les modèles tout en bénéficiant des mises à jour d'Anthropic. L'objectif principal de ce projet est de réduire considérablement le coût d'utilisation de Claude Code grâce à un routage intelligent et à la collaboration multi-modèles.

Motivation du projet

Les outils de programmation IA traditionnels présentent les problèmes suivants :

• Coût élevé : L'utilisation directe de modèles haut de gamme comme Claude pour toutes les tâches est très coûteuse.
• Limitations des modèles : Un modèle unique ne peut pas toujours offrir les meilleures performances dans tous les scénarios.
• Gaspillage des ressources : Des modèles complexes sont utilisés même pour des tâches simples, ce qui entraîne un gaspillage de ressources.

Claude Code Router résout ces problèmes grâce à un routage intelligent. L'auteur mentionne qu'en utilisant Claude-4 avec VSCode Copilot pour résoudre un problème Flutter, trois tours de conversation ont suffi à corrompre les fichiers, nécessitant un retour en arrière. En revanche, l'utilisation de Claude Code avec DeepSeek a permis de mener à bien la tâche en trois ou quatre tours de conversation, pour un coût inférieur à 1 CNY.

Fonctionnalités clés

1. Fonctionnement en double mode

• Mode Normal : Utilise un modèle unique pour toutes les tâches.
• Mode Routeur : Utilise plusieurs modèles spécialisés qui collaborent pour accomplir différents types de tâches.

2. Division intelligente des tâches entre les modèles

En mode routeur, le système utilise quatre modèles spécialisés différents :

• Agent Routeur (Router Agent) : qwen2.5-coder-3b

  • Responsable de la distribution du routage des requêtes.
  • Ne nécessite pas une intelligence élevée, un petit modèle suffit.
  • Utilise actuellement le modèle officiel gratuit qwen2.5-coder-3b d'Alibaba Cloud.

• Agent d'Outils (Tool Agent) : qwen-max-0125

  • Responsable de l'appel d'outils.
  • Doit prendre en charge les appels de fonction.
  • Doit prendre en charge une longueur de description d'outil suffisamment grande (idéalement supérieure à 1754).

• Agent Codeur (Coder Agent) : deepseek-v3

  • Spécialisé dans les tâches de génération de code.
  • Utilise les modèles de la série DeepSeek.

• Agent de Réflexion (Think Agent) : deepseek-r1

  • Responsable des tâches de raisonnement complexes.
  • Utilise le modèle de raisonnement DeepSeek R1.

3. Optimisation des coûts

• Grâce au modèle gratuit qwen2.5-coder-3b d'Alibaba Cloud et à la technologie KV-Cache de DeepSeek.
• Peut réduire considérablement le coût d'utilisation de Claude Code.
• Évite d'utiliser des modèles coûteux pour des tâches simples grâce à la division des tâches.

Installation et configuration

1. Installer Claude Code

npm install -g @anthropic-ai/claude-code

2. Cloner le projet

git clone https://github.com/musistudio/claude-code-reverse.git

3. Installer les dépendances

npm i

4. Configurer les variables d'environnement

Configuration du mode Normal

# Désactiver le routeur
ENABLE_ROUTER=false
OPENAI_API_KEY=""
OPENAI_BASE_URL=""
OPENAI_MODEL=""

Configuration du mode Routeur

# Activer le routeur
ENABLE_ROUTER=true
export TOOL_AGENT_API_KEY=""
export TOOL_AGENT_BASE_URL=""
export TOOL_AGENT_MODEL="qwen-max-2025-01-25"
export CODER_AGENT_API_KEY=""
export CODER_AGENT_BASE_URL="https://api.deepseek.com"
export CODER_AGENT_MODEL="deepseek-chat"
export THINK_AGENT_API_KEY=""
export THINK_AGENT_BASE_URL="https://api.deepseek.com"
export THINK_AGENT_MODEL="deepseek-reasoner"
export ROUTER_AGENT_API_KEY=""
export ROUTER_AGENT_BASE_URL=""
export ROUTER_AGENT_MODEL="qwen2.5-coder-3b-instruct"

5. Démarrage du service

node index.mjs

6. Configuration des variables d'environnement de Claude Code

export DISABLE_PROMPT_CACHING=1
export ANTHROPIC_AUTH_TOKEN="test"
export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
export API_TIMEOUT_MS=600000
claude

Architecture technique

Principe de fonctionnement du mode Routeur

1. Réception des requêtes : Claude Code envoie des requêtes au serveur proxy local.
2. Routage intelligent : L'Agent Routeur analyse le type de requête et décide à quel modèle spécialisé la transférer.
3. Exécution des tâches :
   • Tâches d'appel d'outils → Agent d'Outils
   • Tâches de génération de code → Agent Codeur
   • Tâches de raisonnement complexes → Agent de Réflexion
4. Retour des résultats : Chaque modèle renvoie le résultat une fois la tâche terminée.

Avantages clés

• Séparation des tâches : Sépare les tâches d'appel d'outils et de codage.
• Spécialisation des modèles : Chaque modèle se concentre sur la tâche qu'il maîtrise le mieux.
• Contrôle des coûts : Sélectionne le modèle approprié en fonction de la complexité de la tâche.
• Prise en charge des modèles de raisonnement : Prend en charge les modèles de raisonnement comme R1, même s'ils ne prennent pas en charge les appels de fonction.

Mises en garde

⚠️ Avertissement important :

• Ce projet est en phase de test et peut consommer un grand nombre de jetons (tokens).
• Des échecs d'exécution de tâches peuvent survenir.
• Il est recommandé de configurer des ignorePatterns appropriés pour le projet.

Importance du projet

Claude Code Router représente une direction importante dans le développement des outils de programmation IA :

• Démocratisation des coûts : Rendre les assistants de programmation IA plus abordables pour davantage de développeurs.
• Diversification des modèles : Ne plus dépendre d'un modèle unique, mais pouvoir choisir le modèle le plus adapté de manière flexible.
• Innovation architecturale : Améliorer l'efficacité globale grâce au routage et à la spécialisation des tâches.

Ce projet offre aux développeurs un outil puissant qui permet de réduire considérablement les coûts d'utilisation de Claude Code tout en conservant ses puissantes fonctionnalités. C'est une contribution majeure à la démocratisation des outils de programmation IA.