Как установить Claude Code: Windows, macOS, Linux и сервер

Claude Code это консольный агент: он живёт в терминале, читает ваш проект, правит файлы и запускает команды. Ставится он одинаково просто везде, а вот дальше начинаются различия, о которых стоит знать заранее.

Что нужно до установки

Node.js версии 18 или новее и менеджер пакетов npm. Проверить можно одной командой:

node -v && npm -v

Если версий нет или они старые, ставьте Node с сайта проекта или через менеджер пакетов вашей системы.

Ещё понадобится аккаунт Anthropic с активной подпиской. Агент авторизуется под вами при первом запуске.

Установка

Одинаково для всех систем:

npm i -g @anthropic-ai/claude-code
claude

Первый запуск откроет авторизацию. Дальше агент работает в той папке, из которой вы его запустили, и видит её содержимое.

Windows

Работает, но с оговоркой: в некоторых сборках агент капризничает в стандартной консоли. Если видите странности с вводом или отрисовкой, попробуйте Windows Terminal вместо старого окна cmd.

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

macOS

Ставится тем же способом. Если система ругается на права при глобальной установке, не запускайте npm под sudo: лучше настроить свой каталог для глобальных пакетов, иначе потом получите файлы, которые не сможете обновить без администратора.

Linux и сервер

Здесь всё то же самое, плюс два вопроса, которых нет на домашней машине.

Автозапуск. Сервер перезагружается, и всё, что вы запустили руками, умирает. Настраивайте службу systemd или запускайте агента внутри tmux, который переживает выход из сессии.

Как подойти к агенту. На домашнем компьютере вы просто открываете терминал. К серверу нужно подключаться, и вот тут SSH-клиент в телефоне работает хуже, чем ожидаешь: связь рвётся, клавиш не хватает, прокрутка воюет с интерфейсом агента. Подробный разбор в статье про терминал с телефона.

Если сервис недоступен в вашей стране

Claude Code работает не везде, и из России он не работает. Пытаться обойти это на своём компьютере не советуем: обычно заканчивается блокировкой аккаунта, а не удобной работой.

Рабочая схема другая: агент запускается на арендованном сервере в стране, где сервис доступен, а вы подключаетесь к этому серверу. Ваше устройство при этом ничего не меняет и никуда не притворяется. Подробный разбор со стоимостью и установкой: Claude Code и Codex на своём сервере.

Частые ошибки

Ставят под sudo и потом не могут обновить. Настройте свой каталог для глобальных пакетов.

Запускают в корне диска или в домашней папке. Агент видит всё вокруг и тратит контекст на лишнее. Запускайте из папки проекта.

Забывают про автозапуск на сервере. После первой же перезагрузки всё выключено, а вы не знаете почему.

Держат одну сессию сутками. Модель начинает дрейфовать и забывать договорённости. Начинайте новую сессию под новую задачу.

Что дальше

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