Claude Code en Windows: guía completa y los pasos que atascan

En Mac, instalar Claude Code es pegar un comando y esperar. En Windows también, salvo que casi nadie llega al final a la primera.

No porque sea difícil. Porque hay tres pasos previos que en la documentación aparecen como una nota al pie y que, si no los haces, te dejan mirando un mensaje de error sin ninguna pista de qué hacer.

Te los cuento por orden, con el error exacto que te va a salir en cada uno.

¿Cómo se instala Claude Code en Windows?

El resumen en cuatro líneas, para que sepas dónde vas antes de empezar:

Instalas Git for Windows. Instalas Node en su versión estable. Abres PowerShell. Ejecutas el comando de instalación de Claude Code que hay en la documentación oficial. Y arrancas con claude.

Si eso te ha funcionado a la primera, cierra la pestaña y a disfrutar. Si no, sigue leyendo, porque a partir de aquí va todo lo que se rompe.

Paso 1: Git for Windows (el que más gente se salta)

Claude Code necesita por debajo un entorno tipo Unix para ciertas cosas. En Mac y Linux eso viene de fábrica. En Windows no, y ahí entra Git for Windows, que además de Git te instala una terminal llamada Git Bash.

Lo descargas de la web oficial de Git y lo instalas dándole a siguiente en todo. Hay una pantalla larga con opciones que dan miedo: déjalas como vienen. Los valores por defecto son correctos.

El error que ves si te lo saltas es una queja sobre bash o sobre un comando que no se encuentra. Y no dice en ningún sitio "instala Git", así que puedes estar veinte minutos buscando en foros.

Paso 2: Node en la versión que toca

Claude Code se instala a través del gestor de paquetes de Node. Así que necesitas Node instalado, y necesitas una versión moderna.

Descarga la versión LTS desde la web oficial de Node. LTS significa soporte a largo plazo, que es la manera elegante de decir "la estable". No cojas la que pone Current aunque tenga el número más alto: esa es la experimental.

Durante la instalación te sale una casilla para añadir Node al PATH. Tiene que estar marcada. Viene marcada por defecto, pero míralo, porque si se queda sin marcar el sistema no encuentra el comando y el error que da es el más desconcertante de todos: te dice que npm no existe, cuando lo acabas de instalar.

Para comprobar que va, abres una ventana nueva de PowerShell y escribes node --version. Si te devuelve un número, listo.

Ojo con lo de "una ventana nueva". Si tenías PowerShell abierto antes de instalar Node, esa ventana no conoce el cambio. Ciérrala y abre otra. Este detalle tonto se lleva por delante a muchísima gente.

Paso 3: la política de ejecución de PowerShell

Windows viene configurado para no dejar ejecutar ciertos scripts. Es una medida de seguridad razonable que, en este caso, te bloquea.

El síntoma es un mensaje que habla de que la ejecución de scripts está deshabilitada en este sistema. En la documentación de Microsoft está el comando para cambiar la política a nivel de tu usuario. Se ejecuta una vez y no hay que volver a tocarlo.

No lo cambies a la opción más permisiva de todas por comodidad. La que solo afecta a tu usuario es suficiente y deja el sistema en un sitio razonable.

Paso 4: instalar Claude Code

Ahora sí. Abres PowerShell, vas a la documentación oficial de Claude Code, copias el comando de instalación para Windows y lo pegas.

Tarda un minuto. Salen líneas. Cuando pare, escribes claude y te aparece la bienvenida.

La primera vez te va a pedir iniciar sesión. Escribes /login, se abre el navegador, autorizas con tu cuenta y vuelves a la terminal. Ya estás dentro.

¿Y WSL? ¿Hace falta?

WSL es un Linux que corre dentro de Windows. Es la ruta que recomienda mucha gente y no siempre hace falta.

Mi criterio: si vas a usar Claude Code para gestionar documentos, notas, textos y proyectos sencillos, con la instalación normal te sobra. Si vas a tocar proyectos de desarrollo con dependencias raras, entonces sí, monta WSL y trabaja dentro.

Instalarlo es un comando y un reinicio. Pero añade una capa entera de conceptos nuevos (dónde están tus archivos, cómo pasas de un lado a otro) y si estás empezando, esa capa te sobra. Puedes montarlo más adelante sin perder nada.

¿Qué más se te va a atascar?

Las rutas con espacios o con OneDrive. Si tu carpeta de trabajo está dentro de OneDrive y tiene tildes o espacios en el nombre, van a pasar cosas raras: archivos que se sincronizan a mitad de escritura, rutas que no se resuelven. Crea una carpeta directamente en C: con un nombre corto y sin espacios. Ahí trabajas tranquilo.

El antivirus. Algunos antivirus bloquean la instalación o ralentizan brutalmente las operaciones sobre archivos. Si notas que todo va exageradamente lento, prueba a añadir la carpeta de trabajo a las exclusiones.

El terminal de Windows viejo. Si estás usando la consola antigua, los colores y el formato de Claude Code se ven fatal. Instala Windows Terminal desde la tienda de Microsoft. Es gratis, es oficial, y cambia por completo la experiencia.

Los permisos de administrador. No hace falta ejecutar nada como administrador. Si estás abriendo PowerShell como administrador para que funcione, es señal de que algo está mal instalado, no la solución.

Dónde poner tu carpeta de trabajo

Un apunte que no es de instalación pero que decide si esto te va a ir bien o regular.

Crea una carpeta en la raíz del disco, con un nombre corto, en minúsculas y sin espacios. Algo tipo C:\proyectos. Dentro, una carpeta por proyecto.

Suena a manía y tiene motivo: las rutas largas de Windows tienen un límite de caracteres que se alcanza antes de lo que crees cuando trabajas dentro de la carpeta de usuario, dentro de OneDrive, dentro de Documentos, dentro de otra carpeta con el nombre de tu proyecto en tres palabras. Cuando ese límite salta, los errores que da no dicen en ningún momento que el problema sea la longitud de la ruta.

El truco para no pelearte con nada de esto

Si has llegado hasta aquí y sigues atascado, hay una salida que parece trampa: dejar que otra IA haga la instalación por ti.

Te descargas un editor con agente integrado, lo instalas como una aplicación normal, le pasas el enlace de la documentación de Claude Code y le dices que lo instale en tu sistema. Le das permisos, y ejecuta él los comandos que tú no querías ejecutar.

Lo tengo contado con detalle en la guía de instalación para novatos, donde está la ruta completa sin terminal. Funciona, y no tiene ningún mérito menos que hacerlo a mano.

¿Y ahora qué?

Lo tienes instalado. Crea una carpeta nueva, entra en ella desde la terminal, escribe claude y prueba a pedirle algo sencillo: que te cree un archivo de notas, que te resuma un texto que le pegues.

Si la terminal en sí te sigue dando respeto, tengo un post entero sobre qué es una terminal y por qué da miedo que quita el susto en cinco minutos.

Y si quieres el recorrido ordenado desde cero, sin saber programar y sin dar saltos, está todo en la guía de Claude Code para no programadores.

Instalar esto en Windows lleva veinte minutos si sabes los tres pasos previos y una tarde entera si no. Ahora ya los sabes.

Si lo que quieres es usar Claude Code para montar tu propia web de principio a fin, sin saber programar, eso es exactamente lo que enseño paso a paso en el curso.

Ver el curso de Claude Code