Cómo usar Claude Code gratis con Ollama (y qué no es gratis)
Claude Code con los modelos de Claude pide plan Pro o la API. Gratis solo se puede usar la herramienta con modelos abiertos que corren en tu ordenador con Ollama. Cómo montarlo, qué esperar y cómo volver a Claude.
Con los modelos de Claude no es gratis: Claude Code está desde el plan Pro (20 USD al mes) o con la API de pago. Gratis puedes usar la herramienta con modelos abiertos en tu ordenador gracias a Ollama: instala los dos y ejecuta ollama launch claude.
- Un ordenador con macOS, Linux o Windows y espacio para descargar un modelo
- Saber abrir una terminal y pegar comandos
- Por qué Claude Code con Claude no es gratis y qué opciones hay
- Cómo instalar Claude Code y Ollama
- Cómo arrancar Claude Code con un modelo local en un solo comando
- Cómo configurarlo a mano con variables de entorno
- Qué funciona peor con modelos abiertos y cómo volver a Claude
Entender qué es gratis y qué no
Claude Code, la herramienta, se instala gratis. Lo que se paga es el modelo que piensa detrás. Con los modelos de Claude hay dos vías: un plan de pago (Pro, desde 20 USD al mes o 200 al año; el plan gratuito no incluye Claude Code) o una clave de la API, que se paga por uso. La vía sin coste es otra: desde enero de 2026, Ollama habla el mismo idioma que la API de Anthropic, así que Claude Code puede funcionar con modelos abiertos, como Qwen o Gemma, que corren en tu ordenador. Es Claude Code, pero no es Claude: los resultados dependen del modelo que elijas.
Instalar Claude Code
Usa el instalador nativo, que no necesita Node.js. En macOS, Linux o WSL, pega el primer comando en la terminal; en Windows, el segundo en PowerShell. Al terminar, el comando claude queda disponible. Si ya lo tenías, actualízalo con claude update.
# macOS, Linux o WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iexInstalar Ollama y elegir un modelo
Descarga Ollama desde ollama.com e instálalo; necesitas la versión 0.14 o posterior. Ollama descarga y ejecuta modelos abiertos en tu ordenador. Para programar con Claude Code, elige un modelo que use herramientas y súbele el contexto a 64.000 tokens o más, como recomienda Ollama: con menos, al modelo no le cabe el proyecto. Los modelos grandes piden mucha memoria; si tu ordenador va justo, empieza por uno pequeño y sube si se queda corto.
Arrancar con un solo comando
La forma más sencilla es dejar que Ollama lo configure todo. Abre la terminal en la carpeta de tu proyecto y ejecuta ollama launch claude. Te deja elegir el modelo, lo descarga si hace falta y abre Claude Code ya conectado a él. Funciona igual en macOS, Linux y Windows.
cd mi-proyecto
ollama launch claudeConfigurarlo a mano, si lo prefieres
Si quieres controlar tú la conexión, define tres variables de entorno y arranca Claude Code con el modelo. ANTHROPIC_BASE_URL manda las peticiones a Ollama en tu ordenador en vez de a Anthropic, ANTHROPIC_AUTH_TOKEN puede ser cualquier texto (Ollama no lo comprueba) y ANTHROPIC_API_KEY vacía evita que se use una clave real. Dentro de Claude Code, el comando /status te dice a dónde está conectado.
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3.5Probar los modelos en la nube de Ollama
Si tu ordenador no puede con un modelo grande, Ollama también ofrece modelos en su nube, los que terminan en :cloud, que no se descargan y funcionan con su contexto completo. Necesitan una cuenta de Ollama y van con sus condiciones y límites, que conviene revisar en ollama.com antes de contar con ellos. Se usan igual: eliges el modelo en ollama launch claude o lo pasas con --model.
Saber qué esperar y cómo volver a Claude
Con un modelo compatible funciona lo básico de Claude Code: leer y editar archivos, ejecutar comandos con su sistema de permisos y usar herramientas. Lo que cambia es la calidad: en proyectos grandes o tareas largas, un modelo abierto pequeño se equivoca más y se pierde antes que Claude. Algunas funciones, como la búsqueda web alojada, no van del todo. Para volver a Claude, cierra Claude Code, borra las variables y entra con tu cuenta.
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_API_KEY
claude
# dentro de Claude Code:
/loginTienes Claude Code funcionando sin pagar, con un modelo abierto en tu ordenador a través de Ollama, y sabes que para usarlo con Claude necesitas Pro o la API. Cuando des el salto, el curso de Claude Code para desarrollo con IA va paso a paso.
Preguntas frecuentes
¿Claude Code es gratis?
La herramienta se instala gratis, pero para usarla con Claude necesitas un plan Pro o superior o una clave de la API de pago. El plan gratuito de Claude no incluye Claude Code.
¿Con Ollama estoy usando Claude?
No. Usas el programa Claude Code, pero las respuestas las da el modelo abierto que elijas en Ollama, como Qwen o Gemma. La calidad depende de ese modelo.
¿Qué modelo de Ollama va mejor con Claude Code?
Uno que admita herramientas, con 64.000 tokens de contexto o más. La documentación de Ollama usa qwen3.5 como ejemplo local; los modelos :cloud van sin descargar. La lista cambia a menudo.
¿Por qué Claude Code me cobra si tengo Pro?
Porque hay una variable ANTHROPIC_API_KEY con una clave real en tu sistema: Claude Code la prefiere al plan y cobra por uso en la API. Bórrala y entra con /login.
¿Puedo volver a usar Claude después de probar Ollama?
Sí. Borra las variables ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN y ANTHROPIC_API_KEY, abre Claude Code y entra con tu cuenta con /login.