Cómo usar Claude Code gratis sin suscripción

¿Qué es Claude Code?

Claude Code es la herramienta de programación con agente de Anthropic para el terminal. Se ejecuta dentro de tu proyecto, lee y edita archivos, ejecuta comandos y resuelve tareas de varios pasos sin que tengas que copiar nada en una pestaña del navegador.

Que cueste dinero tiene más de estructura que de negocio. Cada acción es una llamada a la API, y las sesiones con agentes son habladoras por naturaleza: el modelo relee el contexto, llama a herramientas, comprueba resultados e insiste. Una tarde movida en un repositorio grande puede costar varios dólares en tokens sin que parezca especialmente productiva.

Si quieres ver qué hace la herramienta en el día a día, nuestro tutorial de Claude Code cubre la instalación, el refactoring y la depuración en la práctica.

¿Es gratis Claude Code?

La respuesta directa es no. La documentación de Anthropic indica que Claude Code requiere una cuenta Pro, Max, Team, Enterprise o Console, y que el plan gratuito de Claude.ai no incluye acceso. Pro empieza en 20 $ al mes, o 17 $/mes si pagas 200 $ por adelantado para todo el año.

La alternativa es la facturación por consola, donde pagas por token sin suscripción. Claude Sonnet 5 suele costar 3 $ por millón de tokens de entrada y 15 $ por millón de salida. Claude Opus 5 se sitúa en 5 $ y 25 $, y Haiku 4.5 en 1 $ y 5 $.

Son dos rutas con lógicas de cobro completamente distintas, y elegir mal es cómo se termina pagando de más o quedándose sin cupo a mitad de tarea. Aquí tienes cómo se comparan.

El punto clave es la constancia de uso, no el volumen. Una suscripción compra tokens a un precio efectivo mucho mejor que la API hasta que topas con el límite del plan, así que quien lo usa a diario casi siempre sale ganando con Pro. La facturación medida gana cuando tus semanas no se parecen entre sí, porque en las tranquilas no pagas nada.

Entonces, ¿de dónde sale lo de "gratis"? De tres sitios, a grandes rasgos. 

• Crédito inicial que Anthropic concede a cuentas API nuevas
• El hecho de que Claude Code puede hablar con cualquier servidor que hable el formato Anthropic Messages, incluidos los gratuitos, ya sea alojados (OpenRouter) o locales (Ollama)
• Un programa de ayudas para mantenedores de open source

Ese segundo punto merece una advertencia de entrada. Apuntar Claude Code a un modelo gratuito te da la interfaz y el bucle del agente, no a Claude. La diferencia de calidad en razonamiento multi‑paso es real, y volveré sobre ello.

¿El plan gratuito incluye Claude Code?

Voy con el malentendido más común, porque hace perder muchas tardes.

El nivel gratuito no incluye Claude Code. Ni una versión limitada, ni de prueba: nada. La documentación de Anthropic es clara: el plan gratis cubre Claude en web, iOS, Android y escritorio; el agente de terminal no está incluido.

Lo que sí tienes está realmente bien. Desde el 1 de julio de 2026, el plan gratuito ejecuta Claude Sonnet 5 como modelo por defecto, junto con búsqueda web, subida de archivos, Projects y Artifacts, que antes estaban tras el muro de pago. Para pegar un stack trace y preguntar qué ha pasado, cumple de sobra.

Límites del nivel gratuito que más notan los desarrolladores

Anthropic no publica un número de mensajes, y quien te dé una cifra exacta está adivinando. La empresa describe Pro como al menos cinco veces el uso por sesión del plan Free, lo que convierte Free en una referencia, no en una cuota fija. En la práctica, los informes se concentran entre 15 y 40 mensajes por ventana móvil de 5 horas, con mensajes largos y adjuntos agotando el cupo antes.

Hay varios límites más relevantes que el recuento de mensajes:

