Руководство по использованию Claude Code: установка и быстрый старт на Windows/macOS в одной статье

Этот учебник по Claude посвящён Claude Code: от установки и проверки до привязки API Key и устранения типичных ошибок. Следуйте шагам — и за 10 минут вы сможете запустить Claude Code в терминале, используя его для генерации кода, исправления ошибок и простого взаимодействия в разработке.

1. Подготовка перед установкой: не наступите на грабли с версией Node.js

Claude Code зависит от окружения Node.js; рекомендуется сначала установить Node.js версии 18 и выше, затем открыть новое окно терминала. Пользователям Windows достаточно установить через инсталлятор, нажимая «Далее», а на macOS можно использовать официальный установщик или менеджер пакетов. После установки введите в терминале node -v, чтобы убедиться, что номер версии отображается корректно.

2. Установка Claude Code: глобальная установка через npm и зеркала для Китая

Выполните в терминале команду глобальной установки: npm install -g @anthropic-ai/claude-code — это самый распространённый способ установки Claude Code. Если в вашей сети доступ к официальному репозиторию npm медленный, можно использовать зеркальный источник: npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com. После установки заново откройте терминал и введите claude --version, чтобы проверить, доступен ли Claude Code.

3. Первый запуск и привязка API Key: чтобы Claude Code действительно работал

Для работы Claude Code требуется авторизация через API Key Anthropic; при первом запуске claude обычно предлагает настроить ключ. Более надёжный способ — заранее задать в системе переменную окружения ANTHROPIC_API_KEY, а затем запускать Claude Code, чтобы не вводить ключ каждый раз. После этого откройте терминал в каталоге проекта и опишите задачу естественным языком — например, попросите Claude Code проанализировать сообщение об ошибке, сгенерировать патч с исправлением и подсказать, как выполнить проверку.

4. Частые проблемы Claude Code: зависания, ошибки и прерывания — что делать

Если у Claude Code возникают сбои запросов или частые прерывания, в первую очередь проверьте стабильность сети и не сработало ли серверное ограничение по частоте (rate limit); переход на более стабильное соединение обычно заметно улучшает ситуацию. При ошибках установки чаще всего виноваты слишком старая версия Node.js или проблемы с глобальными правами доступа — обновление Node.js и переустановка с правами администратора/sudo обычно решают проблему. Если claude --version ничего не выводит, проверьте, добавлен ли путь глобального npm в PATH, и запустите Claude Code снова в новом окне терминала.