Claude Code на Mac: установка и подключение из России

Чтобы запустить Claude Code на Mac из России, установите его через npm, Homebrew или официальный установщик, затем добавьте ключ и адрес API в ~/.zshrc. Сама установка — только половина дела: без подходящего доступа программа не сможет обратиться к моделям. Ключ можно получить в AI для кода от PurpleSchool: без VPN и с оплатой в рублях.

Инструкция подходит для Mac на Apple Silicon и Intel. Версия для другой системы — в статье Claude Code на Windows.

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

По официальной документации Claude Code работает на macOS 13 или новее. Откройте приложение «Терминал» и проверьте систему:

sw_vers -productVersion

Для установки через npm нужен Node.js 22 или новее:

node -v

Если команда не найдена или версия старше 22, поставьте актуальную версию с официального сайта Node.js или через Homebrew:

brew install node

Шаг 1. Установите Claude Code

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

npm:

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

Не используйте sudo. Документация предупреждает, что глобальная установка через sudo npm install -g может привести к проблемам с правами и безопасностью.

Homebrew:

brew install --cask claude-code

Такая установка не обновляется автоматически, поэтому время от времени выполняйте brew upgrade --cask claude-code.

Официальный установщик:

curl -fsSL https://claude.ai/install.sh | bash

Он обновляет программу сам. Если загрузка из вашей сети не проходит, используйте npm или Homebrew.

Проверьте результат:

claude --version

Шаг 2. Получите ключ

Сайт claude.ai и API Anthropic из России недоступны, поэтому обычный вход не подойдёт. Зарегистрируйтесь в AI для кода, выберите тариф и скопируйте ключ из кабинета. Тарифы начинаются от 499 ₽ в месяц.

Настройку можно сделать одной командой:

npx @purpleschool/ai-for-code

Программа сама пропишет ключ и адрес в установленные инструменты. Если выбрали этот путь, переходите к шагу 4.

Шаг 3. Добавьте переменные в zsh

В macOS по умолчанию используется оболочка zsh, а её настройки находятся в ~/.zshrc. Откройте файл:

nano ~/.zshrc

Добавьте в конец две строки, подставив свой ключ:

export ANTHROPIC_API_KEY="ваш ключ"
export ANTHROPIC_BASE_URL="https://app.purpleschool.ru/api-v2/public/ai-proxy/anthropic"

Сохраните файл сочетанием Ctrl+O, нажмите Enter и выйдите через Ctrl+X. Затем примените настройки:

source ~/.zshrc

Адрес указывается без /v1 на конце.

Шаг 4. Запустите и проверьте

Перейдите в папку проекта и запустите программу:

cd ~/projects/my-app
claude

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

/status

Команда покажет активный способ входа. Для быстрой проверки в обычном терминале выполните:

claude -p "Ответь одним словом: ок" --model claude-haiku-5-5

Этот запрос мы проверили на macOS через адрес PurpleSchool.

Частые проблемы на Mac

zsh: command not found: claude. Терминал не видит установленную программу. Откройте новое окно. Если не помогло, узнайте каталог глобальных пакетов npm:

npm config get prefix

К полученному пути добавьте /bin и пропишите его в ~/.zshrc. Например:

export PATH="$HOME/.npm-global/bin:$PATH"

Для официального установщика обычно нужно добавить каталог ~/.local/bin:

export PATH="$HOME/.local/bin:$PATH"

EACCES при установке через npm. Не хватает прав на глобальный каталог. Не исправляйте это через sudo: настройте каталог в домашней папке или используйте Homebrew.

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

Затем добавьте ~/.npm-global/bin в PATH, как показано выше.

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

echo $ANTHROPIC_BASE_URL

Если вывод пустой, строки не попали в ~/.zshrc или файл не был перечитан. Подробнее о порядке выбора ключа и подписки — в статье Claude Code по API-ключу.

Ключ работает в «Терминале», но не в VS Code. Приложения, запущенные из Dock, могут не видеть настройки ~/.zshrc. Для расширения задайте переменные в его настройках, как описано в статье Claude Code в VS Code.

401, 402 или 404. Это ответы API: неверный ключ, закончившийся баланс или неверный ID модели соответственно.

Другие сценарии разобраны в материале Claude Code не запускается.

Как обновить и удалить

Обновление зависит от способа установки:

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

brew upgrade --cask claude-code

Удаление через npm:

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

Удаление через Homebrew:

brew uninstall --cask claude-code

После удаления уберите строки с ключом из ~/.zshrc.

Частые вопросы

Отличается ли установка на Apple Silicon и Intel? Команды одинаковые.

Нужен ли VPN? С ключом PurpleSchool для запросов к моделям VPN не нужен. Сеть может влиять только на скачивание самой программы.

Можно ли использовать подписку Claude? Сайт и приложения Claude недоступны из России, поэтому этот способ не подходит.

Как выбрать модель? Передайте её при запуске, например claude --model claude-sonnet-5-5, или используйте команду /model внутри сессии.

Можно ли попробовать бесплатно? Новым аккаунтам с почтой из белого списка доступен пробный баланс на 500 000 токенов на 7 дней.

Итог

На Mac нужны три действия: установить Claude Code, получить ключ и добавить две строки в ~/.zshrc. Проверить результат можно одной командой. Ключ для работы из России выдаёт AI для кода от PurpleSchool, и он подойдёт также для VS Code, Cursor и других инструментов.