Ставя кодинг-агента на Windows, первым делом приходится решить: WSL или нативная Windows? Год назад ответ почти всегда был WSL, потому что большинство агентов на Windows нормально не работали. Сегодня Claude Code, Codex, Gemini CLI и Copilot CLI работают в PowerShell нативно, и ответ зависит от проекта.
Короткий ответ
| Ситуация | Рекомендация |
|---|---|
| .NET, C#, Unity, десктопное приложение Windows | Нативная Windows |
Код на диске C:, редактор в Windows | Нативная Windows |
| Инструменты только для Linux, shell-скрипты, Makefile | WSL 2 |
| Разработка с упором на Docker | WSL 2 |
| Нужна песочница (sandbox) Claude Code | WSL 2 |
| Вы будете пользоваться инструментом на основе tmux | WSL 2 |
| Корпоративная машина, WSL запрещён | Нативная Windows |
Плюсы нативной Windows
Короткая установка. Claude Code ставится однострочным скриптом PowerShell, Codex и Gemini CLI — через npm. Все команды — в статье как установить кодинг-агентов на Windows.
Быстрый доступ к файлам. Код на диске C:, агент тоже в Windows; между ними нет моста файловых систем.
Инструменты Windows. dotnet, MSBuild, компиляторы Visual Studio и SDK для Windows доступны напрямую. Вызывать их из WSL можно, но хлопотно.
Песочница Codex для Windows. В нативной Windows Codex работает со своей песочницей.
Минусы нативной Windows
Нет песочницы Claude Code. Изоляция файловой системы и сети в Claude Code не поддерживается в нативной Windows, но поддерживается в WSL 2. Вместо неё вы работаете с правилами разрешений.
Нет tmux. Нативной версии tmux для Windows нет. Инструменты на его основе (вроде Claude Squad) в нативной Windows не работают.
Различия оболочек. Большинство агентов привыкли генерировать команды bash. Claude Code использует Git Bash, если установлен Git for Windows, а иначе PowerShell; другие агенты могут использовать PowerShell или cmd.exe. Привычки bash вроде rm -rf, export или && в PowerShell ведут себя иначе.
Проблемы с путями и окончаниями строк. Пути с обратной косой чертой, лимит 260 символов и окончания строк CRLF время от времени сбивают инструменты редактирования. Большинство проблем решают настройки ниже.
Плюсы WSL 2
Это сам Linux. Команды bash, которые генерируют агенты, работают как есть; make, grep, sed и пакеты Linux под рукой.
Песочница Claude Code. В WSL 2 изоляция Claude Code работает; можно запускать его безопаснее и с меньшим числом подтверждений.
tmux и терминальные инструменты. tmux, Claude Squad и похожие инструменты работают в WSL как есть.
Минусы WSL 2
/mnt/c медленный. Доступ из WSL 2 к файлам Windows заметно медленнее, чем к файлам в файловой системе Linux. Документация Microsoft тоже советует держать проекты на стороне Linux. Клонируйте репозиторий в ~/ и открывайте его из редактора в Windows по пути \\wsl$\.
Две отдельные среды. Node, Python, учётные данные git и входы в агентов на двух сторонах раздельны. Возможно, войти в агента придётся дважды: в WSL и в Windows.
Память. Виртуальная машина WSL 2 потребляет память; когда одновременно работают несколько агентов и стек Docker, может понадобиться ограничить её через .wslconfig.
Совмещение: один репозиторий с двух сторон
Самая частая ошибка — держать репозиторий в Windows и запускать одного агента из WSL, а другого из Windows. Результат: один пишет файл с LF, другой с CRLF; diff становятся шумными, некоторые инструменты редактирования сообщают «текст не найден», права на файлы выглядят изменёнными.
Если будете использовать обе среды вместе:
- Держите каждый репозиторий на одной стороне и запускайте агентов этого репозитория с той же стороны.
- Добавьте в репозиторий
.gitattributes:
* text=auto
*.sh text eol=lf
*.bat text eol=crlf
*.ps1 text eol=crlf- На стороне Windows выполните
git config --global core.autocrlf falseиgit config --global core.longpaths true; пусть окончаниями строк управляет.gitattributes.
Параллельные агенты: возможны на обеих сторонах
Чтобы запускать несколько агентов одновременно, на обеих сторонах используются отдельные git worktree.
- В WSL есть tmux и построенные на нём инструменты вроде Claude Squad.
- В нативной Windows — панели Windows Terminal или десктопное приложение, которое показывает агентов сеткой. AgentVera работает на Windows нативно: открывает 18 агентов рядом для каждого проекта и собирает запросы на подтверждение в одну очередь. Агентами внутри WSL оно напрямую не управляет; их можно открыть в агенте Terminal командой вроде
wsl claude.
Подробнее — в руководстве кодинг-агенты на Windows, полная сводка — на странице Windows.
Итоги
Если вы начинаете новый проект и он не привязан к Windows, WSL 2 по-прежнему вариант с наименьшим числом сюрпризов. Если код уже в Windows, редактор в Windows или проект опирается на инструменты Windows, нативной Windows теперь вполне хватает; причин переносить агентов в WSL не осталось. Что бы вы ни выбрали, держите каждый репозиторий на одной стороне.