Inicio / Guías / Cómo usar Claude Code gratis

Cómo usar Claude Code gratis

Claude Code es un agente de programación de Anthropic. Necesita una API de Mensajes de Anthropic. Esta guía muestra cómo conectar Claude Code con modelos gratuitos a través de FreeLLMAPI. Usted define dos variables de entorno. No necesita una clave de Anthropic.

El código, los nombres de los modelos y las etiquetas del catálogo en vivo se muestran en inglés.

Qué obtiene y qué no obtiene

Claude Code envía cada solicitud a una API con el formato de Anthropic. FreeLLMAPI habla ese formato en /v1/messages. Traduce cada solicitud y la envía a un modelo gratuito, por ejemplo Gemini, GPT-OSS, Qwen o GLM.

  • Obtiene: la interfaz de Claude Code, sus herramientas, la edición de archivos y el bucle del agente, con modelos gratuitos.
  • No obtiene: los modelos Claude de Anthropic. Ningún proveedor ofrece los modelos Claude gratis a través de una API. Lea ¿Existe una API de Claude gratuita? para ver los detalles.
  • Costo: $0 por inferencia. Los niveles gratuitos tienen límites de uso. FreeLLMAPI pasa al siguiente proveedor cuando un límite detiene una solicitud.

Paso 1: Instale FreeLLMAPI

FreeLLMAPI es de código abierto. Se ejecuta en su equipo con Docker. Sus claves de proveedor permanecen en su equipo.

macOS o Linux

curl -fsSL https://freellmapi.co/install.sh | bash

Abra el panel en http://localhost:3001. Añada al menos dos claves de proveedores gratuitos en la página Keys. Google AI Studio y Groq ofrecen una clave gratuita en aproximadamente un minuto. Copie su clave unificada de la misma página.

Paso 2: Conecte Claude Code

El método más rápido es el comando de configuración. Lee su catálogo en vivo, crea una copia de seguridad de ~/.claude/settings.json y añade los ajustes de la puerta de enlace.

Un comando

npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>

Para configurarlo manualmente, defina dos variables de entorno e inicie Claude Code:

Configuración manual (macOS o Linux)

export ANTHROPIC_BASE_URL=http://localhost:3001
export ANTHROPIC_AUTH_TOKEN=<unified-key>
claude

Configuración manual (Windows PowerShell)

$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claude
Importante: use ANTHROPIC_AUTH_TOKEN. No use ANTHROPIC_API_KEY. Si ANTHROPIC_API_KEY está definida, Claude Code detecta una credencial en conflicto y no se inicia.

Para confirmar que las solicitudes llegan a la puerta de enlace, ejecute npx freellmapi doctor. Cada respuesta también tiene un encabezado X-Routed-Via. Este encabezado muestra el proveedor y el modelo que respondieron.

Paso 3: Elija modelos para el trabajo con agentes

Claude Code envía prompts largos. Una solicitud típica tiene un prompt de sistema grande, definiciones de herramientas y contenido de archivos. Use modelos con llamadas a herramientas y una ventana de contexto grande. Los niveles gratuitos pequeños con pocos tokens por minuto fallan con estas solicitudes.

En la pestaña Keys, Anthropic, asigne cada familia de Claude (opus, sonnet, haiku) a auto o a un modelo. Con auto, el enrutador elige un modelo gratuito para cada solicitud. La tabla muestra los modelos gratuitos con llamadas a herramientas y al menos 128K de contexto, según el catálogo de hoy.

Modelos gratuitos para Claude Code: llamadas a herramientas y más de 128K de contexto
ModeloGratis enContextoLímites gratuitos (mejor oferta)HerramientasVisión
GLM 5.3UnoRouter1M1 solicitudes/min
1 req/min per model
SíNo
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 solicitudes/min
40 RPM
SíSí
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSíSí
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSíNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSíSí
Gemini 3.7 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSíSí
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 solicitudes/min
50 solicitudes/día
50 req/day account-wide (1,000 after a $10 purchase)
SíSí
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 solicitudes/min
50 solicitudes/día
Shared rate limit
SíNo
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 solicitudes/min
250 solicitudes/día
70,000 tokens/min
~6M
SíSí
Gemini 3.6 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/daySíSí

