Claude Code GRATIS e ILIMITADO en Windows - instalación, pruebas con prompt y desinstalación | Tus agentes IA 24x7

Free Claude Code | Claude Code | NVIDIA NIM | Windows | PowerShell | AGPL-3.0

Claude Code Gratis en Windows: instalación, pruebas y desinstalación

Free Claude Code es un proxy local que permite usar la interfaz de Claude Code con modelos de otros proveedores. Esta guía lo instala en Windows, lo conecta a NVIDIA Build, lo prueba con dos prompts (uno básico y otro con Docker) y explica cómo dejar el equipo exactamente como estaba.

Vídeo tutorial en YouTube

Mira el vídeo completo sobre cómo instalar Free Claude Code en el canal GENBYTE:

¿Qué es Free Claude Code?

Free Claude Code (FCC) es un proxy local que traduce las peticiones de Claude Code al formato de otros proveedores: NVIDIA NIM, OpenRouter, Ollama y muchos más. Claude Code cree que habla con Anthropic, pero sus peticiones pasan por tu máquina y acaban en el modelo que elijas.

Idea clave: el flujo es Claude Code, luego FCC en localhost y, por último, el modelo de NVIDIA. FCC no instala ningún modelo: solo hace de traductor.
No es Claude gratis. Es la interfaz de Claude Code con otros modelos. Es un proyecto independiente, sin afiliación con Anthropic, y la calidad en tareas largas con herramientas depende del modelo que uses.

Características principales

Muchos proveedores

NVIDIA NIM, OpenRouter, Groq, DeepSeek, Ollama y LM Studio, entre otros.

Panel Admin web

Claves, modelos y razonamiento desde el navegador, sin editar ficheros.

Modelo por nivel

Cada nivel de Claude Code (Fable, Opus, Sonnet, Haiku) se asigna a un modelo distinto.

Fallbacks

Si un modelo falla tras los reintentos, salta al siguiente de tu lista.

App de escritorio

Icono en la bandeja de Windows con acceso al panel Admin.

Varios agentes

Además de Claude Code, funciona con Codex, Pi, OpenCode, Aider y otros.

Requisitos del sistema

  • Windows 11, a ser posible en una máquina virtual con punto de control antes de instalar
  • PowerShell y conexión a internet
  • Clave de NVIDIA Build, que empieza por nvapi-
  • Git para Windows, si Claude Code lo pide: winget install Git.Git
  • Docker Desktop, solo para la prueba con el prompt pro
Antes de empezar: comprueba que no hay una clave de Anthropic activa, o anulará el proxy y podría generar cargos. Las dos líneas deben salir vacías.
$env:ANTHROPIC_API_KEY [Environment]::GetEnvironmentVariable("ANTHROPIC_API_KEY","User")

Instalación paso a paso

Paso 1: descarga el instalador y revísalo

Lee el script antes de ejecutarlo. Descarga el repositorio, instala uv y Python 3.14, y lanza los instaladores oficiales de los agentes que elijas:

cd $HOME irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1" -OutFile install.ps1 notepad install.ps1

Paso 2: ejecútalo

& ([scriptblock]::Create((Get-Content .\install.ps1 -Raw)))

Cuando pregunte qué agentes instalar, elige Claude Code. Después cierra PowerShell y abre una ventana nueva para que el PATH incluya los comandos fcc-*.

Paso 3: crea la clave de NVIDIA

Entra en build.nvidia.com/settings/api-keys, crea una clave nueva y cópiala a un sitio temporal.

Paso 4: configura NVIDIA NIM en el panel Admin

  1. Abre Free Claude Code desde el menú Inicio. Aparece un icono en la bandeja del sistema, y desde ahí entras en Admin.
  2. Ve a Providers, NVIDIA NIM, Add key, pega la clave, pulsa Save y después Test.
  3. En Model Config deja nvidia_nim/nvidia/nemotron-3-ultra-550b-a55b y pulsa Apply. Si no aparece en la lista, escríbelo a mano con ese formato. Elige un modelo con soporte de tool calls.
  4. Activa Proxy Authentication y vuelve a pulsar Apply.
