Claude Code: туториал-2026

Источники:

1. Claude Code Clearly Explained — Greg Isenberg & Professor Ras
2. A Complete Guide to Claude Code — ALL Best Strategies — Cole Medin, ~50 мин, август 2025
3. My Claude Code Workflow for 2026 — ~20 мин, январь 2026
4. Private lesson on Claude Cowork & Claude Code — Борис (создатель Claude Code) — только часть про Claude Code

---

1. Фундаментальные принципы

Plan Mode — сначала план, потом код

📹 Clearly Explained — 5:31 | 📹 Workflow 2026 — 12:18

• Всегда начинай с Plan Mode (Shift+Tab) для сложных и многофайловых задач
• Claude покажет пошаговый план: структуру проекта, модели, фазы, решения
• Просмотри план, откорректируй ("Используй TypeScript, не JS"), одобри → только потом выполнение
• Это как парное программирование: Claude предлагает, ты утверждаешь
• Plan Mode запускает субагентов для сканирования кодовой базы на паттерны — предотвращает архитектурный дрейф

Думай фичами, не продуктом

📹 Clearly Explained — 1:22

• Не описывай продукт абстрактно — перечисли конкретные фичи
• Пиши тест на каждую фичу. Claude реализует фичу → прогоняет тест → если пройден — переходит к следующей
• Последовательный подход "фича за фичей" предотвращает хаос в коде

Claude Code как "деятель", не чат

📹 Clearly Explained — 14:52

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

Человек = оркестратор

📹 Workflow 2026 — 3:35

• В 2026 парадигма сместилась: не "AI пишет код", а "AI выполняет работу"
• Ты — архитектор и ревьюер: пишешь спеки, делегируешь слайсы (маленькие PR), проверяешь результат
• Стек: модели → агенты (Claude Code) → MCP-коннекторы → guardrails (ограждения)

---

2. CLAUDE.md — ваша корпоративная память

📹 Complete Guide — 4:50

Структура файла (3 уровня)

• The What — технологический стек, структура проекта, ключевые пакеты
• The Why — зачем каждый компонент, архитектурные решения
• The How — правила: "запускай тесты после каждого изменения", стандарты кода

Как создать

• Команда /init — автоматическая генерация на основе кодовой базы
• Claude читает этот файл первым при каждом запуске
• Каждая ошибка Claude → новое правило в CLAUDE.md — это компаундинг памяти команды

Глобальные правила (Global Rules)

📹 Complete Guide — 4:50

• Файл ~/.claude/claude.md (глобальный) — действует как системный промпт для всех проектов
• Используй для общих предпочтений: язык ответов, стиль кода, линтинг, поведение по умолчанию
• Проектный .claude.md в корне репо — для правил конкретного проекта
• Оба файла загружаются автоматически при старте сессии

---

3. Hooks — автоматизация рутины

📹 Complete Guide — 30:23

Хуки — это shell-скрипты, запускаемые на определённых этапах жизненного цикла:

• PreToolUse — перед редактированием. Валидация формата, линтинг перед записью
• PostToolUse — после редактирования. Автоформатирование кода (prettier, black)
• Stop — по завершении задачи. Уведомление в Slack/Telegram
• SessionStart — начало сессии. Автозапись в журнал разработки
• SessionEnd — конец сессии. Автокоммит, логирование итогов
• PreCompact — перед компактификацией. Кастомные инструкции сжатия

Настраивай через /hooks или JSON с матчерами (regex: Edit|Write).

Рекомендации:

• Используй block-at-submit, не at-write — больше контроля
• Начинай с малого: добавляй хуки на реальные ошибки Claude

---

4. Контекст и промпты

Давай точный контекст

📹 Clearly Explained — 9:30 | 📹 Complete Guide — 8:38

• Используй @ для подключения файлов: @customer_data.csv, @src/
• Загружай реальные данные, а не описывай их словами
• Указывай конкретные API, параметры, сплиты (70/30, random_state=42)

Формулируй позитивно

• ❌ "Не используй jQuery"
• ✅ "Используй vanilla JS для DOM-манипуляций"
• Фокус на "делай так", а не "не делай так"

Проси уточнять

📹 Clearly Explained — 9:30

• Инструктируй Claude: "Если уверенность < 90%, спроси меня"
• Пусть предлагает варианты, а не угадывает

Context Engineering и PRP Framework

📹 Complete Guide — 19:24

• Context Engineering — замена "vibe coding": вместо размытых промптов предоставляй структурированный контекст
• PRP (Product Requirements Planning): архитектура → best practices → правила проекта → примеры кода → валидация
• Давай полный контекст репозитория (GitHub import, открытые файлы) — избегай "context rot"
• Определяй success criteria, user journeys, edge cases до начала работы
• Чем точнее контекст, тем надёжнее результат — это инженерная дисциплина, а не магия промптов

---

5. Extended Thinking — глубокое размышление

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

---

6. Skills (навыки) — повторяемые инструкции

