¿Se puede utilizar Claude Code sin enviar el código a los modelos de Anthropic? Sí: Ollama permite conectar el agente Claude Code con determinados modelos locales mediante una API compatible con Anthropic. La diferencia fundamental es que estarás utilizando la interfaz y las herramientas de Claude Code, pero las respuestas procederán del modelo que selecciones en Ollama, no de Claude.
La integración oficial se inicia con ollama launch claude. Aquí explicamos el procedimiento para macOS y Windows, qué modelo elegir si tienes poca memoria, cómo comprobar que la conexión funciona y qué limitaciones debes conocer antes de utilizarlo en un proyecto importante. Esta guía se fundamenta en documentación oficial; no afirmamos haber medido rendimiento ni ejecutado estos comandos en una máquina durante la redacción.
Qué necesitas antes de comenzar
- Ollama actualizado: instala la versión actual desde ollama.com/download. La integración
ollama launchse incorporó a Ollama en 2026, por lo que versiones antiguas no reconocen el comando. - Claude Code: el comando de integración de Ollama puede guiarte en su instalación. También están las instrucciones oficiales de Anthropic.
- Un modelo compatible con herramientas: no todos los modelos locales sirven bien para leer repositorios, proponer ediciones o llamar herramientas.
- Espacio y memoria disponibles: la descarga del modelo es solo una parte del consumo; el contexto y otras aplicaciones también requieren memoria.
Ollama ofrece modelos que se ejecutan en el propio equipo y otros alojados en la nube. Para que la inferencia sea local debes seleccionar expresamente un modelo local, no uno con sufijo :cloud. La instalación de los programas es gratuita, pero no significa que los modelos alojados en la nube sean ilimitados o gratuitos en cualquier circunstancia.
1. Instala Ollama y verifica que responde
Descarga Ollama para macOS o Windows desde su sitio oficial, ábrelo y completa los pasos de instalación. En una terminal puedes consultar la versión:
ollama --versionSi el comando no existe, confirma que Ollama está instalado y que tu terminal reconoce su ejecutable. En macOS quizá sea necesario abrir la aplicación instalada al menos una vez. En Windows, puedes utilizar PowerShell o una terminal compatible.
La guía de inicio de Ollama documenta el acceso a modelos locales y a agentes de programación desde la terminal.
2. Descarga un modelo local para la primera prueba
Para empezar con un equipo de memoria limitada, utiliza un modelo pequeño que admita herramientas. Por ejemplo, la familia oficial Qwen 3.5 de Ollama incluye variantes de 4B y 9B parámetros, además de versiones más grandes.
ollama pull qwen3.5:4bEl archivo del modelo de 4B ocupa aproximadamente entre 3 y 4 GB, dependiendo de la variante; eso no equivale al consumo total de RAM en una sesión. El historial de la conversación, el número de tokens de contexto y la ejecución de herramientas pueden aumentar notablemente los recursos necesarios.
Puedes comprobar los modelos descargados con:
ollama listEn una Mac con 16 GB de memoria un modelo pequeño puede ser una elección razonable para comprobar la integración, pero no garantiza un agente de programación rápido ni fiable en repositorios grandes. Un modelo de 9B puede ofrecer más capacidad en ciertas tareas, a cambio de mayor consumo. No ofrecemos velocidades ni puntuaciones de calidad sin pruebas reproducibles.
3. Conecta Claude Code con Ollama
Abre la terminal en la carpeta del proyecto donde quieras trabajar y ejecuta:
ollama launch claude --model qwen3.5:4bEl comando base también permite elegir un modelo de forma interactiva:
ollama launch claudeOllama configura la conexión con su API compatible con Anthropic y, si corresponde, guía la instalación de Claude Code. El flujo está documentado en la integración oficial de Claude Code con Ollama.
¿Esto desbloquea gratuitamente los modelos Claude de Anthropic? No. El comando conecta Claude Code con el modelo que hayas elegido en Ollama. Si eliges qwen3.5:4b, las respuestas proceden de Qwen, no de Claude Sonnet u Opus. Es importante distinguir el programa que gestiona el repositorio del modelo que genera las respuestas.
4. Comprueba que el agente puede explicar tu proyecto
Para una primera prueba usa un proyecto pequeño o una carpeta de ejemplo, preferentemente un repositorio Git que puedas recuperar. No empieces dando permiso para modificar archivos importantes ni para ejecutar comandos desconocidos.
Una vez dentro de Claude Code, puedes comenzar con un mensaje como:
Describe la estructura de este proyecto y explica
qué archivo debería leer primero. No cambies nada.Después, si ves resultados coherentes, prueba una petición acotada:
Busca una función sencilla y propone una mejora.
Primero explica el cambio y no edites archivos.Claude Code puede pedir autorizaciones para acceder a archivos o ejecutar comandos. Revisa los permisos y los cambios antes de aceptarlos, especialmente cuando utilices modelos locales pequeños cuya capacidad de seguir instrucciones largas puede ser limitada. La documentación oficial de configuración de Claude Code detalla los controles de permisos.
5. ¿Cuánta memoria necesitas para Claude Code con Ollama?
La memoria necesaria depende del modelo, su cuantización, el contexto configurado y los demás programas abiertos. Es especialmente relevante porque los agentes para programar suelen enviar descripciones extensas del repositorio e instrucciones de herramientas.
- Mac o PC con 16 GB: comienza con una variante pequeña, como
qwen3.5:4b, y tareas simples. No asumas que una ventana de contexto nominal muy grande puede usarse íntegra con esa memoria. - Mac con 24–32 GB: puedes evaluar modelos mayores, siempre revisando el espacio que necesita el contexto. Es una posibilidad, no una recomendación universal ni un rendimiento certificado.
- Más de 32 GB: Ollama publicó una configuración específica con Qwen 3.5 35B y aceleración MLX que exige expresamente una Mac con más de 32 GB de memoria unificada. No es un modelo indicado para una Mac de 16 GB.
Ollama aconseja un contexto de 64 000 tokens o más para agentes de programación. Este valor mejora el margen para instrucciones y herramientas, pero también incrementa el uso de memoria. Consulta las recomendaciones de contexto de Ollama y las condiciones de la versión MLX para Mac.
6. Modelo local frente a modelo en la nube: diferencias
- Local: la inferencia se realiza en tu equipo. Puedes trabajar con el modelo sin enviar cada petición al servidor de inferencia de Ollama, aunque aplicaciones, actualizaciones o herramientas de búsqueda pueden seguir utilizando internet.
- Cloud: la inferencia se ejecuta en servidores remotos; puedes acceder a modelos de mayor tamaño sin descargar sus pesos, pero dependes de conexión, condiciones de servicio y posibles límites o costos.
- Privacidad: seleccionar un modelo local no implica que absolutamente ningún componente o extensión intercambie datos con internet. Revisa las funciones de búsqueda, integraciones y telemetría del software utilizado.
Si el objetivo es que el código sensible no se envíe a un proveedor remoto, verifica la configuración completa y evita activar funciones externas. No anuncies un entorno como «100 % sin conexión» sin comprobar el tráfico real de sus componentes.
7. Cómo utilizar Codex con Ollama
Ollama también ofrece una integración oficial con Codex CLI. Después de instalar Codex CLI, puedes conectarlo mediante:
ollama launch codexEs un flujo distinto del de Claude Code. Si ya utilizas Codex, consulta la documentación oficial de Codex con Ollama, que explica cómo configurar modelos y cambiar entre ellos. No confundas Codex CLI con todas las funciones de las aplicaciones de escritorio: su integración y sus opciones pueden ser diferentes.
Problemas frecuentes y soluciones
«Unknown command launch»
Significa que la instalación de Ollama podría ser anterior a la introducción de ollama launch. Consulta ollama --version y actualiza desde el sitio oficial. El comando de integración se anunció en enero de 2026 para Ollama 0.15 y versiones posteriores.
Claude Code intenta conectarse a Anthropic
Comprueba que lo iniciaste mediante ollama launch claude y que la configuración cargada no apunta a una API o gateway diferentes. Claude Code admite varias fuentes de configuración y variables de entorno; una configuración previa puede interferir con la sesión. Consulta las prioridades de configuración de Anthropic antes de cambiar variables o credenciales.
El modelo responde, pero falla al editar archivos
Que un modelo pueda chatear no significa que siga correctamente instrucciones complejas o utilice herramientas con fiabilidad. Prueba en una carpeta pequeña, verifica que el modelo admite herramientas y limita el alcance de cada tarea. Si sigue fallando, considera un modelo más capaz, de forma local si tus recursos lo permiten o en la nube si aceptas ese intercambio.
La Mac se queda sin memoria o el agente es muy lento
Reduce la carga: cierra aplicaciones que consuman memoria, utiliza un modelo menor, revisa el contexto configurado y comienza con tareas pequeñas. El tamaño de descarga de un modelo no permite calcular por sí solo la RAM que gastará un agente completo.
¿Puedo utilizar un modelo de 35B en 16 GB?
No es una configuración recomendable. La demostración oficial de Qwen 3.5 35B con MLX está dirigida a Macs con más de 32 GB de memoria unificada. En 16 GB resulta más razonable comenzar con una variante pequeña y aceptar sus limitaciones.
Fuentes y límites de la guía
Esta guía utiliza la integración oficial Ollama–Claude Code, la integración con Codex CLI, el catálogo oficial de modelos Qwen 3.5, el anuncio de Ollama Launch, la nota técnica de MLX para Apple Silicon y la configuración de Claude Code. No se realizaron pruebas nuevas de rendimiento, consumo real de RAM, modificaciones de proyectos ni conectividad en macOS o Windows. Los comandos y las funciones pueden cambiar con las nuevas versiones.