Пять граблей Claude Code на Windows — что прописать агенту, чтобы он перестал спотыкаться
Саммари
Большинство материалов про Claude Code написаны под macOS и Linux. Пользователи Windows, особенно те, кто работает без WSL, сталкиваются с набором специфических проблем на стыке агента и окружения: PowerShell 5.1 вместо 7, имена процессов из Microsoft Store, кодировки, особенности PATH. Автор собрал пять реальных граблей, записал решения в память агента и поделился готовым блоком для CLAUDE.md, который можно забрать целиком.
Проблема не в Claude Code как таковом, а в разрыве между обучающими данными модели (Unix-ориентированными) и реальным окружением пользователя. Агент «думает», что он на Linux/macOS, и пишет команды для bash, а Windows-оболочка их не понимает. Это фундаментальная проблема portability для AI-агентов.
Для Revit-разработчиков, которые почти поголовно на Windows, этот материал особенно актуален: если вы запускаете Claude Code или любого другого AI-агента для работы с Revit API, PowerShell 5.1 будет стандартным окружением, и агента нужно явно обучить его особенностям.
Готовый блок CLAUDE.md — это и есть паттерн «Harness Engineering in Practice»: агент должен знать правила игры (конкретные ограничения окружения), и эти правила должны быть записаны в долговременную память (CLAUDE.md, AGENTS.md), а не в системный промпт.