• Skill = набор инструкций, которому Claude следует как рецепту
• Вместо повторного объяснения предпочтений каждый раз — создай skill один раз
• Можно комбинировать skills с контекстными источниками знаний
• Извлекай системные промпты из успешных проектов → конвертируй в skills

---

7. YOLO Mode — полная автономия

📹 Complete Guide — 9:26

Что это

Флаг --dangerously-skip-permissions, отключающий все подтверждения — Claude создаёт, редактирует, удаляет файлы и запускает команды без вопросов.

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

• ✅ Песочницы, Docker-контейнеры, изолированные среды
• ✅ Быстрое прототипирование и эксперименты
• ✅ CI/CD пайплайны с автоматическими тестами
• ❌ Продакшн-серверы
• ❌ Системы с чувствительными данными

Настройки автономности (Permissions)

• Помимо YOLO, можно гранулярно настраивать разрешения: какие команды разрешены без подтверждения
• "Accept all" в VS Code — ускоряет работу, когда доверяешь Claude
• Рекомендация: начни с подтверждениями, постепенно расширяй автономию по мере доверия

---

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

📹 Complete Guide — 25:51 | 📹 Workflow 2026 — 15:42

Концепция

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

Применения

• 3 субагента одновременно анализируют разные части кодовой базы
• Один агент исследует решение, другой пишет тесты, третий — документацию
• Субагент для веб-поиска добавляет результаты в контекст основного агента

Субагенты vs роли

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

---

9. Параллельные агенты (Parallel Workflows)

📹 Workflow 2026 — 10:04

Стратегии

• Запусти несколько экземпляров Claude Code в разных терминалах/вкладках
• Каждый работает над своей задачей/фичей независимо
• Используй форки репо для экспериментов и обучения

Оптимизация

• Короткие циклы для интерактивных задач — можно прервать и скорректировать
• Длинные автономные задачи (до 7 часов) — для полной реализации фичи
• Комбинируй с YOLO mode для максимальной скорости

---

10. Git Checkpoints — страховка от ошибок

Принцип

Git как safety net: коммить перед каждой крупной операцией Claude.

Практика

• Инструктируй Claude: "Сделай git commit перед началом рефакторинга"
• В YOLO mode Claude может коммитить автоматически
• Используй промпт: "Add tests, run them, fix failures, commit to git checkpoint before ending"
• При ошибке — git diff покажет что изменилось, git checkout вернёт назад
• Рекомендация: devlog.md для логирования контекста между сессиями

---

11. /compact — управление контекстом

Что делает

Сжимает историю разговора в краткое резюме, сохраняя ключевые решения и изменения. Освобождает контекстное окно.

Как использовать

• /compact — стандартное сжатие всей истории
• /compact Только to-do и изменения кода — управляемое сжатие с инструкцией
• /clear — полная очистка без сохранения
• /context — показать использование контекста

Стратегия

• Запускай /compact после каждого завершённого milestone
• Автокомпакт срабатывает при приближении к лимиту — но ручной запуск предсказуемее
• Отключай неиспользуемые MCP-серверы перед компактификацией — экономит токены
• Кастомизируй через PreCompact хук или секцию "Compact Instructions" в CLAUDE.md

---

12. Custom Slash-команды

📹 Complete Guide — 11:22

Встроенные

• /init — генерация CLAUDE.md
• /clear — очистка контекста
• /compact — сжатие контекста
• /hooks — настройка хуков
• /context — информация о контексте
• /output-style explanatory — объяснительный режим
• /output-style learning — обучающий режим

Пользовательские команды

Создавай свои slash-команды через файлы в .claude/commands/:

.claude/commands/
├── bug.md      → /bug
├── test.md     → /test
├── pr.md       → /pr
├── review.md   → /review
└── migrate.md  → /migrate

Пример .claude/commands/bug.md:

Найди и исправь баг: $ARGUMENTS
1. Проанализируй стектрейс
2. Найди root cause
3. Напиши fix + тест
4. Запусти тесты
5. Запиши в devlog.md с таймстампом

Пример .claude/commands/test.md:

Напиши тесты для: $ARGUMENTS
1. Определи edge cases
2. Напиши unit тесты
3. Запусти, исправь failures
4. Цель: coverage 80%+

---

13. MCP серверы — расширение возможностей

📹 Complete Guide — 14:31

Что это

Model Context Protocol — стандарт подключения внешних инструментов к Claude Code. "Context on tap" — без ручного копирования.

Популярные MCP-серверы

• GitHub — доступ к репозиториям, PR, issues
• Linear — тикеты, спринты, статусы задач
• Sentry — ошибки, стектрейсы, мониторинг
• Obsidian — заметки, база знаний
• Postgres/Supabase — прямой доступ к БД
• Crawl4AI — RAG и веб-скрейпинг
• Context7 — актуальная документация библиотек прямо в контексте
• Docs search — поиск по документации

Настройка

