Claude Code: полный гайд — что это, как установить, настроить и использовать

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

По данным опроса разработчиков 2026 года, Claude Code занял первое место среди AI-инструментов для кодинга — 46% разработчиков назвали его «most loved». Для сравнения: Cursor набрал 19%, GitHub Copilot — 9%. Claude Code используют 41% профессиональных разработчиков, обогнав Copilot (38%).

В этом гайде — всё, что нужно для старта: от установки и подписки до продвинутых фич вроде Skills, Hooks и MCP-серверов. Если вы ни разу не открывали терминал — тоже разберётесь.

Что такое Claude Code и чем он отличается от ChatGPT

Когда люди слышат «AI для кода», они думают о ChatGPT или GitHub Copilot. Но Claude Code — это принципиально другой инструмент. Разберём отличия.

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

GitHub Copilot — это автодополнение внутри редактора. Он подсказывает строки кода по мере набора. Хорош для шаблонного кода, но не понимает контекст проекта целиком.

Cursor — IDE со встроенным AI. Видит открытые файлы, предлагает изменения. Мощнее Copilot, но привязан к своему редактору.

Claude Code — это агент. Он:

• Видит весь проект — все файлы, папки, зависимости, git-историю
• Действует сам — создаёт файлы, редактирует код, запускает тесты, коммитит в Git
• Работает автономно — может выполнить задачу из 20 шагов без вашего участия
• Не привязан к IDE — работает из терминала, VS Code, JetBrains, десктоп-приложения или веба

Сравнение в таблице:

Ключевое отличие: вы не пишете код — вы ставите задачу. «Добавь авторизацию через Telegram», «Перепиши этот компонент на TypeScript», «Найди и исправь все SQL-инъекции в проекте». Claude Code сам решает, какие файлы открыть, что изменить, и показывает вам результат на утверждение.

Для кого Claude Code

Claude Code подходит двум категориям людей:

1. Разработчики — ускорение работы в 2-5 раз. Рефакторинг, миграции, дебаг, написание тестов, ревью кода
2. Не-программисты — создание продуктов без знания кода. Сайты, боты, автоматизации, MVP. Это то, что называют вайб-кодингом

Где работает Claude Code

Claude Code доступен на всех основных платформах:

Самый мощный вариант — терминал. Именно там доступны все продвинутые функции: Hooks, MCP-серверы, Agent Teams. Но для начала VS Code — отличный выбор: привычный интерфейс, визуальное подтверждение изменений, встроенный терминал.

Как установить Claude Code

Системные требования

• Node.js 18+ — проверьте командой node --version
• 4 ГБ ОЗУ — минимум, рекомендуется 8 ГБ
• Стабильный интернет — Claude Code работает через API Anthropic
• Подписка Claude Pro ($20/мес) или выше — на бесплатном тарифе недоступен

Установка CLI

Одна команда:

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

Установка в VS Code

1. Откройте VS Code → Extensions (Ctrl+Shift+X)
2. Найдите «Claude Code» от Anthropic
3. Нажмите Install
4. Перезапустите VS Code

Первый запуск

cd ваш-проект
claude

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

Если Node.js не установлен, скачайте его с nodejs.org — установка занимает 2 минуты.

Что происходит при первом запуске

1. Claude Code сканирует текущую директорию — определяет языки, фреймворки, структуру
2. Если есть CLAUDE.md — читает его и запоминает правила проекта
3. Если есть .git — понимает историю изменений и текущую ветку
4. Показывает приглашение — можно вводить задачи

Весь процесс от npm install до первого ответа занимает 3-5 минут. Если вы когда-нибудь устанавливали Node.js-пакет — вы справитесь.

Подписка и цены: как оплатить из России

Claude Code не продаётся отдельно — это часть подписки Claude. Вот что доступно:

Какой план выбрать. Для старта хватает Pro ($20/мес). Если вы работаете с Claude Code каждый день по 6-8 часов — нужен Max. Большинство пользователей живут на Pro.

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

Российские карты Visa/MasterCard на claude.ai не проходят. Рабочие способы на начало 2026 года:

1. Сервисы-посредники (самый быстрый способ) — оплата рублями через СБП. Claude Pro выходит примерно 2 300-2 500 ₽ с комиссией. Подписка активна через 15-60 минут
2. Карта иностранного банка — если есть карта Казахстана, Грузии, Турции или другой страны — оплатите напрямую на claude.ai
3. API-ключ через Anthropic Console — для тех, кто хочет платить за использование, а не помесячно. Нужна иностранная карта

Как пользоваться Claude Code: первые шаги

После установки и авторизации вы оказываетесь в терминале с приглашением Claude Code. Вот что стоит сделать в первые 10 минут.

Шаг 1: Задайте первую задачу

Просто напишите, что хотите. Примеры:

> Объясни структуру этого проекта
> Создай файл README.md с описанием проекта
> Найди все TODO в коде и составь список

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

Шаг 2: Создайте CLAUDE.md

Это файл-память проекта. Создайте CLAUDE.md в корне — Claude Code будет читать его при каждом запуске:

