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

Обновление, август 2026

Урок переписан: Claude Code больше не требует ни Node.js, ни API-ключа. Ставится он одной командой, а вход — обычным аккаунтом claude.ai по подписке. Старый путь (npm + ключ из Console) остался как вариант для тех, кто платит за API по факту.

Почему это важно именно вам

Установка — это тот этап, где большинство людей либо застревают на первом же сообщении об ошибке, либо делают что-то лишнее и потом не понимают, что сломалось. Этот урок написан так, чтобы вы прошли от нуля до работающей команды за одну сессию — без лишних шагов и без «а теперь разберитесь сами».

Один момент стоит понять сразу — про деньги. У Claude Code два способа доступа, и выбирать между ними нужно один раз. Первый: подписка Claude (Pro, Max, Team или Enterprise) — та же самая, по которой вы работаете с Claude в браузере. Вход — обычным аккаунтом claude.ai, отдельно платить за терминал не нужно, расходуется лимит вашего тарифа. Второй: доступ через Claude Console с оплатой по факту использования, тогда нужен API-ключ и баланс на счету.

Для директора, который уже платит за подписку, правильный ответ почти всегда первый: подписка. Ключ из Console нужен, если вы разворачиваете что-то на сервере, работаете от имени компании или хотите платить строго по потреблению.

После этого урока у вас будет работающий инструмент и первый ответ из терминала. Дальше — только практика.

Что это такое

Установка Claude Code состоит из двух шагов: поставить программу и войти в свой аккаунт.

Раньше для установки требовалась платформа Node.js и менеджер пакетов npm — это было главным препятствием для тех, кто не программирует. Сейчас это не нужно: есть установщик, который кладёт готовую программу и дальше обновляет её сам.

Вход — как в любом сервисе: команда открывает браузер, вы подтверждаете вход своим аккаунтом claude.ai, возвращаетесь в терминал. Никаких ключей копировать не надо.

Как работает на практике

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

macOS и Linux — одна команда в терминале:

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

Такая установка дальше обновляется сама в фоне — вы всегда на свежей версии.

Через Homebrew (если вы им пользуетесь):

brew install --cask claude-code

У этого способа есть нюанс: он не обновляется автоматически. Раз в пару недель нужно самому выполнять brew upgrade claude-code. Забытое обновление — самая частая причина, почему у человека «нет» возможностей, описанных в документации.

Windows — в PowerShell:

irm https://claude.ai/install.ps1 | iex

Проверьте, что установилось:

claude --version

Должен появиться номер вида 2.1.x. Если появился — всё в порядке.

Если у вас старая установка через npm

Ставили раньше командой npm install -g @anthropic-ai/claude-code? Она продолжает работать, обновляется через npm install -g @anthropic-ai/claude-code@latest. Переходить на новый установщик не обязательно, но с ним меньше хлопот: не нужен Node.js и обновления идут сами.

Шаг 2. Вход в аккаунт

Запустите:

claude

При первом запуске откроется браузер с формой входа. Войдите тем же аккаунтом claude.ai, по которому пользуетесь Claude — подписка Pro, Max, Team или Enterprise. После входа в терминале появится Login successful.

Если браузер не открылся сам, нажмите c — ссылка скопируется в буфер, вставьте её в браузер вручную. Если после входа браузер показал код вместо возврата в терминал — вставьте этот код в терминале в поле Paste code here if prompted (так бывает при работе по SSH и в контейнерах).

Сменить аккаунт позже: команда /logout внутри сессии, дальше вход заново.

Что значит «работаю по подписке»

Вы не платите за терминал отдельно и не следите за балансом в долларах. Расходуется лимит вашего тарифа — тот же, что и в браузере. Проверить, чем вы вошли и сколько осталось, можно командами /status и /usage внутри сессии.

Шаг 3 (только для Console). API-ключ

Пропустите этот шаг, если вошли по подписке — он вам не нужен.

Ключ нужен, когда вы платите по факту использования через Claude Console или разворачиваете Claude Code на сервере:

Перейдите на platform.claude.com
Раздел API Keys → Create Key
Скопируйте ключ (начинается с sk-ant-) — он показывается один раз
Пополните баланс: Billing → Add Credits

