Claude Code: 4 шага от установки до проекта в 2026 году

Как понять, что всё встало правильно

Есть штатная проверка, которая отвечает подробнее номера версии. Напечатай claude doctor и нажми Enter: команда ничего не запускает и ничего не меняет, она только осматривает установку и печатает отчёт

Вот как выглядит её ответ на исправной установке

Claude Code doctor

Running: npm-global (2.1.261)
Commit: 1349cf9c224c
Platform: darwin-arm64
Path: /opt/homebrew/lib/node_modules/@anthropic-ai/claude-code/bin/claude.exe
Config install method: global
Search: OK (bundled)
Auto-updates: enabled

Главную строку ищи в самом низу отчёта: No installation issues found. Она и означает, что ставить больше нечего

Не хочешь ни Терминала, ни PowerShell - обходной путь есть, и вендор называет его сам: Prefer a graphical interface? The Desktop app lets you use Claude Code without the terminal. То есть у Claude есть обычное приложение для macOS, Windows и Linux, и Claude Code живёт внутри него

Выбирать между двумя путями стоит по одному признаку: боишься чёрного окна или нет

Потянет ли твой компьютер

Требования скромнее, чем обычно ждут, и ходить за ними никуда не надо: весь список лежит ниже строка в строку. Одну строку сразу выношу вперёд, потому что её обычно не ждут: Shell: Bash, Zsh, PowerShell, or CMD. То есть любое из четырёх окон команд подходит, отдельную программу под это ставить не нужно

Дословно со страницы, с переводом на человеческий

В таблице семь строк, а в кадре выше их девять: документация добавляет ещё раздел Additional dependencies про ripgrep - для обычной установки он не нужен, ставится автоматически, поэтому отдельной строкой в таблицу не идёт

Полезнее знать другое: что будет, если требование не выполнено. Экран тут не ругается на память и не говорит «твой компьютер слаб». Он ведёт себя тише и оттого непонятнее

Если система старше нужной версии, официальная команда установки просто не доходит до конца, а claude --version потом отвечает sh: claude: command not found. Ту же самую строку ты увидишь, если установка вообще не запускалась, и по ней эти два случая не различить. Различает их claude doctor: он либо печатает отчёт, либо тоже отвечает command not found, и второе значит, что ставить надо заново

Отдельная развилка, которой пугаться не надо. Официальная команда из первого раздела ничего заранее не требует, а вот у второго способа, через npm, есть условие: на машине должен стоять Node. Не стоит - экран отвечает sh: npm: command not found, и это не поломка Claude Code, а отсутствие другой программы. Выхода два: либо ставить официальной командой (она про Node не спрашивает), либо сначала поставить Node с nodejs.org, а потом повторить

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

И одна разница, которую держат в голове с самого начала: чат с нейросетью отвечает тебе текстом, а агент делает работу руками в твоих файлах. Ты просишь «сделай страницу» - и страница появляется на диске, а не в окне чата

Первая задача: что напечатать, чтобы получилось с первого раза

Здесь новички теряют вечер, и причина не в инструменте. Агент делает ровно то, что ему сказали, и на размытой формулировке он честно выдаёт размытый результат

Первое действие тут не про задачу, а про место: агент работает в той папке, откуда его запустили, и в окно команд надо сначала в эту папку попасть. Делается это двумя строками, одинаковыми на Mac и на Windows

Напечатай mkdir moy-pervyy-proekt и нажми Enter: создастся папка с таким именем, экран при этом промолчит, и молчание здесь означает успех. Следом напечатай cd moy-pervyy-proekt и снова Enter: теперь ты внутри неё

Убедиться, что ты внутри, можно командой pwd - она печатает полный путь текущей папки, и последним в нём стоит moy-pervyy-proekt. Команда ls в этот момент не печатает ничего: папка пустая, так и задумано

Прогон выше сделан на Mac. Машины на Windows у меня под рукой нет, поэтому за Windows отвечаю не своим замером, а страницей Microsoft Using aliases: там лежит таблица соответствия команд, и все три слова в ней стоят. Дословно из таблицы: cd, chdir cd Set-Location sl, cd, chdir, md mkdir New-Item ni и pwd Get-Location gl, pwd, $PWD. По-русски это значит: печатаешь привычное короткое слово, PowerShell сам подставляет свою длинную команду. Механизм назван на соседней странице about_Aliases: PowerShell includes a set of built-in aliases, including cd and chdir for the Set-Location cmdlet

Вот теперь запускай claude из этой папки. Дальше первая задача одной фразой, и в ней обязаны быть три вещи: имя файла, что на странице, и рамка «только это»

Вот формулировка, которая отработала в этом заходе дословно

Сделай файл dela.html: страница со списком дел на сегодня, три пункта, кнопка Добавить. Один файл, только HTML и CSS. Ответь одной строкой, что сделал

Ответ пришёл одной строкой, файл лёг в ту же папку

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

Дальше правки идут такими же фразами: «сделай кнопку зелёной», «добавь четвёртый пункт», «убери дату». Каждый раз агент правит файл, а ты открываешь его заново и смотришь

Три вещи, которые ломают первую задачу чаще всего

• Просьба без имени файла. «Сделай мне список дел» - агент сам придумает имя, и ты потом его ищешь. Называй файл сам
• Просьба без рамки. Без слов «только HTML и CSS» агент вправе собрать проект из десяти файлов, и разобраться в нём новичку уже нечем
• Запуск не из той папки. Агент работает в той папке, откуда его запустили. Запустил из домашней - файл ляжет в домашнюю, среди сотни чужих

Что ломается на старте и как это выглядит на экране