# Мой проект

## Стек
- Python 3.13, FastAPI, PostgreSQL
- Frontend: React 19, TypeScript

## Как запускать
- Backend: `uvicorn main:app --reload`
- Frontend: `npm run dev`
- Тесты: `pytest`

## Правила
- Используем snake_case для Python
- Комментарии на русском
- Все API-эндпоинты документируем через docstring

Шаг 3: Используйте Plan Mode

Перед сложной задачей нажмите Shift+Tab (или введите /plan). Claude Code перейдёт в режим планирования:

• Прочитает код, задаст уточняющие вопросы
• Предложит пошаговый план
• Не будет ничего менять, пока вы не одобрите

Это критически важно для задач вроде рефакторинга, миграций или добавления новых фич. Сначала план — потом выполнение.

Шаг 4: Научитесь слеш-командам

CLAUDE.md: как настроить правильно

CLAUDE.md — это не просто документация. Это операционная система вашего AI-агента. Что туда писать:

Обязательные секции: - Стек и зависимости — Claude Code должен знать, с чем работает - Команды запуска — как стартовать, тестировать, деплоить - Код-стайл — соглашения о наименовании, структуре

Продвинутые секции: - Что НЕ делать — «не трогай файлы в /config/production/», «не используй jQuery» - Архитектурные решения — «мы используем DDD», «все запросы к БД через repository pattern» - Контекст проекта — «это интернет-магазин обуви, основная аудитория — женщины 25-40 лет»

Частая ошибка: слишком длинный CLAUDE.md

Если CLAUDE.md превышает 2-3 экрана текста — Claude Code начинает игнорировать часть инструкций. Правило: если Claude и так делает что-то правильно без инструкции — уберите эту инструкцию. Оставляйте только то, что он не может угадать сам.

Для критичных правил, которые должны выполняться в 100% случаев, используйте Hooks (см. следующий раздел).

Пример хорошего CLAUDE.md

# E-commerce проект

## Стек
- Next.js 15, TypeScript strict mode, Prisma ORM, PostgreSQL
- Стили: Tailwind CSS (не CSS Modules)
- Тесты: Vitest + Playwright

## Команды
- Dev: `npm run dev` (порт 3000)
- Тесты: `npm test`
- Миграции: `npx prisma migrate dev`
- Линтер: `npm run lint`

## Правила
- API-роуты в app/api/ возвращают NextResponse
- Все компоненты — функциональные, с TypeScript типами
- Не трогать: .env.production, prisma/migrations/
- Имена файлов: kebab-case
- Коммиты: conventional commits (feat:, fix:, refactor:)

Заметьте: ничего лишнего. Каждая строка — информация, которую Claude Code не может определить сам из кода.

Skills, Hooks и MCP: продвинутые возможности

Три технологии, которые превращают Claude Code из «умного помощника» в полноценную платформу разработки.

Skills — знания по запросу

Skills — это markdown-файлы, которые расширяют знания Claude Code. В отличие от CLAUDE.md, Skills загружаются только когда нужны — это экономит контекст.

Пример: у вас есть файл .claude/skills/deploy.md с инструкцией как деплоить проект. Когда вы говорите «задеплой проект», Claude Code автоматически подгрузит этот skill.

Можно вызвать skill напрямую: /deploy. Популярные community-навыки: /commit, /review-pr, /test.

По данным Wordstat, «claude code skills» — один из самых частых запросов (2 212 показов/мес). Людям нужны готовые навыки — и коллекция awesome-claude-code на GitHub содержит десятки готовых skills.

Hooks — автоматизация без компромиссов

CLAUDE.md — это рекомендации: Claude следует им примерно в 80% случаев. Hooks — это скрипты, которые выполняются гарантированно в определённых точках:

В 2026 году Claude Code поддерживает 21 lifecycle event для Hooks. Настраиваются в settings.json.

MCP-серверы — подключение к внешним инструментам

MCP (Model Context Protocol) — протокол, через который Claude Code взаимодействует с внешними сервисами. Это как плагины для браузера, только для AI-агента.

Что можно подключить: - GitHub — работа с issues, PR, ревью прямо из Claude Code - Базы данных — запросы к PostgreSQL, MongoDB - Браузер (Glance) — Claude Code может открывать веб-страницы - Google Sheets, Miro, Slack — через community MCP-серверы

Добавление MCP-сервера:

claude mcp add github --scope user

Каталог 50+ MCP-серверов — от баз данных до мониторинга.

Как выбрать, что использовать

Простое правило:

• CLAUDE.md — для информации о проекте (стек, правила, команды). Загружается всегда
• Skills — для специализированных навыков (деплой, ревью, генерация документов). Загружаются по требованию
• Hooks — для правил, которые нельзя нарушать (безопасность, линтинг, форматирование). Срабатывают гарантированно
• MCP — для интеграции с внешними сервисами (GitHub, БД, Slack). Расширяют возможности агента

