Claude Code Desktop en WSL

Ejecutar sesiones de Code dentro de una distribución WSL 2 en Windows

En Windows, la pestaña Code puede ejecutar una sesión dentro de una distribución WSL 2 en lugar de en Windows mismo. El proceso de Claude Code de la sesión, sus herramientas y git se ejecutan todos dentro de la distribución, utilizando su cadena de herramientas Linux y rutas nativas de Linux, el mismo entorno que su proyecto utiliza.

Utilice una sesión WSL cuando su repositorio se encuentre dentro del sistema de archivos de la distribución. Trabajar en esos archivos desde Windows pasa a través de un sistema de archivos de red, que es lento e interrumpe la observación de archivos; ejecutar la sesión dentro de la distribución evita ambos problemas.

Requisitos

• Windows 10 u 11 con WSL 2. WSL 1 no es compatible.
• Al menos una distribución instalada (por ejemplo, Ubuntu).
• git instalado dentro de la distribución.

Iniciar una sesión WSL

1. Elegir una distribución

Inicia una nueva sesión en la pestaña Code y abre el selector de entorno debajo del cuadro del prompt, o encima de él en el diseño anterior. Tus distribuciones WSL 2 instaladas aparecen en WSL. Elige una.

2. Elegir una carpeta

La sesión comienza en el directorio home de la distribución. Usa el selector de carpetas para elegir una carpeta de proyecto. La exploración ocurre dentro de la distribución, con rutas de Linux como /home/you/project.

3. Confiar en la carpeta

La primera sesión en una carpeta muestra el diálogo de confianza del espacio de trabajo. La confianza se otorga por distribución y carpeta. Una carpeta en la que confías en una distribución no es de confianza en otra distribución ni en la misma ruta en Windows.

La primera sesión en una distribución tarda un poco más mientras Claude se configura dentro de ella. También puedes abrir una carpeta \\wsl.localhost\... desde el selector de carpetas normal, y se reabre dentro de esa distribución.

Lo que funciona en una sesión WSL

Las sesiones paralelas, los chats laterales, la revisión visual de diffs, el estado de ramas y pull requests, y los worktrees funcionan todos, respaldados por git y la cadena de herramientas dentro de la distribución. "Abrir en editor" abre VS Code conectado a la distribución a través de Remote - WSL.

Si una característica de Desktop no está disponible o está limitada en una sesión WSL, comprueba si es una de estas:

• Terminal y conectores: es posible que tu sesión no tenga la terminal integrada, los conectores o ambos. Consulta Si la terminal o los conectores no están disponibles.
• Plugins: no están disponibles en sesiones WSL
• Edición de archivos: puedes ver archivos en el panel de archivos, pero no puedes editarlos ahí, así que pídele a Claude que haga los cambios
• Archivos adjuntos: si el menú + muestra Add image en lugar de Add files or photos, solo puedes adjuntar imágenes. Consulta Agregar archivos y contexto a los prompts.

Si la terminal o los conectores no están disponibles

No puedes activar la terminal integrada ni los conectores para una sesión WSL por tu cuenta:

• Cuenta de Claude: las dos características se están implementando por separado. Selecciona Help > Check for Updates… y, si una característica sigue faltando después de actualizar, no hay nada que hacer.
• Proveedor externo: las sesiones WSL no obtienen la terminal ni los conectores, y actualizar Desktop no cambia eso

Dispositivos administrados

En dispositivos administrados por una organización, las sesiones WSL pueden no estar disponibles. Si el inicio de sesión falla con un mensaje de que el dispositivo está administrado, eso está controlado por su administrador. Administradores: consulte cómo llegan las configuraciones a los dispositivos en la guía de implementación.