Гайд по установке
Установка · macOS

Claude Code
на Mac

5 шагов через nvm и Z.AI. 15–25 минут.

15–25 мин на установку
macOS 12 Monterey или новее
Помощь в чате поддержка курса
Прокрути вниз
Шаг 1 из 5
01
Подготовка

Подготовь Mac

Сначала открой Терминал — это приложение, куда мы будем вводить команды. Ничего страшного, это просто текстовый чат с компьютером.

  • Нажми Cmd + Space — откроется Spotlight (поиск)
  • Набери Terminal латиницей (или «Терминал» по-русски) и нажми Enter
  • Проверь версию macOS: меню Apple (левый верхний угол) → Об этом Mac

Нужна macOS 12 (Monterey) или новее. Если версия ниже — обнови Mac через Системные настройки → Обновление ПО. Это займёт время, но потом всё заработает.

Шаг 2 из 5
02
Платформа

Установи Node.js через nvm

Node.js — среда, на которой работает Claude Code. Ставим через nvm (Node Version Manager) — официальная рекомендация Z.AI. nvm ставит Node в твою домашнюю папку, не ломает права npm install -g.

2.1 — Поставь Xcode Command Line Tools
$ 
xcode-select --install
Что произойдёт
Откроется диалог Apple → нажми «Установить» → дождись окончания (5–10 минут). Без этого nvm и npm не работают.
2.2 — Скачай и установи nvm
$ 
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
2.3 — Активируй nvm в текущей сессии
$ 
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
Зачем
Эти две строки nvm-инсталлятор добавляет в ~/.zshrc, но в уже открытом терминале они не активны. Команда выше включает nvm здесь и сейчас, не перезапуская окно.
2.4 — Поставь и активируй Node.js LTS
$ 
nvm install --lts
nvm use --lts
Проверка
$ 
node --version
Ожидаемый результат
v20.x.x (или v22.x.x)

Если пишет «command not found: nvm» — выполни команду 2.3 ещё раз (это включает nvm в текущей сессии), либо закрой Терминал и открой заново. Если после нового окна снова не работает — проверь что в файле ~/.zshrc есть строка export NVM_DIR=...: cat ~/.zshrc | grep nvm.

Шаг 3 из 5
03
Установка

Установи Claude Code

Теперь ставим сам Claude Code. Открой Терминал и введи одну команду:

Терминал
$ 
npm install -g @anthropic-ai/claude-code
Проверка
$ 
claude --version
Ожидаемый результат
1.x.x (или похожее)

Если видишь ошибку permission denied — добавь sudo в начало:
sudo npm install -g @anthropic-ai/claude-code
Терминал попросит пароль от Mac — введи его (символы не отображаются, это нормально).

Шаг 4 из 5
04
Подключение

Подключи Z.AI

Корпоративная подписка GLM Coding Plan — даёт 3× больше лимитов, чем обычная подписка. API-ключ (формат sk-...) получи у организатора курса. Под капотом будут модели GLM-4.7 (замена Sonnet/Opus) и GLM-4.5-Air (замена Haiku). В интерфейсе всё равно увидишь «Claude» — это норма.

A

Автоскрипт — рекомендуем

Скрипт сам создаст ~/.claude/settings.json с нужными переменными. Попросит вставить ключ — вставь.

$ 
curl -O "https://cdn.bigmodel.cn/install/claude_code_zai_env.sh" && bash ./claude_code_zai_env.sh
B

Вручную — через settings.json

Создай файл если нет, открой в текстовом редакторе и вставь:

Создать файл если нет
$ 
mkdir -p ~/.claude && touch ~/.claude/settings.json
~/.claude/settings.json 
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "ТВОЙ_КЛЮЧ_Z.AI",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "API_TIMEOUT_MS": "3000000"
  }
}

Если уже логинился через claude /login — настройка Z.AI перебивает её. Это нормально, мы используем именно Z.AI.