Claude Code gratis: armá apps con OmniRoute en minutos

Actualizado el 02/09/2026 — Este artículo fue actualizado con secciones nuevas sobre OmniRoute, guía de instalación ampliada, comparativa con Ollama y preguntas frecuentes renovadas.

OmniRoute es un gateway de inteligencia artificial de código abierto que actúa como intermediario entre Claude Code y decenas de proveedores de modelos. Se instala por npm, comprime tokens para estirar créditos gratuitos y rutea pedidos automáticamente entre servicios con capa libre, permitiendo armar aplicaciones sin suscripción paga. Funciona en local, es auditable y le devuelve a Claude Code una respuesta unificada cada vez que escribís un prompt.

¿Se puede armar una app con Claude Code sin pagar? Sí, con matices. El Claude Code gratis setup combina tres caminos: los créditos gratuitos de la API de Anthropic, un modelo local con Ollama, o un gateway como OmniRoute, que reparte tus pedidos entre decenas de proveedores sin costo y comprime tokens para estirar cada llamada.

¿Qué es Claude Code y para qué sirve?

Claude Code es el agente de programación por terminal de Anthropic: le describís qué querés construir y él escribe el código, lo ejecuta y corrige los errores. Corre directamente en tu consola, lee los archivos de tu proyecto y trabaja sobre ellos sin que abras un editor.

Ponele que querés un dashboard que muestre tus gastos del mes y no tenés ganas de pelearte con JavaScript. Le contás lo que necesitás, y Claude Code te escribe el código, lo corre y lo arregla si algo se rompe.

Sirve para tres cosas concretas:

• Apps web chicas: calculadoras, formularios y landing pages que quedan funcionando en una sola sesión.
• Herramientas de automatización: scripts que renombran archivos, mueven datos o generan reportes periódicos.
• Prototipos rápidos: validás una idea en minutos antes de invertir horas de desarrollo formal.

La documentación oficial de Anthropic incluye el quickstart en español, que ayuda mucho si nunca tocaste una consola.

¿Qué es OmniRoute exactamente?

OmniRoute es un gateway de inteligencia artificial de código abierto que se comporta como proxy entre Claude Code y múltiples proveedores de modelos. Recibe cada pedido que mandás desde la terminal, decide a cuál de los servicios conectados enviarlo según reglas configurables, aplica compresión de contexto para achicar tokens, y te devuelve una respuesta unificada. Todo corre en tu máquina local: no hay intermediario en la nube, vos tenés el control completo del tráfico.

Sus tres funciones clave son:

• Ruteo inteligente: si el primer proveedor agota su cuota gratuita, pasa automáticamente al siguiente sin que interrumpas el trabajo. No hay fallos por límite de uso.
• Compresión de contexto: achica el prompt antes de mandarlo, reduciendo tokens consumidos. Funciona sin degradar la calidad de la respuesta, solo elimina redundancia.
• Código abierto y auditable: el proyecto está en GitHub, así que podés revisar exactamente qué hace con tus datos y tus claves antes de confiarle nada.

A diferencia de otros gateways pagos, OmniRoute no cobra nada por el software; el costo depende de los proveedores que configures detrás. Si todos tienen capa gratuita, tu gasto es cero pesos.

¿Cómo instalar OmniRoute paso a paso?

El setup completo toma pocos minutos si ya tenés Node instalado. Seguí este orden exacto y no te salteés ningún paso porque uno depende del anterior.