Comprueba que solo escucha en local: netstat -ano | findstr LISTENING debe mostrar 127.0.0.1 en el puerto de Admin, no 0.0.0.0.

Paso 5: primera prueba

# git init crea un repositorio solo en tu equipo, no sube nada a GitHub mkdir $HOME\lab-fcc cd $HOME\lab-fcc git init fcc-claude

Dentro de Claude Code escribe /model para ver los modelos de FCC y /status para ver la información de la sesión.

Prueba 1: prompt básico (web y servidor en PowerShell)

Una web de un solo fichero y un servidor mínimo en PowerShell. Solo necesita Windows. Es la prueba más fácil de superar para un modelo.

mkdir $HOME\lab-homeboard-demo cd $HOME\lab-homeboard-demo fcc-claude
Crea una web llamada HomeBoard en la carpeta actual: un panel simple para ver los servicios de mi homelab. 1. Un único fichero index.html con el CSS y el JavaScript dentro. HTML, CSS y JS puros, sin librerías ni recursos externos. 2. Diseño oscuro y moderno, con acento azul (#0ea5e9), que se vea bien en móvil y en escritorio. 3. Muestra tarjetas de servicios con nombre, URL, puerto y categoría. Cada tarjeta tiene un botón "Abrir" que abre la URL en una pestaña nueva. 4. Un buscador que filtre las tarjetas mientras escribo. 5. Un formulario para añadir un servicio nuevo y un botón para eliminar cada tarjeta. Guarda todo en localStorage. 6. Si no hay datos guardados, carga estos servicios de ejemplo: Open WebUI (7000), SearXNG (8082), Vikunja (3456), Uptime Kuma (3001) y n8n (5678), todos en http://192.168.1.X. 7. Textos en castellano de España. 8. Crea servir.ps1, un servidor con System.Net.HttpListener de PowerShell que sirva esta carpeta en http://localhost:8120/ con el Content-Type correcto, e iniciar.bat para lanzarlo con doble clic. Revisa el código antes de terminar, arranca el servidor y comprueba con Invoke-WebRequest que http://localhost:8120/ devuelve 200. Déjame un resumen de dos líneas con la URL.

Abre http://localhost:8120. Si el servidor no sigue en marcha, haz doble clic en iniciar.bat. El index.html también funciona con doble clic, porque lleva todo dentro.

Prueba 2: prompt pro (servicio con Docker)

Un servicio con API, SQLite y contenedor. El modelo tiene que escribir, construir, desplegar, probar y corregir. Abre Docker Desktop, espera a que diga "Engine running" y comprueba que todo responde:

docker --version docker compose version docker run --rm hello-world mkdir $HOME\lab-homeboard-docker cd $HOME\lab-homeboard-docker fcc-claude
Crea un servicio llamado HomeBoard en la carpeta actual: un panel para registrar los servicios de mi homelab y comprobar si responden. Tengo Docker Desktop en Windows 11 y quiero que se despliegue con docker compose. 1. Backend en Python 3.12 usando SOLO la librería estándar (http.server, sqlite3, json, urllib). Sin pip ni dependencias externas. Guarda los datos en SQLite dentro de /data. 2. API REST en JSON: GET /health, GET /api/servicios, POST /api/servicios (nombre, url, categoría), DELETE /api/servicios/{id} y GET /api/comprobar, que hace una petición HTTP a cada servicio desde el servidor con timeout de 3 segundos y devuelve si está en línea o caído, con el tiempo de respuesta. 3. La misma aplicación sirve una web en la raíz (index.html con CSS y JS dentro): diseño oscuro con acento azul (#0ea5e9), tarjetas de servicios, formulario para añadir, botón para eliminar y botón "Comprobar estado" que usa /api/comprobar y muestra En línea o Caído con su tiempo de respuesta. Textos en castellano de España. 4. Si la base de datos está vacía, crea al arrancar estos servicios de ejemplo: "HomeBoard (este servicio)" con http://localhost:8120/health, y "Servicio inexistente" con http://localhost:9/ para que se vea un caso caído. 5. Dockerfile basado en python:3.12-alpine, con usuario no root. 6. docker-compose.yml con este estilo: name del proyecto, build con context y dockerfile, image genbyte/homeboard:1.0, container_name genbyte-homeboard, restart unless-stopped, puerto 8120:8000, un volumen con nombre (no una carpeta local) montado en /data, healthcheck contra /health, logging json-file con max-size 10m y max-file 3. Toda la configuración escrita directamente en el compose, sin ficheros .env. Cuando termines, compruébalo tú mismo, sin que te lo pida: - Ejecuta docker compose up -d --build y espera a que el contenedor figure como healthy. - Comprueba con Invoke-RestMethod que GET http://localhost:8120/health y /api/servicios responden bien y que /api/comprobar marca el primer servicio En línea y el segundo Caído. - Crea un servicio con POST, ejecuta docker compose down y docker compose up -d, y verifica que el servicio creado sigue ahí (persistencia). - Si algo falla, lee los logs con docker compose logs, corrige y repite. Déjalo en marcha y termina con un resumen de cuatro líneas: ficheros creados, URL, y cómo detenerlo y borrarlo.

Abre http://localhost:8120. Para borrar la demo, incluida su base de datos:

docker compose down -v docker image rm genbyte/homeboard:1.0
Es un reto duro: build, healthcheck, logs y pruebas suman muchas peticiones y puedes rozar el límite de NVIDIA. Un modelo pequeño puede fallar en el healthcheck o en la persistencia. Es buen material, pero ten un plan B.

Límites, fallbacks y Ollama

NVIDIA permite unas 40 peticiones por minuto en la mayoría de modelos. Las peticiones de mantenimiento de Claude Code también cuentan, y los subagentes en paralelo agotan el cupo en segundos. En Model Config, Fallback Models puedes añadir un respaldo. Si el límite es por cuenta y no por modelo, otro modelo de NIM no te salvará: prueba antes con un proveedor distinto.

Ollama como respaldo local

winget install Ollama.Ollama ollama pull llama3.1 setx OLLAMA_CONTEXT_LENGTH 32768

Reinicia Ollama, pulsa Refresh models en Providers, Ollama, y elige ollama/llama3.1. Sube el contexto: el prompt de sistema de Claude Code es grande y con el valor por defecto el modelo se pierde.

Gestión y mantenimiento

Actualizar y diagnosticar

fcc-update fcc-doctor

Cierra antes la app y los comandos fcc-* al actualizar. fcc-doctor es lo que piden en los reportes de errores.

Error "The provider is unavailable"

Guarda la clave y pulsa Apply, sin espacios ni comillas. Si persiste, prueba la clave fuera de FCC para saber si falla la clave o la red:

$key = Read-Host "Pega tu clave nvapi-" Invoke-RestMethod -Uri "https://integrate.api.nvidia.com/v1/chat/completions" ` -Method Post -Headers @{ Authorization = "Bearer $key" } ` -ContentType "application/json" ` -Body '{"model":"meta/llama-3.1-8b-instruct","messages":[{"role":"user","content":"hola"}],"max_tokens":20}'
  • Respuesta correcta: la clave vale y el fallo está en FCC
  • 401 o 403: clave inválida, crea una nueva
  • 404: ese modelo no existe en tu cuenta
  • 429: límite alcanzado, espera un minuto
  • Timeout: red, VPN o firewall. Prueba Test-NetConnection integrate.api.nvidia.com -Port 443

El desinstalador dice que FCC sigue en ejecución

Cierra la app desde la bandeja (clic derecho, Salir) o ejecuta Stop-Process -Name "fcc-desktop" -Force y repite el desinstalador.

Bloque rojo "NativeCommandError" al desinstalar

Es cosmético: PowerShell muestra como error el texto que uv escribe por stderr. Lo importante es la línea final "Free Claude Code has been removed and verified".

Desinstalación completa

La forma más limpia es restaurar el punto de control de la VM. Si no, sigue estos pasos en orden.

Paso 1: cierra todo y quita FCC

Stop-Process -Name "fcc-desktop" -Force -ErrorAction SilentlyContinue & ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/uninstall.ps1")))

Elimina FCC, sus accesos directos y ~/.fcc, pero deja instalados uv, Python y los agentes.

Paso 2: mira qué agentes quedaron

Get-Command claude, codex, pi, opencode, cline, aider, hermes, grok -ErrorAction SilentlyContinue | Select-Object Name, Source

Paso 3: Claude Code

Remove-Item "$env:USERPROFILE\.local\bin\claude.exe" -Force Remove-Item "$env:USERPROFILE\.local\share\claude" -Recurse -Force -ErrorAction SilentlyContinue # Opcional: borra ajustes y sesiones (solo si no lo usabas antes del laboratorio) Remove-Item "$env:USERPROFILE\.claude","$env:USERPROFILE\.claude.json" -Recurse -Force -ErrorAction SilentlyContinue

Paso 4: Codex (si lo instalaste)

winget list codex Remove-Item "$env:LOCALAPPDATA\Programs\OpenAI\Codex" -Recurse -Force Remove-Item "$env:USERPROFILE\.codex" -Recurse -Force -ErrorAction SilentlyContinue

Usa winget uninstall si aparece en la lista. Si no, la segunda línea lo borra a mano y la tercera elimina su configuración.

Paso 5: uv y Python

uv cache clean Remove-Item -Recurse -Force "$(uv python dir)", "$(uv tool dir)" Remove-Item "$env:USERPROFILE\.local\bin\uv.exe","$env:USERPROFILE\.local\bin\uvx.exe","$env:USERPROFILE\.local\bin\uvw.exe" -Force

Hazlo el último de los agentes, porque uv gestiona algunos de ellos.

Paso 6: demo con Docker (si hiciste el prompt pro)

cd $HOME\lab-homeboard-docker docker compose down -v docker image rm genbyte/homeboard:1.0

Docker Desktop puedes dejarlo instalado. Si lo instalaste solo para esto: winget uninstall Docker.DockerDesktop.

Paso 7: restos, variables y Git

Remove-Item "$HOME\lab-fcc","$HOME\lab-homeboard-demo","$HOME\lab-homeboard-docker","$HOME\install.ps1" -Recurse -Force -ErrorAction SilentlyContinue [Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL","User") [Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","User") # Solo si instalaste Git para este laboratorio winget uninstall Git.Git

Las dos variables deben salir vacías.

Paso 8: verificación final

En una PowerShell nueva, los cuatro comandos deben dar "no se reconoce":

fcc-server --version claude --version codex --version uv --version
Revoca la clave: elimínala en build.nvidia.com/settings/api-keys. La desinstalación no la borra.

Stack técnico

  • Lenguaje: Python 3.14, gestionado con uv
  • Rol: proxy local entre el agente y el proveedor del modelo
  • Interfaz: panel Admin web y app de bandeja para Windows
  • Proveedor de esta guía: NVIDIA NIM, en integrate.api.nvidia.com
  • Licencia: AGPL-3.0
Antes de usarlo en serio: los modelos gratuitos o abiertos rinden peor que Claude en tareas largas con herramientas, tu código va a terceros (usa repos de pruebas y revisa las condiciones de NVIDIA) y los límites de las capas gratuitas cambian. Revisa el README, porque el proyecto se actualiza cada pocos días.

Comentarios

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Solución al Error "No se encontró la imagen de Windows RE" en Windows 10 al ejecutar reagentc /enable