Descubre cómo Claude Code Router te permite usar Claude Code con modelos de IA alternativos, como Gemini, GPT, LM Studio o Ollama, sin necesidad de una suscripción de pago. Una guía práctica para desarrolladores.

Si eres desarrollador y has utilizado Claude Code, sabes que es una de las mejores herramientas de IA para programación. Sin embargo, su uso suele estar limitado por suscripciones de pago. ¿Te gustaría poder usarlo con otros modelos de IA, posiblemente gratuitos o más económicos? Claude Code Router es la solución que estabas buscando.

Esta herramienta de código abierto, desarrollada por Musi Studio, actúa como un proxy local que te permite redirigir Claude Code y otras plataformas de agentes de codificación a través de diferentes APIs de IA. En lugar de depender exclusivamente de los modelos de Anthropic, puedes configurarlo para que funcione con OpenAI, Google Gemini, OpenRouter, LM Studio y Ollama. Así, eliges el modelo que mejor se adapte a tus necesidades, ya sea por costo, rendimiento o disponibilidad.

¿Qué es Claude Code Router y por qué es revolucionario?

Claude Code Router no está afiliado a Anthropic, pero eso no le impide ser una solución poderosa. A diferencia de otras herramientas similares, esta se presenta como una aplicación de escritorio pulida y fácil de usar, disponible para Windows, macOS y Linux. Su objetivo es simple: liberarte de las limitaciones de las suscripciones de pago y darte el control total sobre qué modelos de IA utilizas.

Lo más impresionante es su facilidad de configuración. En solo dos minutos, puedes descargarlo, lanzarlo y conectarlo. La aplicación te permite crear perfiles personalizados para cada modelo de IA que desees usar. Por ejemplo, puedes configurar un perfil para que Claude Code utilice la API de Codex en lugar de la de Anthropic. Además, puedes definir el alcance del efecto (global o solo desde la app), el modo de entrada (interfaz de línea de comandos o aplicación de escritorio) y los modelos predeterminados para cada agente.

Pero no solo se limita a Claude Code. También es compatible con otras plataformas de agentes de codificación como Codex, Kimi CLI, Grok CLI, OpenCode y Claude Design. Esto significa que, en lugar de depender de planes exclusivos de cada plataforma, puedes centralizar el uso de múltiples modelos de IA en un solo lugar.

¿Cómo usar LM Studio y Ollama con Claude Code Router?

Configuración de LM Studio

Si prefieres usar modelos locales con LM Studio, sigue estos pasos:

• Descarga e instala LM Studio: Disponible para Windows, macOS y Linux en lmstudio.ai.
• Inicia el servidor de LM Studio: Abre la aplicación y asegúrate de que el servidor esté en ejecución (por defecto, usa el puerto 1234).
• Descarga un modelo compatible: Busca modelos como Qwen3-Coder, Gemma4 o Granite-Code en la pestaña de búsqueda de modelos y descárgalos.
• Configura Claude Code Router: En el archivo de configuración de Claude Code Router (config.json), agrega un nuevo proveedor con los siguientes detalles:

    {
      "name": "lmstudio",
      "api_base_url": "http://localhost:1234/v1/messages",
      "api_key": "lmstudio",
      "models": ["qwen3-coder-30b", "gemma4"]
    }
  

• Inicia Claude Code con LM Studio: Ejecuta Claude Code y selecciona el perfil que apunte a LM Studio. ¡Listo! Ahora estás usando modelos locales.

Nota: Si habilitas la autenticación en LM Studio, configura la variable de entorno ANTHROPIC_AUTH_TOKEN=lmstudio o el token que hayas definido.

Configuración de Ollama

Si prefieres Ollama para modelos locales, el proceso es similar:

• Descarga e instala Ollama: Disponible en ollama.com.
• Inicia el servidor de Ollama: Ollama se ejecuta por defecto en el puerto 11434.
• Descarga un modelo: Usa el comando ollama pull qwen3-coder o ollama pull gemma4 para descargar un modelo compatible.
• Configura Claude Code Router: Agrega un nuevo proveedor en el archivo config.json:

    {
      "name": "ollama",
      "api_base_url": "http://localhost:11434/v1/messages",
      "api_key": "ollama",
      "models": ["qwen3-coder", "gemma4"]
    }
  

• Inicia Claude Code con Ollama: Selecciona el perfil configurado y comienza a usar modelos locales sin costo.

Recomendación: Usa modelos con un contexto de al menos 32K tokens para obtener mejores resultados en tareas de codificación complejas.

¿Cómo se configura Claude Code Router?

La configuración es sorprendentemente sencilla. Tras descargar e instalar la aplicación, solo tienes que:

• Agregar proveedores de IA: Puedes incluir APIs de OpenAI, Anthropic, Google Gemini, LM Studio o Ollama.
• Crear perfiles: Define perfiles para cada modelo o combinación de modelos que desees usar. Por ejemplo, un perfil para GPT-4 y otro para Gemini.
• Configurar reglas de respaldo: Si un modelo falla, puedes establecer reglas para que el sistema cambie automáticamente a otro, garantizando un tiempo de actividad máximo.

Una vez configurado, puedes lanzar estos perfiles desde la interfaz de línea de comandos o directamente desde la aplicación. Las posibilidades son infinitas: desde usar un modelo gratuito de OpenRouter hasta alternar entre diferentes APIs según tus necesidades.

Además, Claude Code Router te permite configurar modelos y perfiles como mecanismos de respaldo. Esto es especialmente útil si trabajas con múltiples modelos de IA de diferentes proveedores y quieres garantizar la máxima disponibilidad. Puedes configurar reglas y acciones mediante descripciones de condiciones o incluso utilizando un script de Node.js.

Proveedores compatibles con Claude Code Router

Además de los proveedores en la nube como OpenAI, Anthropic y Google Gemini, Claude Code Router también soporta:

• LM Studio: Para modelos locales en formato GGUF o MLX (ideal para macOS).
• Ollama: Para modelos locales como Qwen3-Coder, Gemma4 o Llama3.
• OpenRouter: Para acceder a más de 200 modelos de IA a través de un solo punto de acceso.
• DeepSeek: Para modelos especializados en razonamiento avanzado.

¿Vale la pena usar modelos alternativos con Claude Code?

Aquí es donde las cosas se ponen interesantes. Aunque Claude Code Router te permite usar Claude Code con otros modelos de IA, la experiencia no será exactamente la misma. Si estás acostumbrado a las funciones específicas de Claude, como sus capacidades avanzadas de agentes, es posible que notes diferencias significativas al cambiar a un modelo como Gemini, GPT, LM Studio o Ollama.

Por ejemplo, algunas funciones avanzadas de Claude Code pueden no estar disponibles al usar otros modelos. Esto puede afectar el rendimiento en tareas complejas o en la finalización de código. Sin embargo, si usas Claude Code para tareas más generales, como escribir documentación o generar código simple, los modelos alternativos pueden ser una excelente opción, especialmente si buscas ahorrar costos.

En mi experiencia, aunque la transición a un modelo no de Anthropic puede requerir algunos ajustes, la flexibilidad que ofrece Claude Code Router compensa con creces. Si no necesitas las funciones más avanzadas de Claude, esta herramienta te brinda la libertad de elegir el modelo que mejor se adapte a tu presupuesto y necesidades.

Pros y contras de este enfoque

Pros

• Flexibilidad: Puedes usar el modelo de IA que prefieras, ya sea por costo, rendimiento o disponibilidad.
• Ahorro: Evitas el costo de una suscripción de pago a Anthropic.
• Control: Tienes el control total sobre qué modelos y APIs utilizas.
• Compatibilidad: Funciona con múltiples plataformas de agentes de codificación, no solo Claude Code.
• Privacidad: Al usar modelos locales con LM Studio o Ollama, tus datos no salen de tu máquina.

Contras

• Diferencias en la experiencia: Algunos modelos pueden no ofrecer las mismas funciones avanzadas que Claude.
• Configuración inicial: Aunque es sencilla, requiere un mínimo de configuración para empezar.
• Dependencia de APIs externas: Si los proveedores de IA que elijas tienen limitaciones, esto puede afectar tu flujo de trabajo.
• Recursos locales: Usar modelos locales requiere hardware potente, especialmente para tareas complejas.

Comparación: LM Studio vs. Ollama

En resumen, Claude Code Router es una herramienta poderosa para aquellos que buscan maximizar la flexibilidad y el ahorro al usar Claude Code. Aunque puede haber algunas diferencias en la experiencia, la capacidad de elegir entre múltiples modelos de IA hace que valga la pena explorar esta opción.

Si te interesa probarlo, puedes descargar Claude Code Router desde su repositorio oficial en GitHub y comenzar a experimentar con diferentes configuraciones.

Solución de problemas comunes

LM Studio

• El servidor no responde: Asegúrate de que LM Studio esté en ejecución y que el puerto 1234 no esté bloqueado.
• Error de autenticación: Si habilitaste la autenticación, verifica que el token en ANTHROPIC_AUTH_TOKEN sea correcto.
• Modelo no encontrado: Descarga el modelo desde la interfaz de LM Studio antes de intentarlo usar.

Ollama

• Puerto en uso: Si el puerto 11434 está ocupado, reinicia Ollama o cambia el puerto en la configuración.
• Modelo no compatible: Usa modelos que soporten el formato Anthropic Messages API (ej: Qwen3-Coder, Gemma4).
• Error de conexión: Verifica que Ollama esté ejecutándose con el comando ollama serve.