Полный гайд по Claude Code для начинающих

Что такое Claude Code?

Claude Code — это AI-агент с доступом к терминалу, который может управлять компьютером, писать код и автоматизировать задачи. Это CLI-инструмент от Anthropic, работающий на базе LLM (Claude Opus). Он живёт в терминале или как расширение в VS Code. Поскольку у него есть доступ к терминалу, он может управлять компьютером, выполняя команды, и писать код, так как код — это тоже текст.

Для кого подходит:

Даже для тех, кто не знает языков программирования (vibe-кодинг).
Для управления компьютером, создания сайтов, разработки ботов, автоматизации бизнес-процессов.
Как личный AI-ассистент (например, для бронирования билетов через браузер).
Самый продвинутый инструмент для вайб-кодинга с регулярными обновлениями.

Сравнение с конкурентами

Cursor — первое популярное IDE для вайб-кодинга.
VSC Copilot — встроенный AI от Microsoft в VS Code.
Windsurf, Anti-Gravity (от Google) — аналогичные AI-ориентированные IDE.
Open Cursor — open-source альтернатива для локального запуска моделей.
Российские аналоги: Кодик, Гигакод (от Сбера).

Почему именно Claude Code?

Самый навороченный инструмент, новые фишки часто выходят здесь первыми.
Высокая мощность модели Claude Opus.

Тарифы и подписки

Подписка единая для всех продуктов Anthropic (Claude, Claude Code, Claude Desktop).

Бесплатно — Claude Code недоступен.
Pro (~$20/мес) — базовый доступ, но есть жёсткие лимиты.
Max ($100/мес) — в 5 раз больше токенов, чем у Pro.
Max ($200/мес) — в 20 раз больше токенов, чем у Pro, для активной работы без лимитов.

Оплата по API — плата за фактическое использование токенов. Для активного кодинга менее выгодна, чем подписка. Можно подключить как доплату при исчерпании лимитов подписки.

Установка и настройка

Установка через расширение в VS Code (рекомендуется для новичков)

Скачать и установить Visual Studio Code.
В разделе расширений найти Claude Code и установить.
Авторизоваться через подписку (Claude subscription).

Установка через терминал

В терминале выполнить команду: npm install -g @anthropic-ai/claude.
Запустить: claude.
Пройти авторизацию и настройку.

Голосовой ввод: Доступен в терминальной версии (активируется через /voice). В расширении VS Code можно использовать сторонние инструменты (например, Aqua Voice).

Что такое IDE?

IDE (Integrated Development Environment) — среда разработки. Состоит из:

Файлового менеджера (проводник).
Текстового редактора (для написания кода).
Терминала.
Окна чата с агентом (Claude Code).

Популярные IDE для работы с Claude Code:

Visual Studio Code + расширение Claude Code.
Anti-Gravity (AI-ориентированная IDE от Google, но есть блокировки для РФ).

Работа с проектами и GitHub

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

Пример: Попросить Claude Code: «Склонируй этот репозиторий с GitHub в текущую папку».

Интерфейс и режимы работы Claude Code

Основные элементы интерфейса (в расширении VS Code)

История диалогов.
Поле для ввода сообщений.
Кнопки для управления режимами и прикрепления файлов.
Команды через слэш (/).

Ключевые режимы работы

Ask Before Edits — запрашивает разрешение на каждое действие (редактирование файла, команду в терминале).
Edit Automatically — автоматически редактирует файлы, но запрашивает разрешение на некоторые команды в терминале.
Bypass Permissions (рекомендуется) — не запрашивает разрешений, может делать что угодно. Есть риски (теоретически может повредить систему).
Plan Mode — сначала создаёт подробный план (сохраняет в файл), затем выполняет его.

Управление контекстом

Файл claude.md — системный промт. Его содержимое отправляется Claude перед каждым сообщением. Можно создать автоматически командой /init.
Прикрепление файлов: Можно выделить файл в проводнике или упомянуть через @.
Команда /compact — сжимает длинный диалог в краткое изложение (summary), чтобы освободить контекстное окно.
Команда /btw (только в терминале) — позволяет «шепнуть» вопрос Claude, пока он выполняет основную задачу, не прерывая её.

Другие полезные команды и настройки

Смена модели (Opus, Sonet, Haiku).
Включение режима Thinking (модель сначала «размышляет» внутренне, что может улучшить ответ).
Fast Mode — отвечает в 2.5 раза быстрее, но оплачивается отдельно и дороже.
Просмотр использования токенов (/usage).

Папка `.claude` и кастомизация

Глобальная папка с настройками находится по пути ~/.claude. Настройки могут быть глобальными (для всех проектов) и локальными (для конкретного проекта).

Уровни настроек (приоритет сверху вниз)

Enterprise (для компаний) — самые приоритетные.
Локальные (только для вас в проекте).
Проектные (общие для команды, если проект в Git).
Глобальные (ваши личные).

Ключевые файлы для настройки

claude.md / rules/ — системные промты и правила поведения для Claude.
- rules удобнее, так как позволяют разделить промты на части и привязывать их к конкретным папкам.
- Официальная рекомендация — укладываться в 200 строк.
settings.json — настройки разрешений, хуков, модели по умолчанию, языка.
- Хуки (hooks) — автоматические действия при событиях (например, уведомление, когда Claude заканчивает ответ).
skills/ — скилы для автоматизации рутины (аналоги workflow в N8N).
keybindings.json — кастомные горячие клавиши (работают в терминале).
.env — файл для хранения секретов (API-ключей), который не попадает в Git.

