Как установить Claude Code на macOS: пошаговая инструкция 2025

Что нужно перед установкой

Для установки Claude Code на macOS вам понадобится:

• Mac с macOS 12 Monterey и выше (проверьте: Apple → Об этом Mac)
• Аккаунт Anthropic с подпиской Claude Pro ($20/мес) или API-ключ — зарегистрировать на claude.ai
• Доступ к Терминалу (Finder → Программы → Утилиты → Терминал)
• ~10 минут свободного времени

Шаг 1: Установка Node.js

Claude Code работает на Node.js. Проверьте, установлен ли он уже:

node --version

Если видите что-то вроде v20.11.0 — Node.js уже есть, переходите к шагу 2. Если команда не найдена — устанавливаем.

Вариант А: Через официальный сайт (рекомендуется для новичков)

1. Зайдите на nodejs.org
2. Скачайте версию с пометкой LTS (Long Term Support)
3. Запустите установщик и следуйте инструкциям
4. После установки перезапустите Терминал

Вариант Б: Через Homebrew (для тех, кто уже использует Homebrew)

brew install node

Проверьте установку:

node --version
npm --version

Оба должны вернуть номера версий.

Шаг 2: Установка Claude Code

Одна команда устанавливает Claude Code глобально на ваш Mac:

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

Установка займёт 30–60 секунд. Вы увидите прогресс загрузки пакетов.

Проверьте что Claude Code установился:

claude --version

Должна появиться версия вида 1.x.x.

Шаг 3: Авторизация

Запустите Claude Code в любой папке:

claude

При первом запуске он откроет браузер и попросит авторизоваться в аккаунте Anthropic. Войдите в тот же аккаунт, где у вас подписка Claude Pro.

После успешной авторизации в терминале появится приглашение — Claude Code готов к работе.

Шаг 4: Первый запуск и тест

Создайте тестовую папку и запустите Claude Code:

mkdir ~/test-claude && cd ~/test-claude
claude

Напишите ему что-нибудь простое:

Создай файл index.html с простым лендингом — заголовок "Привет от Claude Code", зелёная кнопка "Начать"

Через несколько секунд он создаст файл. Откройте его в браузере — вы увидите готовую страницу.

Поздравляю — Claude Code работает! 🎉

Полезные настройки после установки

Создайте CLAUDE.md в проектах

В каждом проекте создавайте файл CLAUDE.md — это «память» Claude Code для данного проекта. Запишите туда:

# Проект: Лендинг AI-комьюнити
## Стек
- HTML/CSS/JS (без фреймворков)
- Деплой: Vercel

## Стиль
- Цвет акцента: #39e06e
- Шрифты: Space Grotesk, JetBrains Mono

## Правила
- Все тексты на русском
- Код должен быть читаемым, с комментариями

Это сильно экономит токены и делает работу точнее. Подробнее о токенах — в статье «Как сэкономить токены в Claude Code».

Добавьте алиас для быстрого запуска

Добавьте в ~/.zshrc:

alias cc="claude"

Теперь можно запускать просто cc.

Частые ошибки и решения

Ошибка: command not found: claude

Путь npm global bin не добавлен в PATH. Выполните:

npm config get prefix

Скопируйте вывод (например, /usr/local) и добавьте в ~/.zshrc:

export PATH="$PATH:/usr/local/bin"

Затем: source ~/.zshrc

Ошибка: EACCES permission denied

Проблема с правами на папку npm. Решение:

sudo npm install -g @anthropic-ai/claude-code

Или лучше — настройте npm без sudo по официальной инструкции.

Ошибка авторизации / браузер не открывается

Попробуйте авторизацию через API-ключ:

export ANTHROPIC_API_KEY=ваш_ключ_здесь
claude

API-ключ берётся в личном кабинете на console.anthropic.com.

FAQ по установке Claude Code

Нужен ли Homebrew для установки Claude Code?

Нет. Homebrew — один из способов установить Node.js, но не единственный. Можно скачать Node.js напрямую с nodejs.org.

Работает ли Claude Code на M1/M2/M3 Mac?

Да, Claude Code полностью совместим с Apple Silicon (M1, M2, M3). Node.js и npm работают нативно на ARM-архитектуре.

Что делать если claude не найдена после установки?

Добавьте путь npm global bin в переменную PATH. Выполните npm config get prefix и добавьте полученный путь/bin в ~/.zshrc.

Можно ли использовать Claude Code без подписки?

Нет. Нужна подписка Claude Pro ($20/мес) или API-ключ Anthropic. Без авторизации Claude Code установится, но не запустится.

Как обновить Claude Code до новой версии?

Выполните ту же команду установки: npm install -g @anthropic-ai/claude-code. Она автоматически обновит до последней версии.