Claude Code gratis: setup con Ollama y DeepSeek

Claude Code gratis es posible en 2026, y no requiere ningún truco raro. Con Ollama local o OpenRouter, cualquier desarrollador puede conectar Claude Code a modelos alternativos como DeepSeek o Llama sin tocar la API oficial de Anthropic y sin pagar un peso por uso.

En 30 segundos

  • Claude Code es una herramienta CLI de Anthropic para programar con IA desde la terminal, disponible de forma gratuita como binario desde abril 2026.
  • Podés conectarla a Ollama (modelos 100% locales, sin costo) o a OpenRouter (hasta 50 requests/día gratis, o DeepSeek desde USD 0,14 por millón de tokens).
  • El setup requiere configurar dos variables de entorno: ANTHROPIC_API_KEY y ANTHROPIC_BASE_URL. Sin modificar el código de Claude Code.
  • Para uso serio sin gastar fortunas, DeepSeek vía OpenRouter es a mayo 2026 la opción más económica con velocidad real.
  • Claude Code tiene instalador nativo para Windows 10 (1809+) y Windows 11 desde el lanzamiento de la app desktop en abril 2026.

Qué es Claude Code y por qué la gente busca alternativas gratis

Claude Code es una herramienta CLI de Anthropic que permite a los desarrolladores interactuar con Claude directamente desde la terminal para tareas de programación: edita código, ejecuta comandos git, navega repositorios y se integra con herramientas externas vía MCP (Model Context Protocol). No es un plugin de IDE. Es un agente que corre en tu terminal y tiene acceso a todo el contexto de tu proyecto.

El problema es el costo. A mayo 2026, Claude Sonnet 4.6 vía API oficial cuesta USD 3 por millón de tokens de entrada y USD 15 por millón de tokens de salida. En un proyecto real con sesiones largas, eso se acumula rápido. La suscripción Claude Max arranca en USD 100/mes para uso más intensivo. Para un estudiante, un freelancer empezando, o alguien que quiere experimentar sin compromisos, esos números frenan antes de empezar.

Ojo: Claude Code como binario es gratuito. Lo que cuesta es el acceso al modelo. Y ahí es donde entran las alternativas.

Las 3 opciones para usar Claude Code gratis o muy barato en 2026

Ponele que ya instalaste Claude Code. Ahora, en vez de apuntar a la API de Anthropic, redirigís el cliente a otro endpoint. Claude Code respeta las variables de entorno estándar, así que esto funciona sin parchear nada.

Ollama local: privacidad total, costo cero

Ollama te permite correr modelos LLM directamente en tu máquina. Una vez instalado, exponés un servidor local en localhost:11434 con una API compatible con OpenAI. Claude Code no sabe ni le importa que del otro lado hay un Llama 3.1 en vez de Claude: solo sigue el contrato de API.

Los modelos que mejor funcionan con Claude Code en este setup son los que tienen ventana de contexto de 64k o más, como Llama 3.1 70B o Qwen2.5-Coder. La limitación real no es el software, es el hardware: para correr un modelo de 70B con velocidad razonable necesitás una GPU con 24GB de VRAM mínimo, o paciencia infinita con CPU. En una máquina con 8GB de RAM usando modelos de 7B, la experiencia es lenta pero funcional para tareas simples. Cubrimos ese tema en detalle en entender todas las capacidades de Claude.

¿Cuándo tiene sentido? Cuando trabajás offline, cuando los datos son sensibles y no pueden salir de tu máquina, o cuando tenés el hardware para hacerlo bien.

OpenRouter con modelos gratuitos: el balance entre costo y velocidad

OpenRouter actúa como proxy unificado para docenas de modelos de distintos proveedores. Con una cuenta gratuita tenés acceso a unos 50 requests por día sin pagar. Para uso esporádico o para probar, alcanza. Para trabajo diario, no.

