Claude Code gratis: setup con Ollama y DeepSeek

En pocas palabras: Claude Code se descarga gratis, pero usarlo requiere suscripción Pro (USD 20/mes) o créditos de API. Hay tres vías sin pagar verificadas en 2026: los USD 5 de prueba de la API por 14 días, el programa Claude for Open Source, o Ollama con DeepSeek como backend local.

Ejemplo práctico

Martín Quiroga, desarrollador freelance en Córdoba, mantiene un microservicio en Python para una pyme de logística. Para no gastar los USD 20/mes de la suscripción Pro mientras prueba la herramienta, conectó Claude Code a un backend local con Ollama corriendo DeepSeek-Coder 6.7B en su notebook (16 GB de RAM, GPU integrada). El setup le llevó 12 minutos: instaló Ollama, descargó el modelo con ollama pull deepseek-coder:6.7b (3.8 GB) y apuntó la variable de entorno ANTHROPIC_BASE_URL al endpoint local en el puerto 11434.

Su primera tarea concreta: pedirle a la CLI que refactorizara un módulo de 240 líneas que validaba guías de despacho y agregara tests con pytest. El modelo local generó 9 casos de test y detectó 2 bugs de validación de fechas que él no había visto.

Resultado: 0 pesos gastados en API en toda la semana de pruebas, con respuestas en ~8 segundos por consulta de forma local. Para tareas más complejas (arquitectura, debugging multiarchivo) Martín reservó los créditos de prueba de USD 5, que le rindieron 11 días antes de decidir si pasaba al plan Pro.

Cómo funciona

  1. Instalá Ollama: descargá el runtime desde ollama.com para tu sistema operativo (macOS, Linux o Windows). Es el motor que va a correr el modelo en tu propia máquina, sin enviar nada a la nube ni gastar créditos.
  2. Bajá el modelo DeepSeek: corré ollama pull deepseek-coder-v2 (o la variante que te entre en RAM) desde la terminal. Ollama deja el modelo escuchando local en el puerto 11434.
  3. Levantá un puente compatible con la API de Anthropic: como Claude Code espera el formato de mensajes de Anthropic, necesitás un proxy local (tipo claude-code-router o LiteLLM) que traduzca esas llamadas al endpoint de Ollama.
  4. Apuntá Claude Code al backend local: exportá ANTHROPIC_BASE_URL hacia tu proxy y poné cualquier valor en ANTHROPIC_API_KEY. La CLI cree que habla con Anthropic, pero por detrás responde DeepSeek desde tu equipo.
  5. Probá con una tarea real: abrí un proyecto, pedile a la CLI que lea un archivo o genere una función y confirmá que la respuesta sale del modelo local. Si responde sin contar consumo de tokens pagos, el setup gratuito quedó andando.

Instalar Claude Code gratis es posible, pero con una trampa: la descarga no cuesta nada, el uso real sí. Claude Code es una herramienta CLI de Anthropic que permite interactuar con Claude desde la terminal para tareas de programación, y su acceso completo requiere suscripción Pro de USD 20/mes como mínimo.

En 30 segundos

  • Claude Code se descarga gratis, pero para usar la CLI necesitás suscripción Pro (USD 20/mes) o créditos de API.
  • Hay tres caminos gratuitos verificados: créditos de prueba en la API ($5 por 14 días), el programa Claude for Open Source, y Ollama como backend local.
  • Instalación en menos de 5 minutos con el native installer, sin Node.js ni dependencias extra.
  • En benchmarks SWE-bench 2026, Claude Code logró 80.8% contra 72% de Cursor y ~65% de GitHub Copilot.
  • El plan Free de claude.ai (~40 mensajes/día) no incluye acceso al modo CLI.

Por qué Claude Code parece “gratuito” pero no lo es del todo

Buscás “instalar Claude Code gratis”, encontrás un tutorial con cuatro pasos y pensás que listo. Pero cuando llegás al paso de autenticación, la cosa se complica.