• La ventana de cinco horas empieza a contar cuando envías tu primer mensaje.
• Sin acceso CLI a Claude Code. Este es el duro, y no hay atajo que lo cambie.
• Los límites se ajustan según la carga de los servidores, así que las horas punta son peores.
• Las conversaciones largas cuestan más por mensaje porque se relee todo el hilo en cada turno.

Conclusión: el chat gratuito sirve para dudas puntuales y revisiones de código, y se cae en cuanto quieres un ida y vuelta sostenido sobre un codebase. Precisamente para eso está Claude Code.

Opción 1: créditos gratis de la API de Anthropic

Es la vía oficial menos conocida y, en mi opinión, donde debería empezar la mayoría.

Crear una cuenta en platform.claude.com otorga un crédito inicial único. La documentación de precios de Anthropic lo describe como "una pequeña cantidad de créditos gratis" sin concretar cifra, aunque terceras fuentes lo sitúan de forma consistente en torno a 5 $.

Los créditos API autentican el CLI de Claude Code. Obtienes el agente real, ejecutando modelos Claude reales, sobre tu código real. Los créditos no se renuevan y caducan a los 14 días, así que piénsalo como una prueba, no como una bolsa.

Configurar una cuenta de API y canjear los créditos

El recorrido completo va desde registro en frío hasta agente funcionando en unos 10 minutos, y la mayor parte es esperar al instalador. Lo he dividido en cinco pasos porque el tercero tiene una trampa que obliga a reiniciar.

Paso 1: crea tu cuenta de Console

Ve a platform.claude.com y regístrate con tu correo. La consola es un producto distinto de la interfaz de chat claude.ai, así que una cuenta existente de Claude no se arrastra y puede que tengas que registrarte otra vez con el mismo correo.

Por aclarar: a algunas cuentas se les pide verificar el número de teléfono en este punto. Una vez dentro, el crédito inicial se aplica automáticamente, no se canjea en un campo promocional.

Paso 2: comprueba tu saldo de crédito

Abre la sección Billing desde la navegación de la consola. Ahí verás tu saldo inicial, junto con la opción de añadir un método de pago, que por ahora no necesitas.

Compruébalo antes de hacer nada más. Si el saldo marca cero, por muy bien que configures luego nada te dará una sesión funcional.

Paso 3: crea una clave de API

Ve a Settings > API Keys y crea una nueva clave. Dale un nombre que reconocerás dentro de tres meses, porque la mayoría acaba con varias.

El valor completo de la clave se muestra una sola vez. Cópiala en tu gestor de contraseñas en cuanto aparezca, porque cerrar el diálogo sin copiarla significa perderla y repetir el paso.

Paso 4: exporta la clave e instala Claude Code

Exporta la clave como variable de entorno en tu shell y luego instala el CLI. Anthropic recomienda el instalador nativo, que incluye su runtime y no requiere Node.js.

export ANTHROPIC_API_KEY="sk-ant-your-key-here"
curl -fsSL https://claude.ai/install.sh | bash

En Windows PowerShell, el instalador es irm https://claude.ai/install.ps1 | iex. Si prefieres npm, ten en cuenta que desde Claude Code v2.1.198, el paquete requiere Node.js 22 o posterior, un cambio respecto al mínimo de Node.js 18 que aún citan guías antiguas:

npm install -g @anthropic-ai/claude-code

Añade la línea export a tu ~/.zshrc o ~/.bashrc si quieres que la clave sobreviva a una nueva ventana de terminal. Después confirma que la instalación ha ido bien:

claude --version

Paso 5: ejecuta tu primera sesión

Cambia a una carpeta de proyecto e inicia el agente. Ejecutar claude desde tu carpeta home técnicamente funciona, pero la herramienta es casi inútil sin un codebase que leer.

cd ~/projects/my-app
claude

En el primer arranque con ANTHROPIC_API_KEY configurada, Claude Code te pedirá aprobar la clave una vez en lugar de abrir el navegador para OAuth. Apruébala y aterrizarás en la pantalla de bienvenida con tu directorio de trabajo confirmado abajo:

Para confirmar la ruta de facturación y no solo la instalación, ejecuta /status dentro de la sesión. La línea de API key con ANTHROPIC_API_KEY te dice que la sesión está tirando de créditos de Console y no de un login guardado de claude.ai.

Si algo no cuadra, claude doctor imprime diagnósticos de instalación y ajustes sin iniciar sesión, y es un primer paso más rápido que buscar errores en Google.

¿Para cuántas sesiones da el crédito gratis?

Cuentas gruesas con Sonnet 5 a sus tarifas de lanzamiento actuales. Imagina quince intercambios en un repositorio real, cada uno enviando unas 30.000 tokens de contexto y produciendo unos 1.500 tokens de salida. El primer turno paga el precio completo de entrada, y los catorce siguientes entran casi todos por la caché de prompt al 10% del precio.

Tómatelo como orden de magnitud, no como presupuesto. El ejemplo asume contexto plano e ignora la prima por escritura en caché, que es 1,25 veces el precio base de entrada para una caché de cinco minutos, así que tus sesiones reales caerán a un lado u otro.

La diferencia entre las dos últimas filas es lo importante. La caché reduce la factura en torno a tres cuartas partes, por eso las sesiones de Claude Code cuestan bastante menos de lo que sugiere un conteo ingenuo de tokens, y por eso cualquier cosa que rompa la caché (cambiar de repositorio, reiniciar sesiones constantemente, cambiar de modelo a mitad) triplica silenciosamente lo que pagas. En la documentación de precios de Anthropic tienes la tabla completa de multiplicadores si quieres modelarlo bien.

Diferencias de precio entre modelos

La elección del modelo mueve más la cifra que cualquier otra cosa que controles. Ejecutando la misma sesión de quince turnos en toda la linea:

Así que con cinco dólares haces entre cinco y veintisiete sesiones, según el modelo al que apuntes. Sonnet 5 es el valor seguro para evaluar.

Gasta ese saldo en una tarea de verdad, no en ejemplos de juguete. Refactoriza un módulo que uses de verdad o persigue un bug a través de tres archivos: es la única forma de saber si la herramienta se gana un hueco en tu semana.

Cuando el saldo llega a cero, no hay red. La consola es pago por uso, y debajo de Claude Code no hay un nivel gratuito esperando.

Opción 2: modelos gratuitos de OpenRouter

OpenRouter es una puerta de enlace API delante de varios cientos de modelos, y un puñado rotatorio no cuesta nada llamarlos. Sin tarjeta, sin cuota mensual, sin suscripción.

Esto conecta con Claude Code porque el CLI lee su endpoint de una variable de entorno. Cambias la variable, cambias a dónde van las peticiones. OpenRouter ofrece lo que llama una "Anthropic Skin", un endpoint que acepta el formato Anthropic Messages y pasa los thinking blocks y el uso de herramientas nativas tal cual, sin proxy local.

Ten claro lo que obtienes: no son modelos Claude. Mantienes la interfaz de Claude Code, el bucle del agente, la edición de archivos y los comandos de barra, mientras un Qwen o Llama hacen el razonamiento.

La propia documentación de OpenRouter avisa de que Claude Code solo está garantizado con el proveedor de Anthropic y "puede no funcionar correctamente con otros proveedores". Prefiero citarlo a fingir lo contrario.

Cómo funciona el redireccionamiento

Tres variables hacen el trabajo:

• ANTHROPIC_BASE_URL apunta a https://openrouter.ai/api en lugar del endpoint de Anthropic.

• ANTHROPIC_AUTH_TOKEN lleva tu clave de OpenRouter y se envía como cabecera Authorization: Bearer.

• ANTHROPIC_API_KEY debe estar como cadena vacía explícita; si no, Claude Code podría volver a autenticarse contra Anthropic.

Puedes definirlas en tu perfil de shell o en un archivo de ajustes de Claude Code. Algo que evitar: un archivo .env del proyecto no funciona, porque el instalador nativo no lee archivos .env estándar.

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-your-openrouter-key",
    "ANTHROPIC_API_KEY": ""
  }
}

