Перейти к основному содержанию
На Windows вкладка Code может запускать сеанс внутри дистрибутива WSL 2 вместо самой Windows. Процесс Claude Code сеанса, его инструменты и git выполняются внутри дистрибутива, используя его цепочку инструментов Linux и собственные пути Linux, ту же среду, на которую нацелен ваш проект. Используйте сеанс WSL, когда ваш репозиторий находится в файловой системе дистрибутива. Работа с этими файлами из Windows проходит через сетевую файловую систему, что медленно и нарушает отслеживание файлов; запуск сеанса внутри дистрибутива избегает обоих этих проблем.

Требования

  • Windows 10 или 11 с WSL 2. WSL 1 не поддерживается.
  • По крайней мере один установленный дистрибутив (например, Ubuntu).
  • git установлен внутри дистрибутива.

Запуск сеанса WSL

1

Выберите дистрибутив

Запустите новый сеанс на вкладке Code и откройте средство выбора среды. Ваши установленные дистрибутивы WSL 2 появляются в разделе WSL. Выберите один.
2

Выберите папку

Сеанс запускается в домашнем каталоге дистрибутива. Используйте средство выбора папок для выбора папки проекта. Просмотр происходит внутри дистрибутива с путями Linux, такими как /home/you/project.
3

Доверьте папке

Первый сеанс в папке показывает диалог доверия рабочей области. Доверие предоставляется для каждого дистрибутива и папки; доверие папке в одном дистрибутиве не применяется к другому дистрибутиву или к тому же пути на Windows.
Первый сеанс в дистрибутиве занимает немного больше времени, пока Claude настраивается внутри него. Вы также можете открыть папку \\wsl.localhost\... из обычного средства выбора папок, и она снова откроется внутри этого дистрибутива. Папки, которые вы недавно использовали, появляются в средстве выбора для каждого дистрибутива, поэтому повторное подключение к проекту — это один клик.

Что работает в сеансе WSL

Параллельные сеансы, боковые чаты, визуальный просмотр различий, статус ветви и запроса на слияние, а также worktrees работают, поддерживаемые git и цепочкой инструментов внутри дистрибутива. “Открыть в редакторе” открывает VS Code, подключенный к дистрибутиву через Remote - WSL. Несколько функций еще недоступны в сеансах WSL: интегрированный терминал, соединители и плагины, разветвление сеанса, панель браузера файлов и предложения файлов при вводе @ в компоновщик.

Управляемые устройства

На устройствах, управляемых организацией, сеансы WSL могут быть недоступны. Если запуск сеанса завершается с сообщением об управлении устройством, это контролируется вашим администратором. Администраторы: см. как параметры достигают устройств в руководстве по развертыванию.