La configuración es directa: creás cuenta en OpenRouter, generás una API key, y configurás:

ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1
ANTHROPIC_API_KEY=sk-or-tu-key-aqui

Claude Code va a mandar sus requests a OpenRouter, que los redirige al modelo que elegiste. Funciona. La latencia depende del modelo y del momento del día.

DeepSeek vía OpenRouter: la opción más económica con velocidad real

DeepSeek R1 y DeepSeek V3 son modelos chinos con rendimiento competitivo en benchmarks de código. A través de OpenRouter, DeepSeek V3 cuesta USD 0,14 por millón de tokens de entrada a mayo 2026 (el precio varía según el endpoint). Comparado con Claude Sonnet 4.6 oficial (USD 3/MTok entrada), la diferencia es de 20x.

Para tareas de código rutinarias, la diferencia de calidad es tolerable. Para razonamiento complejo o proyectos donde la precisión es crítica, empezás a notar los límites. Pero si el presupuesto es ajustado, a mayo 2026 DeepSeek es la opción más sensata del mercado. En elegir el modelo de IA adecuado profundizamos sobre esto.

Cómo instalar Claude Code en Windows paso a paso

Desde abril 2026, Anthropic lanzó apps desktop nativas para macOS y Windows, lo que simplificó bastante la instalación. Antes había que lidiar con Node.js y npm. Ahora hay un instalador binario directo.

Requisitos mínimos para Windows:

  • Windows 10 versión 1809 o superior, o Windows 11 21H2+
  • Git for Windows instalado (necesario para las integraciones git)
  • 4GB de RAM mínimo (8GB recomendado)
  • Conexión a internet para autenticación inicial

El proceso de instalación es: descargás el instalador desde claude.com/product/claude-code, lo corrés, y te abre un browser para autenticarte con tu cuenta de Anthropic. Si usás Ollama u OpenRouter, configurás las variables de entorno antes de abrir Claude Code por primera vez, o las agregás después en el archivo de configuración.

Si querés WSL2 (opcional), el setup es similar pero dentro del entorno Linux. Tiene sentido si tu stack de desarrollo ya vive en WSL. Si no, el cliente nativo de Windows anda bien.

Una cosa que casi nadie menciona: el archivo CLAUDE.md en la raíz de tu proyecto es donde le explicás a Claude Code el contexto del repo. Qué lenguaje usás, qué comandos correr para tests, cómo está estructurado. Sin ese archivo, Claude Code trabaja a ciegas. Con él, el comportamiento mejora considerablemente.

Configuración con OpenRouter + DeepSeek: los números reales de mayo 2026

Creás tu cuenta en OpenRouter, vas a la sección de API Keys, generás una. Después, en tu sistema o en el archivo de configuración de Claude Code:

export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_API_KEY="sk-or-v1-tukey"

En Windows con PowerShell:

$env:ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
$env:ANTHROPIC_API_KEY="sk-or-v1-tukey"

¿Y qué modelo elegís? Según la guía de MindStudio sobre OpenRouter con Claude Code, los mejores resultados en tareas de código con precio razonable son DeepSeek V3 y Qwen2.5-Coder-32B. Para tareas de razonamiento complejo, DeepSeek R1 da resultados notablemente mejores al costo de un poco más de latencia.

El plan gratuito de OpenRouter tiene 50 requests diarios sin cargo. Para un uso de hobby o exploración, eso alcanza. Para trabajo serio, en una sesión de Claude Code activa podés gastar eso en 20 minutos (Claude Code es chatty: manda muchos requests pequeños en una sola tarea). Con DeepSeek de pago, una sesión de trabajo de 2 horas sale entre USD 0,50 y USD 2, dependiendo de la complejidad del código. Más contexto en explorar las capacidades de Opus.

Claude Code vs Cursor vs Cline: cuál usar según tu caso

