Claude Code con Ollama: usarlo con modelos locales y sin gastar tu cuota

Documentación de Ollama con el comando ollama launch claude — Captura de pantalla: docs.ollama.com.

La idea

DIAGRAMA // QUIÉN HACE QUÉ

Claude Code es la interfaz; Ollama decide qué modelo responde.

Ollama es un programa gratuito que ejecuta modelos de IA de código abierto en tu ordenador. Desde hace poco puede arrancar Claude Code conectado a esos modelos con un solo comando, así que usas la interfaz de Claude Code pero el que responde es un modelo local, sin gastar tu cuota de Claude y sin que tus archivos salgan de tu equipo.

Lo que no es: Claude. Los modelos locales son más pequeños y más lentos, y se equivocan más en tareas difíciles. Pero para empezar, aprender o trabajar con código que no quieres subir a ninguna nube, son una opción real.

Paso a paso

Instala Ollama. En Mac o Linux: curl -fsSL https://ollama.com/install.sh | sh. En Windows, desde PowerShell: irm https://ollama.com/install.ps1 | iex. También puedes descargar el instalador desde ollama.com/download.
Instala Claude Code si no lo tienes: guía de instalación.
Lanza Claude Code con Ollama:

ollama launch claude

Ollama te dejará elegir el modelo. Según su documentación, con modelos locales conviene configurar una ventana de contexto de 64k o más, sobre todo si el proyecto es grande; si es corta, Claude Code «olvida» partes del proyecto.

Modelos locales o en la nube de Ollama

Ollama ofrece dos tipos de modelos. Los locales se descargan y corren en tu equipo: no hay límite de uso, pero necesitas memoria y se nota la velocidad. Los de la nube corren en servidores de Ollama: son más grandes y rápidos, no tienes que descargarlos, pero tienen sus propios planes y límites y tus peticiones salen de tu ordenador. Mira las condiciones en su web antes de usarlos con código privado.

Lo honesto

Qué esperar

Hardware. Cuanto mayor es el modelo, más memoria necesita. Con 8 GB de RAM solo tendrás modelos pequeños; con 16 GB o más, la experiencia mejora. En la página de cada modelo en ollama.com verás cuánto ocupa.
Calidad. Un modelo local pequeño no llega al nivel de Claude. Úsalo para tareas sencillas y revisa todo lo que escriba.
Herramientas. No todos los modelos manejan bien las llamadas a herramientas que usa Claude Code. Elige uno que lo indique como compatible.

Si no te llega la máquina, la alternativa gratuita es freellmapi, que usa los planes gratuitos de proveedores en la nube.

Preguntas frecuentes

¿Puedo usar Claude Code gratis con Ollama?

Con modelos locales no pagas uso, pero Claude Code sigue siendo el programa; lo que responde es un modelo de código abierto en tu ordenador, no Claude. Los modelos en la nube de Ollama tienen sus propios planes y límites.

¿Qué comando lanza Claude Code con Ollama?

ollama launch claude. Según la documentación de Ollama, te deja elegir el modelo y conecta Claude Code a través de su API compatible con Anthropic.

¿Cuánta memoria necesito?

Depende del modelo. Con 8 GB de RAM solo irán modelos pequeños; con 16 GB o más puedes probar modelos medianos. La ficha de cada modelo en ollama.com indica su tamaño.

¿Mis archivos salen de mi ordenador?

Con un modelo local, no: todo se procesa en tu equipo. Con los modelos en la nube de Ollama, tus peticiones sí viajan a sus servidores.