Полный курс по Claude Code: от установки до создания агентных систем

Ключевые тезисы

Claude Code — мощный инструмент для автоматизации, который кратно усиливает продуктивность в бизнесе и личных задачах.
Не требует технической подготовки или навыков программирования.
Позволяет создавать сложные агентные системы, автоматизировать парсинг, анализ метрик, CRM и маркетинг.
Основные компоненты системы: скиллы (Skills), агенты (Agents) и субагенты (Sub-agents).
Для интеграции с внешними сервисами используется MCP (Model Context Protocol).
Курс построен от азов к сложности, с практическим созданием реальных проектов.

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

Регистрация и тарифы

Доступен только на платных тарифах: Pro ($17-20) и Max ($100+).
Рекомендация: для серьёзных проектов лучше тариф Max.
Для оплаты требуется зарубежная карта и номер, но есть сервисы-посредники (ссылки в Telegram-канале автора).

Варианты использования Claude Code

Веб-версия — ограниченный функционал, можно подключать только GitHub-репозитории.
Десктопное приложение — похоже на веб-версию, но позволяет подключать локальные файлы.
Терминальный Claude Code — самый продвинутый вариант с максимальным функционалом.
Расширение в VS Code/Antigravity — удобный интерфейс для работы с файлами.

Установка терминального Claude Code

Перейти на сайт clod.com.
Найти команду для установки в терминал:
- MacOS: curl -L https://clod.com/install.sh | sh
- Windows: использовать командную строку или PowerShell.
После установки запускать командой clod.

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

Почему Claude Code лучше обычного чата?

Имеет доступ к файловой системе компьютера.
Может выполнять терминальные команды.
Подключается к внешним сервисам.
Способен выполнять сложные многошаговые задачи.
Позволяет создавать настоящие агентные системы с несколькими AI-агентами.

Терминальный Claude Code: преимущества

Полная информация: видна модель, загрузка контекста, лимиты, текущая папка.
Кастомизация: можно добавлять кастомные статус-линии.
Больше слэш-команд: расширенный набор команд по сравнению с другими версиями.
Несколько инстансов: можно запускать несколько окон одновременно в одном проекте.
Терминал vs Расширение: Некоторые функции (например, переключение между субагентами) доступны только в терминальной версии Claude Code.

Расширение в VS Code/Antigravity

Удобный файловый менеджер для просмотра и редактирования файлов.
Быстрое переключение между файлами.
Поддержка плагинов для работы с разными форматами файлов.
Интегрированный терминал для запуска Claude Code.

Установка расширения:

В VS Code перейти в раздел Extensions.
Найти "clodcode" (официальное расширение).
Установить и выполнить команду /login для авторизации.

Основные принципы работы и настройки

Контекст и токены

Контекст — оперативная память модели, куда загружаются все файлы и история диалога.
Токены — единицы измерения информации (~0.75 слова).
Важно контролировать контекст: при переполнении модель становится "тупее" и дороже в использовании.

Правила работы с контекстом

Одна задача — один диалог.
Следить за заполнением контекста (желательно не более 50%).
Использовать команды для управления контекстом.

Ключевые команды для управления контекстом

/context — показать текущее состояние контекста.
/compact — сжать диалог до краткого summary.
/new или /clear — начать новый диалог.
/attach — прикрепить файл или упомянуть через @.

Основные настройки Claude Code

Gitignore: Ограничивает доступ агента к определённым файлам.
Update: Обычно устанавливается latest для автоматического обновления.
Theme: Поддержка светлой/тёмной темы терминала.
Notifications: Звуковые уведомления о завершении задач.
Effort: Уровень "размышлений" агента (low, high, max, auto). Рекомендуется high или max.
Voice mode: Возможность диктовать команды голосом.
Resume: Возобновление предыдущего диалога в проекте.
Rewind: Просмотр истории сообщений и откат к предыдущим состояниям (вызывается двойным нажатием Esc).

Слэш-команды и настройки

! — включение BSH mode (терминальный режим).
/config — настройка конфигурации Claude Code.
/skills — управление скилами.

