Invita a un amigo y consigue 1 mes de Pro gratisCómo funciona

¿WSL o Windows nativo para agentes de programación?

¿Claude Code y Codex en WSL 2 o en Windows nativo? Velocidad, sandbox, tmux, CRLF, la lentitud de /mnt/c y qué opción conviene a cada tipo de proyecto.

Solviera Teknoloji 5 min de lectura

Cuando instalas un agente de programación en Windows, la primera decisión es esta: ¿WSL o Windows nativo? Hace un año la respuesta era casi siempre WSL, porque la mayoría de los agentes no funcionaban bien en Windows. Hoy Claude Code, Codex, Gemini CLI y Copilot CLI funcionan de forma nativa en PowerShell; la respuesta ya depende del proyecto.

Respuesta corta

SituaciónRecomendación
.NET, C#, Unity, app de escritorio de WindowsWindows nativo
El código está en la unidad C: y tu editor en WindowsWindows nativo
Herramientas específicas de Linux, scripts de shell, MakefilesWSL 2
Desarrollo con mucho DockerWSL 2
Quieres el sandbox de Claude CodeWSL 2
Vas a usar una herramienta que depende de tmuxWSL 2
Equipo corporativo con WSL prohibidoWindows nativo

Ventajas de Windows nativo

Instalación corta. Claude Code se instala con un script de PowerShell de una línea; Codex y Gemini CLI, con npm. Tienes todos los comandos en cómo instalar agentes de programación en Windows.

Acceso rápido a archivos. El código está en la unidad C: y el agente en Windows; no hay ningún puente de sistema de archivos de por medio.

La cadena de herramientas de Windows. dotnet, MSBuild, los compiladores de Visual Studio y los SDK específicos de Windows están accesibles directamente. Llamarlos desde WSL es posible, pero engorroso.

El sandbox de Windows de Codex. En Windows nativo, Codex funciona con su propio sandbox.

Desventajas de Windows nativo

Claude Code no tiene sandbox. El aislamiento de sistema de archivos y de red de Claude Code no es compatible con Windows nativo; en WSL 2, sí. En su lugar trabajas con reglas de permisos.

No hay tmux. tmux no tiene versión nativa para Windows. Las herramientas que dependen de tmux (como Claude Squad) no funcionan en Windows nativo.

Diferencias de shell. La mayoría de los agentes están acostumbrados a generar comandos de bash. Claude Code usa Git Bash si Git for Windows está instalado y, si no, PowerShell; otros agentes pueden usar PowerShell o cmd.exe. Costumbres de bash como rm -rf, export o && se comportan de otra forma en PowerShell.

Problemas de rutas y finales de línea. Las rutas con barra invertida, el límite de 260 caracteres y los finales de línea CRLF confunden de vez en cuando a las herramientas de edición. Los ajustes de más abajo resuelven la mayoría.

Ventajas de WSL 2

Linux de verdad. Los comandos de bash que generan los agentes funcionan tal cual; make, grep, sed y los paquetes de Linux están listos.

El sandbox de Claude Code. En WSL 2 funciona el aislamiento de Claude Code; puedes ejecutarlo de forma más segura con menos aprobaciones.

tmux y las herramientas de terminal. tmux, Claude Squad y herramientas similares funcionan en WSL tal cual.

Desventajas de WSL 2

/mnt/c es lento. Desde WSL 2, acceder a archivos de Windows es notablemente más lento que acceder a los del sistema de archivos de Linux. La propia documentación de Microsoft recomienda guardar los proyectos en el lado de Linux. Clona el repositorio bajo ~/ y ábrelo desde tu editor de Windows a través de la ruta \\wsl$\.

Dos entornos separados. Node, Python, las credenciales de git y los inicios de sesión de los agentes están separados en cada lado. Puede que tengas que iniciar sesión en el agente una vez dentro de WSL y otra en Windows.

Memoria. La máquina virtual de WSL 2 consume memoria; cuando varios agentes y una pila de Docker funcionan a la vez, puede que tengas que ponerle un límite con .wslconfig.

Combinarlos: el mismo repositorio desde los dos lados

El error más común es guardar el repositorio en Windows y ejecutar un agente desde WSL y otro desde Windows. Resultado: uno escribe los archivos con LF y el otro con CRLF; los diffs se llenan de ruido, algunas herramientas de edición dicen «texto no encontrado» y los permisos de los archivos parecen haber cambiado.

Si vas a usar los dos entornos a la vez:

  • Guarda cada repositorio en un solo lado y ejecuta los agentes de ese repositorio desde ese mismo lado.
  • Añade un .gitattributes al repositorio:
* text=auto
*.sh text eol=lf
*.bat text eol=crlf
*.ps1 text eol=crlf
  • En el lado de Windows, configura git config --global core.autocrlf false y git config --global core.longpaths true; deja que .gitattributes gestione los finales de línea.

Agentes en paralelo: posibles en los dos lados

Para ejecutar varios agentes a la vez, en los dos lados usas git worktrees separados.

  • En WSL tienes tmux y herramientas construidas sobre él, como Claude Squad.
  • En Windows nativo, los paneles de Windows Terminal o una app de escritorio que muestre los agentes en una cuadrícula. AgentVera funciona de forma nativa en Windows; abre 18 agentes lado a lado por proyecto y reúne las solicitudes de aprobación en una sola cola. No gestiona directamente los agentes dentro de WSL; esos los puedes abrir en un agente Terminal con un comando como wsl claude.

Para más detalles, consulta la guía de agentes de programación en Windows, y para el resumen completo, la página de Windows.

Para terminar

Si empiezas un proyecto nuevo y no depende de Windows, WSL 2 sigue siendo la opción con menos sorpresas. Si tu código ya está en Windows, tu editor está en Windows o el proyecto depende de la cadena de herramientas de Windows, Windows nativo ya es más que suficiente; no queda ningún motivo para mover los agentes a WSL. Elijas lo que elijas, guarda cada repositorio en un solo lado.

Preguntas frecuentes

¿Debería ejecutar Claude Code en WSL o en Windows nativo?

Si tu proyecto es específico de Windows y tu código está en la unidad C:, Windows nativo. Si tu proyecto depende de herramientas de Linux o quieres usar el sandbox de Claude Code, WSL 2. El sandbox no existe en Windows nativo.

¿Por qué va lento un agente de programación en WSL?

Lo más probable es que tu código esté bajo /mnt/c, es decir, en el sistema de archivos de Windows. Desde WSL 2, acceder a archivos de Windows es notablemente más lento que acceder a los del sistema de archivos de Linux. Clona el repositorio bajo ~/.

¿Funciona tmux en Windows?

No de forma nativa; solo funciona dentro de WSL, Cygwin o MSYS2. Por eso las herramientas que dependen de tmux, como Claude Squad, necesitan WSL en Windows. En Windows nativo puedes usar los paneles de Windows Terminal o un gestor de agentes.

¿Puede AgentVera gestionar agentes dentro de WSL?

No directamente. AgentVera funciona de forma nativa en Windows e inicia los agentes instalados en Windows. Un agente de WSL lo puedes ejecutar abriendo un agente Terminal con un comando como wsl claude; así obtienes un panel de terminal, pero no las funciones específicas del agente, como retomar sesiones.

Reúne a tus agentes en un mismo escritorio.

Descarga AgentVera gratis; tus CLI instaladas ya están listas.

Más artículos