Modo
Agendar llamada

Claude Code gratis con FreeLLMAPI: la guía paso a paso

Instalá FreeLLMAPI y conectalo a Claude Code con ANTHROPIC_BASE_URL para usarlo gratis, sin pagar la API de Anthropic. Guía real, paso a paso.

Mateo de noche en su escritorio con una terminal que apunta Claude Code a FreeLLMAPI y el dato de 34 proveedores gratis
En esta guía

Claude Code pide un plan pago de Claude (Pro, Max, Team o Enterprise) o una cuenta de la API de Anthropic que cobra por token, y el plan gratuito de Claude.ai no lo incluye, según la documentación oficial. Si viste el tip de FreeLLMAPI y querés el paso a paso real para dejar de pagarle a la API oficial, es esto: instalar FreeLLMAPI en tu máquina y apuntar Claude Code ahí con una sola variable de entorno.

#Qué es FreeLLMAPI y por qué sirve para esto

FreeLLMAPI es un proyecto open source que agrega el free tier de unos 34 proveedores de modelos de lenguaje (Google, Groq, Mistral, entre otros) detrás de un único endpoint local. Ese endpoint imita tanto la API de OpenAI como la Messages API de Anthropic, así que Claude Code lo puede usar como si fuera la API oficial, sin que nadie tenga que tocar el código de Claude Code. Corre en tu propia máquina (o en un servidor tuyo), no en la nube de un tercero: vos cargás tus propias API keys gratuitas de cada proveedor y el sistema las guarda cifradas en local, según el repositorio del proyecto.

La diferencia con la vía más conocida de "Claude Code gratis" (usar Ollama con un modelo corriendo en tu computadora) es que ahí necesitás una placa de video con memoria suficiente para el modelo. Con FreeLLMAPI los modelos corren en la nube de cada proveedor: tu máquina sólo enruta el tráfico.

#Cómo instalar FreeLLMAPI

La instalación más rápida es con un script, que necesita tener Docker instalado:

curl -fsSL https://freellmapi.co/install.sh | bash

También hay opciones con Docker, Docker Compose, en local con Node, o como app de escritorio para Mac y Windows. Una vez instalado, el paso siguiente es cargar tus API keys gratuitas de los proveedores que quieras usar (por ejemplo, la key gratuita de Google AI Studio o de Groq). Sin al menos una key cargada, el router no tiene a dónde mandar las requests.

#Cómo conectar Claude Code a FreeLLMAPI

Con FreeLLMAPI corriendo y con al menos una key cargada, quedan dos pasos del lado de Claude Code:

  1. Instalar Claude Code de forma global, si todavía no lo tenés:
npm install -g @anthropic-ai/claude-code
  1. Setear las variables de entorno que le dicen a Claude Code a qué servidor mandar las requests, en vez de a la API paga de Anthropic. Según la documentación de FreeLLMAPI, la dirección va sin /v1 (Claude Code lo agrega solo) y la key unificada del panel va en ANTHROPIC_AUTH_TOKEN, no en ANTHROPIC_API_KEY:
export ANTHROPIC_BASE_URL=http://localhost:3001
export ANTHROPIC_AUTH_TOKEN=freellmapi-tu-key-unificada
claude

Desde ese momento, cada mensaje que le mandes a Claude Code sale hacia tu FreeLLMAPI local, que a su vez lo reparte entre los proveedores gratuitos que tengas cargados. La interfaz, los permisos y los plugins de Claude Code siguen siendo los mismos: lo único que cambió es el backend que responde. Si además querés bajar el consumo de tokens por sesión (algo que ayuda incluso con backends gratis, porque cada proveedor tiene su propio límite), la guía para ahorrar tokens con un archivo CLAUDE.md suma en el mismo sentido.

#FreeLLMAPI vs Claude.ai gratis vs Ollama local

Las tres opciones que se suelen comparar para usar Claude sin pagar parten de necesidades distintas:

VíaQué necesitásLímite principal
Plan gratuito de Claude.aiSólo una cuentaNo incluye Claude Code: solo chat en la web y la app
Ollama localGPU propia con memoria suficienteEl modelo corre en tu hardware
FreeLLMAPIAPI keys gratuitas de tercerosRate limit de cada proveedor

Ninguna es "mejor" en todos los casos. Si tenés una GPU potente sin usar, Ollama te da control total, como explica la guía de Claude Code gratis con Ollama. Si no tenés GPU pero sí paciencia para sumar un par de API keys gratuitas, FreeLLMAPI te da acceso a modelos más grandes sin depender de tu hardware. Y si lo que buscás es comparar directamente las distintas formas de usar Claude en general, sumá la nota sobre 3 formas de usar Claude y cuál vale la pena.

#Límites reales de este método

Vale ser honesto con lo que este método no resuelve. Cada proveedor gratuito tiene su propio rate limit, así que en sesiones largas el router puede rotar de modelo en medio de una tarea, y la calidad de respuesta va a depender del modelo que esté detrás en ese momento (no siempre va a ser tan bueno como el modelo pago de Anthropic). Tampoco es una vía pensada para equipos: FreeLLMAPI está armado para uso individual y local, no como servicio compartido para varias personas a la vez. Y como con cualquier free tier de terceros, las condiciones de cada proveedor pueden cambiar sin aviso.

Para uso personal, para probar Claude Code sin comprometerte a pagar, o para tareas donde no necesitás el modelo más potente del mercado, es una vía real. Si en algún momento tu volumen de trabajo justifica pagar la API oficial o un plan de Claude.ai, siempre podés volver a sacar las variables ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN y Claude Code vuelve a hablar directo con Anthropic.

