Старт

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

Aleksei | Claude Code без воды

Алексей · 8 мин чтения · обновлено 13 июля 2026

Скопируй страницу и вставь в Claude или GPT — разберёт под твою задачу.

Claude Code ставится в терминал одной командой — и дальше работает прямо у тебя на машине: понимает задачу словами, читает твои файлы, пишет код, запускает команды. Никакого сложного окружения поднимать не нужно. В этом гайде пройдём весь путь по шагам: что приготовить, как поставить, как первый раз войти и какую команду дать сразу, чтобы почувствовать инструмент.

Короткий ответ

Ставишь Claude Code нативным установщиком — одна строка в терминал, Node.js для этого не нужен. Потом заходишь в папку проекта, запускаешь командой claude и при первом старте логинишься: подпиской Anthropic (Pro/Max) или API-ключом. Главная команда установки на macOS и Linux:

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

После этого в любой папке доступна команда claude — с неё и начинается работа.

Что понадобится

Терминал. Обычное окно, куда ты пишешь команды текстом. Есть на любой системе: на macOS — «Терминал», на Linux — «Terminal» или «Консоль», на Windows — PowerShell. Знать сотни команд не нужно, для старта хватит открыть терминал и нажать Enter.
Node.js 18+ — только для установки через npm. Если пойдёшь нативным установщиком (рекомендованный путь), Node не нужен вообще. Он пригодится, лишь когда ты сознательно выберешь способ через npm.
Аккаунт Anthropic. Сам инструмент бесплатный, но мозги ему даёт модель Claude, а к ней нужен доступ: либо платная подписка (Pro или Max), либо API-ключ. Заведи аккаунт заранее, чтобы на шаге входа не отвлекаться.

Установка

Способов несколько, но суть одна — одна команда в терминал. Начни с нативного установщика, остальные бери, только если тебе так привычнее.

Нативный установщик (рекомендованный). Node.js не требуется, инструмент дальше сам обновляется в фоне. На macOS и Linux вставь в терминал:

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

Жмёшь Enter, установщик скачивает Claude Code и раскладывает файлы — через минуту команда claude готова. Если по ходу мелькают строки с warning, обычно это нормально: важна итоговая строка об успешной установке.

Через npm (кроссплатформенно). Если Node.js у тебя и так стоит и привычный процесс крутится вокруг npm, можно поставить так — нужен Node версии 18 или выше:

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

Это единственный способ, которому реально нужен Node. npm тут — просто канал доставки, сама команда claude потом работает не на Node. Не живёшь в npm — бери нативный установщик выше, он проще.

macOS через Homebrew. Если ты уже пользуешься Homebrew, установка укладывается в одну строку:

brew install --cask claude-code

Windows. Под Windows у Claude Code есть собственный установщик, который запускается из PowerShell. Точную команду не выдумывай — она может меняться, а гадать с командами установки не стоит. Открой официальную документацию Anthropic (разделы Installation / Setup на docs.claude.com или code.claude.com/docs) и возьми актуальную строку оттуда. Это источник, который не устаревает.

После установки проверь, что всё встало. Версия:

claude --version

И диагностика установки — покажет, что и как поставилось, и подсветит проблемы, если они есть:

claude doctor

Команды выше — официальные и стабильные, их можно вставлять как есть. Если что-то пошло не так или хочется свериться, полный список способов установки и системные требования всегда лежат в официальной документации Claude Code. За точными строками под свою систему возвращайся туда, а не в случайную инструкцию из интернета.

Первый запуск и вход

Claude Code работает в контексте папки — той, из которой ты его запустил. Он видит файлы внутри неё и относится к ней как к рабочему пространству. Поэтому сначала перейди в папку своего проекта (или создай пустую для тренировки), а уже потом запускай:

cd ~/projects/my-first-project
claude

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

Подписка Anthropic (Pro или Max). Откроется браузер, ты входишь в свой аккаунт через OAuth, подтверждаешь — и возвращаешься в терминал уже авторизованным.
API-ключ. Отдельный режим с оплатой за использование: подключаешь ключ из своего аккаунта Anthropic.

