Claude Code с нуля: установка, доступ из России и первые команды

Что такое Claude Code и зачем он нужен

Claude Code — это CLI-агент от Anthropic: программа, которая запускается в терминале, читает файлы проекта целиком, правит их, выполняет команды и работает с git без постоянных подсказок «скопируй этот код сюда». Agent вышел в феврале 2025 года, и с тех пор Anthropic выпускает обновления примерно каждые две недели — темп, из-за которого гайды двухлетней давности местами уже неточны.

На август 2026 года это уже не инструмент только для разработчиков. Anthropic позиционирует Claude Code как универсального агента для любой повторяющейся работы с файлами и данными: маркетологи используют его для черновиков текстов, SEO-специалисты — для анализа структуры страниц, предприниматели без опыта в коде — для сортировки документов и составления отчётов. В основе — актуальный модельный стек: Opus 4.6 для сложных многошаговых задач, Sonnet 4.6 как модель по умолчанию, Haiku 4.5 для простых операций, где важна скорость и цена. Контекстное окно у флагманских моделей — 1 млн токенов, наценка за такой объём отменена с 13 марта 2026 года.

Важно сразу закрыть частое заблуждение: Claude Code — не отдельный платный продукт, который покупают отдельно. Это функция, которая открывается той же подпиской, что и Claude Pro, Max, Team или Enterprise — либо доступом через API-ключ Console с оплатой по токенам. Бесплатный тариф Claude.ai доступа к Claude Code не даёт.

Доступ из России: подписка и оплата

Это первый практический барьер, и его стоит закрыть до установки, а не после. Anthropic официально не поддерживает Россию: страна не входит в список разрешённых регионов, действует блокировка по IP, а нарушение условий использования приводит к блокировке аккаунта.

Прямая регистрация с территории России требует двух вещей: VPN с «чистым» IP одобренного региона и карты иностранного банка. Публичные VPN с общим IP-адресом — частая причина отказа на этапе оплаты через Stripe или прямой блокировки аккаунта Anthropic, потому что один и тот же IP уже засветился на десятках других регистраций.

На практике в рунете на август 2026 года используют два рабочих способа:

Отдельный момент, который путает новичков: раз Claude Code активируется той же подпиской, что и Claude Pro или Max, вопрос «как оплатить Claude Code» на практике равен вопросу «как оплатить Claude Pro». Отдельной оплаты именно за CLI-агента не существует — это часть той же учётной записи.

Установка: CLI, требования, платформы

До 2026 года стандартом установки была команда npm install -g @anthropic-ai/claude-code — она встречается в старых гайдах и всё ещё рабочая, но требует заранее поставленных Node.js и npm. Приоритетный способ на август 2026 года — нативный установщик: он ставится меньше чем за две минуты, ничего не требует заранее и обновляется в фоне сам, без ручного npm update.

Для запуска нужен платный аккаунт — Pro, Max, Team или Enterprise — либо pay-per-token API-ключ через Anthropic Console. Это стоит проверить до установки: сам установщик отработает на бесплатном аккаунте без ошибок, но при первом запуске claude упрётесь в требование оплаты.

Установка на Windows

На Windows 10 (сборка 1809 и новее) и Windows 11 Claude Code ставится нативно, без обязательного WSL. Команда для PowerShell:

Node.js и npm для этого пути не нужны — установщик самодостаточен. Если раньше Claude Code уже стоял через npm, оба варианта не конфликтуют, но держать два способа установки одновременно смысла нет — проще перейти на нативный.

Установка на Linux, Ubuntu и VPS

На macOS, Linux и внутри WSL команда установки одна и та же:

Для VPS и серверных сценариев есть нюанс: авторизация через браузер по умолчанию рассчитана на локальную машину. На headless-сервере без графического окружения процесс логина выведет ссылку, которую нужно открыть в браузере на любом другом устройстве — сама установка при этом ничем не отличается от десктопной. Это частый сценарий для продвинутых пользователей, которые гоняют Claude Code как часть CI-пайплайна или на выделенном сервере под мультиагентные конфигурации.

Работа с Claude Code: команды и VS Code

Минимальный набор, который закрывает первые 30 минут работы:

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

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

Продвинутые сценарии: API, ключ и MCP

Для интеграций и автоматизации вне интерактивного терминала используется API-ключ Anthropic Console — он даёт доступ по модели pay-per-token, отдельно от подписки Pro/Max, и удобен, когда Claude Code запускается как часть скрипта или CI-джобы, а не в диалоговом режиме.

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

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

С CLAUDE.md есть ещё один слой путаницы — файлов может быть несколько, и они образуют иерархию по приоритету: политика уровня организации (Managed Policy), затем глобальный ~/.claude/CLAUDE.md для пользователя, затем ./CLAUDE.md уровня проекта, и в конце личные переопределения CLAUDE.local.md, которые не попадают в git. Рекомендуемый объём — около 200 строк, при этом полезнее объяснять «почему» так, а не только «что» делать — короткое правило без причины агент чаще игнорирует в пограничных случаях.

Для управления плагинами и готовыми скиллами есть отдельный набор команд: /plugin открывает менеджер, /plugin marketplace add владелец/репозиторий подключает маркетплейс — по сути обычный git-репозиторий со списком скиллов, /plugin install имя@маркетплейс ставит конкретный. Официальный маркетплейс Anthropic курируемый и подписанный, на июль 2026 года в нём больше 200 плагинов. Комьюнити-маркетплейсы предлагают тысячи скиллов, но они не проходят проверку и не подписаны — ставить их с доступом к файлам и командам без разбора кода не стоит.

Частые ошибки новичков

Список ниже собран из практики и повторяется почти у всех, кто начинает работать с агентом:

Отдельно — про деградацию контекста, о которой мало где пишут прямо: после заполнения окна примерно на 60% качество ответов начинает падать, это не повод паниковать, а сигнал закончить текущую задачу и начать новую с /clear. К 90% заполнения модель ощутимо «глупеет» — инструкции из начала диалога теряются, нюансы стираются. Марафонские сессии без /compact ещё и дорогие: каждое сообщение истории при каждом новом запросе уходит в API заново, то есть тысячи «мёртвых» токенов оплачиваются повторно. Подключение слишком многих MCP-серверов разом добавляет ту же проблему — до 15% контекста может уходить просто на описание доступных инструментов, ещё до начала работы.

Для агентства «Термос Беспалова» это не абстрактный пример: сам процесс подготовки и публикации статей на этом сайте построен как мультиагентный пайплайн на связке CLAUDE.md, скиллов и субагентов — по сути, продвинутый сценарий из этого раздела, применённый на практике, а не только в теории.