HerramientaPrecio baseArquitecturaModelos compatiblesMejor para
Claude CodeGratis (pagas el modelo)CLI / TerminalAnthropic, OpenRouter, OllamaDevs que viven en la terminal, proyectos grandes
CursorUSD 20/mes (Pro)IDE dedicado (fork de VS Code)GPT-4o, Claude Sonnet 4.6, otrosQuienes prefieren GUI, trabajo visual
ClineGratis (extensión open-source)Extensión VS CodeCualquier API compatibleMáxima flexibilidad de backend, VS Code users
claude code gratis diagrama explicativo

La diferencia de fondo es la filosofía. Claude Code es agéntico puro: tomás una tarea, la dejás correr, el agente edita archivos, ejecuta comandos, hace git commits. Cursor es más interactivo, más IDE. Cline es la opción open-source máximamente flexible pero requiere más configuración manual.

Si ya usás VS Code y no querés cambiar tu entorno, Cline con OpenRouter o Ollama como backend te da prácticamente el mismo resultado que Claude Code gratis (spoiler: es casi lo mismo por dentro). Si te importa el rendimiento en tareas complejas y tenés presupuesto aunque sea mínimo, Claude Code con DeepSeek vía OpenRouter es el punto medio más sensato a mayo 2026.

MCP: cómo extender Claude Code más allá del código

Model Context Protocol (MCP) es el sistema que usa Claude Code para conectarse a herramientas externas. Con MCP podés darle acceso a Google Drive, Slack, Jira, bases de datos, o herramientas custom que vos mismo construyas.

Lo interesante es que MCP funciona igual independientemente del backend de modelo que estés usando. Si conectaste Claude Code a Ollama o a OpenRouter, los servidores MCP andan igual. No hay dependencia con la API de Anthropic para esta parte.

Un ejemplo concreto: si tu proyecto tiene documentación en Google Drive, podés configurar el MCP server de Google Drive para que Claude Code lea esos archivos directamente al analizar tu código. Sin copiar y pegar nada. La configuración va en el archivo .claude/mcp_servers.json del proyecto, o en la configuración global del cliente.

Si el proyecto también involucra el deployment en algún servidor, con donweb.com podés integrar fácilmente el hosting sin salir del flujo de trabajo que Claude Code ya conoce.

Qué está confirmado y qué todavía no

Confirmado

  • Claude Code es gratuito como binario desde su lanzamiento general en 2026
  • La integración con Ollama vía variables de entorno funciona según múltiples implementaciones documentadas en GitHub
  • OpenRouter acepta requests de Claude Code con la configuración de ANTHROPIC_BASE_URL
  • El cliente nativo para Windows está disponible desde abril 2026
  • DeepSeek V3 cuesta USD 0,14/MTok de entrada en OpenRouter a mayo 2026

Todavía no confirmado o con matices

  • El rendimiento de modelos locales para tareas complejas de refactoring varía mucho según el modelo y la máquina. Los benchmarks en repositorios como claude-code-ollama-local-es son indicativos, no definitivos
  • Los precios de OpenRouter fluctúan. El dato de USD 0,14/MTok es de mayo 2026, pero puede cambiar
  • La compatibilidad de todos los MCP servers con backends alternativos no está documentada exhaustivamente

Errores comunes al configurar Claude Code gratis

Error 1: Configurar las variables de entorno en la sesión equivocada. Si ponés export ANTHROPIC_BASE_URL=... en una terminal y después abrís Claude Code en otra, no hereda esas variables. El resultado es que Claude Code conecta a la API oficial de Anthropic y te cobra. Solucioná esto agregando las variables al perfil de tu shell (.bashrc, .zshrc, o en Variables de Entorno del sistema en Windows).

Error 2: Elegir un modelo local sin contexto suficiente. Claude Code necesita modelos con ventana de contexto grande (mínimo 32k, preferentemente 64k o más) porque manda el contenido de archivos enteros en cada request. Con un modelo de 4k o 8k de contexto, el agente empieza a fallar en proyectos medianos. Fijate en el context length antes de descargar el modelo. Sobre eso hablamos en escalar Claude Code en proyectos grandes.