1. Verificá Node.js: los requisitos oficiales de Claude Code piden Node 18 o superior. Corré node -v en la terminal para confirmarlo antes de seguir.
2. Instalá el gateway global: ejecutá npm install -g omniroute y esperá a que npm termine de bajar el paquete. No lo instales local en una carpeta, tiene que ser global para que funcione desde cualquier terminal.
3. Levantá el servicio: escribí omniroute en la terminal y presioná Enter. El gateway arranca, te muestra logs de actividad y queda escuchando en tu máquina en el puerto 20128.
4. Abrí el dashboard: en tu navegador favora, entrá a localhost:20128 (o http://127.0.0.1:20128 si prefieres la IP). Ahi ves un panel que muestra el estado del gateway y te permite configurar proveedores.
5. Agregá tus credenciales: en el dashboard cargás las claves de API de los proveedores que querés usar. OmniRoute acepta claves de OpenAI, Anthropic, Google, Mistral y muchos más. Solo el gateway las conoce, nunca salen de tu máquina.
6. Hacé una prueba de tráfico: apuntá Claude Code al gateway (paso siguiente) y mandá un prompt mínimo. Mirá el dashboard en tiempo real para confirmar que el tráfico pasó por OmniRoute.

¿Cómo conectar Claude Code a OmniRoute?

La conexión se hace apuntando Claude Code al gateway local en lugar de a la API de Anthropic. Eso se logra configurando una variable de entorno que le dice dónde buscar el servicio.

En Linux, macOS o PowerShell (Windows), abrí una terminal nueva y ejecutá esto:

export ANTHROPIC_BASE_URL=http://localhost:20128

Luego corrés Claude Code normalmente:

claude code tu_proyecto/

Desde ese momento, todos los prompts pasan por tu gateway local. Podés ver en el dashboard exactamente qué tráfico circula, cuántos tokens consume cada llamada y cuál proveedor se usó.

Si querés que la variable sea persistente (sin repetirla cada vez que abrís la terminal), agregala a tu archivo de perfil:

• En macOS/Linux: edítá ~/.bashrc o ~/.zshrc, agregá la línea export ANTHROPIC_BASE_URL=http://localhost:20128 y guardá.
• En Windows PowerShell: abrí PowerShell como admin y ejecutá [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","http://localhost:20128","User") para que quede permanente.

¿Cómo configurar qué modelos y proveedores usa OmniRoute?

El dashboard de OmniRoute (en localhost:20128) te permite armar un “stack” o cascada de proveedores. La idea es simple: le decís al gateway “primero intentá con este modelo gratis, si se agota la cuota pasá al siguiente, si también falla usá este otro”.

Dentro del panel vas a encontrar una sección de “Providers” o “Modelos”. Agregás lo que necesites:

• Proveedores gratuitos con límite: OpenRouter (gratuito con cuota diaria), HuggingFace Inference (gratis), DeepSeek (capa gratuita).
• Tu propia API de Anthropic: si tenés suscripción Pro o Max, la agregás acá y OmniRoute renueva la variable ANTHROPIC_API_KEY cada vez que haces un pedido.
• Ollama local: si también tenés un modelo corriendo en localhost:11434, podés decirle a OmniRoute que lo use como fallback.
• Orden de intento (fallback chain): definis la prioridad: primero la opción 1, si falla la 2, si falla la 3, etcétera. El gateway elige automáticamente.

La configuración se guarda en un archivo JSON local dentro de OmniRoute. Podés editarlo a mano o desde el dashboard sin reiniciar el gateway.

¿Cuántos tokens ahorra OmniRoute realmente?

OmniRoute declara ahorros que varían de 15% a 95% según el contenido. Ese rango tan amplio no es marketing, es honestidad: el ahorro real depende completamente de qué mandás.

La compresión funciona así:

• Máximo ahorro (80%-95%): cuando mandás código repetitivo, bloques de documentación, listas de datos, logs estructurados. La compresión elimina redundancia predecible sin perder información.
• Ahorro moderado (30%-50%): en conversaciones naturales donde cada oración aporta contexto nuevo. Hay menos redundancia que comprimir, pero algo siempre sale.
• Ahorro bajo (15%-25%): en prompts muy específicos y variados. Casi todo el contenido es único, hay poco que achique sin riesgo de perder detalle.

En la práctica: si arreglás un bug repitiendo “fijate acá, ahora probá esto, revisá si pasa lo otro”, cada iteración consume menos tokens en el gateway que directamente contra la API. Si escribís un prompt nuevo de cero cada vez, el ahorro es menor.

¿Cuál es mejor: OmniRoute u Ollama?

Depende de dos cosas: cuánto hardware tenés disponible y cuánto te importa la privacidad. No es “una u otra”, muchas veces es “ambas”.

La estrategia inteligente: usá OmniRoute para lo de todos los días (prototipos, bugs menores, documentación) porque aprovecha las capas gratuitas y no ocupa espacio. Reservá Ollama para lo sensible (datos de clientes, código de producción, secretos) porque nada sale de tu equipo. Podés tener ambos corriendo en paralelo.

¿Qué requisitos técnicos necesito para el setup?

Menos de lo que pensás. Si querés solo OmniRoute sin Ollama, la barrera es muy baja.

• Terminal y Node.js 18+: imprescindible para instalar y correr OmniRoute por npm.
• Internet estable: OmniRoute necesita conectarse a los proveedores en la nube para hacer el ruteo.
• Una cuenta de Claude: gratis para probar con los USD 5 iniciales, o paga si querés plan Pro/Max.
• Espacio en disco: OmniRoute ocupa menos de 50 MB. Ollama ocupa 7-15 GB según el modelo que bajes.
• ¿Programación?: no hace falta saber escribir código. Claude Code escribe por vos. Saber lo que pedís ayuda, pero no es requisito.

Si más adelante querés publicar tu app online y que quede corriendo 24/7, necesitarás un hosting. Para proyectos en Argentina, donweb.com te resuelve dominio y servidor en una mano.

¿Se puede usar Claude Code gratis en 2026?

Gratis del todo, no. Con maña, casi. La API de Anthropic regala un crédito inicial de USD 5 al registrarte, y eso alcanza para varias sesiones de prueba. Los planes de suscripción que incluyen Claude Code arrancan en USD 20/mes (Pro) y USD 100/mes (Max).

• Ollama (local y gratis): corrés modelos abiertos en tu propia máquina. Cero costo por token, pero necesitás disco y una GPU decente para que no se arrastre.
• OmniRoute (gateway con capa gratuita): reenvía tus pedidos a proveedores con planes gratuitos (algunos con límites diarios o mensuales) y comprime la conversación para gastar menos.
• Créditos de API: los USD 5 iniciales más lo que sumes si Anthropic lanza promos puntuales.

La honestidad manda: ninguna de estas opciones te da la potencia completa del modelo top de Claude sin poner plata. Lo que sí te dan es un camino real para aprender, prototipar y armar herramientas sin sacar la tarjeta de crédito.

¿Cuánto tiempo tarda crear una app con Claude Code?

Depende de qué tan ambicioso seas, pero los tiempos reales son: una calculadora básica sale en 5-7 minutos, un generador de contraseñas en 10-12, y un dashboard simple con gráficos en 25-35 minutos, contando idas y vueltas.

Lo que estira el reloj no es la respuesta inicial, es la iteración. Pedís la app, la ves, notás que el botón está feo, pedís un cambio, aparece un bug, lo corregís, querés otro color. Así se te van los minutos. El truco para acortar: cuanto más claro el pedido inicial (qué funciones, qué aspecto, qué datos maneja), menos vueltas.

Ejemplos prácticos: qué podés armar

Generador de contraseñas en 10 minutos

Prompt inicial: “hacé una página con un botón que genere contraseñas de 16 caracteres”. Resultado: funciona, pero todas sin símbolos. Pedís cambio: “agregá símbolos y un slider para elegir el largo”. Segundo resultado: listo, con copiar al portapapeles. Diez minutos, dos iteraciones.

Dashboard de gastos en media hora

Arrancás pidiendo una tabla con categorías y montos, sumás un gráfico de torta, querés que guarde los datos en el navegador para no perderlos al recargar. Cada pedido es una vuelta. Media hora después tenés algo que funciona.

En el blog de Donweb hay una guía de cómo crear tu primera app con Claude que sigue exactamente este camino, paso a paso.

Errores comunes al configurar OmniRoute

• Instalar sin Node.js: el comando npm no existe si no tenés Node. Instalalo primero desde nodejs.org, después OmniRoute. Es el tropiezo número uno.
• No apuntar Claude Code al gateway: instalás OmniRoute pero seguís pegándole directo a la API de Anthropic porque nunca configuraste ANTHROPIC_BASE_URL. Sin ese paso, el gateway está ahí pero no hace nada.
• Variables de entorno volátiles: si exportás la URL solo en la sesión y cerrás la terminal, se pierde. Poné la variable en tu archivo de perfil (.bashrc, .zshrc) o como variable de Windows permanente.
• Esperar magia con Ollama en hardware flojo: un modelo de 7-13B en una notebook sin GPU se arrastra bastante. Si tu equipo es modest, probá OmniRoute primero.
• Confundir OmniRoute con algo oficial de Anthropic: es un proyecto open source de terceros. Mirá el GitHub antes de confiarle claves importantes.
• Prompts vagos: pedir “hacé una app buena” no lleva a ningún lado. Cuanto más específico el pedido, menos vueltas y menos tokens quemados.
• No chequear credenciales en el dashboard: si agregás claves de API y después el gateway no funciona, miró los logs en la interfaz web. Ahí te dice qué falló.

¿Es seguro usar OmniRoute con tu código?

Es tan seguro como los proveedores que configures detrás y tan transparente como quieras, ya que el código es público. Pero sí hay riesgos claros que tenés que evitar:

• El código es auditable en GitHub: cualquiera puede leer exactamente qué hace el gateway con tus datos. No hay magia oculta.
• Tus prompts salen de tu máquina: cada request viaja a los proveedores en la nube que configures, con sus propias políticas de privacidad.
• Protegé tus claves: guardá las credenciales de cada API en tu configuración local del gateway y jamás las metas adentro de un prompt.
• Evitá datos sensibles: nada de contraseñas de producción, datos de clientes, o secretos de negocio en las conversaciones.
• Leé los términos de cada capa gratuita: algunos proveedores limitan el uso comercial o aplican condiciones particulares que tenés que respetar.

Regla práctica: tratá todo lo que escribas en un prompt como si fuera público. Si un dato no puede salir de tu oficina, ese trabajo va para Ollama en local o no se hace.

Ventajas y limitaciones de Claude Code para crear apps

Cuándo conviene Claude Code: para prototipos, herramientas internas de usar-una-vez, scripts de automatización. Cuándo conviene código a mano: sistemas que van a crecer, muchos usuarios, miles de lineas que alguien más tendrá que mantener después.

¿Qué está confirmado y qué es especulación?

• Confirmado: los planes Pro (USD 20/mes) y Max (USD 100/mes) incluyen Claude Code, según docs.anthropic.com.
• Confirmado: OmniRoute se instala con npm install -g omniroute, es código abierto en GitHub y su dashboard corre en puerto 20128.
• Confirmado: Ollama permite correr modelos abiertos en local sin costo por uso.
• Pendiente de auditoría externa: el número exacto de 231 proveedores y los 50 gratuitos sale del propio proyecto OmniRoute, sin verificación independiente.
• Pendiente: los porcentajes de compresión (15% a 95%) son cifras declaradas por OmniRoute, no mediciones bajo control.
• Pendiente: los tiempos de 5-30 minutos son estimaciones típicas, no un benchmark medido. Tu experiencia varía.

Preguntas Frecuentes sobre OmniRoute y Claude Code

¿OmniRoute u Ollama: cuál elijo si es mi primer setup?

Empezá con OmniRoute. Es más simple de instalar, no ocupa casi espacio y funciona en cualquier máquina. Si tu hardware es limitado o vas a prototipar mucho, OmniRoute es tu aliado. Después, cuando tengas más capacidad (RAM, GPU), agregá Ollama para lo sensible.

¿Cuál es el costo total de OmniRoute en un mes?

Cero, si solo usás proveedores con capa gratuita y respetás sus límites diarios/mensuales. OpenRouter, HuggingFace Inference y DeepSeek ofrecen cuotas gratuitas que varían. Si los agotás, subís de categoría a plan pago en esos servicios, pero OmniRoute mismo no cobra nada.

¿OmniRoute es seguro para datos confidenciales?

No recomendable. Tus prompts viajan a proveedores en la nube con sus propias políticas. Para datos sensibles (clientes, secretos), usá Ollama en local o no proceses eso con LLMs. OmniRoute es ideal para trabajo público: blogs, tutoriales, código genérico.

¿Se puede combinar OmniRoute con Ollama?

Sí, perfectamente. Configurás OmniRoute con una cascada: primero intenta con Ollama local (lo sensible), si no está disponible cae a un proveedor en la nube. Así tenés seguridad y fallback juntos.

¿Cómo sé si OmniRoute está funcionando?

Dos controles: primero, abrí el dashboard en localhost:20128 y mirá los logs en tiempo real. Segundo, corré un comando simple con Claude Code (tipo “hacé un hola mundo en JavaScript”) y mirá si aparece en el dashboard. Si ves la actividad registrada, está funcionando.

¿Puedo usar OmniRoute con múltiples máquinas?

OmniRoute corre local en tu máquina. Para compartirlo entre varias computadoras, necesitarías publicar el gateway en la red (algo más avanzado) o correr una instancia en cada máquina. Para la mayoría, es una herramienta personal, no compartida.

¿Qué diferencia hay entre OmniRoute gratis y otros gateways pagos?

OmniRoute es gratis porque es open source mantenido voluntariamente. Gateways pagos (tipo Azure OpenAI Gateway o algunos proxies comerciales) ofrecen support, garantías de uptime y features avanzadas. Para hobby y learning, OmniRoute te sobra.

¿Necesito dejar OmniRoute corriendo todo el día?

Solo cuando uses Claude Code. Si cerrás la terminal y el gateway, al siguiente día lo volvés a iniciar con omniroute. No consume recursos en background si no está levantado.

¿Puedo cambiar de proveedor sin perder mi trabajo?

Sí. El código que Claude Code genera queda en tu carpeta, no depende del gateway. Si cambias de proveedor en OmniRoute o pasas a otro gateway, tu proyecto sigue igual.

Conclusión

Lo que cambió en 2026 es el punto de entrada: hoy podés probar Claude Code sin pagar desde el minuto uno, entre el crédito de la API, Ollama en local y OmniRoute como gateway con compresión. No es gratis para siempre ni reemplaza a un desarrollador en sistemas grandes, pero para aprender, prototipar y armar herramientas internas, el piso bajó muchísimo.

El camino concreto: instalá Node, probá OmniRoute con npm install -g omniroute, empezá con una app boba (un generador de contraseñas) para agarrarle la mano, y en una tarde sabés si esto es para vos. Los USD 5 iniciales de crédito, combinados con capas gratuitas, te alcanzan para bastante más de lo que suena.

Fuentes

• Documentación oficial de Claude Code (Anthropic) — quickstart en español
• OmniRoute en GitHub — repositorio del gateway de código abierto
• ExplainX — OmniRoute como AI gateway y proxy LLM gratuito para Claude Code
• Blog Donweb — cómo crear tu primera app con Claude
• Node.js — plataforma de ejecución para JavaScript en terminal