claude-howto: визуальный гид по Claude Code — от базы до многоагентных систем

«Вы установили Claude Code, запустили несколько промптов. Что дальше?» — именно с этого вопроса начинается репозиторий claude-howto, и именно на него он отвечает исчерпывающе.

Что это и для кого

claude-howto — это открытый обучающий репозиторий на GitHub, созданный разработчиком luongnv89. Это не очередной справочник фич — это структурированный, визуальный, основанный на примерах гид, который учит использовать каждую возможность Claude Code с помощью реальных шаблонов, которые можно скопировать в свой проект прямо сейчас.

Актуальная версия — v2.1.119 (апрель 2026 года), совместима с Claude Code 2.1+.

Целевая аудитория:

  • Разработчики, которые уже установили Claude Code, но не знают, как раскрыть его потенциал
  • Тимлиды, желающие внедрить AI-воркфлоу в команду
  • DevOps-инженеры, автоматизирующие CI/CD с помощью Claude
  • Все, кто хочет перейти от «набил пару промптов» к «оркестрирую агентные команды»
ℹ Проблема, которую решает проект
Официальная документация описывает фичи, но не показывает, как их комбинировать. Вы знаете, что slash-команды существуют, но не знаете, как связать их с хуками, памятью и subagents в воркфлоу, который реально экономит часы.

Структура репозитория

Папки пронумерованы в рекомендованном порядке изучения:

├── 01-slash-commands/     # Пользовательские ярлыки-команды
├── 02-memory/             # Примеры персистентного контекста
├── 03-skills/             # Переиспользуемые навыки
├── 04-subagents/          # Специализированные AI-ассистенты
├── 05-mcp/                # Примеры Model Context Protocol
├── 06-hooks/              # Событийная автоматизация
├── 07-plugins/            # Бандлы фич
├── 08-checkpoints/        # Снимки сессий
├── 09-advanced-features/  # Планирование, мышление, фоновые задачи
├── 10-cli/                # Справочник CLI
└── scripts/               # Сборочные и утилитарные скрипты

Ключевые возможности

1. Slash-команды и Skills

Agent Skills — это модульные возможности, которые превращают универсальных агентов в специалистов. В отличие от промптов (инструкций уровня беседы для разовых задач), Skills загружаются по требованию и устраняют необходимость многократно давать одни и те же инструкции в разных разговорах.

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

---
name: deploy
description: Deploy the application to production
disable-model-invocation: true
allowed-tools: Bash(npm *), Bash(git *)
---
Deploy $ARGUMENTS to production:
1. Run the test suite: `npm test`
2. Build the application: `npm run build`
3. Push to the deployment target
4. Verify the deployment succeeded
5. Report deployment status

2. Subagents и Agent Teams

Agent Teams координируют несколько экземпляров Claude Code, работающих вместе над сложными задачами. В отличие от subagents (которым делегируются подзадачи с возвратом результата), teammates работают независимо с собственными контекстными окнами и могут напрямую обмениваться сообщениями через общий почтовый ящик.

Пример вызова командной работы:

User: Build the authentication module.
Use a team — one teammate for the API endpoints,
one for the database schema, and one for the test suite.

3. Hooks — событийная автоматизация

Hooks — это событийная автоматизация, которая выполняет shell-команды при наступлении событий Claude Code.

Пример: автоматический security-скан после записи файла:

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write|Edit",
      "hooks": [{
        "type": "command",
        "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/security-scan.py"
      }]
    }]
  }
}

4. Memory — персистентный контекст

Memory — это персистентный контекст, который автоматически загружается между сессиями. Существует несколько уровней: Organization (управляется администраторами), Project (общий через git), User (личные настройки), Local (не коммитится), Session (авто-управление).

Быстрый старт за 15 минут:

