Разработчик из Казани столкнулся с тем, что почти вся документация по Claude Code ориентирована на macOS и Linux, тогда как его задачи требуют нативной работы в Windows без WSL — в частности, для автоматизации браузера с живыми профилями Chrome. Сам агент под Windows работает стабильно, но проблемы возникают на уровне окружения: PowerShell 5.1, кодировки, имена процессов и переменные PATH.

Каждый сбой на этой почве он фиксировал в памяти агента, чтобы тот не повторял одних и тех же ошибок. В итоге накопилось пять ключевых правил, которые касаются типовых нестыковок между Claude Code и системным окружением Windows.

Отдельно автор приводит готовый блок для файла CLAUDE.md, который можно скопировать целиком. По его словам, эти настройки способны сэкономить несколько вечеров тем, кто работает на Windows без WSL.

Материал ориентирован на разработчиков, которые используют браузерную автоматизацию и живые профили Chrome, а не изолированные среды вроде WSL. Именно на стыке агента и нативной ОС, по наблюдениям автора, и возникают основные сложности.

Ожидаемо, что подобные заметки будут накапливаться и дальше, поскольку поддержка Windows в инструментах для ИИ-агентов пока остаётся второстепенной.