Разница простая. Подписка — фиксированная цена за месяц с лимитами, удобна для регулярной ежедневной работы. API-ключ тарифицируется за токены и хорош под автоматизацию и точечные интеграции. Точные цены и лимиты смотри на сайте Anthropic — они меняются, и выдумывать их я не буду.

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

Первая рабочая команда

Агент запустился и поздоровался — теперь можно им пользоваться. С чего начать:

/init — Claude Code осматривает твой проект и генерирует стартовый файл CLAUDE.md: краткое описание структуры, стека и правил. Дальше агент читает его в каждой сессии и лучше понимает, с чем работает.
/help — показывает список доступных команд, если хочешь осмотреться.
Дальше — обычными словами. Не нужно учить синтаксис: ставишь задачу человеческим языком, по-русски или по-английски. «Расскажи, что лежит в этой папке», «создай тестовый файл» — Claude поймёт и сделает.

Совет: в новом проекте первым делом запусти /init. Это 30 секунд, а сгенерированный CLAUDE.md окупается всю сессию — агент перестаёт гадать про структуру проекта и сразу работает по делу.

Claude Code стоит и слушается — дальше вопрос уже не установки, а внедрения: куда его вообще применить в работе и жизни, чтобы он экономил часы, а не пылился. Пошаговый маршрут — в гайде как внедрить AI-агентов в работу и жизнь. Свежие гайды и находки по Claude Code кидаю в Telegram-канал.

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

Симптом	Причина	Что сделать
`claude: command not found` после `npm install`	Глобальная папка npm не прописана в `PATH`	Проще всего — поставить нативным установщиком (`curl … install.sh \| bash`). Или поправить `PATH` / npm prefix так, чтобы глобальные пакеты были видны
`EACCES` / permission denied при `npm install -g`	Нет прав на запись в глобальную папку npm	Ставь нативным установщиком — `curl … install.sh \| bash` кладёт файлы к тебе и обходит проблему с правами
Запустился, но требует войти	Не завершён вход — нет доступа к модели	Пройди авторизацию до конца командой `/login`: подписка через браузер или API-ключ
Ругается на старую версию Node	Способ через npm требует Node 18 или выше	Обнови Node до 18+ либо просто поставь нативным установщиком, которому Node не нужен
Не уверен, что установка целая	Что-то встало наполовину или конфликтует	Запусти `claude doctor` — диагностика покажет состояние установки и подскажет, что чинить

FAQ

Нужно ли уметь программировать, чтобы поставить?

Нет. Установка — это одна команда в терминал: вставляешь готовую строку, жмёшь Enter. Писать код на этом шаге не требуется, всё дальнейшее агент делает сам.

Подписка или API-ключ — что выбрать?

Для живой ежедневной работы почти все берут подписку: цена предсказуемая, фиксированная за месяц. API-ключ имеет смысл, если нужен точечный доступ с оплатой по токенам — под автоматизацию и разовые интеграции. Начинаешь знакомиться с инструментом — подписка проще и спокойнее по деньгам.

Работает ли на Windows?

Да. У Claude Code есть собственный установщик под Windows, который запускается из PowerShell. Точную команду возьми в официальной документации Anthropic — там всегда актуальная строка под твою систему.

Обязателен ли Node.js?

Нет. Нативный установщик и Homebrew ставят инструмент без Node. Node версии 18+ нужен только тем, кто сознательно выбирает способ через npm.

Что ты увидишь

После установки проверь версию — должен выйти номер, а не ошибка «command not found»:

$ claude --version
2.1.199 (Claude Code)

Итог

Claude Code ставится одной командой в терминал: нативный установщик curl -fsSL https://claude.ai/install.sh | bash (без Node), через npm install -g @anthropic-ai/claude-code (нужен Node 18+), через brew install --cask claude-code на macOS, а под Windows — своим установщиком по официальной доке. Проверяешь установку через claude --version и claude doctor, запускаешь claude в папке проекта, логинишься подпиской или ключом (/login) и первым делом делаешь /init. Дальше ставишь задачи человеческим языком.

Но мощность Claude Code раскрывается не в том, что он установлен, а в том, как ты с ним разговариваешь. В следующем гайде — как объяснять задачу, чтобы агент делал именно то, что нужно, а не то, что ты случайно попросил.