Claude Code corre en Windows de forma nativa desde PowerShell o CMD, sin necesidad de WSL. También puedes instalarlo dentro de WSL si prefieres un entorno Linux. Te explico las dos vías, cuál te conviene y los detalles que la gente pasa por alto.
Aviso de transparencia: yo trabajo en Mac, así que esto no es "mi experiencia instalándolo en Windows". Es la documentación oficial de Anthropic contrastada y ordenada, con los puntos donde se atasca la gente. Para lo que sí uso a diario, mira cómo usar Claude Code.
Lo que necesitas
- Windows 10 versión 1809 o superior, o Windows Server 2019 o superior.
- Nada más. No hace falta ser administrador.
Opción 1: instalación nativa (la recomendada)
Abre PowerShell y pega:
irm https://claude.ai/install.ps1 | iexSi prefieres CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdCuando termine, abre una terminal en la carpeta de tu proyecto y escribe `claude`.
Cómo saber en cuál de las dos estás. Es la confusión número uno. Si tu línea empieza por `PS C:\`, estás en PowerShell. Si empieza por `C:\` sin el `PS`, estás en CMD. Y los errores te lo dicen: si ves que `&&` no es un separador válido, estás en PowerShell y has pegado el comando de CMD. Si ves que `irm` no se reconoce, estás en CMD y has pegado el de PowerShell.
Opción 2: WinGet
Si administras el equipo con WinGet:
winget install Anthropic.ClaudeCodeCon un matiz importante: las instalaciones por WinGet no se actualizan solas. Tendrás que lanzar `winget upgrade Anthropic.ClaudeCode` de vez en cuando. La instalación nativa sí se actualiza en segundo plano.
Opción 3: dentro de WSL
Si tus proyectos viven en Linux o quieres ejecución de comandos en un entorno aislado, instala WSL 2 y dentro usa el comando de Linux:
curl -fsSL https://claude.ai/install.sh | bashLa diferencia práctica entre las dos vías:
| Windows nativo | WSL 2 | |
|---|---|---|
| Requisitos | Ninguno | WSL 2 activado |
| Ejecución aislada | No disponible | Sí |
| Para qué | Proyectos y herramientas de Windows | Cadenas de herramientas Linux |
WSL 1 también sirve, pero no soporta la ejecución aislada. Úsalo solo si WSL 2 no está disponible en tu equipo.
Cuál de las dos elegir
La pregunta que lo resuelve es dónde viven tus archivos.
Si tus proyectos están en `C:\Users\tunombre\...` y trabajas con herramientas de Windows, ve a nativo. Vas a evitarte el lío de rutas entre los dos mundos, que es la fuente número uno de problemas raros cuando se mezclan.
Si ya trabajas dentro de WSL porque tu equipo usa herramientas de Linux, instálalo en WSL y no lo pienses más.
Y si no tienes ni idea de qué es WSL, esa es la respuesta: nativo. No actives un subsistema Linux entero solo para instalar esto.
El detalle que casi nadie menciona: Git para Windows
En Windows nativo conviene instalar Git para Windows. No es obligatorio, y ahí está el matiz que cambia cómo se comporta la herramienta.
Sin Git para Windows, Claude Code ejecuta los comandos usando PowerShell.
Con Git para Windows, usa Git Bash, que es el entorno para el que están escritos la mayoría de los comandos y ejemplos que vas a encontrar por ahí.
Si lo instalas y aun así no lo encuentra, apunta la ruta en tu `settings.json`:
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}En WSL no hace falta nada de esto.
Si la instalación falla
La documentación oficial tiene una tabla de errores con su solución. Estos son los que más se repiten en Windows, con lo que significa cada uno:
`'claude' is not recognized` después de instalar. El instalador dejó el ejecutable en `%USERPROFILE%\.local\bin\claude.exe`, pero esa carpeta no está en tu PATH. Ve a Propiedades del sistema, Variables de entorno, edita el PATH de usuario y añádela. Y luego abre una terminal nueva: una ventana que ya estaba abierta no se entera del cambio.
Ojo con un caso que despista: si solo instalaste la extensión de VS Code, ese ejecutable no existe. La extensión lleva su propia copia interna y no la publica al PATH. Para usar `claude` desde una terminal hay que hacer la instalación normal.
`'bash' is not recognized as the name of a cmdlet`, o un error sobre el parámetro `fsSL`. Has pegado el comando de otra plataforma en PowerShell. Usa el `irm` de más arriba.
`The process cannot access the file... because it is being used by another process`. Hay una descarga a medias retenida, a veces por un antivirus escaneándola. Borra la carpeta `%USERPROFILE%\.claude\downloads` y vuelve a lanzar el instalador.
`running scripts is disabled on this system` o un error de PSSecurityException. Es la política de ejecución de PowerShell bloqueando los scripts. En equipos de empresa esto suele necesitar que lo mire quien administra el parque.
`Claude Code does not support 32-bit Windows`. Has abierto la entrada x86 de PowerShell. Abre la normal.
Un 403 o un error de sintaxis con `<`. El instalador ha devuelto HTML en vez del script, normalmente por un proxy o un filtro de red por medio.
Cómo actualizarlo y cómo quitarlo
Depende de por dónde lo instalaste, y esto es lo que más despista:
- Instalación nativa: se actualiza sola en segundo plano. No tienes que hacer nada.
- WinGet: no se actualiza sola. `winget upgrade Anthropic.ClaudeCode` cada cierto tiempo.
Para desinstalar, usa la vía por la que lo instalaste. Y si además quieres borrar la configuración, acuérdate de los archivos de ajustes que hayas creado en tus proyectos, porque esos no se van con la desinstalación.
Si la terminal te echa para atrás
Hay aplicación de escritorio para Windows. Te la descargas, la abres y trabajas con Claude Code sin tocar la línea de comandos.
Yo empecé en terminal cuando no había otra cosa, y esa pantalla negra echaba para atrás a mucha gente con razón. Si es tu caso, la app de escritorio te quita esa barrera de encima y el resto funciona igual.
Cuando ya está instalado
La instalación es la parte fácil. Lo que decide si esto te sirve o no es lo que hagas la primera semana: cómo usar Claude Code para empezar, qué es un CLAUDE.md para que entienda tu proyecto, y cómo crear una skill cuando repitas una tarea por tercera vez.
Y si vienes de otra herramienta o dudas entre varias, tengo la comparativa en Cursor vs Claude Code.
En Digital Brain publicamos noticias de IA a diario y los miércoles una pieza de formación a fondo.
Relacionado
