← Назад на сайт denisyudin.com

Claude Code — полный курс (конспект)

Конспект видеокурса по Claude Code на русском языке. Автор — практик, использующий Claude Code ежедневно с момента выхода для построения агентных систем, автоматизации бизнес-процессов (CRM, парсинг конкурентов, аналитика метрик, маркетинг, продажи). Опыт автоматизаций в бизнесе — более 5 лет.

  1. Введение и обзор курса
  2. Регистрация и тарифы Anthropic
  3. Установка Claude Code
  4. Среды разработки (IDE)
  5. Терминал vs расширение VS Code
  6. Токены, контекст и стоимость
  7. Модели: Opus, Sonnet, Haiku
  8. Режимы работы и Bypass Permissions
  9. Файл CLAUDE.md — мозг проекта
  10. Практика: создание сайта с нуля
  11. Папка .claude и её структура
  12. Скиллы (Skills)
  13. Субагенты
  14. MCP (Model Context Protocol)
  15. Agent Teams — агентные команды
  16. Агентная система на практике
  17. Деплой и подключение Telegram
  18. Remote Control с телефона

1. Введение и обзор курса

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

Программа курса

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

Тарифные планы

ТарифЦенаClaude CodeПримечание
Free$0НетClaude Code недоступен
Pro~$20ДаСтартовый вариант, базовые лимиты
Max (5x)$100Да5x больше использования, чем Pro
Max (20x)$200Да20x больше использования, чем Pro

Рекомендация: начинать с Pro ($20), при нехватке лимитов апгрейд до Max.

Регистрация

3. Установка Claude Code

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

ВариантВозможностиОграничения
Веб-версия (claude.ai → Code)Подключение GitHub-репозиториевНет доступа к локальным файлам
Десктоп-приложениеЛокальные файлы + GitHubОграниченный функционал
Терминал ⭐Полный функционал, все slash-команды, скиллы, MCPИнтерфейс терминала
Расширение VS Code ⭐Удобный интерфейс + файловый менеджерЧасть команд недоступна

Оптимальный вариант: терминал + VS Code (или Windsurf/Antigravity) для файлового менеджера.

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

macOS:

# Команда с официального сайта docs.anthropic.com
npm install -g @anthropic-ai/claude-code

Windows: аналогичная команда через PowerShell или командную строку.

После установки запуск:

claude

Авторизация

В терминале или расширении VS Code:

/login

4. Среды разработки (IDE)

VS Code

Windsurf (Antigravity)

Расширение Claude Code для VS Code

  1. Открыть Extensions (плитка слева)
  2. Найти "Claude Code" (официальное расширение)
  3. Установить
  4. Авторизоваться через /login

5. Терминал vs расширение VS Code

Преимущества терминала

Преимущества расширения VS Code

Ограничения расширения

6. Токены, контекст и стоимость

Что такое токены

Что попадает в контекст

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

Одна задача — один диалог. Не перегружать контекст. Желательно не более 50%.

Аналогия: контекст как рабочий день — утром голова свежая (контекст пустой), к вечеру голова забита (контекст переполнен), качество мышления падает.

Последствия переполненного контекста

Управление контекстом — ключевые команды

КомандаДействие
/contextПоказать содержимое контекста с процентным разбиением
/compactСжать диалог в краткое summary
/new или /clearНачать новый диалог с нуля

7. Модели: Opus, Sonnet, Haiku

Переключение модели

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

МодельНазначениеКонтекстСтоимость
Opus 4.6Архитектурные решения, глубокий research, сложные задачи1M токеновВысокая
SonnetИсполнительные задачи, написание кода по готовой спецификацииСтандартныйСредняя
HaikuБыстрые простые задачи, массовая обработка (API)СтандартныйНизкая

Рекомендации по выбору

Лайфхак: Opus Plan

/model opus-plan

Модель автоматически выбирает Opus или Sonnet в зависимости от сложности задачи. Экономит токены, но для критически сложных задач лучше вручную включить Opus.

Thinking Mode и Effort

ПараметрЗначенияВлияние
Thinking ModeOn / OffВключает/выключает режим размышлений
EffortLow / High / Max / AutoГлубина размышлений и расход токенов