Dónde pongas ese archivo importa más de lo que parece. Usa ~/.claude/settings.json para una configuración global, o .claude/settings.local.json para un proyecto concreto, ya que Claude Code añade este último a tu gitignore. 

No guardes credenciales en .claude/settings.json de un proyecto, porque ese archivo se comitea y lo verá cualquiera que clone el repositorio.

Configurar Claude Code con OpenRouter

1. Instala Claude Code con el instalador nativo si aún no lo has hecho.

2. Crea una cuenta gratis en openrouter.ai y genera una clave en Settings > Keys. No se requiere tarjeta para usar solo modelos gratuitos.

3. Escribe la configuración en ~/.claude/settings.json usando el bloque de arriba, o exporta las mismas tres variables en tu perfil de shell.

4. Si alguna vez iniciaste sesión en Claude Code con una cuenta de Anthropic, ejecuta /logout dentro del CLI, cierra y vuelve a abrir. Una sesión en caché invalida tus variables y se manifiesta como errores de modelo no encontrado.

5. Arranca claude y comprueba a dónde van las peticiones.

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://openrouter.ai/api

Tus peticiones también deberían aparecer en el panel de actividad de OpenRouter en unos segundos, la forma más rápida de confirmar que el desvío funciona.

Elegir un modelo gratuito en OpenRouter

Los IDs de modelos gratis terminan en :free, y el listado cambia constantemente a medida que los proveedores añaden, retiran o cambian precios. La colección de modelos gratuitos de OpenRouter muestra cuáles están disponibles sin coste. openrouter/free es el auto‑router de OpenRouter para modelos gratis. Elige lo que esté disponible y encaje con tu petición, lo que mantiene tu configuración funcionando cuando roten modelos concretos. Es el punto de partida más simple, pero la calidad varía mucho.

Los precios, el importe de créditos y el listado de modelos gratis en OpenRouter cambian mes a mes, y algunos cambiaron mientras escribía esto. Consulta la página de precios de Anthropic y el filtro de gratuitos de OpenRouter antes de basarte en cualquier cifra de aquí.

Luego están los límites de ritmo, que duelen más que la elección del modelo. Los modelos gratuitos permiten 20 peticiones por minuto en cualquier cuenta, y 50 al día si nunca has comprado créditos. Si compras 10 $ en créditos una vez, ese cupo diario sube a 1.000 y se mantiene incluso cuando el saldo vuelve a cero.

Cincuenta peticiones al día suenan manejables hasta que recuerdas que una sesión con agente gasta peticiones como un compañero hablador tu tarde. Una tarea algo seria puede consumir un tercio del cupo diario. Los intentos fallidos también cuentan, así que reintentar a ciegas empeora la situación.

Para dirigir roles de modelo concretos, Claude Code expone variables separadas por nivel:

bash
export ANTHROPIC_DEFAULT_SONNET_MODEL="cohere/north-mini-code:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="cohere/north-mini-code:free"
export CLAUDE_CODE_SUBAGENT_MODEL="cohere/north-mini-code:free"

Los refactors sencillos, ediciones de un solo archivo y tareas de explicación aguantan bien. Dicho esto, el trabajo largo de varios pasos se degrada notablemente, y el fallo típico está en el uso de herramientas más que en la calidad de código: el modelo elige mal la herramienta, interpreta mal un resultado o entra en bucle.

Si quieres una estrategia más deliberada para combinar modelos por tarea, nuestra guía de Claude Code Router cubre el enrutado multi‑modelo en detalle.

Opción 3: modelos locales con Ollama

Ollama ejecuta modelos abiertos en tu propia máquina. Sin claves API, sin límites de ritmo y sin conexión a internet una vez descargados los pesos.

En enero de 2026, Ollama añadió compatibilidad con la API Anthropic Messages en la v0.14.0, lo que hizo viable este flujo. Antes hacía falta un proxy traductor en medio. Ahora Claude Code habla directamente con localhost.

El coste no desaparece; se traslada al hardware, y en concreto al ancho de banda de memoria, no solo a la capacidad. 