El instalador no cuesta nada. Lo que sí cuesta es el acceso al modelo detrás. Claude Code es la interfaz CLI de Anthropic, una herramienta que corre en tu terminal y se conecta a los modelos Claude (Sonnet, Opus, Haiku) vía API. Sin créditos de API o suscripción Pro activa, la CLI se instala pero no ejecuta nada útil.

La confusión viene de mezclar tres cosas distintas: claude.ai (la web con plan Free), la API de Anthropic (console.anthropic.com, con free tier de $5), y Claude Code la CLI (que requiere Pro o API con saldo). Son productos separados que comparten marca.

Y acá viene la diferencia arquitectónica que importa para elegir herramienta. Claude Code corre en tu terminal como agente autónomo. Cursor es un fork de VS Code con IA integrada. GitHub Copilot es una extensión que sugiere código línea a línea. No son lo mismo ni compiten exactamente en el mismo espacio (aunque las comparativas abundan, como veremos más adelante).

Requisitos reales: sistema y suscripción

Para que Claude Code corra, necesitás:

  • Windows 10 o superior (recomendado Windows 11), macOS 12+, o Linux con Ubuntu 20.04+ (también Debian, Fedora recientes).
  • Git instalado en Windows. Es el error más común que detiene la instalación antes de arrancar.
  • Node.js 18+ solo si usás el método legacy vía npm. El native installer no lo requiere.
  • Suscripción Pro de claude.ai (USD 20/mes) o créditos activos en console.anthropic.com.

¿Por qué no funciona con el plan Free de claude.ai? Porque ese plan da acceso a la interfaz web con límite de ~40 mensajes/día, sin modo agente ni CLI. La arquitectura es diferente: la web es conversacional, la CLI es un agente que toma acciones sobre tu código, navega archivos, ejecuta comandos y hace múltiples llamadas al modelo en una sola tarea. Eso consume tokens de manera diferente y Anthropic lo separa deliberadamente. Tema relacionado: si querés conocer más sobre Claude.

Instalación paso a paso en Windows, macOS y Linux

El método recomendado desde 2026 es el native installer, sin dependencias:

Windows

Antes que nada, instalar Git desde git-scm.com si no lo tenés. Después, descargar el instalador desde code.claude.com/docs/es/setup, ejecutarlo, y seguir el wizard. La autenticación se abre en el navegador y conecta con tu cuenta claude.ai. Tiempo total: menos de 5 minutos.

macOS

Misma lógica con el .pkg del sitio oficial, o con Homebrew si preferís: brew install claude. Autenticación vía navegador, igual que Windows.

Linux

El método legacy sigue siendo el más documentado acá: npm install -g @anthropic-ai/claude-code (requiere Node.js 18+). El native installer ya está disponible pero el soporte de distribuciones varía. Verificá con claude --version que quedó instalado.

Eso sí: instalar es la parte fácil. Lo que viene después (la autenticación, los créditos, el modelo que elegís) es donde la gente traba.

Las únicas formas verificadas de instalar Claude Code gratis

Siendo honesto: no hay hack mágico. Pero sí hay cuatro caminos reales.

1. Free tier de la API (el más rápido para arrancar)

Crear cuenta en console.anthropic.com da $5 de crédito por 14 días. Con eso podés usar Claude Code CLI con el modelo Haiku (el más barato) durante un par de sesiones reales. No es mucho, pero alcanza para evaluar si la herramienta tiene sentido para tu flujo de trabajo antes de pagar.

2. Claude for Open Source

Si tenés un proyecto open source activo, Anthropic tiene un programa que otorga acceso equivalente a USD 1.200 en seis meses. El proceso es una solicitud de formulario. No es inmediato, pero si calificás es el mejor deal disponible.

3. Ollama como backend local (100% offline)

