Claude Code en Windows: instalación, PowerShell, Git Bash y WSL
Aprende a utilizar Claude Code en Windows de forma nativa con PowerShell, CMD o Git Bash, o dentro de WSL 2 si tu proyecto utiliza herramientas Linux. Veremos instalación, configuración, Git, apertura de proyectos, sandboxing, rendimiento y solución de los errores más habituales en Windows.
¿Claude Code funciona en Windows?
Sí. Claude Code funciona actualmente de forma nativa en Windows y ya no es obligatorio utilizar WSL. Puedes instalarlo desde PowerShell, CMD o WinGet y ejecutarlo desde cualquier terminal. Git for Windows es opcional: si está instalado, Claude Code puede utilizar Git Bash; si no, puede ejecutar comandos mediante PowerShell. WSL 2 sigue siendo recomendable cuando trabajas con toolchains Linux o necesitas sandboxing.
Tres formas de utilizar Claude Code en Windows
No existe una única configuración correcta. La mejor opción depende de dónde se encuentren tus proyectos.
PowerShell
La opción más directa para proyectos completamente nativos de Windows.
Git Bash
Añade un entorno Bash familiar para Git y herramientas tipo Unix.
WSL 2
Recomendado para toolchains Linux, Docker, proyectos Linux y sandboxing.
Windows nativo o WSL 2: cuál elegir
Una regla sencilla es ejecutar Claude Code en el mismo entorno donde vive realmente tu proyecto.
Proyecto nativo de Windows
Utiliza Claude Code directamente en Windows con PowerShell o Git Bash.
Proyecto basado en Linux
Utiliza WSL 2 cuando tu stack depende principalmente de herramientas Linux.
Necesitas aislamiento
WSL 2 permite actualmente utilizar el sandboxing de Claude Code.
Requisitos de Claude Code en Windows
Antes de configurar tu entorno, comprueba los requisitos básicos.
| Requisito | Claude Code |
|---|---|
| Sistema operativo | Windows 10 1809+ o Windows Server 2019+ |
| Procesador | x64 o ARM64 |
| Memoria RAM | 4 GB o más |
| Conexión | Internet requerido |
| PowerShell | Sí |
| CMD | Sí |
| Git for Windows | Opcional |
| WSL | Opcional |
Cómo instalar Claude Code directamente en Windows
La instalación nativa es actualmente el método recomendado para proyectos Windows.
Instalación nativa
irm https://claude.ai/install.ps1 | iexAnthropic indica que Claude Code puede instalarse desde una sesión normal del usuario.
PowerShell y CMD utilizan comandos diferentes
Uno de los errores más habituales al empezar consiste en copiar el comando de la terminal equivocada.
| Terminal | Aspecto del prompt |
|---|---|
| PowerShell | PS C:\Users\Usuario> |
| CMD | C:\Users\Usuario> |
Instalar desde Command Prompt
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Si PowerShell muestra
que &&
no es un separador válido,
probablemente estás utilizando
el comando de CMD
dentro de PowerShell.
Si Windows indica
que irm
no se reconoce,
probablemente estás ejecutando
el comando PowerShell
dentro de CMD.
Instalar Claude Code con WinGet
También puedes gestionar Claude Code utilizando el gestor de paquetes de Windows.
Instalación
winget install Anthropic.ClaudeCodeActualizar
winget upgrade Anthropic.ClaudeCodeSi eliges este método, recuerda actualizar Claude Code periódicamente.
Comprobar Claude Code en Windows
Después de instalarlo, comprueba primero que Windows encuentra correctamente el ejecutable.
Comprobar versión
claude --versionRevisar configuración
claude doctor¿Es obligatorio instalar Git for Windows?
No. Git for Windows es actualmente opcional para ejecutar Claude Code de forma nativa.
PowerShell
Claude Code puede ejecutar comandos utilizando su herramienta PowerShell.
Bash + Git
Claude Code obtiene acceso a Git Bash y a su herramienta Bash.
Si tu flujo depende
frecuentemente
de Git,
Bash,
scripts .sh
o comandos Unix,
instalar Git for Windows
puede mejorar
la experiencia.
Qué hacer si Claude Code no encuentra Git Bash
En algunas instalaciones, Claude Code puede no detectar automáticamente el ejecutable.
Indicar manualmente la ruta
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}
Dentro de JSON
una ruta de Windows
utiliza \\
para representar
una barra invertida.
Claude Code puede trabajar con PowerShell directamente
En Windows nativo ya no necesitas Bash para todas las operaciones.
Comandos PowerShell nativos
Claude Code puede utilizar PowerShell para navegar, ejecutar programas, administrar archivos y realizar acciones necesarias para completar tareas del proyecto.
Ejecutar scripts
.ps1.
Ejecutar herramientas instaladas en Windows.
Utilizar comandos del entorno PowerShell.
Trabajar con proyectos
almacenados en
C:\.
Abrir un proyecto de Windows con Claude Code
Entra primero a la carpeta raíz del proyecto.
Ejemplo
cd C:\proyectos\mi-aplicacion
claudeAsí podrá encontrar configuración, código, dependencias, tests y documentación relacionada.
Primer prompt recomendado en Windows
Analiza este proyecto.
Primero determina:
- qué tecnologías utiliza
- cómo se ejecuta en Windows
- qué comandos de desarrollo existen
- si depende de Bash, PowerShell o WSL
- cómo se ejecutan los tests
- qué archivos son importantes
No realices cambios todavía.Cómo usar Claude Code dentro de WSL
WSL permite ejecutar un entorno Linux directamente dentro de Windows.
Instalar Claude Code dentro de Linux
curl -fsSL https://claude.ai/install.sh | bash
Si instalas Claude Code
dentro de WSL,
debes iniciar
claude
desde la terminal WSL,
no desde PowerShell
ni CMD.
Windows nativo vs WSL 2 para Claude Code
| Característica | Windows nativo | WSL 2 |
|---|---|---|
| Proyectos Windows | Ideal | Compatible |
| PowerShell | Nativo | Secundario |
| Toolchains Linux | Limitado | Ideal |
| Bash | Git Bash opcional | Nativo |
| Sandboxing | No soportado actualmente | Sí |
| Docker Linux | Depende del entorno | Muy conveniente |
| Rendimiento archivos C:\ | Directo | Puede tener penalización |
Dónde guardar tus proyectos cuando utilizas WSL
Esta decisión puede afectar notablemente las búsquedas dentro de proyectos grandes.
/home/usuario/proyecto
Mantener el proyecto dentro del filesystem Linux suele ofrecer mejor rendimiento desde WSL.
/mnt/c/proyecto
Acceder constantemente desde Linux a archivos almacenados en Windows puede ser más lento.
Anthropic recomienda
mover el proyecto
al filesystem Linux
bajo /home/
o considerar
ejecutar Claude Code
directamente en Windows.
Sandboxing de Claude Code en Windows
Actualmente existe una diferencia importante entre Windows nativo y WSL 2.
Sandbox disponible
Si necesitas limitar el acceso de comandos al filesystem y a la red, WSL 2 es actualmente la opción compatible en Windows.
Sandbox no soportado actualmente
Claude Code puede ejecutarse nativamente, pero la documentación actual no marca el sandbox como disponible en este entorno.
Claude Code en VS Code para Windows
No estás limitado a trabajar en una ventana externa de PowerShell.
Terminal integrada
Puedes abrir
el proyecto en VS Code,
iniciar su terminal integrada
y ejecutar
claude
desde allí.
Claude Code también dispone de integración con IDE
Esto permite trabajar más cerca de archivos, diffs y código seleccionado sin abandonar el editor.
Texto corrupto o extraño dentro de VS Code
Algunos problemas visuales pueden estar relacionados con el renderizado GPU del terminal integrado.
Ejecutar terminal setup
/terminal-setupEntre otras configuraciones, puede desactivar la aceleración GPU del terminal integrado para corregir caracteres corruptos o renderizado defectuoso.
Claude Code no encuentra archivos en Windows
Claude Code utiliza ripgrep para gran parte de sus búsquedas dentro del proyecto.
Comprueba Search
claude doctorSi el binario incluido no funciona correctamente, puedes instalar una versión del sistema y configurar Claude Code para utilizarla.
Problemas frecuentes de Claude Code en Windows
claude no se reconoce:
revisa instalación,
reinicia la terminal
y ejecuta
claude doctor.
irm no se reconoce: estás probablemente dentro de CMD y no PowerShell.
Error con &&: estás probablemente ejecutando el comando CMD dentro de PowerShell.
Git Bash no encontrado:
configura
CLAUDE_CODE_GIT_BASH_PATH.
Búsquedas lentas en WSL:
mueve el proyecto
desde /mnt/c/
hacia /home/.
Terminal congelada:
intenta cancelar
con Ctrl+C
y luego reanuda
la sesión si es necesario.
Qué hacer si Claude Code se cierra o bloquea
Cerrar la terminal no significa necesariamente perder la conversación.
Recuperar una sesión
claude --resumeClaude Code en Windows para desarrollar WordPress
Si desarrollas localmente con herramientas como Local, XAMPP, Laragon u otros stacks Windows, Claude Code nativo puede trabajar directamente con esos proyectos.
Abrir un plugin en Laragon
cd C:\laragon\www\miweb\wp-content\plugins\mi-plugin
claudePara desarrollar un plugin o theme, normalmente conviene iniciar Claude Code directamente dentro de ese proyecto en lugar de darle todo WordPress como contexto inicial.
Claude Code para WordPress →Configuración recomendada según tu proyecto
Configuración básica de Claude Code en Windows
Instala Claude Code mediante PowerShell o WinGet.
Ejecuta
claude --version.
Ejecuta
claude doctor.
Decide si necesitas Git Bash.
Decide si el proyecto debe ejecutarse en Windows o WSL.
Abre Claude desde la raíz del proyecto.
Pide primero analizar la arquitectura antes de modificar.
Documentación de Claude Code para Windows
Advanced Setup
Windows nativo, PowerShell, Git Bash, WSL e instalación.
Ver configuración oficial →Troubleshooting
Problemas de búsqueda, WSL, terminal y recuperación.
Ver troubleshooting →Guías relacionadas
Continúa con VS Code, CLAUDE.md, Plan Mode y otras funciones.
FAQ sobre Claude Code en Windows
Respuestas sobre Windows nativo, PowerShell, Git Bash, WSL, sandbox y configuración.
Sí. Claude Code puede ejecutarse actualmente de forma nativa en Windows 10 1809 o versiones posteriores sin necesidad obligatoria de utilizar WSL.
No. WSL es opcional. Resulta especialmente útil para toolchains Linux y para utilizar sandboxing en Windows.
No es obligatorio. Sin Git for Windows, Claude Code puede utilizar PowerShell para ejecutar comandos. Instalar Git for Windows permite además utilizar Git Bash.
Sí. Puedes instalarlo mediante el comando oficial irm https://claude.ai/install.ps1 | iex.
Sí. Puedes utilizar winget install Anthropic.ClaudeCode desde una terminal compatible.
Windows nativo suele ser mejor para proyectos y herramientas Windows. WSL 2 es preferible cuando el proyecto depende de un entorno Linux o necesitas sandboxing.
El sandboxing no está soportado actualmente en Windows nativo. Sí está disponible cuando Claude Code se ejecuta dentro de WSL 2.
Para obtener mejor rendimiento suele ser preferible guardar los proyectos dentro del filesystem Linux, por ejemplo /home/usuario/proyecto, en lugar de trabajar constantemente desde /mnt/c/.
Sí. Puedes utilizar Claude Code desde la terminal integrada de VS Code y también mediante su integración con IDE.
Puedes definir CLAUDE_CODE_GIT_BASH_PATH dentro de settings.json indicando la ruta del ejecutable bash.exe de Git for Windows.
Integra Claude Code con Visual Studio Code
Ya tienes Claude Code funcionando correctamente en Windows. Ahora veremos cómo integrarlo con VS Code para trabajar con archivos, código seleccionado, diffs, terminal y proyectos completos directamente desde el editor.
Claude Code en VS Code →