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:
- Instalar Claude Code de forma global, si todavía no lo tenés:
npm install -g @anthropic-ai/claude-code
- 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 enANTHROPIC_AUTH_TOKEN, no enANTHROPIC_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ía | Qué necesitás | Límite principal |
|---|---|---|
| Plan gratuito de Claude.ai | Sólo una cuenta | No incluye Claude Code: solo chat en la web y la app |
| Ollama local | GPU propia con memoria suficiente | El modelo corre en tu hardware |
| FreeLLMAPI | API keys gratuitas de terceros | Rate 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:
- Lista completa de comandos y trucos de límite de uso de Claude Code
- Cómo ahorrar tokens en Claude Code con un archivo CLAUDE.md
- 3 formas de usar Claude y cuál vale la pena
- 5 herramientas para reducir tokens en Claude Code
- 3 plugins gratis de SEO para Claude Code: GSC MCP, OpenSEO y GEO
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.
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.
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.
?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.
Para aprender más de Claude para marketing
- Guía de Claude e IA para marketingEl orden para empezar y las notas de este tema.Guía
- Cómo ahorrar tokens en Claude Code con un archivo CLAUDE.mdClaude Code gasta tokens de más por default: reescribe archivos enteros, te saluda en cada respuesta y relee el mismo contexto. Se arregla con un archivo.Nota
- 3 formas de usar Claude, y solo una vale la penaHay 3 formas de usar Claude: Chat, Cowork y Claude Code. Solo una te cambia la vida. Cuándo usar cada una y por qué Claude Code es la profesional.Nota
Más notas de Claude para marketing
- Biblioteca de skills gratis para Claude CodeQué es la biblioteca comunitaria de skills gratis para Claude Code, quién sube cada una y qué mirar antes de copiarla a tu proyecto.Nota
- The Agency: 7 agentes de IA gratis para Claude CodeThe Agency trae 282 agentes de IA gratis para Claude Code (octubre de 2026). Los 7 que conviene instalar primero y cómo sumarlos en 3 pasos, sin código.Nota
- Everything Claude Code: qué es y cómo instalar ECCEverything Claude Code (ECC) es el setup gratis de Affaan Mustafa, que ganó un hackathon de Anthropic: 311 skills y 71 agentes. Cómo instalarlo.Nota
AI KID
RE/MAX Patagon
Mateo Caño