El mejor setup de Claude Code para Windows: terminal, shell y flujo de trabajo

El stack recomendado de un vistazo

• Terminal: Windows Terminal (gratis, en la Microsoft Store) con perfiles de PowerShell 7 o Git Bash.
• Instalación de Claude Code: instalador nativo, que se actualiza solo en segundo plano.
• Shell para Claude: Git Bash vía Git para Windows, por su compatibilidad mucho mejor con comandos estilo bash.
• Opcional: WSL 2 para proyectos Linux-first o sandboxing.
• Para escalar: CodeAgentSwarm para supervisar varias sesiones a la vez.

Elige bien el terminal: Windows Terminal

Claude Code funciona en PowerShell a secas, CMD, Git Bash y shells de WSL. Pero la aplicación de terminal donde ejecutas esos shells importa para la comodidad del día a día, y en Windows el ganador claro es Windows Terminal: pestañas, paneles, renderizado correcto de Unicode y un copiar-pegar decente.

• Instala Windows Terminal desde la Microsoft Store si no lo tienes.
• Si quieres un shell más moderno, instala PowerShell 7+ desde aka.ms/powershell; Claude Code también funciona bien con el Windows PowerShell de serie.
• Añade un perfil de Git Bash a Windows Terminal cuando instales Git para Windows, para poder elegir por pestaña.

Instala Git para Windows y deja que Claude use Git Bash

Este es el ajuste con más impacto de toda la guía. Sin Git para Windows, Claude Code usa PowerShell para ejecutar los comandos que lanza mientras trabaja en tu código. Funciona, pero una parte enorme del tooling de desarrollo, scripts y one-liners asumen un shell tipo bash. Con Git para Windows instalado, Claude Code usa Git Bash automáticamente, y muchos menos comandos necesitan traducción o fallan de formas raras.

• Descarga Git para Windows desde git-scm.com e instálalo con las opciones por defecto.
• Reinicia el terminal. Claude Code detecta Git Bash automáticamente.
• Además te llevas git, que Claude Code necesita para cualquier cosa relacionada con control de versiones de todos modos.

Si Claude Code no detecta Git Bash (por ejemplo con una ruta de instalación de Git personalizada), apúntalo explícitamente en tu settings.json:

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

Mantenlo actualizado (y elige canal de releases)

• Si usaste el instalador nativo, no tienes que hacer nada: se actualiza solo en segundo plano y aplica la actualización en el siguiente arranque.
• Si instalaste con WinGet, las actualizaciones son manuales (winget upgrade Anthropic.ClaudeCode), o define CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 para activarlas automáticas.
• Claude Code publica versiones muy rápido. Si prefieres menos sorpresas a tener las novedades el primer día, cambia el canal de "latest" a "stable" en tu configuración; stable va una semana por detrás y se salta las regresiones gordas.

Cuándo WSL 2 se gana un sitio en tu setup

Para la mayoría del trabajo nativo en Windows no necesitas WSL para nada. Hay dos casos que lo justifican:

• Proyectos Linux-first: si tu stack asume Linux (backends con mucho Docker, scripts de despliegue, Makefiles llenos de linuxismos), ejecuta Claude Code dentro de WSL 2, donde el proyecto se comporta como en producción.
• Sandboxing: la ejecución de comandos con sandbox de Claude Code solo funciona en WSL 2. Windows nativo y WSL 1 no la soportan. Si quieres más aislamiento cuando dejas a Claude ejecutar comandos con libertad, WSL 2 es el camino.

Las instalaciones nativa y de WSL conviven sin problema en la misma máquina, así que puedes mantener la nativa por defecto y usar WSL 2 para los proyectos que lo pidan. Más detalle en nuestra guía de cómo ejecutar Claude Code en Windows.

Higiene de proyecto: CLAUDE.md y permisos

Dos hábitos mejoran notablemente cada sesión de Claude Code, en cualquier sistema operativo:

• Ten un CLAUDE.md en tu repo. Ejecuta /init una vez en un proyecto y Claude lo genera: comandos de build, convenciones, estructura. Cada sesión futura arranca con ese contexto gratis.
• Ajusta los permisos en lugar de aprobar todo a mano. Permite los comandos seguros y repetitivos (tu test runner, tu linter) y deja la confirmación para los destructivos. Si te tienta desactivarlo todo, lee antes nuestra guía sobre usar el modo YOLO / Turbo con cabeza.

La mejora de verdad: de una sesión a varias

Cuando tu setup de un solo terminal va fino, el cuello de botella pasa a ser el propio Claude: mientras trabaja, tú esperas. Los desarrolladores que más partido sacan a Claude Code en Windows ejecutan varias sesiones en paralelo: una arreglando un bug, otra escribiendo tests, otra con un refactor.

Puedes hacerlo con pestañas de Windows Terminal a pelo, pero pierdes visibilidad rápido: sin notificación cuando un agente termina, sin vista de qué cambió cada uno, con el historial disperso por sesión.

CodeAgentSwarm es una app de escritorio para Windows (y macOS) construida exactamente para esto: hasta 6 terminales de Claude Code en paralelo, notificaciones de escritorio cuando un agente termina o necesita tu input, historial buscable de todas las sesiones, diffs en vivo por terminal y un tablero kanban que los propios agentes mantienen al día. Funciona sobre tu instalación existente de Claude Code, así que todo lo de esta guía sigue aplicando.

Para montar ese flujo, mira cómo usar varios terminales de Claude Code.

Conclusión

Un buen setup de Claude Code en Windows no es complicado: Windows Terminal para la comodidad, el instalador nativo para no pensar en actualizaciones, Git Bash para que los comandos simplemente funcionen, WSL 2 solo cuando el proyecto lo exige, y una herramienta multisesión cuando un terminal se queda corto.

Móntalo una vez y Claude Code en Windows se siente igual de fino que en un Mac.