Claude Code GRATIS e ILIMITADO en Windows - instalación, pruebas con prompt y desinstalación | Tus agentes IA 24x7
Obtener enlace
Facebook
X
Pinterest
Correo electrónico
Otras aplicaciones
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.
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-*.
Abre Free Claude Code desde el menú Inicio. Aparece un icono en la bandeja del sistema, y desde ahí entras en Admin.
Ve a Providers, NVIDIA NIM, Add key, pega la clave, pulsa Save y después Test.
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.
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.
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:
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.
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
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
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.
Wireguard en Mikrotik Breve Explicación de Wireguard ¿Qué es WireGuard VPN? WireGuard es un nuevo protocolo de VPN. No se trata de un software, sino de un conjunto de instrucciones que permite crear VPNs de forma muy sencilla. Ha sido desarrollada como una alternativa a IPsec, OpenVPN y similares VPNs, pero más rápida y sencilla de usar. En esencia, WireGuard está basado en ideas del protocolo IPsec. WireGuard es una VPN extremadamente simple, pero rápida y moderna que utiliza criptografía de última generación. Su objetivo es ser más rápido, más simple, y más versátil que IPSec, evitando al mismo tiempo el enorme dolor de cabeza (sobre todo en redes con NAT). Pretende ser considerablemente más eficaz que OpenVPN. WireGuard está diseñado como una VPN de propósito general para ejecutarse en interfaces embebidas, apto para muchas circunstancias diferentes. Se ejecuta sobre el protocolo UDP, por lo tanto es considerado un túnel de capa 3. ¿Cómo funciona Wireguard VPN? WireGuard es un proto...
Instalación y puesta en marcha de Synology DSM 7.2.2 en PC Vídeo ACTUALIZADO, NUEVA VERSIÓN DEL ARC LOADER: https://youtu.be/LgghogL-UCA https://genbyte.blogspot.com/2025/08/como-convertir-pc-en-synlogy-con-6-tb.html ----- Proceso de instalación y puesta en marcha de sistema operativo DSM Synology versión 7.2.2 en un PC, concretamente un HP 800 G1 EliteDesk. El PC tendrá 3 discos SSD, uno de 120 GB para el S.O. DSM, y otros dos de 240GB cada en RAID 1 para los Datos. Los 3 dicos duros conectados al PC mediante cables SATA. Lo primero que necesitamos es descargar la imagen bootloader ARC, desde el siguiente repositorio de Gothub, también necesitamos Rufus, en este momento, es la versión 4.6. Imagen ARC: https://github.com/AuxXxilium/arc Imagen usado en el vídeo 1.1.29: https://github.com/AuxXxilium/arc/releases/tag/1.1.29 Rufus: https://rufus.ie/es/ Después de descargar la imagen ARC.img, conectamos nuestro primer disco SSD de 120GB por cable o conector SATA-USB y...
Cómo solucionar Error "No se encontró la imagen de Windows RE" en Windows 10 al ejecutar reagentc /enable En algunos casos, puede aparecer el error «No se encontró la imagen de Windows RE» durante el proceso de reagentc /enable . Afortunadamente, es posible solucionar el error montando la imagen de Windows desde la ISO, copiando los archivos necesarios y volviendo a habilitar el agente de recuperación: Descargue un archivo ISO de Windows 10 y móntelo en una unidad. Acuérdate de la letra de esta unidad. Abra el símbolo del sistema como administrador y ejecute el comando: reagentc /disable Cree un nuevo directorio para montar la imagen de Windows. Utilice este comando: md c:\WinMount Ejecute el siguiente comando para montar la imagen: La unidad E: corresponde a la unidad DVD de la ISO Windows 10 montada en el equipo. dism /mount-wim /wimfile:E:\Sources\install.wim /index:1 /mountdir:C:\WinMount /readonly Copie los archivos de recuperación de la imagen montada...
Comentarios
Publicar un comentario