В Telegram-канале - что нового в вайб-кодинге: инструменты, находки, ошибки. Подпишись.
Что такое Claude Code и зачем он в терминале?
Терминал пугает почти всех, кто пришёл в вайб-кодинг не из разработки. Выглядит как чёрное окно из фильмов про хакеров, а на деле это просто строка, куда ты пишешь команды. Для Claude Code она нужна ровно затем, чтобы он мог сам открывать твои файлы, менять их и запускать проверки, пока ты диктуешь задачу словами.
Anthropic описывает продукт так.
Claude Code - агентный инструмент для кодинга, который живёт прямо в терминале, понимает твой код и ускоряет работу: берёт на себя рутинные задачи, объясняет сложные места и ведёт git-процессы - и всё это обычными командами на человеческом языке.
Разница с привычным чатом простая. В браузере ты копируешь код руками: туда-сюда, из окна в редактор и обратно. Claude Code сам лезет в папку проекта, читает нужные файлы, вносит правку и показывает, что изменил. Ты остаёшься тем, кто решает и подтверждает, а механическую работу он делает за тебя.
Если терминал совсем не хочется трогать - у Anthropic есть приложение для компьютера с обычным окном и веб-версия на claude.ai/code, которая запускается прямо в браузере. Но самый мощный и гибкий вариант - именно версия для терминала, о ней и весь материал.
Где официальный сайт Claude Code и что качать?
Первая путаница у новичка - где вообще официальный сайт Claude Code и что нажимать, чтобы скачать. Свожу все официальные адреса Anthropic в одну таблицу, чтобы ты не гадал.
| Адрес | Что это |
|---|---|
claude.com/product/claude-code | Продуктовая страница: описание, ссылки на установку |
code.claude.com | Сайт продукта: демо, цены, детали |
code.claude.com/docs | Официальная документация: установка, первый запуск, ошибки |
claude.ai/code | Веб-версия Claude Code прямо в браузере |
github.com/anthropics/claude-code | Официальный репозиторий |
@anthropic-ai/claude-code | Официальный пакет в npm |
С сайта ты не качаешь установочный файл, как обычную программу, - и это ломает привычное ожидание. Установка идёт командой в терминале, а она уже сама скачивает нужную версию под твою систему. Дальше в материале - точные команды под Mac, Windows и Linux.
Отдельная ловушка - написание названия: его часто вбивают с ошибкой как clode code, clade code, слод код, clode design. Продукт называется Claude Code, через au. Держи это в голове, когда ищешь официальный сайт: похожие по написанию домены - чужие.
Про имя пакета в npm тоже стоит знать точно. Канонический пакет - @anthropic-ai/claude-code, с префиксом @anthropic-ai/. Короткое имя claude-code без префикса Anthropic держит сам - это их официальный указатель на тот же пакет. Ориентир простой: издатель должен быть Anthropic, а рабочее имя для установки - с префиксом.
Что нужно для установки: требования к компьютеру
Требования у Claude Code скромные: тяжёлую работу берут на себя серверы Anthropic, твоя машина только шлёт запросы и получает ответы.
| Что | Требование |
|---|---|
| macOS | 13.0 и новее |
| Windows | 10 (сборка 1809) и новее, напрямую или через WSL |
| Linux | Ubuntu 20.04+, Debian 10+, Alpine 3.19+ |
| Память | 4 ГБ и больше (для самой установки хватает ~512 МБ свободных) |
| Процессор | x64 или ARM64 |
| Сеть | постоянный доступ в интернет |
| Оболочка | Bash, Zsh, PowerShell или CMD |
Отдельно про Node.js, потому что вокруг него больше всего мифов. Нативному установщику - тому, что рекомендует сама Anthropic - Node.js не нужен совсем: ставится один самостоятельный файл. Node.js требуется только если ты ставишь Claude Code через npm, и там нужна версия 22 или новее. Старые статьи пишут «Node 18 и выше» - это устарело, ориентируйся на 22+.
Терминал нужен для основной версии. Кто терминал видеть не хочет - ставит приложение для компьютера с обычным окном или работает в веб-версии claude.ai/code. Функционально мощнее всё же версия для терминала, поэтому дальше разбираю установку именно её.
Поставить Claude Code - это взять инструмент в руки. Но сам по себе он часто галлюцинирует: забывает твой проект, придумывает то, чего нет, теряет нить на середине задачи. Стабильным его делает связка из трёх вещей - ИИ-клон, Второй мозг и контекст-инжиниринг. На практикуме за три вечера собираешь все три - те самые три кита, без которых ИИ галлюцинирует.
Как установить Claude Code на macOS?
Открой Терминал (он есть в Mac из коробки: Spotlight по Cmd+Space, набери «Терминал») и вставь одну строку:
curl -fsSL https://claude.ai/install.sh | bashКоманда скачивает установщик с официального адреса Anthropic и ставит Claude Code. Node.js при этом не нужен. Нативный способ удобен ещё и обновлениями.
Нативная установка сама обновляется в фоне и держит тебя на последней версии.
Если ты уже пользуешься Homebrew, есть второй путь:
brew install --cask claude-codeРазница между ними в обновлениях: нативный установщик обновляется сам, а Homebrew - нет, его придётся обновлять руками командой brew upgrade claude-code. Программа внутри ставится одна и та же, так что выбирай по привычке. Не уверен - бери первый способ.
Как установить Claude Code на Windows?
Сначала пойми, где ты находишься. В Windows две оболочки, и команда для каждой своя. Открой окно и посмотри на начало строки: PS C:\> - это PowerShell, а просто C:\> без PS - командная строка (CMD).
Для PowerShell (проще всего его и открыть - правый клик по кнопке «Пуск», «Терминал»):
irm https://claude.ai/install.ps1 | iexДля командной строки (CMD):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdЕсть и третий вариант - через встроенный менеджер пакетов WinGet:
winget install Anthropic.ClaudeCodeAnthropic советует заранее поставить Git for Windows. Тогда Claude Code сможет пользоваться Bash для своих команд. Без него он работает через PowerShell, но с Git многие вещи идут ровнее.
Кто уже держит рабочее окружение в WSL (Linux внутри Windows) - ставит Claude Code той же командой, что и на Linux, прямо внутри WSL. Про WSL есть отдельная тонкость с Node - разберу её ниже, в частых ошибках.
Как установить Claude Code на Linux?
Базовый способ на любом популярном дистрибутиве - тот же самодостаточный установщик:
curl -fsSL https://claude.ai/install.sh | bashNode.js не требуется, программа приходит одним файлом и дальше обновляется сама.
Кто привык ставить программы только через системный менеджер пакетов, может подключить официальные репозитории Anthropic: apt для Debian и Ubuntu, dnf для Fedora и RHEL, apk для Alpine. Они подписаны ключом, есть стабильный и свежий каналы. Для новичка это перебор, поэтому подробности оставляю в документации из блока источников, а по умолчанию советую команду выше.
Одна засада бывает на дешёвых серверах. Если у машины совсем мало свободной памяти, установка может оборваться со словом Killed (код 137) - это система убила процесс из-за нехватки памяти. Лечится добавлением файла подкачки (swap): для установки Claude Code нужно около 512 МБ свободной памяти.
Как запустить Claude Code в первый раз?
Первый запуск занимает пару минут. Порядок такой.
Зайди в папку проекта
В терминале командойcd путь-к-проектуперейди в папку, с которой хочешь работать, и набериclaude.Войди в аккаунт
Откроется браузер с окном входа. Если он не открылся сам - нажмиc, чтобы скопировать ссылку, и вставь её в браузер вручную. Если браузер показал код (так бывает в WSL и на удалённых серверах) - вставь этот код обратно в терминал.Дождись подтверждения
Когда вход прошёл, терминал напишетLogin successfulи попросит нажать Enter.Задай первый вопрос
Спроси что-нибудь простое про проект, например «что делает этот проект?». Claude прочитает файлы и ответит.Разреши первую правку
Когда попросишь что-то изменить, Claude покажет предполагаемые изменения и спросит подтверждение. Режимы доступа переключаются клавишамиShift+Tab.
Базовые команды внутри сессии стоит запомнить сразу: /help - список команд, /clear - очистить историю разговора, /exit - выйти (то же делает двойное Ctrl+D). Всё это Claude покажет и сам, если наберёшь /help.
Вход по подписке или по API-ключу: что выбрать?
Это первый вопрос, на который натыкаются при входе.
Нужен аккаунт Pro, Max, Team, Enterprise или Console. Бесплатный тариф Claude.ai доступа к Claude Code не даёт.
Способа входа два, и отличаются они моделью оплаты.
| Способ входа | Как платишь | Кому подходит |
|---|---|---|
| Подписка Claude.ai (Pro / Max / Team / Enterprise) | Фиксированная сумма в месяц | Большинству: предсказуемо, вошёл своим аккаунтом Claude.ai |
| Claude Console (API-ключ) | По факту, за использование | Тем, кто хочет платить строго за объём и следить за расходом |
При входе по подписке ты просто заходишь своим аккаунтом Claude.ai. При входе по API-ключу берёшь ключ в Claude Console (platform.claude.com), и оплата идёт с предоплаченного баланса по мере работы. Задал ключ в переменную окружения ANTHROPIC_API_KEY - Claude Code не будет каждый раз открывать браузер.
Сменить аккаунт внутри сессии можно командой /login, выйти - /logout.
Отдельная тема - как вообще оформить и оплатить доступ из России, где привычные карты не проходят. Это тянет на самостоятельный разбор, поэтому его я вынес в материал как оплатить Claude Code из России. Но без платного доступа Claude Code не запустится в любом случае.
Как проверить, что всё установилось правильно?
Три команды, которые стоит знать с самого начала.
Первая - проверка версии:
claude --versionРабочая установка ответит номером в формате X.Y.Z (Claude Code). Конкретные цифры растут от версии к версии, важно, что команда вообще отвечает номером версии. Ответ «команда не найдена» означает другое - разбираю его в следующем разделе.
Вторая - диагностика, если что-то идёт не так.
claude doctor показывает диагностику установки и настроек, не запуская сессию: проверяет здоровье установки, ошибки в файлах настроек и выдаёт предупреждения с подсказками, что чинить.
Третья - /status внутри сессии: она покажет, каким способом ты вошёл, какая почта или организация привязана и не истёк ли доступ. А claude update применит свежее обновление сразу, не дожидаясь фонового.
Почему команда claude не находится после установки?
Это самая частая жалоба новичков, и звучит страшнее, чем есть. Терминал ищет команды не по всему компьютеру, а только в папках из списка PATH. Claude Code кладёт себя в ~/.local/bin/claude (на Mac и Linux) или в %USERPROFILE%\.local\bin\claude.exe (на Windows), и если этой папки в PATH нет - терминал программу просто не видит.
На Mac и Linux добавь папку в список. Открой файл настроек своей оболочки (~/.zshrc для Zsh, ~/.bashrc для Bash) и допиши в конец строку:
export PATH="$HOME/.local/bin:$PATH"Потом закрой и открой терминал заново (или выполни source ~/.zshrc). После этого claude найдётся.
Есть и подводный камень: расширение Claude Code для VS Code кладёт свою копию программы внутрь папки расширения и в PATH её не добавляет. Поэтому после установки только расширения команда claude в терминале работать не будет - для терминала ставь Claude Code отдельно, командой из этого материала.
Частые ошибки при установке и первом запуске
Разбираю по порядку, все - из официального каталога ошибок Anthropic.
- Старый Node при установке через npm. Пакет
@anthropic-ai/claude-codeтребует Node.js 22 или новее. На Windows npm может упасть с фразой про запрет запуска скриптов - это политика PowerShell блокирует запуск. В WSL частая ошибкаexec: node: not found: WSL берёт виндовый Node вместо линуксового. Если с npm боль - перейди на нативный установщик, ему Node не нужен. - Перепутан установщик под оболочку.
'irm' is not recognizedзначит, что ты вставил команду для PowerShell в командную строку.The token '&&' is not a valid statement separator- наоборот, команду для CMD запустил в PowerShell.A parameter cannot be found that matches parameter name 'fsSL'- запустил команду для Mac/Linux в PowerShell. Сверься с началом строки:PS C:\- PowerShell,C:\- CMD. - Старый API-ключ перебивает подписку. Если подписка активна, но в профиле остался старый ключ, увидишь
API Error: 400 ... This organization has been disabled. Ключ важнее входа по подписке. Убери его командойunset ANTHROPIC_API_KEY(в PowerShell -Remove-Item Env:ANTHROPIC_API_KEY), проверь~/.zshrcи~/.bashrc, потом набери/status. - Нехватка памяти на слабом сервере. Установка обрывается со словом
Killedи кодом 137 - это нехватка оперативной памяти. Нужно около 512 МБ свободных, лечится добавлением swap. - Установщик вернул не то. Ошибка
syntax error near unexpected token '<'или упоминание<!DOCTYPE html>значит, что по адресу установки вернулась веб-страница вместо скрипта установки - обычно из-за региона, корпоративного фаервола или временного сбоя. Попробуй другой способ (Homebrew, WinGet) или повтори через несколько минут.
При любой из этих ошибок первый шаг один: запусти claude doctor, он покажет, что именно сломано, и подскажет, куда смотреть.
Работает ли Claude Code из России?
Скрывать смысла нет: Россия отсутствует в списке поддерживаемых стран Anthropic, и это заметно на двух шагах. При установке команда может вернуть 403 или страницу App unavailable in region. При входе аккаунт может не пустить с той же формулировкой про регион.
Тут есть нюанс диагностики: такой же голый 403 при установке даёт корпоративный фаервол или прокси. Так что если ты в офисной сети - сначала проверь, не режет ли доступ она.
Как настроить доступ и оформить оплату из России, я в этом материале не разбираю - это отдельная тема со своими тонкостями. Про доступ я собрал разбор Claude Code в России, а про оплату - материал как оплатить Claude Code из России.
Что делать после установки: первые шаги
Установка - это только вход. Дальше начинается собственно работа, и первое, обо что спотыкаются - память. Языковая модель не помнит тебя между разговорами: в новом чате она знает только то, что ты сам положил в контекст.
Поэтому первый настоящий шаг после установки - завести в корне проекта файл CLAUDE.md. Это текстовый файл с правилами проекта и контекстом, который Claude Code читает при каждом запуске. Один раз описал, чем занимаешься, как устроен проект и что важно - и перестал повторять это в каждом разговоре.
Как собрать такой файл и вообще настроить Claude под себя, я показываю по шагам в отдельном разборе - как настроить Claude под себя. А общую карту инструментов вайб-кодинга на 2026 год собрал здесь.
Что ещё спрашивают
Частые вопросы
Источники
- Claude Code Docs - Overview
- Claude Code Docs - Quickstart
- Claude Code Docs - Advanced setup (установка, требования, обновление, проверка)
- Claude Code Docs - Authentication (вход, подписка vs Console)
- Claude Code Docs - Troubleshoot installation (каталог ошибок)
- Claude Code Docs - Terminal guide (для тех, кто не пользовался терминалом)
- Claude Code - продуктовая страница
- Anthropic - официальный репозиторий Claude Code на GitHub
- npm - пакет @anthropic-ai/claude-code
- Anthropic - список поддерживаемых стран
- Claude Console (API-биллинг)
- Claude Code в браузере
- Claude Code Docs - установка в VS Code
- Claude Code Docs - плагин JetBrains
Полная схема вайб-кодинга за три вечера: ИИ-клон + Второй мозг + Контекст-инжиниринг. Записи эфиров в личном кабинете, доступ 30 дней.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