Важные настройки в `/config`

Autocompact — автоматическое сжатие диалога.
Thinking mode — размышляющий режим.
Rewind cod — создание чекпоинтов для отката изменений.
Verb output — показ логики размышлений модели.
Respect Git ignore — уважение файла .gitignore.

Модели Claude Code

Сравнение моделей

Opus 4.6 — самая мощная модель.
- 1 млн контекста.
- Для глубокого ресерча и архитектурных задач.
- Самая дорогая в использовании.
Sonet — для исполнительных задач.
- Хорош для написания кода по готовым инструкциям.
- Баланс цены и качества.
Haiku — для быстрых и дешёвых задач.
- Самая быстрая и экономичная модель.
- Для обработки больших массивов простой информации.

Лайфхак: Opus Plan

Автоматический выбор модели в зависимости от задачи.
Экономит токены на подписке Pro.
Для сложных задач лучше включать Opus целенаправленно.

Режимы работы Claude Code

Четыре основных режима

Ask before edits — запрашивает разрешение на каждое действие.
Edit automatically — автоматически редактирует файлы, но спрашивает разрешение на инструменты.
Plan mode — только создаёт план без выполнения действий.
Bypass Permissions — полный доступ без запросов разрешения.

Включение Bypass Permissions

Вариант 1: Через настройки в файле settings.json.
Вариант 2: Через терминал с флагом --dangerously-skip-permissions.

Внимание: в режиме Bypass Permissions Claude Code будет выполнять все действия без подтверждения, включая потенциально опасные операции!

Безопасная настройка permissions

Добавить в settings.json запреты на:
- Чтение файла .env с API-ключами.
- Выполнение опасных команд (например, rm -rf *).
- Экспорт данных во внешние источники.
Настроить хуки для уведомлений о завершении задач.

Системная папка `.clod`

Два типа папок `.clod`

Локальная — настройки только для текущего проекта.
Глобальная — настройки для всех проектов.

Структура папки `.clod`

settings.json — главный файл настроек.
skills/ — папка со скилами (навыками).
rules/ — правила для проекта.
agents/ — субагенты.
work_trees/ — ветки для разных вариантов кода.

Файл `settings.json`

Включает экспериментальные функции (например, Agent Teams).
Определяет permissions и запреты.
Настраивает хуки (триггеры событий).
Устанавливает уровень effort и другие параметры.

Скиллы (Skills)

Скилл — это набор инструкций (Markdown-файл skill.md) и сопутствующих материалов (скрипты, шаблоны, референсы), который расширяет возможности агента.

Особенности и преимущества

Экономия контекста: Агент читает не весь скилл, а только его краткое описание в YAML-формате (название и description). Это позволяет устанавливать десятки скиллов без перегрузки контекста.
Автоматический вызов: Агент сам анализирует задачу и запускает подходящий скилл. Можно также вызвать вручную через слэш-команду (/).
Готовые библиотеки: Существуют маркетплейсы (Skills Age, Smizery) с тысячами готовых скиллов на любой случай.

Безопасность

При установке скилов из ненадёжных источников есть риск запуска вредоносного кода. Рекомендуется:

Устанавливать скилы от проверенных поставщиков (Anthropic, Microsoft и др.).
Проверять содержимое skill.md перед установкой.
Настраивать разрешённые команды для агента.

Установка скила (на примере Skills Age)

Скопировать команду установки с маркетплейса.
Вставить команду в терминал VS Code или Cursor.
Выбрать скиллы для установки (через пробел).
Выбрать программу (Claude Code, Cursor и т.д.).
Выбрать область установки (Project или глобально).

Пример работы: Установлен скилл agent-browser. При запросе "открой сайт и сделай скриншот" агент автоматически запускает этот скилл, парсит сайт и сохраняет изображение.

Агенты и субагенты (Agents & Sub-agents)

Агенты — это Markdown-файлы с инструкциями в папке .claude/agents. Они позволяют выполнять сложные задачи, разбивая их на параллельные или последовательные этапы.

Зачем нужны субагенты?

