Presentación del Proyecto Claude Code Router

Resumen del Proyecto

Claude Code Router es un proyecto de código abierto diseñado para enrutar las solicitudes de Claude Code a diferentes modelos de IA, sirviendo como base para la infraestructura de codificación. Permite a los usuarios decidir cómo interactuar con los modelos mientras disfrutan de las actualizaciones de Anthropic. El objetivo principal de este proyecto es reducir significativamente el costo de usar Claude Code mediante el enrutamiento inteligente y la colaboración multimodo.

Motivación del Proyecto

Las herramientas tradicionales de programación con IA presentan los siguientes problemas:

• Alto costo: El uso directo de modelos de alta gama como Claude para todas las tareas es muy costoso.
• Limitaciones del modelo: Un solo modelo no puede rendir al máximo en todos los escenarios.
• Desperdicio de recursos: Las tareas sencillas también utilizan modelos complejos, lo que provoca un desperdicio de recursos.

Claude Code Router resuelve estos problemas mediante el enrutamiento inteligente. El autor menciona que al usar Claude-4 en VSCode Copilot para problemas de Flutter, tres rondas de conversación desordenaron los archivos y requirieron una reversión. En cambio, al usar Claude Code junto con DeepSeek, la tarea se completó con éxito después de tres o cuatro rondas de conversación, con un costo inferior a 1 CNY.

Características Principales

1. Operación en Doble Modo

• Modo Normal: Utiliza un único modelo para completar todas las tareas.
• Modo Enrutador: Utiliza múltiples modelos especializados que colaboran para completar diferentes tipos de tareas.

2. División Inteligente de Modelos

En el modo enrutador, el sistema utiliza cuatro modelos especializados diferentes:

• Agente Enrutador: qwen2.5-coder-3b

  • Responsable de la distribución del enrutamiento de solicitudes.
  • No requiere alta inteligencia, un modelo pequeño es suficiente.
  • Actualmente utiliza el modelo oficial gratuito qwen2.5-coder-3b de Alibaba Cloud.

• Agente de Herramientas: qwen-max-0125

  • Responsable de la llamada a herramientas.
  • Debe soportar la llamada a funciones.
  • Necesita soportar una longitud de descripción de herramientas suficientemente grande (idealmente mayor a 1754).

• Agente Codificador: deepseek-v3

  • Especializado en tareas de generación de código.
  • Utiliza modelos de la serie DeepSeek.

• Agente de Razonamiento: deepseek-r1

  • Responsable de tareas de razonamiento complejas.
  • Utiliza el modelo de inferencia DeepSeek R1.

3. Optimización de Costos

• Gracias al modelo gratuito qwen2.5-coder-3b de Alibaba Cloud y la tecnología KV-Cache de DeepSeek.
• Puede reducir significativamente el costo de usar Claude Code.
• Evita el uso de modelos costosos para tareas sencillas mediante la división del trabajo.

Instalación y Configuración

1. Instalar Claude Code

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

2. Clonar el proyecto

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

3. Instalar dependencias

npm i

4. Configurar variables de entorno

Configuración del Modo Normal

# Deshabilitar el enrutador
ENABLE_ROUTER=false
OPENAI_API_KEY=""
OPENAI_BASE_URL=""
OPENAI_MODEL=""

Configuración del Modo Enrutador

# Habilitar el enrutador
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. Iniciar el servicio

node index.mjs

6. Configurar las variables de entorno 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

Arquitectura Técnica

Principio de Funcionamiento del Modo Enrutador

1. Recepción de Solicitudes: Claude Code envía solicitudes al servidor proxy local.
2. Enrutamiento Inteligente: El Agente Enrutador analiza el tipo de solicitud y decide a qué modelo especializado reenviarla.
3. Ejecución de Tareas:
   • Tareas de llamada a herramientas → Agente de Herramientas
   • Tareas de generación de código → Agente Codificador
   • Tareas de razonamiento complejas → Agente de Razonamiento
4. Retorno de Resultados: Cada modelo devuelve el resultado una vez completada la tarea.

Ventajas Clave

• Separación de Tareas: Separa las tareas de llamada a herramientas y las de codificación.
• Especialización del Modelo: Cada modelo se enfoca en la tarea en la que es más competente.
• Control de Costos: Selecciona el modelo adecuado según la complejidad de la tarea.
• Soporte para Modelos de Razonamiento: Soporta modelos de razonamiento como R1 que no admiten la llamada a funciones.

Notas

⚠️ Aviso Importante:

• Este proyecto se encuentra en fase de prueba y puede consumir una gran cantidad de tokens.
• Pueden ocurrir fallos en la ejecución de tareas.
• Se recomienda configurar ignorePatterns apropiadamente para el proyecto.

Importancia del Proyecto

Claude Code Router representa una dirección importante en el desarrollo de herramientas de programación con IA:

• Democratización de Costos: Hace que los asistentes de programación con IA sean más asequibles para más desarrolladores.
• Diversificación de Modelos: Ya no depende de un solo modelo, permitiendo una selección flexible del modelo más adecuado.
• Innovación Arquitectónica: Mejora la eficiencia general mediante el enrutamiento y la división del trabajo especializada.

Este proyecto ofrece a los desarrolladores una herramienta potente que, al tiempo que mantiene la potente funcionalidad de Claude Code, reduce drásticamente los costos de uso, lo que representa una contribución importante a la popularización de las herramientas de programación con IA.