Desde la versión 0.14.0 de Claude Code, podés configurarlo para que use un modelo local corriendo en Ollama en vez de conectarse a la API de Anthropic. Completamente gratis, sin límites de uso, sin conexión a internet requerida. Las limitaciones son reales (calidad del modelo, sin acceso a Claude Sonnet ni Opus), pero para tareas de código básico zafa.

4. Plan Free de claude.ai (solo web)

Técnicamente gratis, pero no es lo mismo. La interfaz web de claude.ai con plan Free no incluye el modo agente ni la CLI. Podés pedirle que te ayude con código en la web, pero no es Claude Code. Lo explicamos a fondo en elegir entre los modelos disponibles.

Método Ollama: ejecutar Claude Code sin pagar nada

Instalás Ollama desde ollama.ai, bajás un modelo compatible (Llama 3, Mistral 7B, Code Llama), y configurás Claude Code para apuntar al servidor local:

  • En tu archivo CLAUDE.md o como variable de entorno: ANTHROPIC_BASE_URL=http://localhost:11434/v1
  • El modelo se especifica con ANTHROPIC_MODEL=llama3 o el nombre que descargaste.
  • Claude Code arranca normalmente pero usa tu GPU local en vez de los servidores de Anthropic.

¿Y cuándo vale la pena? Cuando trabajás en código que no puede salir de tu red (proyectos con NDA, datos sensibles, zonas con conectividad inestable). Los modelos locales son peores que Claude Sonnet para tareas complejas de razonamiento, pero para refactoreo simple, generación de tests o documentación rápida, hacen el trabajo.

Subís el modelo local, lo probás con un refactor de función, funciona bien, lo probás con una migración de base de datos con 15 tablas y de repente empieza a inventar columnas, olvidarse del contexto y sugerirte cosas que funcionan en ningún ORM real. Ese es el límite real del método.

Comparativa: Claude Code vs Cursor vs GitHub Copilot en 2026

Si estás evaluando opciones, acá están los datos concretos según benchmarks y pricing de 2026:

HerramientaArquitecturaPrecio baseSWE-bench 2026Context windowMejor para
Claude CodeTerminal CLI agenteUSD 20/mes (Pro)80.8%1M tokensTareas complejas, refactoreo profundo
CursorFork de VS CodeUSD 20/mes72%200k tokensIDE moderno, flujo visual
GitHub CopilotExtensión IDEUSD 10/mes~65%128k tokensAutocompletado, accesibilidad de precio
instalar claude code gratis diagrama explicativo

La diferencia de 8 puntos entre Claude Code y Cursor en SWE-bench no es trivial cuando hablás de tareas reales de código. Eso sí: el benchmark es del propio ecosistema de Anthropic, así que tomalo con pinzas.

Lo que mucha gente que trabaja con estas herramientas reporta en 2026 es un esquema híbrido: Cursor o Copilot para el día a día de codeo (autocompletado, navegación, commits pequeños), y Claude Code para sesiones de trabajo pesado donde necesitás que el agente entienda el contexto amplio del proyecto y tome decisiones encadenadas. Para más detalles técnicos, mirá capacidades y límites de cada modelo.

Errores comunes que detienen tu instalación

Error 1: Creer que descargar = usar gratis

La instalación no tiene costo. El uso requiere créditos o suscripción. Si vas directo a la CLI sin configurar credenciales, vas a ver un error de autenticación que parece un bug de instalación pero no lo es.

Si querés meterte en esto, tenemos todo cubierto en nuestro artículo de setup gratuito de Claude Code.

Para empezar a usar este modelo, contamos con una guía completa sobre usar DeepSeek gratis.

Error 2: Confundir claude.ai con Claude Code

Son productos distintos con autenticaciones distintas. Tener cuenta en claude.ai no alcanza para usar la CLI si no tenés Pro o saldo de API. Mucha gente configura todo bien y después no entiende por qué no arranca.

Error 3: Buscar la “extensión de Claude Code” para VS Code