#Seguir leyendo

Si querés seguir bajando el costo de usar Claude Code o comparar otras vías, estas notas suman:

Si además usás Claude Code para editar video, la guía de transiciones animadas con Claude Code y Remotion muestra los pedidos exactos para transiciones, animación y branding en el mismo render.

Pídeselo a tu agenteClaude o ChatGPT
Quiero aplicar a mi caso la guía "Claude Code gratis con FreeLLMAPI: la guía paso a paso" de Claura.
Guía: https://claura-ai.com/resources/claude-code-gratis-con-freellmapi

Mi caso: [a qué me dedico, qué herramientas uso y qué quiero lograr]

La guía cubre:
- Qué es FreeLLMAPI y por qué sirve para esto
- Cómo instalar FreeLLMAPI
- Cómo conectar Claude Code a FreeLLMAPI
- FreeLLMAPI vs Claude.ai gratis vs Ollama local
- Límites reales de este método

Lee la guía (si no puedes abrir el link, trabaja con los temas de arriba). Si te falta información sobre mi caso, hazme hasta 3 preguntas antes de empezar. Después arma un plan para aplicar la guía paso a paso a mi caso y dime qué puedo hacer hoy en menos de una hora.

Cópialo y pégalo en tu agente: te pregunta lo que le falta de tu caso y arma el plan con los pasos de esta guía. ¿Prefieres que lo armemos nosotros? Agenda una llamada.

PDF gratis

Descarga la hoja de comandos de Claude Code

Para cuando ya tengas Claude Code funcionando: todos los comandos por momento de uso y tres trucos para cuidar el límite.

Recibe la guía en tu correo

?Preguntas frecuentes sobre Claude Code gratis con FreeLLMAPI

¿Qué es FreeLLMAPI?

Es un proyecto open source que junta el free tier de unos 34 proveedores de modelos de lenguaje (Google, Groq, Mistral y otros) detrás de un único endpoint que corre en tu propia máquina. Ese endpoint habla el mismo idioma que la API de OpenAI y también el de la Messages API de Anthropic, así que cualquier herramienta pensada para Claude, incluido Claude Code, puede apuntarle sin que la tengas que modificar. No es un servicio en la nube de un tercero cobrándote: lo instalás vos, con tus propias credenciales gratuitas, según el repositorio oficial en GitHub.

¿Cómo conecto Claude Code a FreeLLMAPI paso a paso?

Primero instalás FreeLLMAPI en tu máquina (script de instalación o Docker) y cargás ahí tus API keys gratuitas de los proveedores soportados. Después instalás Claude Code de forma global con npm install -g @anthropic-ai/claude-code, si todavía no lo tenés. El paso clave es setear la variable de entorno ANTHROPIC_BASE_URL apuntando a la dirección local donde quedó corriendo FreeLLMAPI (http://localhost:3001, sin /v1) y ANTHROPIC_AUTH_TOKEN con la key unificada que te da el panel, antes de abrir una sesión con el comando claude, como indica la documentación de FreeLLMAPI. Desde ese momento, cada request de Claude Code sale hacia tu FreeLLMAPI en vez de ir a la API paga de Anthropic. Podés confirmar que el consumo real bajó revisando la lista completa de comandos y trucos de límite de uso.

¿Es seguro cargar mis API keys gratuitas en FreeLLMAPI?

FreeLLMAPI está pensado para correr en modo local, de un solo usuario: según su propia documentación, las keys que cargás quedan cifradas en tu máquina y no se mandan a ningún servidor externo del proyecto. El riesgo real no es de FreeLLMAPI en sí, sino de cada proveedor individual: cada free tier tiene su propio límite de uso y sus propias condiciones, así que conviene leerlas antes de sumar una key. Si un proveedor corta el acceso gratuito, simplemente dejás de usarlo desde ahí y seguís con los demás que tengas cargados en el mismo router, siguiendo los mismos pasos de la sección cómo conectar Claude Code a FreeLLMAPI de esta guía.

¿FreeLLMAPI reemplaza al plan gratuito de Claude.ai?

No, son dos cosas distintas. El plan gratuito de Claude.ai te deja usar Claude en la web o en la app con un cupo de uso limitado, pero no incluye Claude Code: según la documentación oficial, Claude Code pide una cuenta Pro, Max, Team, Enterprise o de la API. Guías como la comparativa de vías gratuitas para usar Claude Code repasan esas opciones. FreeLLMAPI, en cambio, no te da acceso a los modelos de Anthropic gratis: te deja correr Claude Code contra otros modelos (de Google, Groq, Mistral, etc.) usando la interfaz y los permisos de Claude Code, pero sin pagar la API oficial de Anthropic. Es una alternativa para cuando querés probar Claude Code sin pagar un plan ni la API por token.

¿Qué pasa si se me acaban los créditos gratuitos de los proveedores?

Cada proveedor que soporta FreeLLMAPI tiene su propio tope de uso gratuito por día o por minuto, y el router va rotando entre los que tengas disponibles cuando uno se corta por rate limit. Si se te terminan todos al mismo tiempo, tenés tres caminos: esperar a que se reinicien al otro día, sumar la key gratuita de otro proveedor soportado, o bajar el consumo real de tokens por sesión con hábitos como los que explica la guía para ahorrar tokens en Claude Code. Ese último punto importa incluso usando backends gratis: menos tokens por tarea significa menos probabilidad de pegar contra el límite de cualquier proveedor.

Fuentes e inspiración

  • claude
  • claude code gratis
  • freellmapi
  • anthropic base url
  • claude code sin pagar la api

Elegí qué cookies usamos