• En Apple Silicon, la memoria unificada es la cifra clave: 16 GB mueve un modelo ~14B como gpt-oss:20b, pero los modelos de 30B para código que merecen la pena piden 32 GB o más si añades ventana de contexto de 32K. 

• En Windows o Linux, la cifra relevante es la VRAM de la GPU, no la RAM del sistema: un modelo que cabe en RAM pero corre en CPU es demasiado lento para trabajo con agente, donde cada tarea lanza decenas de llamadas.

Configurar Ollama con Claude Code

1. Instala Ollama. En macOS y Linux, curl -fsSL https://ollama.com/install.sh | sh, y en Windows, descarga el instalador desde ollama.com y ejecútalo.

2. Descarga un modelo de código. Aunque no compite con los Claude actuales, Qwen3-Coder es una opción decente: ollama pull qwen3-coder.

3. Confirma que el modelo está con ollama list.

4. Sube la longitud de contexto, porque es el ajuste que la gente olvida y luego culpa al modelo. Ollama sugiere al menos 32K tokens para Claude Code.

5. Apunta Claude Code al endpoint local y elige tu modelo.

bash
export OLLAMA_CONTEXT_LENGTH=32768
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434

claude --model qwen3-coder

El token de autenticación lo exige el protocolo y Ollama lo ignora, así que su valor da igual. Si prefieres dejar la configuración permanente, esas tres claves van en el bloque env de ~/.claude/settings.json.

Dos carencias conviene conocer antes de juzgar resultados:

• La caché de prompts de Anthropic no aplica, así que cada petición reprocesa el system prompt y todo el historial desde cero: aquí es lento, no caro.

• La capa de compatibilidad de Ollama ignora tool_choice, el campo que Claude Code a veces usa para forzar una herramienta específica; cuando importa, el agente puede elegir mal y quedarse en bucle.

Para una guía más a fondo, tenemos un tutorial dedicado a usar Claude Code con modelos locales de Ollama, y guías separadas para ejecutar Qwen 3 y DeepSeek R1 en local.

Realidad del hardware

Para la mayoría de desarrolladores, OpenRouter gana a Ollama salvo que tengas 32 GB o más de memoria unificada/VRAM, necesites trabajar offline o quieras que tu código no salga de la máquina. Este último motivo es de peso, y por eso no descartaría esta ruta solo por rendimiento.

Opción 4: el programa Claude for Open Source

La mayoría de guías se quedan en tres opciones y se pierden la que te da el producto real, en el nivel más alto, durante medio año.

Anthropic lanzó Claude for Open Source en febrero de 2026 y lo amplió en julio. Los mantenedores y contribuidores que cumplan los criterios reciben seis meses de Claude Max 20x, el plan de 200 $ al mes, sin coste. Incluye Claude Code, con el margen de uso del tope de consumo.

Los criterios publicados son más amplios de lo que muchos suponen:

• Mantenedores de paquetes con 500 o más repositorios dependientes, 100 o más paquetes dependientes, o 200.000 o más descargas mensuales combinadas en npm, PyPI, crates.io, RubyGems u otros registros similares.
• Committers listados en proyectos reconocidos de fundaciones o lenguajes como CPython, el equipo de Rust, el TSC de Node.js, un PMC de Apache, CNCF, Kubernetes, el kernel de Linux, Django o Rails.
• Quien haya creado 100 o más pull requests fusionados en repositorios que no posee en los últimos doce meses.
• Constructores de comunidad cuyo repositorio haya recibido 20 o más contribuidores externos únicos con PRs fusionados en el último año.
• Mantenedores de cualquier proyecto con puntuación de criticidad OpenSSF de 0,4 o superior.

La página de Anthropic invita expresamente a que los casos fronterizos apliquen e indiquen de qué depende el ecosistema en silencio. El programa está limitado a 10.000 beneficiarios y se revisa de forma continua; las solicitudes se tramitan en claude.com/contact-sales/claude-for-oss.

Un matiz: esto cubre la suscripción, no créditos de API. Tu uso de ANTHROPIC_API_KEY se factura por separado, así que es un plan personal, no algo para apuntar un pipeline de CI.