Ключ задаётся переменной среды:

export ANTHROPIC_API_KEY="sk-ant-ваш-ключ"

Если эта переменная установлена, Claude Code не будет предлагать вход через браузер, а попросит подтвердить ключ. Чтобы вернуться к работе по подписке — уберите переменную и выполните /login.

Шаг 4. Первый запрос

В открывшейся сессии просто напишите словами, без кавычек и без специального синтаксиса:

Напиши короткое приветствие на русском языке от имени умного ассистента директора.

Если получили ответ — установка прошла успешно.

Как выйти из интерактивного режима

Нажмите Ctrl+C или введите /exit.

Частые ошибки

Ошибка 1. claude: command not found после установки

Терминал ещё не знает про новую команду. Закройте терминал и откройте заново — переменная PATH обновится. Если не помогло, проверьте, куда установилась программа: ls ~/.local/bin/claude (нативная установка) или brew list claude-code (Homebrew).

Ошибка 2. Вход не проходит: браузер открылся, но терминал ничего не ждёт

Так бывает при работе по SSH, в контейнерах и в WSL2: браузер не может достучаться обратно до терминала. Тогда браузер показывает код — вставьте его в терминале в поле Paste code here if prompted.

Ошибка 3. Просит API-ключ, хотя у вас подписка

Значит, в вашем окружении установлена переменная ANTHROPIC_API_KEY — Claude Code видит её и пропускает вход через браузер. Проверьте echo $ANTHROPIC_API_KEY; если она задана в ~/.zshenv или ~/.zshrc и вам не нужна — уберите строку, перезапустите терминал и выполните /login.

Ошибка 4. Возможностей из документации нет, а версия старая

Проверьте claude --version. При установке через Homebrew обновления не приходят сами — нужно brew upgrade claude-code. Отставание на пару месяцев означает, что половины описанного у вас действительно нет.

Ошибка 5. Ответ на английском языке

По умолчанию Claude отвечает на языке запроса. Пишите на русском — получите ответ на русском. В будущих уроках разберём, как зафиксировать язык через CLAUDE.md.

Когда нужно / когда нет

Этот урок — разовая установка. После неё Claude Code работает как любая другая команда: вводите claude и работаете.

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

нативная установка (install.sh) — обновляется сама в фоне;
Homebrew — вручную: brew upgrade claude-code;
старая установка через npm — npm install -g @anthropic-ai/claude-code@latest.

Проверить версию: claude --version.

Связь с другими уроками

День 1 — зачем вообще Claude Code: если пропустили, прочитайте перед тем как устанавливать
День 3 — интерактивный режим vs headless: первые шаги после установки
День 8 — режимы разрешений: важно понять до того, как начнёте работать с файлами

Задание на сегодня

Установите Claude Code, войдите своим аккаунтом и выполните один реальный запрос — не тестовый «привет», а что-то из настоящей работы.

Установите программу и проверьте claude --version.
Запустите claude, войдите через браузер, дождитесь Login successful.
Выполните /status — убедитесь, что вошли подпиской, а не ключом.
Напишите прямо в сессии, обычным текстом:

напиши шаблон письма партнёру с благодарностью за встречу
и предложением продолжить сотрудничество

Критерий «выполнено»: в терминале есть ответ на русском по вашему запросу, а /status показывает вашу подписку.

Резюме

Установка — одна команда: curl -fsSL https://claude.ai/install.sh | bash (macOS/Linux) или brew install --cask claude-code. Node.js и npm больше не нужны.
Вход — обычным аккаунтом claude.ai по вашей подписке (Pro, Max, Team, Enterprise): claude → браузер → Login successful.
API-ключ нужен только при оплате по факту через Claude Console или на сервере; при работе по подписке он не требуется.
Если переменная ANTHROPIC_API_KEY задана в окружении, Claude Code спросит ключ вместо входа через браузер — уберите её, если работаете по подписке.
Нативная установка обновляется сама, Homebrew — нет: brew upgrade claude-code раз в пару недель.
/status показывает, чем вы вошли; /logout меняет аккаунт.