Se muestran 12 de 109 modelos gratuitos que coinciden. Ver todos los modelos.

Datos en vivo del catálogo de FreeLLMAPI (versión 2026.11.19, revisado 2026-11-19). Los límites gratuitos cambian con frecuencia. El catálogo se revisa todos los días.

Límites de uso y cómo ayuda la conmutación por error

Una tarea de Claude Code puede enviar de 20 a 100 solicitudes. Un solo nivel gratuito lo detiene rápido. Por ejemplo, una clave gratuita de Gemini Flash permite pocas solicitudes al día. FreeLLMAPI lleva la cuenta de la cuota de cada clave. Cuando un proveedor envía un error 429, el enrutador prueba el siguiente proveedor del grupo. Su sesión de Claude Code continúa.

  • Añada claves de cuatro o más proveedores. Más claves dan más solicitudes al día.
  • Asigne haiku a un modelo pequeño y rápido. Claude Code lo usa para tareas cortas en segundo plano.
  • Mantenga el contexto pequeño. Use /clear entre tareas para enviar menos tokens.

Solución de problemas

ProblemaCausaSolución
Claude Code le pide que inicie sesiónLas variables de entorno no están definidas en esta terminalDefina ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN, y luego inicie claude de nuevo
"Conflicting credential" o no se iniciaANTHROPIC_API_KEY está definidaElimínela con unset ANTHROPIC_API_KEY
Error 429 en todas las solicitudesTodas sus claves de proveedor alcanzaron su límiteAñada claves de más proveedores en la página Keys
Las llamadas a herramientas fallan o el agente se detieneEl modelo no admite bien las llamadas a herramientasAsigne la familia a un modelo de la tabla de arriba
Las solicitudes son lentasPrompts grandes en un modelo gratuito lentoFije un modelo rápido, por ejemplo un modelo de Groq o de Cerebras
Use cada uno de estos modelos con una sola clave. FreeLLMAPI es un enrutador de código abierto y autoalojado. Reúne todos estos niveles gratuitos detrás de un único endpoint compatible con OpenAI y cambia de proveedor cuando uno alcanza su límite. Explore el catálogo o ir en vivo.

Preguntas frecuentes

¿Claude Code es gratis?

El programa Claude Code es gratis de instalar. Necesita una API de modelos para funcionar. Con FreeLLMAPI, usa niveles gratuitos de proveedores, por lo que la inferencia cuesta $0.

¿Puedo obtener los modelos reales de Claude gratis?

No. Anthropic no ofrece una API de Claude gratuita. Claude Code funciona con otros modelos gratuitos, por ejemplo Gemini, GPT-OSS, Qwen o GLM, a través del endpoint con formato de Anthropic.

¿Por qué usar ANTHROPIC_AUTH_TOKEN y no ANTHROPIC_API_KEY?

Claude Code envía ANTHROPIC_AUTH_TOKEN como token Bearer a su puerta de enlace. Si ANTHROPIC_API_KEY está definida, Claude Code la trata como una credencial de primera parte y se niega a iniciarse.

¿Qué modelo gratuito es el mejor para Claude Code?

Use un modelo con llamadas a herramientas y una ventana de contexto de 128K tokens o más. La tabla de esta página muestra los modelos gratuitos más potentes que cumplen ambas reglas hoy.

¿Funciona en Windows?

Sí. Defina las dos variables en PowerShell con $env:ANTHROPIC_BASE_URL y $env:ANTHROPIC_AUTH_TOKEN, y luego inicie claude.

Guías relacionadas

Fuentes

Todas las guías · Ver todos los modelos gratuitos