<!-- i18n-source: README.md -->
<!-- i18n-source-sha: 63a1416 -->
<!-- i18n-date: 2026-04-10 -->

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="../resources/logos/claude-howto-logo-dark.svg">
  <img alt="Claude How To" src="../resources/logos/claude-howto-logo.svg">
</picture>

🌐 **Language / Мова:** [English](../README.md) | [Tiếng Việt](../vi/README.md) | [中文](../zh/README.md) | [Українська](README.md)

# Опануй Claude Code за вихідні

Від простого введення `claude` до оркестрації агентів, хуків, навичок та MCP-серверів — з візуальними туторіалами, готовими шаблонами та керованим навчальним шляхом.

**[Почни за 15 хвилин](#почни-за-15-хвилин)** | **[Визнач свій рівень](#не-знаєш-з-чого-почати)** | **[Каталог функцій](CATALOG.md)**

---

## Зміст

- [Проблема](#проблема)
- [Як Claude How To вирішує це](#як-claude-how-to-вирішує-це)
- [Як це працює](#як-це-працює)
- [Не знаєш з чого почати?](#не-знаєш-з-чого-почати)
- [Почни за 15 хвилин](#почни-за-15-хвилин)
- [Що можна побудувати?](#що-можна-побудувати)
- [FAQ](#faq)
- [Внесок](#внесок)
- [Ліцензія](#ліцензія)

---

## Проблема

Ви встановили Claude Code. Виконали кілька промптів. Що далі?

- **Офіційна документація описує функції — але не показує як їх комбінувати.** Ви знаєте, що слеш-команди існують, але не знаєте як поєднати їх з хуками, пам'яттю та субагентами в робочий процес, що реально економить години.
- **Немає чіткого навчального шляху.** Чи вивчати MCP перед хуками? Навички перед субагентами? В результаті ви переглядаєте все і не опановуєте нічого.
- **Приклади занадто базові.** "Hello world" слеш-команда не допоможе побудувати продакшен-пайплайн код-рев'ю, який використовує пам'ять, делегує спеціалізованим агентам та автоматично запускає перевірки безпеки.

Ви використовуєте лише 10% потужності Claude Code — і не знаєте, чого не знаєте.

---

## Як Claude How To вирішує це

Це не черговий довідник функцій. Це **структурований, візуальний, заснований на прикладах довідник**, що навчає використовувати кожну функцію Claude Code з реальними шаблонами, які можна скопіювати у ваш проєкт вже сьогодні.

| | Офіційна документація | Цей довідник |
|--|----------------------|-------------|
| **Формат** | Довідкова документація | Візуальні туторіали з Mermaid-діаграмами |
| **Глибина** | Опис функцій | Як працює під капотом |
| **Приклади** | Базові фрагменти | Готові до продакшену шаблони для негайного використання |
| **Структура** | Організовано за функціями | Прогресивний навчальний шлях (від початківця до просунутого) |
| **Онбординг** | Самостійне вивчення | Керована дорожня карта з оцінками часу |
| **Самооцінка** | Відсутня | Інтерактивні тести для пошуку прогалин та побудови персоналізованого шляху |

### Що ви отримаєте:

- **10 навчальних модулів**, що охоплюють кожну функцію Claude Code — від слеш-команд до кастомних команд агентів
- **Готові конфігурації** — слеш-команди, шаблони CLAUDE.md, скрипти хуків, конфіги MCP, визначення субагентів та повні пакети плагінів
- **Mermaid-діаграми**, що показують як кожна функція працює всередині, щоб ви розуміли *чому*, а не лише *як*
- **Керований навчальний шлях**, що проведе від початківця до досвідченого користувача за 11-13 годин
- **Вбудована самооцінка** — запустіть `/self-assessment` або `/lesson-quiz hooks` прямо у Claude Code для виявлення прогалин

**[Почати навчальний шлях ->](LEARNING-ROADMAP.md)**

---

## Як це працює

### 1. Визначте свій рівень

Пройдіть [тест самооцінки](LEARNING-ROADMAP.md#-визначте-свій-рівень) або запустіть `/self-assessment` у Claude Code. Отримайте персоналізовану дорожню карту на основі того, що ви вже знаєте.

### 2. Слідуйте керованому шляху

Проходьте 10 модулів по порядку — кожен будує на попередньому. Копіюйте шаблони безпосередньо у свій проєкт під час навчання.

### 3. Комбінуйте функції в робочі процеси

Справжня потужність — у комбінуванні функцій. Навчіться поєднувати слеш-команди + пам'ять + субагенти + хуки в автоматизовані пайплайни для код-рев'ю, розгортань та генерації документації.

### 4. Перевірте розуміння

Запустіть `/lesson-quiz [тема]` після кожного модуля. Тест точно вказує, що ви пропустили, щоб швидко заповнити прогалини.

**[Почни за 15 хвилин](#почни-за-15-хвилин)**

---

## Не знаєш з чого почати?

Пройдіть самооцінку або оберіть свій рівень:

| Рівень | Ви вмієте... | Почніть тут | Час |
|--------|-------------|-------------|-----|
| **Початківець** | Запустити Claude Code та спілкуватись | [Слеш-команди](01-slash-commands/) | ~2.5 години |
| **Середній** | Використовувати CLAUDE.md та кастомні команди | [Навички](03-skills/) | ~3.5 години |
| **Просунутий** | Конфігурувати MCP-сервери та хуки | [Просунуті функції](09-advanced-features/) | ~5 годин |

**Повний навчальний шлях з усіма 10 модулями:**

| Порядок | Модуль | Рівень | Час |
|---------|--------|--------|-----|
| 1 | [Слеш-команди](01-slash-commands/) | Початківець | 30 хв |
| 2 | [Пам'ять](02-memory/) | Початківець+ | 45 хв |
| 3 | [Контрольні точки](08-checkpoints/) | Середній | 45 хв |
| 4 | [Основи CLI](10-cli/) | Початківець+ | 30 хв |
| 5 | [Навички](03-skills/) | Середній | 1 год |
| 6 | [Хуки](06-hooks/) | Середній | 1 год |
| 7 | [MCP](05-mcp/) | Середній+ | 1 год |
| 8 | [Субагенти](04-subagents/) | Середній+ | 1.5 год |
| 9 | [Просунуті функції](09-advanced-features/) | Просунутий | 2-3 год |
| 10 | [Плагіни](07-plugins/) | Просунутий | 2 год |

**[Повний навчальний план ->](LEARNING-ROADMAP.md)**

---

## Почни за 15 хвилин

```bash
# 1. Клонувати довідник
git clone https://github.com/luongnv89/claude-howto.git
cd claude-howto

# 2. Скопіювати першу слеш-команду
mkdir -p /path/to/your-project/.claude/commands
cp 01-slash-commands/optimize.md /path/to/your-project/.claude/commands/

# 3. Спробувати — у Claude Code введіть:
# /optimize

# 4. Готові до більшого? Налаштуйте пам'ять проєкту:
cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md

# 5. Встановіть навичку:
cp -r 03-skills/code-review-specialist ~/.claude/skills/
```

Хочете повне налаштування? Ось **необхідне за 1 годину**:

```bash
# Слеш-команди (15 хв)
cp 01-slash-commands/*.md .claude/commands/

# Пам'ять проєкту (15 хв)
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# Встановити навичку (15 хв)
cp -r 03-skills/code-review-specialist ~/.claude/skills/

# Ціль на вихідні: додати хуки, субагенти, MCP та плагіни
# Слідуйте навчальному шляху для керованого налаштування
```

---

## Що можна побудувати?

| Сценарій | Функції, які ви поєднаєте |
|----------|--------------------------|
| **Автоматичне код-рев'ю** | Слеш-команди + Субагенти + Пам'ять + MCP |
| **Онбординг команди** | Пам'ять + Слеш-команди + Плагіни |
| **Автоматизація CI/CD** | CLI + Хуки + Фонові завдання |
| **Генерація документації** | Навички + Субагенти + Плагіни |
| **Аудит безпеки** | Субагенти + Навички + Хуки (режим читання) |
| **DevOps-пайплайни** | Плагіни + MCP + Хуки + Фонові завдання |
| **Складний рефакторинг** | Контрольні точки + Режим планування + Хуки |

---

## FAQ

**Це безкоштовно?**
Так. Ліцензія MIT, безкоштовно назавжди. Використовуйте в особистих проєктах, на роботі, у команді — без обмежень, крім включення ліцензії.

**Це підтримується?**
Активно. Довідник синхронізується з кожним релізом Claude Code. Поточна версія: v2.1.112 (квітень 2026), сумісна з Claude Code 2.1+.

**Чим це відрізняється від офіційної документації?**
Офіційна документація — це довідник функцій. Цей довідник — туторіал з діаграмами, готовими до продакшену шаблонами та прогресивним навчальним шляхом. Вони доповнюють одне одного — починайте тут для навчання, звертайтесь до офіційних документів коли потрібні деталі.

**Скільки часу потрібно пройти все?**
11-13 годин для повного шляху. Але ви отримаєте цінність за 15 хвилин — просто скопіюйте шаблон слеш-команди та спробуйте.

**Чи працює це з Claude Sonnet / Haiku / Opus?**
Так. Усі шаблони працюють з Claude Sonnet 4.6, Claude Opus 4.6 та Claude Haiku 4.5.

**Чи можна долучитися?**
Звичайно. Див. [CONTRIBUTING.md](CONTRIBUTING.md) для настанов. Ми вітаємо нові приклади, виправлення, покращення документації та шаблони спільноти.

**Чи можна читати офлайн?**
Так. Запустіть `uv run scripts/build_epub.py` для генерації EPUB-книги з усім контентом та відрендереними діаграмами.

---

## Почніть опановувати Claude Code сьогодні

Ви вже встановили Claude Code. Єдине, що відділяє вас від 10-кратного підвищення продуктивності — знання як його використовувати. Цей довідник дає вам структурований шлях, візуальні пояснення та готові шаблони для цього.

Ліцензія MIT. Безкоштовно назавжди. Клонуйте, форкніть, зробіть своїм.

**[Почати навчальний шлях ->](LEARNING-ROADMAP.md)** | **[Каталог функцій](CATALOG.md)** | **[Почни за 15 хвилин](#почни-за-15-хвилин)**

---

<details>
<summary>Швидка навігація — Усі функції</summary>

| Функція | Опис | Папка |
|---------|------|-------|
| **Каталог функцій** | Повний довідник з командами встановлення | [CATALOG.md](CATALOG.md) |
| **Слеш-команди** | Ярлики, ініційовані користувачем | [01-slash-commands/](01-slash-commands/) |
| **Пам'ять** | Постійний контекст | [02-memory/](02-memory/) |
| **Навички** | Багаторазові можливості | [03-skills/](03-skills/) |
| **Субагенти** | Спеціалізовані AI-помічники | [04-subagents/](04-subagents/) |
| **Протокол MCP** | Доступ до зовнішніх інструментів | [05-mcp/](05-mcp/) |
| **Хуки** | Автоматизація на основі подій | [06-hooks/](06-hooks/) |
| **Плагіни** | Пакетні функції | [07-plugins/](07-plugins/) |
| **Контрольні точки** | Знімки сесій та відкат | [08-checkpoints/](08-checkpoints/) |
| **Просунуті функції** | Планування, мислення, фонові завдання | [09-advanced-features/](09-advanced-features/) |
| **Довідник CLI** | Команди, прапорці та опції | [10-cli/](10-cli/) |

</details>

<details>
<summary>Порівняння функцій</summary>

| Функція | Виклик | Постійність | Найкраще для |
|---------|--------|------------|-------------|
| **Слеш-команди** | Ручний (`/cmd`) | Лише сесія | Швидкі ярлики |
| **Пам'ять** | Авто-завантаження | Між сесіями | Довгострокове навчання |
| **Навички** | Авто-виклик | Файлова система | Автоматизовані процеси |
| **Субагенти** | Авто-делегування | Ізольований контекст | Розподіл завдань |
| **Протокол MCP** | Авто-запити | Реальний час | Доступ до живих даних |
| **Хуки** | За подіями | Налаштовувані | Автоматизація та валідація |
| **Плагіни** | Одна команда | Усі функції | Комплексні рішення |
| **Контрольні точки** | Ручний/Авто | Сесійні | Безпечне експериментування |
| **Режим планування** | Ручний/Авто | Фаза плану | Складні реалізації |
| **Фонові завдання** | Ручний | Час завдання | Тривалі операції |
| **Довідник CLI** | Термінальні команди | Сесія/Скрипт | Автоматизація та скриптинг |

</details>

<details>
<summary>Швидкий довідник встановлення</summary>

```bash
# Слеш-команди
cp 01-slash-commands/*.md .claude/commands/

# Пам'ять
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# Навички
cp -r 03-skills/code-review-specialist ~/.claude/skills/

# Субагенти
cp 04-subagents/*.md .claude/agents/

# MCP
export GITHUB_TOKEN="token"
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# Хуки
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

# Плагіни
/plugin install pr-review

# Контрольні точки (увімкнені за замовчуванням)
# Див. 08-checkpoints/README.md

# Просунуті функції (налаштування в settings)
# Див. 09-advanced-features/config-examples.json

# CLI (не потребує встановлення)
# Див. 10-cli/README.md
```

</details>

<details>
<summary>01. Слеш-команди</summary>

**Розташування**: [01-slash-commands/](01-slash-commands/)

**Що**: Ярлики, ініційовані користувачем, збережені як Markdown-файли

**Приклади**:
- `optimize.md` — Аналіз оптимізації коду
- `pr.md` — Підготовка pull request
- `generate-api-docs.md` — Генератор API-документації

**Встановлення**:
```bash
cp 01-slash-commands/*.md /path/to/project/.claude/commands/
```

**Використання**:
```
/optimize
/pr
/generate-api-docs
```

</details>

<details>
<summary>02. Пам'ять</summary>

**Розташування**: [02-memory/](02-memory/)

**Що**: Постійний контекст між сесіями

**Приклади**:
- `project-CLAUDE.md` — Командні стандарти проєкту
- `directory-api-CLAUDE.md` — Правила для каталогу
- `personal-CLAUDE.md` — Персональні налаштування

**Встановлення**:
```bash
# Пам'ять проєкту
cp 02-memory/project-CLAUDE.md /path/to/project/CLAUDE.md

# Пам'ять каталогу
cp 02-memory/directory-api-CLAUDE.md /path/to/project/src/api/CLAUDE.md

# Персональна пам'ять
cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md
```

**Використання**: Автоматично завантажується Claude

</details>

<details>
<summary>03. Навички</summary>

**Розташування**: [03-skills/](03-skills/)

**Що**: Багаторазові можливості з автовикликом, інструкціями та скриптами

**Приклади**:
- `code-review/` — Комплексне код-рев'ю зі скриптами
- `brand-voice/` — Перевірка відповідності голосу бренду
- `doc-generator/` — Генератор API-документації

**Встановлення**:
```bash
# Персональні навички
cp -r 03-skills/code-review-specialist ~/.claude/skills/

# Навички проєкту
cp -r 03-skills/code-review-specialist /path/to/project/.claude/skills/
```

**Використання**: Автоматично викликаються за потреби

</details>

<details>
<summary>04. Субагенти</summary>

**Розташування**: [04-subagents/](04-subagents/)

**Що**: Спеціалізовані AI-помічники з ізольованими контекстами та кастомними промптами

**Приклади**:
- `code-reviewer.md` — Комплексний аналіз якості коду
- `test-engineer.md` — Стратегія тестування та покриття
- `documentation-writer.md` — Технічна документація
- `secure-reviewer.md` — Рев'ю безпеки (тільки читання)
- `implementation-agent.md` — Повна реалізація функцій

**Встановлення**:
```bash
cp 04-subagents/*.md /path/to/project/.claude/agents/
```

**Використання**: Автоматичне делегування головним агентом

</details>

<details>
<summary>05. Протокол MCP</summary>

**Розташування**: [05-mcp/](05-mcp/)

**Що**: Model Context Protocol для доступу до зовнішніх інструментів та API

**Приклади**:
- `github-mcp.json` — Інтеграція з GitHub
- `database-mcp.json` — Запити до бази даних
- `filesystem-mcp.json` — Файлові операції
- `multi-mcp.json` — Кілька MCP-серверів

**Встановлення**:
```bash
# Встановити змінні оточення
export GITHUB_TOKEN="your_token"
export DATABASE_URL="postgresql://..."

# Додати MCP-сервер через CLI
claude mcp add github -- npx -y @modelcontextprotocol/server-github
```

**Використання**: MCP-інструменти автоматично доступні Claude після налаштування

</details>

<details>
<summary>06. Хуки</summary>

**Розташування**: [06-hooks/](06-hooks/)

**Що**: Shell-команди на основі подій, що виконуються автоматично у відповідь на події Claude Code

**Приклади**:
- `format-code.sh` — Автоформатування коду перед записом
- `pre-commit.sh` — Запуск тестів перед комітами
- `security-scan.sh` — Сканування на проблеми безпеки
- `log-bash.sh` — Логування всіх bash-команд
- `validate-prompt.sh` — Валідація промптів
- `notify-team.sh` — Надсилання сповіщень

**Встановлення**:
```bash
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh
```

**Використання**: Хуки виконуються автоматично за подіями

**Типи хуків** (4 типи, 25 подій):
- **Хуки інструментів**: `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`
- **Хуки сесій**: `SessionStart`, `SessionEnd`, `Stop`, `StopFailure`, `SubagentStart`, `SubagentStop`
- **Хуки завдань**: `UserPromptSubmit`, `TaskCompleted`, `TaskCreated`, `TeammateIdle`
- **Хуки життєвого циклу**: `ConfigChange`, `CwdChanged`, `FileChanged`, `PreCompact`, `PostCompact`, `WorktreeCreate`, `WorktreeRemove`, `Notification`, `InstructionsLoaded`, `Elicitation`, `ElicitationResult`

</details>

<details>
<summary>07. Плагіни</summary>

**Розташування**: [07-plugins/](07-plugins/)

**Що**: Пакетні набори команд, агентів, MCP та хуків

**Приклади**:
- `pr-review/` — Повний процес рев'ю PR
- `devops-automation/` — Розгортання та моніторинг
- `documentation/` — Генерація документації

**Встановлення**:
```bash
/plugin install pr-review
/plugin install devops-automation
/plugin install documentation
```

**Використання**: Використовуйте пакетні слеш-команди та функції

</details>

<details>
<summary>08. Контрольні точки та відкат</summary>

**Розташування**: [08-checkpoints/](08-checkpoints/)

**Що**: Збереження стану розмови та повернення до попередніх точок для дослідження різних підходів

**Ключові поняття**:
- **Контрольна точка**: Знімок стану розмови
- **Відкат**: Повернення до попередньої контрольної точки
- **Точка розгалуження**: Дослідження кількох підходів з однієї точки

**Використання**:
```
# Контрольні точки створюються автоматично з кожним промптом
# Для відкату натисніть Esc двічі або:
/rewind

# Потім оберіть:
# 1. Відновити код і розмову
# 2. Відновити розмову
# 3. Відновити код
# 4. Підсумувати звідси
# 5. Скасувати
```

</details>

<details>
<summary>09. Просунуті функції</summary>

**Розташування**: [09-advanced-features/](09-advanced-features/)

**Що**: Просунуті можливості для складних робочих процесів та автоматизації

**Включає**:
- **Режим планування** — Детальні плани реалізації перед кодуванням
- **Розширене мислення** — Глибоке міркування для складних проблем (перемикання через `Alt+T` / `Option+T`)
- **Фонові завдання** — Тривалі операції без блокування
- **Режими дозволів** — `default`, `acceptEdits`, `plan`, `dontAsk`, `bypassPermissions`
- **Headless-режим** — Claude Code у CI/CD: `claude -p "Run tests and generate report"`
- **Управління сесіями** — `/resume`, `/rename`, `/fork`, `claude -c`, `claude -r`
- **Конфігурація** — Налаштування поведінки в `~/.claude/settings.json`

Див. [config-examples.json](09-advanced-features/config-examples.json) для повних конфігурацій.

</details>

<details>
<summary>10. Довідник CLI</summary>

**Розташування**: [10-cli/](10-cli/)

**Що**: Повний довідник інтерфейсу командного рядка Claude Code

**Швидкі приклади**:
```bash
# Інтерактивний режим
claude "explain this project"

# Print mode (неінтерактивний)
claude -p "review this code"

# Обробка вмісту файлу
cat error.log | claude -p "explain this error"

# JSON-вивід для скриптів
claude -p --output-format json "list functions"

# Відновлення сесії
claude -r "feature-auth" "continue implementation"
```

**Сценарії**: Інтеграція CI/CD-пайплайнів, автоматизація скриптів, пакетна обробка, багатосесійні процеси

</details>

<details>
<summary>Приклади робочих процесів</summary>

### Повний процес код-рев'ю

```markdown
# Використовує: Слеш-команди + Субагенти + Пам'ять + MCP

User: /review-pr

Claude:
1. Завантажує пам'ять проєкту (стандарти кодування)
2. Отримує PR через GitHub MCP
3. Делегує субагенту code-reviewer
4. Делегує субагенту test-engineer
5. Синтезує знахідки
6. Надає комплексний огляд
```

### Автоматична документація

```markdown
# Використовує: Навички + Субагенти + Пам'ять

User: "Generate API documentation for the auth module"

Claude:
1. Завантажує пам'ять проєкту (стандарти документації)
2. Виявляє запит на генерацію документації
3. Автоматично викликає навичку doc-generator
4. Делегує субагенту api-documenter
5. Створює комплексну документацію з прикладами
```

### DevOps-розгортання

```markdown
# Використовує: Плагіни + MCP + Хуки

User: /deploy production

Claude:
1. Запускає pre-deploy хук (валідація середовища)
2. Делегує субагенту deployment-specialist
3. Виконує розгортання через Kubernetes MCP
4. Моніторить прогрес
5. Запускає post-deploy хук (перевірки стану)
6. Звітує про статус
```

</details>

<details>
<summary>Найкращі практики</summary>

### Робіть
- Починайте просто зі слеш-команд
- Додавайте функції поступово
- Використовуйте пам'ять для командних стандартів
- Тестуйте конфігурації локально спочатку
- Документуйте кастомні реалізації
- Контролюйте версії проєктних конфігурацій
- Діліться плагінами з командою

### Не робіть
- Не створюйте надлишкових функцій
- Не хардкодьте облікові дані
- Не пропускайте документацію
- Не ускладнюйте прості завдання
- Не ігноруйте найкращі практики безпеки
- Не комітьте чутливі дані

</details>

<details>
<summary>Усунення неполадок</summary>

### Функція не завантажується
1. Перевірте розташування та назву файлу
2. Перевірте синтаксис YAML frontmatter
3. Перевірте дозволи файлу
4. Перевірте сумісність з версією Claude Code

### MCP-з'єднання не вдалося
1. Перевірте змінні оточення
2. Перевірте встановлення MCP-сервера
3. Протестуйте облікові дані
4. Перевірте мережеве з'єднання

### Субагент не делегує
1. Перевірте дозволи інструментів
2. Перевірте чіткість опису агента
3. Перевірте складність завдання
4. Протестуйте агента окремо

</details>

---

## Внесок

Ми вітаємо внески! Будь ласка, ознайомтесь з [Настановами для контриб'юторів](CONTRIBUTING.md) для деталей.

---

## Ліцензія

Ліцензія MIT — див. [LICENSE](LICENSE). Вільне використання, модифікація та розповсюдження. Єдина вимога — включити повідомлення про ліцензію.

---

**Останнє оновлення**: Квітень 2026
**Версія Claude Code**: 2.1.97
**Сумісні моделі**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5
