Как установить Claude Code на Windows, macOS и WSL

Установка Claude Code редко бывает сложной. Сложным бывает всё, что происходит сразу после неё: авторизация, доступ и первый запуск в реальном проекте.

Требования

Немного:

• Терминал, которым вы готовы пользоваться. Агент живёт в нём.
• Git в проекте. Формально не обязателен, практически обязателен: без него нельзя посмотреть, что агент изменил, и откатить это.
• Оплаченный аккаунт или ключ API - см. ключ API.
• Сетевой доступ к API провайдера. В России это отдельный вопрос, разобранный в статье про доступ.

Из железа ничего специфического не нужно: вся тяжёлая работа происходит на стороне модели, локально выполняются только команды вашего проекта.

macOS и Linux

Самый прямой путь - официальный установщик, который приносит зависимости с собой. Альтернатива - установка через npm, если Node уже стоит и вы предпочитаете держать инструменты в одном месте.

После установки проверьте, что команда видна из терминала. Если нет - каталог с исполняемым файлом не попал в PATH. Это самая частая заминка, и лечится она одной строкой в файле настроек оболочки.

Windows

Два пути, и выбор между ними не косметический.

Нативная установка. Агент работает в вашем обычном окружении: PowerShell, пути Windows, программы, установленные в системе. Подходит, если проект и так собирается под Windows.

WSL. Внутри - обычный Linux. Подходит, если проект в проде живёт на Linux: агент будет запускать ровно те команды, которые работают в вашем CI.

Практическое соображение: самая частая причина странных ошибок на Windows - смешение двух миров. Проект лежит в файловой системе Windows, а команды выполняются в WSL, и вы получаете медленный ввод-вывод, конфликты прав и путаницу с концами строк. Держите проект целиком по одну сторону границы.

Отдельно про переводы строк: если репозиторий настроен на автоматическое преобразование, агент может получить файл в одном виде, а записать в другом, и в диф попадёт весь файл вместо трёх строк. Это не ошибка агента, это настройка git.

Первый запуск и авторизация

Порядок такой:

1. Перейдите в каталог проекта. Агент работает относительно текущего каталога, и это важно: он видит то, что здесь лежит.
2. Запустите его. При первом старте он попросит авторизоваться - по подписке или по ключу.
3. Дайте маленькую задачу с очевидным критерием: пусть объяснит, как устроен один модуль. Это проверяет всю цепочку и ничего не меняет в проекте.
4. Только после этого давайте задачу, которая правит файлы, и обязательно на чистом рабочем дереве git.

Совет по существу: не начинайте с большой задачи. Первая же правка на грязном рабочем дереве - это способ не понять, что изменил агент, а что вы.

Типовые ошибки установки

• Команда не найдена. Каталог не в PATH. Перезапустите терминал; если не помогло, добавьте путь руками.
• Отказано в доступе при установке. Глобальная установка в системный каталог без прав. Правильное решение - настроить пользовательский каталог для глобальных пакетов, а не ставить всё через sudo: иначе часть файлов окажется с чужим владельцем и это аукнется позже.
• Старая версия Node. Установка проходит, а запуск падает с невнятной ошибкой синтаксиса. Проверьте версию до того, как искать причину в другом месте.
• Работает, но не авторизуется. Это уже не установка: смотрите ключ API и доступ.
• Запускается, но не видит файлы проекта. Вы стартовали не из того каталога.

Что дальше

Дальше - команды и режимы CLI и настройка того, что агенту разрешено. Общая картина - гид по Claude Code.