Error 3: No configurar el CLAUDE.md del proyecto. Sin este archivo, Claude Code no sabe nada sobre tu proyecto específico. Empieza explorando a ciegas, hace más requests, consume más tokens, y tarda más. Un CLAUDE.md mínimo con descripción del stack, comandos de test y estructura de carpetas mejora mucho la eficiencia. Cualquiera que haya configurado Claude Code en un proyecto grande y no haya agregado ese archivo sabe a qué me refiero: el agente da vueltas innecesarias.

Error 4: Asumir que DeepSeek anda igual que Claude en todo. Para tareas de autocompletado y refactoring puntual, la diferencia es menor. Para razonamiento en múltiples pasos (tipo “analizá toda la arquitectura y proponé una migración”), Claude Sonnet 4.6 sigue siendo notablemente mejor. Usá el modelo correcto para la tarea correcta.

Preguntas Frecuentes

¿Cómo puedo usar Claude Code gratis en 2026?

Instalás el cliente gratuito de Claude Code y configurás la variable ANTHROPIC_BASE_URL para que apunte a Ollama local o a OpenRouter. OpenRouter tiene un tier gratuito de 50 requests/día. Con Ollama corriendo modelos como Llama 3.1 o Qwen2.5-Coder en tu máquina, el costo es cero aunque necesitás hardware decente.

¿Se puede instalar Claude Code sin pagar suscripción?

Sí. Claude Code como software es gratuito. Lo que tiene costo es el acceso al modelo de Anthropic vía API. Si usás backends alternativos (Ollama, OpenRouter), no pagás nada a Anthropic. Si usás DeepSeek vía OpenRouter, el costo es mínimo (centavos por sesión de trabajo normal).

¿Cómo conectar Claude Code a Ollama local?

Instalás Ollama, descargás un modelo con 64k de contexto, y configurás ANTHROPIC_BASE_URL=http://localhost:11434/v1 y cualquier string como ANTHROPIC_API_KEY (Ollama no la valida). Claude Code detecta el servidor automáticamente. La limitación es el hardware: modelos grandes requieren GPU con bastante VRAM.

¿Cuál es más barato: Claude Code con DeepSeek, Cursor o Cline?

Claude Code con DeepSeek vía OpenRouter es lo más barato para uso intensivo: entre USD 0,50 y USD 2 por sesión de 2 horas. Cursor Pro cuesta USD 20 fijos por mes. Cline con OpenRouter puede salir similar a Claude Code + DeepSeek. La diferencia real no es el costo sino el flujo de trabajo: Claude Code es agéntico y CLI, Cursor es IDE visual.

¿Claude Code funciona con DeepSeek vía OpenRouter?

Sí, funciona. Configurás ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1 con tu API key de OpenRouter, y elegís DeepSeek V3 o R1 como modelo. Para código rutinario la calidad es buena. Para razonamiento complejo de múltiples pasos, Claude Sonnet 4.6 sigue teniendo ventaja, pero a 20 veces el precio por token.

Conclusión

Claude Code gratis no es marketing, es una realidad de 2026. El cliente es gratuito, la arquitectura es abierta, y las alternativas de backend son maduras. Para proyectos personales o experimentación, Ollama o el tier gratuito de OpenRouter alcanzan sin gastar nada. Para trabajo real con frecuencia diaria, DeepSeek vía OpenRouter es el punto de entrada más sensato: prestaciones razonables a un costo de dos cafés por mes.

Lo que cambió este año es que la fricción bajó. La app desktop, la compatibilidad con Ollama sin parchear nada, y la proliferación de modelos económicos de buena calidad hacen que el setup sea accesible para cualquiera que sepa usar una terminal. Si venías postergando probarlo por el costo, ese argumento ya no aplica.

Fuentes

Desplazarse hacia arriba