Ключевые концепции Claude Code

Скилы (Skills)

Скил — это подробная текстовая инструкция (стандартная операционная процедура) для автоматизации повторяющихся задач.

Как работают:

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

Примеры использования скилов:

Парсинг YouTube по ключевым словам и сохранение в таблицу.
Генерация презентаций в определённом стиле (например, в Excalidraw).
Структурирование надиктованных мыслей в пост для Telegram.
Автоматическое создание структуры папок для нового проекта.
Настройка Docker-деплоя с учётом типичных ошибок.
Использование прокси для обхода региональных ограничений API.
Установка MCP по единой инструкции.
Подключение к серверу без ошибок.
Использование сервиса Tavily для доступа к информации с сайтов, которые не может обработать встроенный веб-поиск Claude.

Где брать скилы: Telegram-каналы, Reddit, GitHub, соцсети.

Субагенты (Subagents)

Субагент — это изолированный агент, которого вызывает основной Claude для выполнения конкретной задачи.

Преимущества:

У субагента своё чистое контекстное окно. Техническая информация (например, HTML-разметка при веб-поиске) остаётся у него и не захламляет контекст главного агента.
Главный агент получает только сжатый, готовый ответ.
После выполнения задачи субагент автоматически удаляется.
Для субагентов можно использовать более дешёвые модели (например, Sonnet вместо Opus).

Популярные кейсы:

Веб-поиск (Websearch) — самый наглядный пример.
Code Reviewer — проверка кода "свежим взглядом".
Researcher — исследование кодовой базы или поиск информации.
Q&A — тестирование и ответы на вопросы по коду.

Как создавать: Можно попросить самого Claude создать субагента с нужными параметрами.

MCP (Model Context Protocol)

MCP — протоколы для подключения внешних сервисов и инструментов к Claude.

Must-have MCP:

Context 7 — даёт доступ к актуальной документации библиотек и фреймворков (обучение Claude заканчивается ~осенью 2025). Позволяет избежать ошибок из-за устаревших знаний.
Playwright — позволяет управлять браузером (открывать вкладки, кликать, заполнять формы). Полезен для тестирования через UI и автоматизации действий в браузере.

Важно: MCP сильно грузят контекстное окно, поэтому не стоит устанавливать много ненужных протоколов.

Память (Memory) и Контекстное окно

Memory.md

Универсальный файл, куда Claude может записывать информацию о пользователе (например, предпочтения, факты).
По сути, это ещё один системный промпт, но с менее прикладным смыслом.

Управление контекстным окном

Контекстное окно заполняется: системными промптами (claude.md), описаниями MCP, описаниями агентов и скилов, историей диалога, системными инструментами.
Переполнение контекста делает модель "тупее".
Как экономить контекст:
- Использовать скилы (загружаются по требованию).
- Минимизировать количество MCP.
- Использовать субагентов для ресурсоёмких задач.
- Писать краткие и точные промпты.
- Использовать команду /compact для сжатия истории.
- Можно мониторить заполненность через statusline в терминале.

Продвинутые методики

Agent Teams

Новая фича, где несколько полноценных экземпляров Claude (каждый со своими скилами и MCP) работают вместе над одной задачей.
Агенты общаются между собой, имеют общий скратчпад и распределяют работу, как настоящая команда (например, backend, frontend, SQL).
Пока в бета-версии, требует допиливания.

Work 3 (Параллельная работа)

Методология для работы над одним проектом из нескольких окон Claude одновременно.
Проблема: Агенты в разных окнах конфликтуют, редактируя одни и те же файлы.
Решение (Skill Work 3): Каждому агенту создаётся копия проекта, в которой он работает изолированно. После завершения задач все изменения мерджатся (объединяются) в основной проект, а конфликты разрешаются.
Позволяет ускорить работу в 4-5 раз.

Практика: Создание простого сайта

Задача: Создать сайт «Крестики-нолики» в разных стилях.

Процесс:

Открыть несколько вкладок с Claude Code.
В каждой включить Plan Mode и дать задачу: «Создай сайт крестики-нолики в стиле [Хакерский/Морской/Райский]».
Утвердить детальные планы.
Включить режим Bypass Permissions и запустить выполнение.
Claude Code создаст HTML, CSS, JS файлы, реализует логику игры и стилизацию.
Попросить доработать (добавить адаптивность, игру с компьютером).

Итог: За несколько минут создано несколько рабочих прототипов сайтов.

Лучшие практики от создателя Claude Code

Всегда начинайте с /plan — сначала создайте и доведите до идеала план, и только потом приступайте к написанию кода.
Просите Claude проверять свою работу — это создаёт цикл обратной связи и может в 3 раза улучшить итоговый результат.
Создавайте скилы и субагентов для ситуаций, где Claude регулярно спотыкается.
Работайте параллельно — используйте несколько окон (Agent Teams или Work 3) для одновременной работы над разными частями проекта.

Выводы

Claude Code — мощнейший инструмент для автоматизации и создания ПО, не требующий навыков программирования.
Начинать лучше с расширения в VS Code.
Для продуктивной работы рекомендуется подписка Max ($200/мес) и режим Bypass Permissions.
Кастомизация через папку .claude (правила, скилы, хуки) делает работу невероятно эффективной.
Ключ к успеху — менять мышление: не делать сложные настройки вручную, а просить об этом самого Claude Code.