# Slash-команды
cp 01-slash-commands/*.md .claude/commands/

# Память проекта
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# Установка навыка
cp -r 03-skills/code-review ~/.claude/skills/

5. Расширенные возможности: Ultraplan и Planning Mode

/ultraplan передаёт задачу планирования из локального CLI в облачную сессию Claude Code в режиме плана. Claude составляет план в облаке, пока ваш терминал остаётся свободным для другой работы, затем вы проверяете черновик в браузере и выбираете, где выполнять — в той же облачной сессии или обратно в терминале.

💡 Совет по быстрому старту
Запустите /self-assessment прямо в Claude Code для интерактивного теста, который оценит вашу компетентность по всем 10 областям фич и сгенерирует персонализированный учебный путь.

Путь обучения


graph TD
    A[🚀 Старт: /self-assessment] --> B{Ваш уровень?}
    B -->|Новичок| C[01 Slash-команды\n02 Memory\n⭐ 1-2 ч]
    B -->|Средний| D[03 Skills\n04 Subagents\n⭐⭐ 2-3 ч]
    B -->|Опытный| E[05 MCP\n06 Hooks\n07 Plugins\n⭐⭐⭐ 3-4 ч]
    C --> D
    D --> E
    E --> F[08 Checkpoints\n09 Advanced Features\n10 CLI Mastery\n⭐⭐⭐⭐ 2-3 ч]
    F --> G[🏆 Power User:\nAgent Teams + CI/CD + Plugins]

Репозиторий содержит 10 обучающих модулей, охватывающих все возможности Claude Code — от slash-команд до кастомных команд агентов; готовые к копированию конфиги — slash-команды, шаблоны CLAUDE.md, hook-скрипты, конфиги MCP, определения subagents и полные бандлы плагинов; Mermaid-диаграммы, объясняющие, как каждая фича работает внутри; управляемый учебный путь от новичка до опытного пользователя за 11–13 часов.

Цены и лицензия

claude-howto — MIT-лицензия, бесплатно навсегда. Используйте в личных проектах, на работе, в команде — без ограничений, кроме включения уведомления о лицензии.

Сам Claude Code (инструмент, для которого написан гайд) имеет следующие тарифы:

ПланЦенаПримечание
Pro$20/месВключает Claude Code, Sonnet 4.6, 5x vs Free
Max 5x$100/мес+Opus 4.7, приоритетный доступ
Max 20x$200/месМаксимальные лимиты, Opus без ограничений
Team Premium$100/seat/месМин. 5 мест, Claude Code включён
EnterpriseCustom500K контекст, HIPAA, SSO
APIPay-as-you-goSonnet 4.6: $3/$15 за 1M токенов
⚠ Важно по ценообразованию
Подписки Pro/Max/Team дают фиксированную ежемесячную плату с включённым использованием — Claude Code расходует тот же токен-бюджет, что и обычное использование Claude. При достижении лимита либо ждёте сброса окна, либо платите по стандартным API-тарифам.

Плюсы и минусы

✅ Плюсы❌ Минусы
Полностью бесплатно, MIT-лицензияНе обучает работе с самим Claude, только с Claude Code
Синхронизируется с каждым релизом Claude CodeТребует предварительной установки и настройки Claude Code
10 модулей, прогрессивный путь обучения за 11–13 часовОбъём материала может перегрузить новичков
Mermaid-диаграммы для понимания архитектуры, copy-paste шаблоныНет интерактивного веб-интерфейса — только markdown в GitHub
Сообщество принимает новые примеры, баг-репорты, улучшения документации и шаблоныБольшинство примеров — в bash/CLI, сложнее для Windows-пользователей
Поддержка EPUB: можно собрать электронную книгу для чтения офлайнНекоторые продвинутые фичи (Agent Teams, Ultraplan) — в Research Preview
Встроенная самооценка через /self-assessment и /lesson-quizНет видео-туториалов и интерактивных упражнений

Сравнение с альтернативами

Для контекста — сравним claude-howto с похожими обучающими ресурсами и подходами к освоению Claude Code:

Параметрclaude-howtoОфициальная документация AnthropicAider (открытая альтернатива CLI)
ТипОбучающий гид (open-source)Справочник фичСамостоятельный AI-инструмент
ЦенаБесплатно (MIT)БесплатноБесплатно (платите за API)
Диаграммы и шаблоны✅ Есть❌ Нет
Прогрессивный путь обучения✅ 10 модулей❌ Линейный справочник
Copy-paste конфиги✅ Все модули❌ Только примеры
Актуальностьv2.1.119, апрель 2026Иногда отстаётОтдельный продукт
МультимодельностьТолько Claude CodeТолько Claude CodeРаботает с Claude, GPT-4o, open-source моделями через единый интерфейс
Агентные команды✅ Agent Teams + subagentsОписание без туториалаТребует больше ручного управления, чем агентные возможности Claude Code
Оффлайн-чтение✅ EPUB❌ Только онлайн
📝 Пример быстрого старта

Чтобы начать работу с claude-howto за 15 минут:

git clone https://github.com/luongnv89/claude-howto
cd claude-howto
# Копируем slash-команды в проект
cp 01-slash-commands/*.md .claude/commands/
# Устанавливаем проектную память
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
# Запускаем в Claude Code
/self-assessment

Вердикт

claude-howto — один из лучших открытых ресурсов для тех, кто хочет перейти от поверхностного использования Claude Code к профессиональному владению инструментом. Официальная документация — это справочник фич. Этот гид — учебник с диаграммами, production-ready шаблонами и прогрессивным путём обучения. Они дополняют друг друга: начните здесь, обращайтесь к официальной документации за деталями.

Кому подойдёт:

  • ✅ Разработчикам, только осваивающим Claude Code
  • ✅ Командам, внедряющим AI-воркфлоу (hooks, subagents, CI/CD)
  • ✅ DevOps-инженерам, автоматизирующим пайплайны с AI
  • ❌ Тем, кто ищет готовый GUI-инструмент «из коробки»
  • ❌ Новичкам без опыта работы с терминалом

Рейтинг: 8.5 / 10

КритерийОценка
Качество материала9/10
Актуальность9/10
Практичность шаблонов9/10
Удобство навигации7/10
Порог входа7/10
Сообщество и поддержка8/10