Qué necesitas
Free Claude Code (FCC) es un proyecto independiente y de código abierto que conecta Claude Code, y otros 10 agentes de programación, a modelos gratuitos de decenas de proveedores. Según su propio repositorio, suma más de 1.300 millones de tokens gratis al mes.
Lo mejor: si un modelo se cae o se te acaba el cupo, salta solo al siguiente y tu tarea sigue. Se acabó el "has llegado a tu límite".
Antes de nada, para que no haya sorpresas: con FCC usas la interfaz de Claude Code, pero las respuestas las dan otros modelos (NVIDIA, Gemini, DeepSeek, Groq, modelos locales…), no los modelos de Claude de Anthropic. Es un proyecto de la comunidad, no está afiliado ni respaldado por Anthropic.
- Un ordenador con Windows, Mac o Linux.
- Saber abrir la terminal (en Windows, PowerShell).
- Al menos un agente instalado: por ejemplo, Claude Code. El instalador te deja elegirlo.
- Una API key gratuita de al menos un proveedor. Te explico cómo en el paso 3.
Seguridad: el instalador es un script que se descarga de internet y se ejecuta en tu ordenador. Si quieres, ábrelo antes y léelo (el enlace está en el repositorio). Es una buena costumbre con cualquier comando de este tipo.
Paso 1 · Instálalo con un comando
Abre la terminal y pega el comando de tu sistema.
Mac y Linux:
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh
Windows (PowerShell):
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1")))
Durante la instalación te preguntará qué agentes quieres usar. Elige al menos uno (por ejemplo, Claude Code). Lo demás puedes dejarlo por defecto.
Paso 2 · Abre Free Claude Code
- Windows: abre Free Claude Code desde el escritorio o el menú Inicio.
- Mac: ábrelo desde el escritorio o la carpeta Aplicaciones.
- Linux: escribe
fcc-serveren la terminal y deja esa ventana abierta mientras lo uses.
Al arrancar se abre el panel de administración (Admin UI) en el navegador. Desde ahí se configura todo.
Paso 3 · Conecta tus proveedores de tokens gratis
Aquí decides de dónde salen los tokens. Según el proyecto, solo incluye proveedores que lo permiten en sus condiciones, y retira los que dejan de permitirlo.
- En el panel, ve a la lista de proveedores.
- Elige uno y abre su enlace para crear tu cuenta gratuita y sacar tu API key.
- Pega la key en el campo que indica la tabla del proveedor. Por ejemplo, para NVIDIA:
NVIDIA_NIM_API_KEY. - Busca y selecciona un modelo (
MODEL). - Pulsa Apply.
Para empezar, te recomiendo NVIDIA: es el proveedor que FCC trae configurado por defecto, con el modelo nvidia_nim/nvidia/nemotron-3-super-120b-a12b.
Otros que puedes añadir, cada uno con su campo:
| Proveedor | Campo donde va la key |
|---|---|
| NVIDIA | NVIDIA_NIM_API_KEY |
| OpenRouter | OPENROUTER_API_KEY |
| Groq | GROQ_API_KEY |
| Google Gemini | GEMINI_API_KEY |
| DeepSeek | DEEPSEEK_API_KEY |
| Ollama (modelos en tu ordenador) | OLLAMA_BASE_URL (por defecto http://localhost:11434) |
Si tienes ChatGPT o GitHub Copilot, también puedes conectarlos desde Providers → OAuth providers.
Paso 4 · El truco bueno: que salte solo al siguiente modelo
Esto es lo que hace que no te vuelvas a quedar tirado.
- En el panel, ve a Model Config.
- En Fallback Models, añade varios modelos en orden: el primero es el que prefieres; los siguientes, los de reserva.
- Guarda.
Si un modelo falla o se queda sin cupo, FCC reintenta y, si sigue fallando, pasa al siguiente de la lista sin que tengas que repetir nada. Funciona para todos los agentes que tengas conectados.
Ojo: una petición que falla puede llegar a gastar cupo de más de un proveedor antes de salir bien. Con cupos gratuitos no es grave, pero tenlo en cuenta.
Paso 5 · Úsalo con Claude Code
- En la terminal, en vez de
claude, escribe:
fcc-claude
- Dentro de Claude Code, escribe
/modely elige uno de los modelos de FCC. - Trabaja como siempre.
Con otros agentes
Cada agente tiene su comando:
| Agente | Comando |
|---|---|
| Claude Code | fcc-claude |
| Codex | fcc-codex |
| Pi | fcc-pi |
| OpenCode | fcc-opencode |
| Cline | fcc-cline |
| Hermes | fcc-hermes |
| DeepSeek Harness | fcc-dsh |
| Grok Build | fcc-grok |
| Muse Code | fcc-muse |
| Aider | fcc-aider |
Para VS Code y otras apps, ve al panel → Integrations.
Actualizar y desinstalar
Actualizar: cierra todo lo de FCC que tengas abierto y ejecuta:
fcc-update
Desinstalar (borra FCC y su configuración, pero no toca tus agentes):
Mac y Linux:
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/uninstall.sh" | sh
Windows (PowerShell):
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/uninstall.ps1")))
Antes de usarlo en serio
- Los cupos gratuitos los pone cada proveedor y pueden cambiar. El "1.300 millones" es la suma que indica el proyecto, no una garantía.
- Piensa qué código mandas y a quién. Cada petición va al proveedor del modelo que elijas. Para proyectos de clientes o datos sensibles, revisa la política de privacidad de ese proveedor o usa un modelo local (Ollama).
- No compartas tus API keys ni las pegues en chats o repositorios públicos.
- No es Claude. Para tareas delicadas, compara el resultado con el de tu Claude Code normal.
Si algo no funciona
| Problema | Solución |
|---|---|
La terminal no reconoce fcc-claude | Cierra la terminal y ábrela de nuevo después de instalar. |
| El panel no se abre en Linux | Comprueba que fcc-server sigue abierto en su terminal. |
| Claude Code no responde o da error | Revisa que pegaste bien la API key y pulsaste Apply, y que elegiste un modelo de FCC con /model. |
| Se te acaba el cupo de un proveedor | Añade más modelos en Fallback Models (paso 4). |
| Quieres volver a tu Claude Code normal | Ábrelo con el comando claude de siempre; FCC se usa a través de fcc-claude. |