• Конфигурируется в .claude/mcp_servers.json
• Можно ограничить доступ: read-only для feature flags, full для dev DB
• Отключай неиспользуемые серверы — экономит контекст

---

14. Голосовая диктовка

📹 Workflow 2026 — 11:32

Зачем

Быстрее формулировать идеи голосом, чем печатать. Особенно для спецификаций и высокоуровневых инструкций.

Как применять

• Диктуй спеки и архитектурные решения — Claude понимает естественный язык
• Прерывай длинные сессии голосом для быстрых корректировок
• Комбинируй с параллельными агентами: диктуешь одному → переключаешься к другому
• Инструменты: встроенная диктовка OS, Whisper, SuperWhisper

---

15. Автоматический журнал разработки (Dev Journal)

Концепция

Файл (devlog.md, development_diary.json), в который Claude автоматически записывает прогресс.

Что записывать

• Завершённые задачи с таймстампами
• Принятые архитектурные решения и почему
• Обнаруженные баги и их фиксы
• To-do на следующую сессию

Автоматизация

• Хук SessionEnd → Claude дописывает итоги в журнал
• Инструкция в CLAUDE.md: "После каждого milestone обнови devlog.md"
• При /compact — включай контент из журнала в резюме
• Полезно при работе в YOLO mode: журнал = аудит действий

---

16. Рабочий процесс

📹 Workflow 2026 — 0:32 | 📹 Clearly Explained — 16:36

Итеративная структура

1. Видео-спек / детальная спецификация — начни с описания scope, constraints, edge cases — 📹 Workflow 2026 — 0:32
2. Plan Mode — Claude генерирует план, субагенты сканируют кодовую базу — 📹 Clearly Explained — 5:31
3. Делегируй слайсами — маленькие PR, тесты на каждый
4. Ревью через diff-gazing — проверяй «форму» диффов, углубляйся только если что-то не так — 📹 Workflow 2026 — 14:17
5. Итерируй — /compact между milestone'ами
6. Ставь follow-up задачи в очередь

Параллельная работа

📹 Workflow 2026 — 10:04

• Запусти задачу → пока Claude работает, переключись на другой терминал
• Несколько экземпляров Claude Code одновременно экономят время
• Форки репо для экспериментов

---

17. Верификация и безопасность

📹 Clearly Explained — 18:41

Проверяй выходные данные

• Давай Claude инструменты для самопроверки (браузер, тесты)
• Не полагайся только на AI — ручной аудит обязателен
• Определяй "done" заранее: что значит "задача выполнена"
• Test-first: AI генерирует тесты → запускает → исправляет failures → отчитывается

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

• Claude Code запрашивает подтверждение перед деструктивными действиями (если не YOLO mode)
• Reverse elicitation: Claude спрашивает, а не предполагает
• Environment variables для секретов — никогда не хардкодь
• Обязательные тесты на каждую задачу
• Git checkpoints как страховка (см. раздел 10)

---

18. Интеграции

VS Code

• Установи расширение Claude Code (Anthropic-verified)
• Тестируй с простых задач ("add hello world")
• Включи "Accept all" когда доверяешь — ускоряет работу

MCP (Model Context Protocol)

📹 Complete Guide — 14:31

• Подключай внешние инструменты и серверы (см. раздел 13)
• Расширяет возможности Claude за пределы файловой системы
• Используй для субагентов и кастомных команд

Браузер (через MCP)

• Через MCP-серверы Claude Code может взаимодействовать с браузером
• Полезно для тестирования веб-приложений и исследований

---

19. Типичные ошибки

📹 Clearly Explained — 23:48 | 📹 Workflow 2026 — 12:18

• Бросаться в код без плана → всегда Plan Mode первым
• Негативные инструкции ("не делай X") → позитивные ("делай Y")
• Вагальные промпты → конкретные фичи, файлы, параметры
• Игнорирование ошибок Claude → добавлять правила в CLAUDE.md
• Одна задача за раз → параллельные потоки
• Не определять "done" → критерии завершения в промпте
• Ручное копирование контекста → MCP-серверы для автодоступа
• Переполнение контекста → /compact после milestone'ов
• Нет страховки от ошибок AI → Git checkpoints перед крупными изменениями
• Архитектурный дрейф при параллельных агентах → общие паттерны в CLAUDE.md — 📹 Workflow 2026 — 12:18

---

20. Неожиданные применения

• Обучение: форки репо + Claude Code для изучения незнакомых кодовых баз — 📹 Workflow 2026 — 18:44
• Рефакторинг: анализ 18k+ строк, поиск паттернов и зависимостей
• Миграции: переход между фреймворками, обновление API
• Документация: автогенерация README, JSDoc, API docs из кода
• Code review: анализ PR, поиск багов, предложения по улучшению

---

Что читать дальше

• Если бы я делал курс по вайб-кодингу, он был бы таким — полный план обучения от настройки IDE до архитектуры
• GitHub, Docker и деплой: база вайб-кодера — практический набор инструментов для деплоя вашего проекта