Рекомендация: для Opus на сложных задачах — Max effort. Для исполнительных задач — можно снижать.

8. Режимы работы и Bypass Permissions

Четыре режима

РежимОписание
Ask Before EditsПодтверждение каждого действия вручную
Edit AutomaticallyФайлы редактируются автоматически, но инструменты (MCP, терминал) требуют подтверждения
Plan ModeТолько планирование, без изменений файлов
Bypass PermissionsПолная автономия, никаких подтверждений

Включение Bypass Permissions

Способ 1: через settings.json (глобальный или локальный)

{
  "default_mode": "bypass_permissions"
}

Способ 2: флаг при запуске

claude --dangerously-skip-permissions

Безопасность при Bypass Permissions

Обязательно настроить deny permissions в settings.json:

{
  "permissions": {
    "allow": ["Read", "Write", "Bash(...)"],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(export *)",
      "Bash(curl *)",
      "Read(.env)"
    ]
  }
}

Критические запреты:

9. Файл CLAUDE.md — мозг проекта

Назначение

CLAUDE.md — главная системная инструкция проекта. Читается агентом при каждом запуске, перед любым действием.

Что включает

Зачем нужен

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

Уровни CLAUDE.md

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

Порядок работы

  1. Создать пустую папку, открыть в VS Code
  2. Создать файл instructions.md — описание ТЗ (даже в свободной форме)
  3. Загрузить файл в Claude Code через @instructions.md
  4. Попросить агента задать уточняющие вопросы
  5. Ответить на вопросы
  6. Агент создаёт CLAUDE.md (системная инструкция проекта)
  7. После утверждения — агент приступает к реализации

Markdown-файлы — стандарт работы с AI-агентами

Профессиональный подход (для сложных сайтов)

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

11. Папка .claude и её структура

Типы папки .claude

ТипРасположениеОбласть действия
ЛокальнаяВ корне проекта .claude/Только текущий проект
ГлобальнаяСкрытая папка на компьютере ~/.claude/Все проекты

Структура папки .claude

.claude/
├── settings.json     # Настройки (permissions, mode, hooks)
├── agents/           # Субагенты (MD-файлы с инструкциями)
├── skills/           # Скиллы (папки с SKILL.md + скрипты)
├── rules/            # Отдельные модули правил
├── worktrees/        # Ветки кода (Git worktrees)
└── CLAUDE.md         # (опционально) системная инструкция

Глобальная директория содержит

settings.json — ключевые настройки

{
  "default_mode": "bypass_permissions",
  "experimental": {
    "agent_teams": true
  },
  "permissions": {
    "allow": [...],
    "deny": [...]
  },
  "hooks": {...},
  "effort_level": "max",
  "model": "opus",
  "theme": "dark",
  "auto_update": "latest",
  "notifications": "terminal_bell",
  "auto_compact": true,
  "verbose_output": true,
  "terminal_progress_bar": true,
  "rewind_checkpoints": true
}

12. Скиллы (Skills)

Что такое скилл

Скилл = инструкция (SKILL.md) + сопутствующие материалы (скрипты, шаблоны, референсы).

В отличие от простого MD-файла, скилл может включать:

Структура скилла (стандарт Anthropic)

skill-name/
├── SKILL.md          # Главная инструкция скилла
├── scripts/          # Python, JS, Shell-скрипты
├── references/       # Референсные материалы
├── templates/        # Шаблоны
└── assets/           # Активы, ресурсы

YAML-форматирование в SKILL.md

В начале каждого SKILL.md есть скрытый YAML-блок:

---
name: skill-name
description: Краткое описание того, что делает скилл
---

Зачем: агент при каждом запросе читает только name + description всех установленных скиллов (не весь файл). Это экономит контекст. Полный SKILL.md загружается только при вызове конкретного скилла.

Как агент выбирает скилл

  1. Пользователь пишет задачу
  2. Агент читает name + description всех установленных скиллов
  3. Определяет, какой скилл подходит
  4. Загружает полный SKILL.md только нужного скилла
  5. Выполняет задачу по инструкции

