Enrutamiento de Modelos · Infraestructura Cero Costes

Cómo usar Claude Code Gratis: Guía Completa con OmniRouter y Modelos Locales

Escrito por Akshat

Fundador de The AI Server · Ingeniero de Sistemas Autónomos

Arquitectura de enrutamiento OmniRouter para Claude Code

⚡ Resumen Rápido: ¿De qué trata esta guía?

El nuevo agente de terminal de Anthropic, Claude Code (@anthropic-ai/claude-code), es una de las herramientas más potentes para desarrolladores. Sin embargo, al inspeccionar repositorios completos y ejecutar bucles terminales de depuración, una sola mañana de programación puede costar entre 20$ y 50$ en la API de Anthropic. En esta guía paso a paso te explico cómo conectar Claude Code a OmniRouter, configurar un proxy local con rotación de claves gratuitas y programar de forma ilimitada sin pagar facturas de API.

¿Qué es Claude Code y por qué consume tantos tokens?

A diferencia de un chat convencional en la web como ChatGPT o Claude.ai, Claude Code es un agente de ingeniería de software autónomo que corre directamente en tu terminal. Cuando le das una orden como:

"Refactoriza el módulo de autenticación JWT, añade pruebas unitarias con Jest y verifica que todos los tests pasen."

Claude Code no solo te da código para copiar y pegar. De forma autónoma:

Explora los archivos de tu proyecto con comandos grep y find.
Lee archivos completos para comprender la arquitectura.
Edita archivos línea por línea y ejecuta npm test en tu sistema operativo.
Si ocurre un fallo de compilación, lee la traza de error y se auto-corrige en un bucle continuo.

Cada una de estas acciones envía el contexto acumulado de vuelta al modelo de lenguaje. En un proyecto mediano, una sesión de 20 minutos puede consumir más de 500.000 tokens. Si no tienes una cuenta empresarial, el coste es prohibitivo.

La Solución: ¿Qué es OmniRouter?

OmniRouter (u OmniRoute) es una capa proxy local de código abierto diseñada para interceptar las llamadas salientes del SDK de Anthropic y redirigirlas a través de una red distribuida de proveedores compatibles con la API de OpenAI o Anthropic:

Filtro de Reintentos y Respaldo (Fallback): Si tu proveedor principal devuelve un error de tasa límite (Rate Limit 429), OmniRouter redirige la petición instantáneamente al siguiente proveedor en milisegundos sin interrumpir la sesión de Claude Code.
Agrupación de Claves Gratuitas (Key Pooling): Puedes combinar niveles gratuitos de OpenRouter, Groq, Google Gemini API, DeepSeek y Together AI en un único endpoint unificado.
Soporte de Modelos Locales: Te permite conectar modelos locales ejecutados en tu propia tarjeta gráfica a través de Ollama o vLLM con coste exactamente cero.

Panel de control de OmniRouter con métricas en tiempo real

Figura 1: Panel de monitorización local de OmniRouter mostrando balanceo de carga en tiempo real.

Paso 1: Instalación de Claude Code en tu Sistema

Abre tu terminal en macOS, Linux o WSL2 en Windows y ejecuta el instalador oficial de Anthropic:

bash — Terminal

# Instalar el paquete CLI global con Node.js 18+
npm install -g @anthropic-ai/claude-code

# Verificar que la instalación fue exitosa
claude --version

Paso 2: Descarga y Configuración de OmniRouter

Puedes ejecutar OmniRouter mediante Docker o compilándolo directamente en Node.js:

bash — Configuración Proxy

# Opción A: Ejecutar el contenedor oficial de OmniRouter
docker run -d -p 8080:8080 --name omnirouter   -v ./omnirouter-config.json:/app/config.json   omniroute/omnirouter:latest

# Opción B: Iniciar mediante npx
npx omniroute-proxy start --port 8080

Configuración de proveedores y reglas de rotación en OmniRouter

Figura 2: Interfaz de configuración de rotación de claves y fallback automático.

Paso 3: Conectar Claude Code al Proxy Local

Claude Code respeta las variables de entorno oficiales de Anthropic para definir la URL base de la API. Solo necesitas apuntar el cliente a tu puerto local 8080:

bash — Variables de Entorno

# Redirigir el tráfico hacia el proxy local de OmniRouter
export ANTHROPIC_BASE_URL="http://localhost:8080/v1"

# Clave virtual gestionada por tu pool local de OmniRouter
export ANTHROPIC_API_KEY="sk-ant-omnirouter-pool-token"

# Iniciar el asistente en tu proyecto actual
claude

Consejo para usuarios habituales: Añade las líneas export ANTHROPIC_BASE_URL=... a tu archivo ~/.bashrc o ~/.zshrc para que el entorno esté siempre listo al abrir cualquier terminal.

Cómo Usar Modelos 100% Locales (DeepSeek y Qwen) con Ollama

Si tienes un ordenador con tarjeta gráfica dedicada (NVIDIA RTX con 8GB a 16GB de VRAM) o un Mac con procesador Apple Silicon (M1/M2/M3/M4 con memoria unificada), puedes programar completamente gratis y offline:

bash — Ollama Local

# Descargar un modelo de código de última generación
ollama run qwen2.5-coder:7b

# En tu configuración de OmniRouter, mapea 'claude-3-5-sonnet' al modelo local de Ollama:
# "target_model": "http://localhost:11434/v1/models/qwen2.5-coder:7b"

¿Quieres nuestro Script de Configuración Multi-Clave Empresarial?

Suscríbete para recibir nuestra plantilla privada de configuración de OmniRouter con rotación automática entre 5 proveedores gratuitos y script de auto-reconexión.

Preguntas Frecuentes (FAQ)

¿Es legal usar un proxy con Claude Code?

Sí. Claude Code es una herramienta CLI de código abierto publicada bajo licencia oficial de Anthropic que incluye explícitamente compatibilidad con la variable de entorno ANTHROPIC_BASE_URL para permitir a desarrolladores y empresas conectar sus propios proxies internos o servidores compatibles.

¿Qué modelos son recomendados para sustituir a Sonnet 3.5?

Los mejores modelos de código abierto con rendimiento comparable en tareas de programación son DeepSeek V3 / R1, Qwen 2.5 Coder 32B y Codestral 22B de Mistral AI.