Не нужно настраивать всё сразу. Начните с CLAUDE.md — этого достаточно для первых недель. Skills и Hooks добавляйте по мере необходимости. MCP — когда захотите подключить Claude Code к вашим рабочим инструментам.

Что можно сделать с Claude Code: 7 практических сценариев

Не абстрактные возможности, а конкретные задачи, которые решаются за минуты или часы:

1. Сайт с нуля за 1 день

Описываете бизнес и целевую аудиторию — Claude Code создаёт полный лендинг: адаптивная вёрстка, формы обратной связи, анимации, SEO-метатеги, подключение аналитики. Остаётся только задеплоить. Реальный пример: сайт claude-cource.ru — лендинг на 2000 строк, 4 сегмента аудитории, интеграция с ЮKassa — был создан за один рабочий день.

2. Telegram-бот с оплатой

«Сделай бота для записи к парикмахеру с оплатой через Telegram Stars и ЮKassa» — через 2-3 часа у вас рабочий бот с базой данных, обработкой платежей и уведомлениями. Claude Code сам выберет фреймворк (aiogram для Python), настроит вебхуки, напишет обработчики команд.

3. Рефакторинг legacy-кода

Наследуете проект с 800-строчными файлами, без тестов и документации. Claude Code видит весь проект целиком — разбивает монолитные файлы на модули, добавляет типизацию, пишет тесты, обновляет импорты по всему проекту. По данным SFEIR, экономия — до 70% времени по сравнению с ручным рефакторингом.

4. Миграция между фреймворками

40 React-компонентов с классами нужно переписать на Hooks? Express-сервер — на Fastify? REST API — на GraphQL? Claude Code делает это файл за файлом, сохраняя бизнес-логику и адаптируя паттерны. Средняя скорость — 30% быстрее, чем вручную, с меньшим количеством регрессий.

5. Автоматизация рутины

Парсеры данных, ETL-пайплайны, скрипты деплоя, CI/CD конфигурации, генераторы отчётов — всё, что повторяется и отнимает время. Описываете логику, Claude Code пишет код, вы проверяете и запускаете.

6. MVP за выходные

Идея стартапа → рабочий прототип за 2 дня. Не макет в Figma и не презентация — работающий продукт с бэкендом, базой данных, авторизацией и фронтендом. Покажите инвесторам или первым пользователям реальный продукт, а не слайды.

7. Онбординг в чужой проект

Новый разработчик тратит 2-3 недели на погружение в сложный проект. С Claude Code — 3-5 дней. «Объясни архитектуру», «Покажи как работает авторизация», «Где обрабатываются платежи» — агент прочитает сотни файлов и даст структурированный ответ с ссылками на конкретные файлы и строки.

5 ошибок новичков в Claude Code

Даже мощный инструмент можно использовать неэффективно. Вот чего стоит избегать:

1. Слишком абстрактные задачи

Плохо: «Сделай мне приложение для бизнеса»

Хорошо: «Создай веб-приложение для учёта заказов пиццерии: форма заказа (имя, телефон, адрес, выбор пиццы), панель оператора со списком заказов, база данных SQLite»

Чем конкретнее задача — тем лучше результат. Claude Code не читает мысли: ему нужны детали.

2. Пропуск Plan Mode на сложных задачах

Если вы сразу даёте команду «перепиши архитектуру проекта», Claude Code начнёт менять файлы без общего плана. Результат может быть непредсказуемым. Всегда используйте Plan Mode (Shift+Tab) для задач, затрагивающих больше 2-3 файлов.

3. Не проверять изменения

Claude Code показывает каждое изменение перед применением. Не нажимайте «Accept all» на автомате — просматривайте дифы. Особенно в файлах конфигурации, миграциях БД, обработке платежей. Агент ошибается — ваша задача ловить эти ошибки.

4. Зацикливание на одном решении

Если Claude Code третий раз пробует исправить ошибку одним и тем же способом — остановите его. Скажите: «Это решение не работает. Ты уже пробовал {X}. Предложи принципиально другой подход». Иначе агент будет ходить по кругу.

5. Перегруженный CLAUDE.md

50 строк правил, из которых 40 очевидны. Claude Code начинает игнорировать важные инструкции, потому что контекст «замусорен». Держите CLAUDE.md лаконичным: только то, что агент не может определить сам из кода.

Чеклист: начало работы с Claude Code

1. Установите Node.js 18+ — скачайте с nodejs.org, установка за 2 минуты
2. Оформите подписку Claude Pro — $20/мес, из России через посредника ~2 300 ₽
3. Установите Claude Code — npm install -g @anthropic-ai/claude-code
4. Авторизуйтесь — запустите claude, войдите через браузер
5. Создайте CLAUDE.md — опишите стек, команды запуска, правила
6. Попробуйте Plan Mode — Shift+Tab перед первой задачей
7. Установите VS Code расширение — для визуального контроля изменений
8. Изучите слеш-команды — /plan, /clear, /compact, /help
9. Подключите первый MCP-сервер — начните с GitHub
10. Попробуйте Skills — установите community-навыки из awesome-claude-code