Elegir la opción gratuita adecuada para ti

Dos preguntas lo deciden. ¿Para qué quieres Claude Code y cuánto montaje estás dispuesto a hacer antes de aburrirte?

Tabla comparativa

¿Cuál elegir?

• Si nunca has usado Claude Code y quieres saber si vale 20 $ al mes, aprovecha los créditos iniciales de la API. Es la única ruta que te enseña el producto real, y una docena de sesiones bastan para formarte una opinión.
• Si quieres acceso gratuito continuo y no necesitas específicamente Claude, OpenRouter ofrece la mejor relación calidad/esfuerzo. Reserva una tarde para el primer montaje y espera chocar con el cupo diario antes de lo que te gustaría.
• Si necesitas trabajar offline, o tu empresa tiene opinión sobre adónde viaja el código fuente, Ollama es la respuesta pese a la factura de hardware. Con menos de 16 GB de memoria unificada/VRAM, yo no me molestaría.
• Si mantienes algo sobre lo que otros construyen, mira la ayuda para open source antes de nada. Seis meses en el nivel más alto y asunto zanjado.

Solución de problemas en los redireccionamientos

Las opciones 3 y 4 comparten superficie de fallo, y un puñado de problemas explica la mayoría. Como ni Anthropic ni los gateways pueden depurar tu combinación exacta, esto es lo primero que conviene revisar.

• Claude Code te sigue pidiendo iniciar sesión. El CLI no tiene credenciales propias, y un base URL accesible no cuenta como tal. Un bloque env en .claude/settings.json del proyecto solo aplica tras el asistente de primera ejecución; define ANTHROPIC_AUTH_TOKEN en un sitio que se lea antes: un export en shell o ~/.claude/settings.json.

• Un aviso de arranque nombra dos orígenes de credenciales. Están activos un gateway y un login guardado. Ejecuta /logout para limpiar el login guardado o deshaz la variable para volver al anterior.

• Errores 400 con campos no reconocidos. Claude Code envía campos a endpoints con formato Anthropic que algunos upstreams rechazan. Definir CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 suprime la mayoría de campos en pruebas y aclara el problema.

• Errores 400 mencionando thinking o adaptive. El modelo upstream no acepta razonamiento adaptativo, que Claude Code solicita para modelos recientes de Claude. Suele requerir actualizar el upstream del gateway, no un arreglo del lado cliente.

• El control remoto y la dictado por voz dejan de funcionar. Ambos dependen de una identidad de claude.ai y no están disponibles mientras haya una credencial de gateway. Desde la v2.1.196, el control remoto también se desactiva cuando ANTHROPIC_BASE_URL apunta a un host no Anthropic.

Cuando algo se comporta raro y no sabes qué capa lo causa, /status dentro de la sesión te dice qué base URL y qué origen de credenciales están en juego. Ese único comando resuelve más casos que cualquier lluvia de reexports.

Reflexión final

Cuatro rutas para usar Claude Code gratis, ninguna perfecta, y los sacrificios son la parte interesante, no la letra pequeña.

Mi recomendación es concreta. Si lo que quieres es el agente CLI de Claude Code y no una ventana de chat, empieza con los créditos de la API, porque aprenderás más en una sesión real con el producto auténtico que en una tarde configurando un sustituto. Si encaja en tu flujo, 20 $ al mes es un gasto defendible. Si no, no has perdido nada y ahora sabes por qué.

A largo plazo, OpenRouter es la opción gratuita más sostenible, y Ollama gana en el momento en que la privacidad o el modo offline pasan de deseables a imprescindibles.

Para los hábitos que separan una sesión útil de una frustrante, nuestra guía de buenas prácticas de Claude Code cubre planificación, transferencia de contexto y desarrollo guiado por tests en proyectos reales. Y si partes de cero, Claude Code 101 enseña los fundamentos con lecciones interactivas y estructuradas que te llevan desde la primera instalación hasta un flujo de trabajo operativo.