Четыре ошибки закрывают почти все случаи. Каждая ниже дана своим экранным текстом: сравни с тем, что у тебя, и бери свою строку. Памятка в конце статьи добавляет к ним ещё два экранных текста (отсутствие Node и обратный случай с PowerShell/CMD) - в теле их нет специально, чтобы не повторять зеркальные абзацы дважды

Пишет, что команды нет. Экранный текст в двух видах, оба из одного захода: sh: claude-code: command not found и (eval):9: command not found: claudecode. Обе строки означают одно: система такого имени не знает. Причина почти всегда в имени - команда называется claude, одним словом, без дефиса и без слова code. Второй вариант причины: окно открыто ДО установки. Закрой его и открой заново, окно про свежепоставленную программу не знает

Ругается на права. Экранный текст в моём прогоне: строка npm error code: 'EPERM', и ниже npm error The operation was rejected by your operating system. Дальше своя же подсказка: npm error It is likely you do not have the permissions to access this file as the current user Это попытка положить программу в системную папку. Ставь официальной командой из первого раздела, она кладёт инструмент в твою домашнюю папку и прав не просит

Не находит пакет. Экранный текст: npm error code E404 и строка 404 Not Found - GET https://registry.npmjs.org/@anthropic-ai%2fclaude_code - Not found. Смотри на имя в конце адреса: в нём подчёркивание вместо дефиса. Правильное имя пакета пишется через дефис

Ругается на разделитель команд. Случай только для Windows, и причина в том, что окон команд там два. Одно называется PowerShell, другое CMD, и команды у них разные. Документация называет обе стороны дословно: If you see The token '&&' is not a valid statement separator, you’re in PowerShell, not CMD. If you see 'irm' is not recognized as an internal or external command, you’re in CMD, not PowerShell. Отличить окна проще всего по строке слева от курсора: в первом она начинается с PS C:\, во втором просто C:\

Чтобы не листать четыре абзаца заново, вот та же четвёрка одной таблицей: находи свою строку по левой колонке

Общая проверка на любой из четырёх: закрой окно команд, открой заново и напечатай claude doctor. Если он отвечает No installation issues found., проблема была в окне, а не в установке

Доступ из России: чем ты рискуешь и чем не рискуешь

Строка требований Location: Anthropic supported countries стоит на официальной странице рядом с требованиями к памяти, и это не формальность. Правила Anthropic разрешают пользоваться сервисом из поддерживаемых стран, России в этом списке нет

Что из этого следует практически. Инструмент технически ставится и запускается, но аккаунт живёт по правилам компании, и рисковать тут можно только сознательно. Деньги за подписку при блокировке аккаунта никто не пересчитывает

Разбор самого маршрута с оплатой и доступом у меня вынесен отдельно, чтобы не растворять его здесь: как оплатить подписку Claude из России и что делать, если аккаунт уже заблокировали

Отдельно про экран входа. Показать его кадром я не могу: страница claude.ai/login моему инструменту съёмки не открылась, вместо неё пришёл заголовок Just a moment... и строка Performing security verification. Это защита сайта от роботов, а не поломка: на твоём обычном браузере страница открывается нормально. Поэтому шаг я описываю словами: набираешь claude, открывается браузер, там кнопка входа через почту или через Google, подтверждаешь, возвращаешься в окно команд

Сколько это стоит и какой тариф брать новичку

Агент работает от подписки Claude. Бесплатный план агента не даёт, и это первая развилка, на которой люди останавливаются

Для старта хватает самого младшего платного тарифа. Точную цифру называть не буду и не хочу врать на цене: тарифы Anthropic меняются, и число из статьи месячной давности читатель приносит в кассу как обещание. Открой claude.com/pricing и посмотри две строки: сколько стоит младший платный план и какие ограничения по объёму работы у него стоят

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

Чем это отличается от обычного чата с нейросетью

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

Отсюда и практическое следствие для первого вечера: агенту не нужно пересказывать содержимое файлов. Вместо «вот мой код, посмотри» пишешь «посмотри dela.html и почини кнопку» - он откроет файл сам. Ровно поэтому шаг с переходом в папку и оказался главным: пока агент не в той папке, читать ему нечего

Хочешь сравнить с соседним инструментом до установки - у меня есть отдельный разбор Claude Code против Codex для новичка, там та же задача решается обоими и видно разницу на руках

Что дальше, когда первая страница уже получилась

Дальше полезно знать три вещи, и они экономят больше времени, чем любая настройка

Первое: агент читает файл CLAUDE.md, если положить его в папку проекта. Это обычный текстовый файл с правилами, которые агенту не надо повторять каждый раз: на каком языке отвечать, чего не делать, как называть файлы

Второе: повторяющуюся процедуру можно записать один раз и вызывать словом. У меня так собраны собственные скиллы под рабочие задачи, и это меняет работу сильнее, чем кажется со стороны

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

Источники

• Claude Code, официальная страница продукта
• Advanced setup, официальная документация: системные требования и установка
• Claude Code quickstart, официальная документация
• Troubleshoot installation, официальная документация
• Тарифы Claude, официальная страница

Памятка: первый вечер с Claude Code

Устроена не по порядку статьи, а по тому, что у тебя перед глазами. Первая часть - определитель по строке на экране: нашёл свою строку, прочитал выход. Вторая - формула задачи агенту, которую уносят целиком. Третья - две команды проверки. Всё работает без этой страницы рядом

Частые вопросы

Читайте также

Если команда не сработала

Разбор установки по шагам

Оплата подписки из России

Что с доступом и деньгами

Чем агент отличается от чата

Тот же вопрос без привязки к Claude