Важно: скилл может быть вызван автоматически (без явного указания) или через slash-команду /skill-name.

Установка скиллов

Маркетплейсы:

Команда установки:

# Из терминала (не из Claude Code)
claude skills install <repository-url> [skill-name]

При установке выбрать:

Безопасность скиллов

Внимание: проверяйте содержимое скиллов перед установкой! Вредоносные скиллы могут содержать инструкции для отправки API-ключей и паролей злоумышленникам.

Безопасные источники: Anthropic, Vercel, OpenAI, Microsoft, GitHub (официальные).

Примеры скиллов

13. Субагенты

Проблема без субагентов

Что такое субагент

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

Размещение субагентов

.claude/agents/
├── analyst.md
├── coordinator.md
├── reporter.md
├── scraper.md
└── youtube-analyzer.md

YAML-форматирование субагента

---
name: analyst
description: Анализирует собранные данные
tools:
  - Read
  - Write
  - Bash
model: opus
color: green
---

Параметры:

Оркестрация субагентов

Управление описывается в CLAUDE.md (или отдельном pipeline.md):

Pipeline: Координатор → Скрейпер → Аналитик → Репортёр → Координатор

Применение в разработке

Большие проекты разбиваются на чанки (chunks):

Переключение между субагентами (только терминал)

В терминале можно стрелками переключаться между:

В расширении VS Code это недоступно — видно только запуск и финальный результат.

14. MCP (Model Context Protocol)

Что такое MCP

MCP — протокол от Anthropic, объединяющий все API-запросы к внешним сервисам в единую схему. Аналогия: USB-хаб, через который подключаются внешние сервисы к AI-агенту.

Что даёт MCP

Альтернатива без MCP

Без MCP нужно вручную описывать каждый endpoint:

Установка MCP

Способ 1 — через агента:
Скопировать промт с маркетплейса → вставить в Claude Code → агент сам установит.

Способ 2 — через терминал:

claude mcp install <command>

Маркетплейсы: Smithery, GitHub

Управление MCP

/mcp          # Показать установленные MCP

Проблема MCP: нагрузка на контекст

Каждый MCP загружает описания всех своих инструментов в контекст при каждом сообщении.

Пример: Google Sheets MCP = 38 инструментов ≈ 2000 токенов.
10 MCP-серверов = ~20000 токенов в контексте постоянно.

Правило использования MCP

Частота использованияРекомендация
Каждый диалогMCP ✅
Раз в неделюСкилл ✅, MCP ❌
РедкоHTTP-запросы в скилле ✅

Лайфхак: конвертация MCP в скилл

Можно попросить Claude Code создать скилл из существующего MCP:

"У нас есть MCP Google Sheets. Проанализируй его документацию и создай скилл, который будет вызываться только по необходимости, используя Skill Creator."

Скилл загружается в контекст только при вызове, в отличие от MCP.

Примеры MCP

15. Agent Teams — агентные команды

Отличие от субагентов

ПараметрСубагентыAgent Teams
КонтекстИзолированныйОбщий (обмен информацией)
КоммуникацияТолько через главного агентаНапрямую между агентами
Расход токеновУмеренныйВысокий
НазначениеПростые параллельные задачиСложные задачи, требующие координации

Включение Agent Teams

В settings.json:

{
  "experimental": {
    "agent_teams": true
  }
}

В CLAUDE.md указать режим работы Agent Teams.

Как работает

  1. Агенты запускаются в параллельных сессиях
  2. Могут обмениваться данными между собой
  3. Могут запрашивать дополнительную информацию у других агентов
  4. Координатор управляет процессом

Визуализация с Tmux

tmux                    # Запуск Tmux
claude                  # Запуск Claude Code внутри Tmux

Tmux позволяет Claude Code автоматически создавать новые окна для каждого агента. Агенты отображаются в отдельных панелях с цветовой кодировкой.

Когда использовать

Предостережение

Agent Teams расходуют значительно больше токенов, чем обычные субагенты. Используйте только для сложных комплексных задач.

16. Агентная система на практике

Архитектура демо-системы