No existe oficialmente. Claude Code es CLI, no extensión. Hay extensiones no oficiales en el marketplace pero no son el producto real. Si necesitás integración con VS Code, usás Claude Code desde la terminal integrada del editor.

Error 4: Saltarse Git en Windows

Git es requisito en Windows antes de instalar Claude Code. Sin Git, el instalador falla o la herramienta no puede operar sobre repositorios. Instalarlo después del error no siempre resuelve el problema sin reinstalar Claude Code.

Esto se conecta con Claude Code Free Setup That Actually Works, que cubrimos en detalle acá.

Error 5: Pensar que el plan Free de claude.ai tiene acceso al modo Code

El plan Free tiene ~40 mensajes/día de conversación web. No incluye el modo agente ni la capacidad de correr tareas autónomas. Eso es exclusivo de Pro y Max.

Preguntas Frecuentes

¿Cómo instalo Claude Code sin pagar?

Podés instalar la CLI sin pagar, pero para usarla necesitás créditos de API. La opción más rápida es registrarte en console.anthropic.com y usar los $5 de crédito de prueba por 14 días. Para uso permanente sin costo, la alternativa es Ollama como backend local desde la versión 0.14.0. Te puede servir nuestra cobertura de escalar Claude Code en proyectos grandes.

¿Claude Code tiene versión gratuita disponible?

No hay una versión gratuita con acceso completo. El free tier de la API da $5 de crédito inicial por 14 días. El programa Claude for Open Source otorga acceso equivalente a USD 1.200 en seis meses para proyectos open source calificados. Todo lo demás requiere suscripción Pro (USD 20/mes) o pago por uso de API.

¿Cuáles son los requisitos mínimos para instalar Claude Code?

Windows 10+, macOS 12+, o Ubuntu 20.04+ en Linux. Git instalado (obligatorio en Windows). Node.js 18+ solo si usás el método de instalación vía npm legacy. El native installer no requiere Node.js. En cuanto a hardware, cualquier equipo moderno que corra un navegador sin problemas puede correr Claude Code CLI.

¿Puedo usar Claude Code con Ollama gratis?

Sí. Desde la versión 0.14.0 de Claude Code podés configurarlo para usar Ollama como backend local. Instalás Ollama, descargás un modelo compatible (Llama 3, Mistral, Code Llama), y apuntás Claude Code al servidor local con la variable de entorno ANTHROPIC_BASE_URL=http://localhost:11434/v1. Sin costo, sin internet, pero con limitaciones de calidad respecto a Claude Sonnet.

¿Cuál es mejor: Claude Code, Cursor o GitHub Copilot para Argentina?

Depende del uso. Para presupuesto ajustado, Copilot a USD 10/mes tiene el costo más bajo. Para flujo visual en IDE, Cursor ofrece mejor experiencia integrada. Para tareas complejas donde necesitás un agente que maneje contexto amplio (1M de tokens) y tome decisiones encadenadas, Claude Code lidera en benchmarks SWE-bench 2026 con 80.8%. Muchos equipos usan Copilot o Cursor para el día a día y Claude Code para sesiones de trabajo pesado.

Conclusión

Claude Code se puede instalar gratis, pero operar gratis tiene límites claros. El free tier de API ($5 por 14 días) alcanza para evaluarlo. Ollama como backend es la única opción de uso indefinido sin costo, con la baja de calidad que eso implica. Para uso profesional en Argentina, la cuenta Pro a USD 20/mes contra los benchmarks de 2026 justifica la inversión si trabajás con código complejo regularmente.

Si vas a alojar el proyecto donde uses Claude Code en algún servidor, recordá que para hosting y dominios en Argentina, donweb.com es una opción con soporte local y presencia desde hace años en el mercado regional.

El takeaway real: no busques el hack mágico que no existe. Evaluá con los $5 de crédito, medí si la diferencia de rendimiento respecto a tu herramienta actual vale el costo mensual, y decidís con datos.

Fuentes

Desplazarse hacia arriba