Claude Code превращает терминал в среду с AI-парным программированием. Вместо того чтобы копировать код в браузер или переключаться между IDE и чатом, вы запускаете claude прямо в директории проекта — и получаете ассистента который уже знает вашу кодовую базу. Он читает файлы, понимает структуру, правит баги, пишет тесты и делает коммиты.
Разберём как поставить Claude Code на Mac с нуля, три способа установки, как выбрать подходящий и что происходит после первого claude.
Что такое Claude Code
Claude Code — CLI-инструмент от Anthropic, компании создавшей языковую модель Claude. Работает локально в вашем терминале: bash, zsh, любой совместимый shell. При запуске в папке проекта агент сканирует репозиторий, читает структуру директорий и историю git, после чего готов отвечать на вопросы о коде и вносить изменения.
Это не просто чат с кодом. Claude Code может автономно выполнять многошаговые задачи: получить задание, найти нужные файлы, написать код, запустить тесты, исправить ошибки которые появились, и только потом предложить коммит. Разработчик утверждает, одобряет или просит скорректировать каждый шаг.
Текущая актуальная версия — 2.x. Выходит на macOS (10.15+, Intel и Apple Silicon), Linux и Windows через WSL.
Что нужно перед установкой
Аккаунт Anthropic с оплатой. Бесплатный план Claude.ai для Claude Code не работает. Нужна одна из платных опций:
- Claude Pro — $20/месяц. Достаточно для большинства разработчиков: личные проекты, фриланс, работа с одним репозиторием.
- Claude Max — $100 или $200/месяц. Для тех кто работает с Claude Code несколько часов в день или гоняет его в CI/CD пайплайнах.
- Anthropic Console — прямой API-доступ. Платите за токены, нет фиксированной подписки. Подходит для автоматизации и команд которые хотят контролировать расход через API.
Железо и ОС. macOS 10.15 Catalina или новее. Работает на Intel и Apple Silicon без дополнительных шагов. Минимум 4 GB RAM, рекомендуется 8 GB+ для комфортной работы с большими проектами. Около 200–300 MB на диске.
Git. Не строго обязателен, но без него Claude Code не видит историю коммитов и теряет часть контекста о проекте. Устанавливается через Xcode Command Line Tools:
xcode-select --install
Три способа установки
Способ 1: Нативный установщик (один curl — и готово)
Anthropic рекомендует именно этот способ. Нет зависимостей, нет конфликтов с Node.js, автообновление в фоне без вашего участия. Бинарник подписан Anthropic и нотаризован Apple — Gatekeeper не будет жаловаться.
curl -fsSL https://claude.ai/install.sh | bash
Скрипт устанавливает бинарник в ~/.local/bin/ и прописывает путь в ~/.zshrc. После завершения:
source ~/.zshrc
claude --version
Если видите номер версии — установка прошла. Дальше — авторизация.
Способ 2: Homebrew
Если вы уже используете Homebrew для управления инструментами на Mac:
brew install --cask claude-code
Работает корректно, но автообновление отключено. Новые версии нужно устанавливать вручную командой brew upgrade claude-code. Если забываете обновлять инструменты — нативный установщик удобнее.
Способ 3: npm (устарел, но поддерживается)
Anthropic продолжает поддерживать npm-установку, но считает её устаревшей. Используйте только если вам нужно зафиксировать конкретную версию или вы в среде где npm — стандарт.
Требование: Node.js 18+. Установить через nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.zshrc
nvm install 22 && nvm use 22
Затем:
npm install -g @anthropic-ai/claude-code
Запрет на sudo: никогда не пишите sudo npm install -g. Это ломает права на npm-директорию. Если видите ошибку EACCES — настройте prefix вместо sudo:
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Авторизация
Первый запуск claude в любой директории открывает браузер для авторизации через OAuth. Входите в свой Claude.ai аккаунт, подтверждаете — и токен сохраняется локально в ~/.claude/config.json.
Токен действует 30 дней без использования. Если работаете в среде без браузера (удалённый сервер, Docker):
claude auth login --headless
Терминал покажет URL — открываете его вручную, авторизуетесь, вводите код обратно в терминал.
Для работы через API-ключ:
export ANTHROPIC_API_KEY=sk-ant-ваш-ключ
Добавьте в ~/.zshrc чтобы ключ загружался автоматически.
Команда для диагностики всего:
claude doctor
Покажет: статус авторизации, версию, состояние PATH, проблемы с конфигурацией. Это первое что нужно запустить если что-то не так.
Первый проект
Переходите в любую папку с кодом:
cd ~/Projects/my-app
claude
Claude Code за несколько секунд сканирует репозиторий и открывает интерактивный режим в терминале. Можно сразу спрашивать:
> как устроена система аутентификации в этом проекте?
> где обрабатываются ошибки API?
> добавь логирование в функцию createOrder
Для одиночных задач без интерактивного режима:
claude -p "напиши unit-тесты для модуля payment.js"
Файл CLAUDE.md: контекст который запоминается
Создайте в корне проекта файл CLAUDE.md — Claude Code читает его при каждом запуске. Здесь описываете всё что агент должен знать: как запускать проект, архитектурные решения, соглашения по коду.
## Как запускать
- `npm run dev` — dev-сервер на 3000 порту
- `npm test` — тесты через Jest
- `npm run lint` — ESLint
## Стек
- Next.js 15, App Router
- PostgreSQL + Prisma
- Авторизация: NextAuth.js
## Правила
- TypeScript strict, `any` запрещён
- Компоненты: server by default, `use client` только при необходимости
- Коммиты на английском, imperative mood
CLAUDE.md коммитится в репозиторий — все участники команды получают одинаковый контекст.
Частые проблемы
command not found: claude — PATH не обновился в текущей сессии. Выполните source ~/.zshrc или откройте новую вкладку терминала. Если не помогает — проверьте что в ~/.zshrc есть строка с путём к claude.
Gatekeeper блокирует запуск — нативный бинарник нотаризован Apple и блокироваться не должен. Если блокирует — скорее всего старая npm-версия. Переустановите нативным установщиком.
Claude Code долго думает на старте — большой проект с node_modules или тяжёлый .git. Создайте .claudeignore в корне (синтаксис как у .gitignore) и исключите лишнее:
node_modules/
dist/
build/
.next/
*.log
EACCES при npm install — не используйте sudo. Настройте npm prefix через mkdir -p ~/.npm-global && npm config set prefix '~/.npm-global'.
Ресурсы:
- Официальная документация Claude Code
- Подписка Claude Pro и Max
- Anthropic Console
- npm: @anthropic-ai/claude-code
FAQ:
Работает ли Claude Code на M1/M2/M3/M4?
Да. Нативный бинарник скомпилирован для arm64, работает без Rosetta 2.
Можно ли использовать бесплатный Claude.ai?
Нет. Claude Code требует платный план — минимум Claude Pro за $20/мес.
Нужен ли Node.js?
Только для npm-способа установки (устаревший). Нативный установщик и Homebrew — без зависимостей.
Как обновить Claude Code?
Нативный установщик обновляется автоматически в фоне. Homebrew — brew upgrade claude-code. npm — npm update -g @anthropic-ai/claude-code.
Мой код куда-то отправляется?
В Anthropic уходят запросы к модели с тем контекстом который вы явно добавляете в запрос. Файлы проекта не передаются автоматически целиком — только то что агент явно включает в запрос при выполнении задачи.