CLAUDE.md (оркестратор)
│
├── agents/
│   ├── router.md          # Координатор, маршрутизатор запросов
│   ├── deep-research.md   # Глубокий research по теме
│   ├── parser.md          # Парсинг веб-сайтов
│   ├── news-digest.md     # Поиск и дайджест новостей
│   ├── doc-analyzer.md    # Анализ документов (Word, PDF, CSV, Excel)
│   ├── report-generator.md # Генерация отчётов (PDF, Sheets, Excel)
│   ├── meeting-notes.md   # Выжимка из записей встреч
│   └── youtube-analyzer.md # Транскрипция и анализ YouTube
│
├── agent-runtime/
│   ├── outputs/           # Готовые отчёты (PDF, HTML, MD)
│   └── shared/            # Данные для обмена между агентами
│
└── skills/                # Установленные скиллы

Маршрутизация запросов (Router)

Ключевые слова в запросеАгент
"найди", "сравни", "исследуй"Deep Research
"собери с сайта", "скачай"Parser
"новости"News Digest
"проанализируй документ" + файлDoc Analyzer
"сделай отчёт"Report Generator
"заметки к встрече"Meeting Notes
YouTube-ссылкаYouTube Analyzer

Цепочки агентов

Принципы написания инструкций агентов

17. Деплой и подключение Telegram

Подключение Telegram-бота

Шаг 1: Создать бота в @BotFather

/start → /newbot → имя бота → @username_bot

Получить Bot Token.

Шаг 2: Установить плагин Telegram в Claude Code

# Команда с официального сайта Anthropic
claude plugins install telegram

Шаг 3: Сохранить токен бота

claude telegram set-token "YOUR_BOT_TOKEN"

Шаг 4: Установить Bun (runtime)

Шаг 5: Запустить в режиме channels

claude --channels

Шаг 6: Написать боту в Telegram → скопировать команду → вставить в Claude Code.

Результат

Полный доступ к агентной системе из Telegram:

Ограничение текущей интеграции

18. Remote Control с телефона

Настройка

В терминальном Claude Code:

/remote-control

Появится QR-код → отсканировать с телефона в приложении Claude.

Требования

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

Идеальный сценарий

Claude Code развёрнут на выделенном VPS-сервере (24/7) → доступ с телефона или любого устройства через:

Сводка ключевых команд

Slash-команды (терминал)

КомандаНазначение
/contextПоказать содержимое и загрузку контекста
/compactСжать диалог в summary
/new, /clearНовый диалог
/modelПереключить модель
/configНастройки Claude Code
/mcpУправление MCP-серверами
/usageПоказать использование лимитов
/statusВерсия, папка, показатели
/effortУровень размышлений (low/high/max/auto)
/voiceГолосовой ввод
/resumeВернуться к предыдущему диалогу
/rewindОткатиться до предыдущего сообщения (с откатом файлов)
/remote-controlПодключение телефона
!командаВыполнить bash-команду из Claude Code
Esc EscБыстрый вызов Rewind

Флаги запуска

claude                                    # Обычный запуск
claude --dangerously-skip-permissions     # Bypass Permissions
claude --channels                          # Режим каналов (Telegram)

Ключевые принципы работы с Claude Code

  1. Одна задача — один диалог. Не смешивать разные задачи в одном контексте.
  2. Контролировать контекст. Регулярно проверять /context, не превышать 50%.
  3. CLAUDE.md — основа проекта. Всё описание, архитектура, правила — в одном файле.
  4. Скиллы > MCP для редких задач. MCP загружает контекст постоянно, скиллы — по вызову.
  5. Субагенты для больших задач. Разбивать сложные задачи на изолированные субагенты.
  6. Agent Teams для комплексных задач. Когда агентам нужно обмениваться информацией.
  7. Безопасность: настраивать deny permissions, проверять скиллы перед установкой, не хранить секреты в доступных файлах.
  8. Правильная модель для задачи: Opus для сложного, Sonnet для исполнения, Haiku для массовой обработки.
  9. Markdown — стандарт коммуникации с AI-агентами.
  10. Простота инструкций: конкретно, но без лишнего. Чем проще — тем надёжнее.