Cómo ejecutar Claude Code en Windows: instalación nativa o WSL

Respuesta rápida: instala Claude Code en Windows en una línea

# PowerShell (recomendado)
irm https://claude.ai/install.ps1 | iex

# O con WinGet
winget install Anthropic.ClaudeCode

# Verifica la instalación
claude --version

Eso es toda la instalación nativa. Sin WSL, sin configurar Node.js, sin permisos de administrador. El instalador añade Claude Code a tu PATH automáticamente y la versión nativa se actualiza sola en segundo plano.

Todos los comandos de esta guía salen de la documentación oficial de instalación de Claude Code.

Qué necesitas antes de instalar

• Windows 10 (versión 1809 o posterior) o Windows 11, de 64 bits. Windows de 32 bits no está soportado.
• PowerShell, que viene preinstalado con Windows.
• Git para Windows: opcional pero recomendado. Con él, Claude Code usa Git Bash como shell, lo que da mejor compatibilidad con comandos bash. Sin él, Claude Code usa PowerShell.
• Una cuenta de Anthropic (suscripción Claude Pro/Max o acceso por API).

Instalación nativa paso a paso

La instalación nativa lleva más o menos un minuto:

• Abre Windows Terminal o PowerShell. No hace falta ejecutarlo como administrador.
• Ejecuta el instalador: irm https://claude.ai/install.ps1 | iex
• Espera a que el script termine. Instala Claude Code en tu perfil de usuario y lo añade al PATH.
• Cierra y vuelve a abrir el terminal para que el cambio del PATH haga efecto.
• Ejecuta claude --version para confirmar que está instalado.

Si prefieres CMD en lugar de PowerShell, hay un instalador equivalente:

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

Primer arranque: iniciar sesión

• Abre un terminal en la carpeta de un proyecto y escribe claude.
• Tu navegador se abre con el login de Anthropic. Inicia sesión con tu cuenta de Claude.
• Si el navegador no se abre, pulsa c en el terminal para copiar la URL de login y pégala en el navegador a mano.
• De vuelta en el terminal, ya está: pídele a Claude algo sobre tu código.

Si algo no va bien después de instalar, claude doctor ejecuta un diagnóstico que detecta la mayoría de los problemas de configuración habituales.

Instalar Claude Code en WSL (y cuándo es mejor opción)

Antes de que existiera el soporte nativo para Windows, WSL era la única forma de usar Claude Code en Windows. Sigue estando totalmente soportado y hay dos escenarios donde sigue siendo la mejor opción:

• Tu proyecto depende de herramientas de Linux. Si tu cadena de build, scripts o dependencias asumen Linux, ejecuta Claude Code donde realmente corre tu proyecto.
• Quieres ejecución de comandos con sandbox. El sandboxing de Claude Code funciona en WSL 2 pero no en Windows nativo (ni en WSL 1).

Para instalar dentro de WSL, abre el terminal de tu distribución WSL (no PowerShell) y ejecuta el instalador de Linux:

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

Luego lanza claude desde dentro del terminal de WSL. Un detalle con el login: en WSL el navegador a veces te muestra un código en lugar de redirigir automáticamente. Pega ese código en el terminal cuando te lo pida.

Windows nativo vs WSL: ¿cuál usar?

• Windows nativo: lo mejor para proyectos nativos de Windows (.NET, Unity, desarrollo web con herramientas de Windows). Setup más simple, se actualiza solo, funciona con PowerShell o Git Bash.
• WSL 2: lo mejor para toolchains de Linux y para ejecución con sandbox. Tus archivos viven en el sistema de archivos de Linux, así que los proyectos Linux-first se comportan exactamente igual que en un servidor.
• WSL 1: solo si WSL 2 no está disponible en tu máquina. No soporta sandboxing y tiene problemas conocidos ejecutando binarios nativos.

Si no lo tienes claro, empieza con la nativa. Es el camino con menos fricción y siempre puedes añadir una instalación en WSL después; las dos pueden convivir en la misma máquina.

Errores comunes en Windows y cómo arreglarlos

• "Claude Code on Windows requires either Git for Windows (for bash) or PowerShell": PowerShell no está en tu PATH o estás en un shell raro. Usa el Windows PowerShell estándar, o instala Git para Windows.
• Git Bash instalado pero no detectado: apunta Claude Code a él explícitamente en tu settings.json: {"env": {"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"}}
• "The process cannot access the file" durante la instalación: otro proceso está bloqueando la descarga. Borra la carpeta %USERPROFILE%\.claude\downloads y vuelve a ejecutar el instalador.
• Errores SSL/TLS en Windows 10 antiguo: ejecuta [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 en PowerShell antes de instalar.
• "Exec format error" en WSL: estás en WSL 1. Actualiza la distribución a WSL 2 con wsl --set-version <distro> 2.

Para cualquier otra cosa, la página oficial de troubleshooting cubre la lista completa de problemas de instalación conocidos.

Ejecutar varias sesiones de Claude Code en Windows

Con Claude Code funcionando, el siguiente cuello de botella aparece rápido: un terminal significa una tarea a la vez. Le das algo que hacer a Claude, y a esperar. La mayoría acaba abriendo varias pestañas de terminal y perdiendo la pista de qué agente terminó, cuál está esperando un permiso y qué cambió cada uno.

Ese es el problema que resuelve CodeAgentSwarm, y ya funciona en Windows. Te da hasta 6 terminales de Claude Code en paralelo con notificaciones de escritorio cuando un agente termina o necesita tu input, historial buscable de todas las sesiones y un diff en vivo de lo que cambió cada terminal.

Si quieres tirar por ese camino, estas dos guías son el siguiente paso natural: Cómo usar varios terminales de Claude Code y Ejecutar múltiples sesiones de Claude Code.

Conclusión

Ejecutar Claude Code en Windows pasó de "configura WSL primero" a una instalación de una línea en PowerShell. La nativa es la opción correcta por defecto para la mayoría de desarrolladores en Windows; WSL 2 está ahí para cuando necesitas herramientas de Linux o sandboxing.

Instálalo, ejecuta claude doctor si algo no cuadra, y cuando un solo terminal se te quede corto, ya sabes dónde encontrarnos.