Установка Claude Code: терминал без страха

Понадобится компьютер: Mac или Windows, любой не древний ноутбук потянет. Если подписки ещё нет — сначала урок 3, без неё агент не запустится. И держи включённым «ТОГО, чьё имя нельзя называть»: для входа в аккаунт он обязателен.

Терминал: что это вообще такое

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

Почему агент живёт именно тут, а не в программе с кнопками? Кнопка умеет ровно одно действие, на которое её запрограммировали. Текст умеет всё: создать файл, запустить программу, поставить другую программу, собрать проект. Агенту нужна свобода действий, и терминал — единственное место, где она полная.

У новичка тут обычно два страха, сниму оба сразу.

• «Я что-нибудь сломаю». Не сломаешь. Команды из этого урока безобидны, а агент, когда заработает, будет спрашивать разрешение перед каждым действием с файлами.
• «Придётся учить язык программистов». Не придётся. Пару команд скопируешь отсюда, а дальше будешь писать агенту обычными русскими фразами.

Открывается терминал так:

• Mac. Нажми Cmd+Space, набери «Терминал» (или Terminal) и жми Enter.
• Windows. Открой «Пуск», набери «PowerShell», Enter. На Windows 11 подойдёт и приложение «Терминал».

Открылось окно, курсор мигает? Набери whoami и нажми Enter. Компьютер ответит именем твоего пользователя. Поздравляю: ты только что отдал первую команду, и ничего не взорвалось.

Шаг 1. Ставим Node.js

Node.js — движок, на котором работают современные веб-проекты. Нам он нужен дважды: его установщик пакетов поставит Claude Code, и на нём же будут крутиться проекты из следующих модулей. Ставится один раз, дальше про него забываешь.

Шаг 2. Ставим Claude Code одной командой

Теперь сам агент. Скопируй в терминал и нажми Enter:

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

Расшифрую, чтобы не было магии. npm — установщик программ, приехал вместе с Node. -g значит «поставить для всей системы, а не одной папки». Дальше имя пакета. Минуту-другую терминал будет сыпать строчками — это нормально, он качает и раскладывает файлы. Потом перезапусти терминал ещё раз и набери claude --version: в ответ придёт номер версии агента.

Шаг 3. Входим в аккаунт

Шаг 4. Папка для проектов

Claude Code работает внутри папки: всё, что агент видит и меняет, живёт в ней. Запускать его где попало — как пустить ремонтную бригаду не в ту квартиру. Заведём агенту дом.

Создай на рабочем столе папку ai-first обычным способом, правой кнопкой мыши. А теперь трюк, который будет служить тебе годами: в терминале набери cd (с пробелом на конце), перетащи папку мышкой прямо в окно терминала и нажми Enter. Команда cd означает «перейти в папку», а перетаскивание само подставило путь к ней. Работает и на Mac, и на Windows.

Правило на будущее: один проект — одна папка. Курсовые эксперименты пусть живут в ai-first, а под каждый настоящий проект заведёшь отдельную. Так агент не будет путаться в чужих файлах.

Ты внутри. Набери claude — агент откроется уже в этой папке. Если при первом запуске он спросит, доверяешь ли ты файлам в папке (trust), соглашайся: папка твоя, ты её только что создал. Проверим, что агент живой:

Ответил — значит, установка удалась. И сразу про выход, а то новички стесняются спросить: команда /exit закрывает агента, а само окно терминала можно просто закрыть крестиком. Ничего не сломается и не потеряется.

Полноценную рабочую сессию проведём в следующем уроке, а пока закрепим фундамент.

Частые проблемы и решения

• «command not found: claude» или «не является командой». В девяти случаях из десяти ты не перезапустил терминал после установки. Закрой окно целиком, открой заново.
• «npm: command not found». Node не установился или терминал опять же не перезапущен. Вернись к шагу 1 и дойди до проверки node -v.
• Mac ругается на права: EACCES, permission denied. Не лечи это через sudo, наживёшь проблем поглубже. Проще взять «родной» установщик с официальной страницы — он ставит без прав администратора.
• Вход не проходит: ошибка или «недоступно в вашем регионе». Это «он». Проверь, что включён и страна не сменилась, попробуй ещё раз в окне инкогнито.
• Выбрал вход через Console по ошибке. Не страшно. Набери в Claude Code команду /login и войди заново, уже по подписке.

Чек-лист: агент живёт у тебя

• Терминал открываешь без мурашек, whoami отвечает.
• node -v показывает версию.
• claude запускается, вход выполнен по подписке, не через Console.
• Папка ai-first создана, умеешь заходить в неё через cd и перетаскивание.
• Агент ответил тебе по-русски.

Финальный промпт урока

Установку руками ты прошёл, теперь пусть агент сам проверит своё новое жильё. Промпт устроен как протокол из пяти шагов: агент сначала изучает, потом докладывает и ждёт, и только после твоего «да» что-то ставит. Запомни сам подход — он пригодится для любой установки в будущем. Вставь в Claude Code в папке ai-first:

Что дальше

Агент установлен и отвечает — пора учиться с ним работать. В уроке «Первый диалог: команды, режимы и первый результат» проведём полноценную сессию: агент создаст файл у тебя на глазах, а ты освоишь команды, которые жмут каждый день. Захочешь забежать вперёд — держи гайд «Claude Code с нуля» с разбором команд и режимов.