Cómo instalar Claude Code en Windows: nativo o WSL (2026)

Respuesta rápida: Claude Code funciona en Windows de dos formas. Nativo: abre PowerShell y ejecuta irm https://claude.ai/install.ps1 | iex. WSL 2: abre tu distribución Linux y ejecuta curl -fsSL https://claude.ai/install.sh | bash. No necesitas permisos de administrador para la opción nativa. Verifica con claude --version en una terminal nueva. Necesitas una cuenta Pro, Max, Team, Enterprise o Console: el plan gratis de Claude no incluye Claude Code.

Dónde instalas	Comando oficial	Auto-actualización
PowerShell	irm https://claude.ai/install.ps1 | iex	Sí
CMD	curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd	Sí
WinGet	winget install Anthropic.ClaudeCode	No por defecto (winget upgrade Anthropic.ClaudeCode)
WSL (Ubuntu u otra)	curl -fsSL https://claude.ai/install.sh | bash	Sí

Los comandos vienen de la página oficial Advanced setup de Claude Code, consultada el 26 de octubre de 2026.

Esta guía resuelve una sola pregunta: cómo dejar Claude Code funcionando en una PC con Windows y qué opción elegir. Para la visión general de Claude Code y Claude Cowork en macOS y Windows, lee Cómo instalar Claude Code y Claude Cowork. Para aprender a usarlo después, sigue Claude Code desde cero en español. Si aún eliges herramienta, revisa Claude Code vs Codex. El resto de guías de instalación está en el hub Construir agentes. El siguiente paso práctico es el curso gratuito Instala tu primer agente.

Nativo o WSL: cómo decidir en un minuto

La documentación oficial compara tres opciones:

Opción	Qué necesitas	Sandbox de comandos	Cuándo elegirla
Windows nativo	Nada; Git for Windows es opcional	No disponible	Proyectos y herramientas de Windows (.NET, PowerShell, Visual Studio)
WSL 2	WSL 2 activado	Disponible	Proyectos con herramientas de Linux, o si quieres aislar los comandos del agente
WSL 1	WSL 1 activado	No disponible	Solo si WSL 2 no está disponible en tu equipo

Regla práctica:

• Si tu proyecto vive en C:\Users\... y usas herramientas de Windows, instala nativo.
• Si tu proyecto usa Node, Python, Docker o scripts de bash pensados para Linux, instala en WSL 2.
• Si quieres que el agente ejecute comandos dentro de un sandbox, la única opción en Windows es WSL 2.

No instales las dos el primer día. Elige una, prueba y cambia solo si te falta algo.

Requisitos

Según la página oficial:

• Windows 10 versión 1809 o posterior, o Windows Server 2019 o posterior.
• 4 GB de RAM o más; procesador x64 o ARM64.
• Conexión a internet y estar en un país donde Anthropic da servicio.
• Una terminal: PowerShell o CMD (nativo), o la terminal de tu distribución (WSL).
• Cuenta Pro, Max, Team, Enterprise o Console. También puedes usar Amazon Bedrock, Google Cloud o Microsoft Foundry como proveedor.

Opción A: instalar Claude Code nativo en Windows

Paso 1: abre la terminal correcta

Abre el menú Inicio, escribe «PowerShell» y ábrelo. No hace falta «Ejecutar como administrador». Sabes que estás en PowerShell porque la línea empieza con PS C:\Users\TuNombre>. En CMD aparece C:\Users\TuNombre> sin PS.

Paso 2: ejecuta el instalador

En PowerShell:

irm https://claude.ai/install.ps1 | iex

En CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

El instalador no muestra progreso mientras descarga. Espera a que vuelva el cursor.

¿Viste guías que instalan Claude Code con npm install -g @anthropic-ai/claude-code? Ese método sigue documentado, pero hoy pide Node.js 22 o posterior y instala el mismo binario nativo. La documentación recomienda el instalador nativo de arriba porque se actualiza solo y no depende de Node. No mezcles los dos: si ya lo instalaste con npm, sigue con npm o desinstálalo antes (npm uninstall -g @anthropic-ai/claude-code).

Alternativa con WinGet, si prefieres un gestor de paquetes:

winget install Anthropic.ClaudeCode

Con WinGet, Claude Code no se actualiza solo. Ejecuta winget upgrade Anthropic.ClaudeCode de vez en cuando.

Paso 3 (recomendado): instala Git for Windows

Git for Windows es opcional, pero la documentación lo recomienda. Incluye Git Bash, que Claude Code usa para su herramienta Bash. Sin Git for Windows, Claude Code ejecuta los comandos con PowerShell.

Descárgalo desde git-scm.com/downloads/win y acepta las opciones por defecto. Además, tener Git te permite deshacer cambios del agente, algo que vas a querer.

Si Claude Code no encuentra Git Bash, indícale la ruta en tu archivo settings.json:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Opción B: instalar Claude Code en WSL 2

Paso 1: activa WSL

Si aún no tienes WSL, Microsoft documenta la instalación con un solo comando. Abre PowerShell como administrador y ejecuta:

wsl --install

Reinicia la PC cuando lo pida. Al volver, se abre Ubuntu (la distribución por defecto) y te pide un usuario y una contraseña de Linux. Esa contraseña es solo para WSL.

Paso 2: instala Claude Code dentro de WSL

Abre Ubuntu desde el menú Inicio y ejecuta el instalador de Linux:

curl -fsSL https://claude.ai/install.sh | bash

Importante: instala y ejecuta claude dentro de la terminal de WSL, no desde PowerShell ni CMD. En WSL no necesitas Git for Windows.

Paso 3: guarda tus proyectos dentro de Linux

Trabaja en carpetas dentro de tu directorio de Linux (por ejemplo ~/proyectos), no en /mnt/c/.... Microsoft recomienda guardar los archivos en el mismo sistema operativo que las herramientas que los usan, porque el acceso entre Windows y Linux es más lento.

Verifica la instalación y entra por primera vez

Cierra la terminal y abre una nueva. Luego:

claude --version

Una instalación correcta imprime un número, por ejemplo 2.1.211 (Claude Code). Para un diagnóstico más completo:

claude doctor

claude doctor revisa la instalación y tu configuración sin abrir una sesión, y sugiere correcciones.

Después, entra a una carpeta de prueba y arranca:

mkdir prueba-claude
cd prueba-claude
claude

La primera vez se abre el navegador para iniciar sesión con tu cuenta de Claude. Ejemplo propuesto de primera tarea: «Crea un README.md que explique en tres líneas para qué sirve esta carpeta». Revisa el archivo antes de seguir.

Errores comunes en Windows

Mensaje o síntoma	Causa	Qué hacer
'irm' is not recognized as an internal or external command	Estás en CMD con el comando de PowerShell	Usa el comando de CMD o abre PowerShell
The token '&&' is not a valid statement separator	Estás en PowerShell con el comando de CMD	Usa el comando de PowerShell
claude no se reconoce después de instalar	La terminal se abrió antes de instalar o la carpeta no está en PATH	Abre una terminal nueva; si sigue, revisa la sección Fix your PATH de la guía oficial de problemas
Error 403 o syntax error near unexpected token '<'	Bloqueo de red, proxy o país no soportado	Revisa la página oficial Troubleshoot installation
Claude Code no encuentra Git Bash	Git instalado en otra ruta	Define CLAUDE_CODE_GIT_BASH_PATH en settings.json
Tienes dos instalaciones (nativa y WinGet)	Instalaste por dos vías	Desinstala una; la guía oficial explica cómo encontrar instalaciones en conflicto
WinGet no actualiza mientras Claude Code está abierto	Windows bloquea el ejecutable en uso	Cierra Claude Code y ejecuta winget upgrade Anthropic.ClaudeCode
No puedes iniciar sesión con tu cuenta gratis	El plan gratis no incluye Claude Code	Usa un plan Pro o superior, o una cuenta de Console con API

Actualizar y desinstalar

La instalación nativa (PowerShell, CMD o WSL) se actualiza sola en segundo plano. Para forzarlo ahora: claude update.

Para desinstalar la versión nativa en PowerShell, según la documentación oficial:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Con WinGet: winget uninstall Anthropic.ClaudeCode. En WSL: rm -f ~/.local/bin/claude y rm -rf ~/.local/share/claude.

Esos comandos no borran tu configuración en .claude. Hazlo solo si quieres perder ajustes, servidores MCP e historial.

Checklist de seguridad

• Prueba en una carpeta vacía antes de abrir un proyecto real.
• Haz commit antes de pedir cambios grandes.
• No guardes secretos en la carpeta del proyecto; usa variables de entorno.
• Si necesitas aislar los comandos del agente, usa WSL 2: el sandbox no está disponible en Windows nativo.
• Lee cada comando antes de aprobarlo. Para automatizar reglas, mira hooks de Claude Code.

Preguntas frecuentes

¿Claude Code funciona en Windows sin WSL? Sí. Desde la instalación nativa corre en PowerShell o CMD; Git for Windows es opcional.

¿Necesito ser administrador? Para la instalación nativa, no. Para activar WSL con wsl --install, sí.

¿Es gratis? El programa se descarga gratis, pero usarlo requiere un plan Pro, Max, Team o Enterprise, o una cuenta de Console con facturación por API. El plan gratis de Claude no incluye Claude Code.

¿Qué opción es más rápida? Depende de dónde estén tus archivos. Lo más importante es no mezclar: proyectos de Windows con Claude Code nativo; proyectos en el disco de Linux con Claude Code en WSL.

¿Puedo usarlo sin terminal? Sí, con la app de escritorio. La guía Cómo instalar Claude Code y Claude Cowork cubre esa vía.

¿Funciona en Windows ARM? Sí. La documentación lista procesadores x64 y ARM64.

¿Qué hago después de instalarlo? Sigue el curso gratuito Instala tu primer agente y la guía Claude Code desde cero.