Экономия контекста: Каждый субагент запускается в "чистой" среде, не загружая историю основного диалога.
Параллелизм: Можно запускать несколько агентов одновременно для разных подзадач.
Специализация: Каждый агент выполняет свою узкую роль (аналитик, парсер, репортёр и т.д.).

Архитектура агентной системы

Главный агент (Team Lead / Router): Координатор в файле claude.md. Анализирует запрос пользователя и решает, какого агента или цепочку агентов запустить.
Специализированные агенты: Выполняют конкретные задачи (парсинг, анализ, генерация отчётов).
Папка runtime/: Хранит результаты работы (outputs/) и технические данные для обмена между агентами (shared/).

Пример пайплайна:

Пользователь просит проанализировать новости с сайта.
Роутер запускает Парсер → тот скачивает данные.
Роутер передаёт данные Аналитику → тот обрабатывает информацию.
Роутер передаёт вывод Репортёру → тот создаёт PDF/Excel отчёт.
Роутер получает финальный результат и выдаёт его пользователю.

Преимущество: Вся цепочка выполняется в рамках одного диалога, но с изоляцией контекста для каждого этапа.

Интеграция с внешними сервисами (MCP)

MCP (Model Context Protocol) — это протокол для подключения Claude Code к внешним сервисам (Google Таблицы, Notion, YouTube и др.).

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

Простота: Не нужно вручную описывать API каждого сервиса. MCP предоставляет агенту готовые инструкции по использованию инструментов.
Установка в два клика: Можно установить через промт в Claude Code или команду в терминале.
Широкий выбор: Существуют библиотеки готовых MCP-серверов для популярных сервисов.

Главный недостаток MCP

Перегрузка контекста: Все инструменты подключённого MCP загружаются в контекст при каждом запуске агента (например, Google Таблицы "весят" ~2000 токенов). Установка нескольких MCP быстро исчерпывает лимит контекста.

Альтернатива MCP: Скиллы для API

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

Лайфхак: Можно попросить Claude Code проанализировать документацию MCP и создать на её основе оптимизированный скилл, который не будет нагружать контекст.

Практика: создание сайта с нуля

Пошаговый процесс

Создание папки проекта в VS Code.
Написание инструкции в файле instruction.md.
Загрузка инструкции в Claude Code через @.
Уточняющие вопросы от Claude для детализации ТЗ.
Создание файла clod.md — системной инструкции проекта.
Реализация сайта по созданному плану.

Ключевые моменты

Markdown (.md) — золотой стандарт для работы с AI-агентами.
Файл clod.md — главная инструкция, которую читает агент при каждом запуске.
Новый диалог для новой задачи — лучшая практика для экономии контекста.

Результат

Сайт создаётся за 5-10 минут.
Поддерживает анимации, параллакс-эффекты, адаптивность.
Возможность доработки: изменение шрифтов, цветов, функционала.

Агентные команды (Agent Teams) в Claude Code

Ключевые тезисы:

Agent Teams — это новейшая функция Claude Code, позволяющая объединять агентов в команды для решения комплексных задач.
Агенты в команде могут общаться друг с другом, обмениваться контекстом и уточнять информацию, что повышает качество итогового результата.
Режим потребляет много токенов, поэтому рекомендуется для сложных задач, где важна глубина анализа.
Систему можно интегрировать с Telegram и мобильным приложением Claude для удалённого доступа.
Готовые проекты и конфигурации доступны для бесплатного скачивания.

Демонстрация работы Agent Teams

Задача: Создать детальный аналитический отчёт по курсу доллара к рублю с прогнозом на ближайшие месяцы.

Процесс выполнения:

Формирование команды: Главный агент (Team Lead) создал команду специализированных агентов:
- News Digest — для анализа новостной повестки.
- Deep Research — для углублённого исследования.
- Parser — для парсинга указанных сайтов.
- Report Generator — для генерации финального отчёта.
Визуализация: Каждый агент в терминале был выделен своим цветом, что позволяло в реальном времени наблюдать за их общением и распределением задач