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 | bashAbra 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>
claudeConfiguración manual (Windows PowerShell)
$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claudeANTHROPIC_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.
| Modelo | Gratis en | Contexto | Límites gratuitos (mejor oferta) | Herramientas | Visión |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 solicitudes/min 1 req/min per model | Sí | No |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 solicitudes/min 40 RPM | Sí | Sí |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sí | Sí |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Sí | No |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sí | Sí |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sí | Sí |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 solicitudes/min 50 solicitudes/día 50 req/day account-wide (1,000 after a $10 purchase) | Sí | Sí |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 solicitudes/min 50 solicitudes/día Shared rate limit | Sí | No |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 solicitudes/min 250 solicitudes/día 70,000 tokens/min ~6M | Sí | Sí |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Sí | 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
haikua un modelo pequeño y rápido. Claude Code lo usa para tareas cortas en segundo plano. - Mantenga el contexto pequeño. Use
/clearentre tareas para enviar menos tokens.
Solución de problemas
| Problema | Causa | Solución |
|---|---|---|
| Claude Code le pide que inicie sesión | Las variables de entorno no están definidas en esta terminal | Defina ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN, y luego inicie claude de nuevo |
| "Conflicting credential" o no se inicia | ANTHROPIC_API_KEY está definida | Elimínela con unset ANTHROPIC_API_KEY |
| Error 429 en todas las solicitudes | Todas sus claves de proveedor alcanzaron su límite | Añada claves de más proveedores en la página Keys |
| Las llamadas a herramientas fallan o el agente se detiene | El modelo no admite bien las llamadas a herramientas | Asigne la familia a un modelo de la tabla de arriba |
| Las solicitudes son lentas | Prompts grandes en un modelo gratuito lento | Fije un modelo rápido, por ejemplo un modelo de Groq o de Cerebras |
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
- ¿Existe una API gratuita de Claude?
- Mejores API gratuitas de modelos para programar
- Use Codex CLI con modelos gratuitos
- Cline, Roo Code y Kilo Code con una API gratuita
- Límites de uso de API LLM gratuitas
Fuentes
- FreeLLMAPI docs: Anthropic and Claude clients (revisado 20 November 2026)
- FreeLLMAPI CLI generators (revisado 20 November 2026)
- Claude Code documentation: LLM gateway configuration (revisado 20 November 2026)