mirror of
https://github.com/luongnv89/claude-howto.git
synced 2026-06-01 10:31:33 +02:00
fix(uk): replace stub README with full translation, fix broken anchors
- Replace 3KB stub README with full 31KB translation matching original structure - Fix apostrophe anchor mismatch in 04-subagents (U+02BC vs U+0027) - Fix duplicate heading in 06-hooks (Prompt-хуки → Хуки на основі промптів) Ref: luongnv89/claude-howto#63
This commit is contained in:
@@ -22,7 +22,7 @@
|
|||||||
7. [Використання субагентів](#використання-субагентів)
|
7. [Використання субагентів](#використання-субагентів)
|
||||||
8. [Відновлювані агенти](#відновлювані-агенти)
|
8. [Відновлювані агенти](#відновлювані-агенти)
|
||||||
9. [Ланцюжки субагентів](#ланцюжки-субагентів)
|
9. [Ланцюжки субагентів](#ланцюжки-субагентів)
|
||||||
10. [Постійна пам'ять для субагентів](#постійна-памʼять-для-субагентів)
|
10. [Постійна пам'ять для субагентів](#постійна-память-для-субагентів)
|
||||||
11. [Фонові субагенти](#фонові-субагенти)
|
11. [Фонові субагенти](#фонові-субагенти)
|
||||||
12. [Ізоляція через Worktree](#ізоляція-через-worktree)
|
12. [Ізоляція через Worktree](#ізоляція-через-worktree)
|
||||||
13. [Обмеження створюваних субагентів](#обмеження-створюваних-субагентів)
|
13. [Обмеження створюваних субагентів](#обмеження-створюваних-субагентів)
|
||||||
@@ -35,7 +35,7 @@
|
|||||||
20. [Найкращі практики](#найкращі-практики)
|
20. [Найкращі практики](#найкращі-практики)
|
||||||
21. [Приклади субагентів у цій папці](#приклади-субагентів-у-цій-папці)
|
21. [Приклади субагентів у цій папці](#приклади-субагентів-у-цій-папці)
|
||||||
22. [Інструкції з встановлення](#інструкції-з-встановлення)
|
22. [Інструкції з встановлення](#інструкції-з-встановлення)
|
||||||
23. [Пов'язані концепції](#повʼязані-концепції)
|
23. [Пов'язані концепції](#повязані-концепції)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -133,7 +133,7 @@ Claude Code підтримує чотири типи хуків:
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
LLM оцінює промпт і повертає структуроване рішення (деталі див. у [Prompt-хуки](#prompt-хуки-1)).
|
LLM оцінює промпт і повертає структуроване рішення (деталі див. у [Хуки на основі промптів](#хуки-на-основі-промптів)).
|
||||||
|
|
||||||
### Agent-хуки
|
### Agent-хуки
|
||||||
|
|
||||||
@@ -504,7 +504,7 @@ hooks:
|
|||||||
| `${CLAUDE_PLUGIN_DATA}` | Хуки плагінів | Шлях до каталогу даних плагіна |
|
| `${CLAUDE_PLUGIN_DATA}` | Хуки плагінів | Шлях до каталогу даних плагіна |
|
||||||
| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Хуки SessionEnd | Налаштовуваний таймаут у мілісекундах для хуків SessionEnd (перевизначає стандартний) |
|
| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Хуки SessionEnd | Налаштовуваний таймаут у мілісекундах для хуків SessionEnd (перевизначає стандартний) |
|
||||||
|
|
||||||
## Prompt-хуки
|
## Хуки на основі промптів
|
||||||
|
|
||||||
Для подій `Stop` та `SubagentStop` можна використовувати оцінку на основі LLM:
|
Для подій `Stop` та `SubagentStop` можна використовувати оцінку на основі LLM:
|
||||||
|
|
||||||
|
|||||||
+650
-67
@@ -1,79 +1,662 @@
|
|||||||
<!-- i18n-source: README.md -->
|
<!-- i18n-source: README.md -->
|
||||||
<!-- i18n-source-sha: 63a1416 -->
|
<!-- i18n-source-sha: 63a1416 -->
|
||||||
<!-- i18n-date: 2026-04-09 -->
|
<!-- i18n-date: 2026-04-10 -->
|
||||||
|
|
||||||
# Посібник Claude Code
|
<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)
|
🌐 **Language / Мова:** [English](../README.md) | [Tiếng Việt](../vi/README.md) | [中文](../zh/README.md) | [Українська](README.md)
|
||||||
|
|
||||||
> **Опануй Claude Code за вихідні**
|
# Опануй Claude Code за вихідні
|
||||||
|
|
||||||
Це українська версія документації [Claude Code How-To Guide](../README.md).
|
Від простого введення `claude` до оркестрації агентів, хуків, навичок та MCP-серверів — з візуальними туторіалами, готовими шаблонами та керованим навчальним шляхом.
|
||||||
|
|
||||||
## 📖 Про що це
|
**[Почни за 15 хвилин](#почни-за-15-хвилин)** | **[Визнач свій рівень](#не-знаєш-з-чого-почати)** | **[Каталог функцій](CATALOG.md)**
|
||||||
|
|
||||||
Цей посібник допоможе вам:
|
|
||||||
|
|
||||||
- Зрозуміти та ефективно використовувати Claude Code
|
|
||||||
- Автоматизувати завдання з розробки програмного забезпечення
|
|
||||||
- Інтегрувати Claude Code у ваш щоденний робочий процес
|
|
||||||
|
|
||||||
## 🚀 Швидкий старт
|
|
||||||
|
|
||||||
### Вимоги
|
|
||||||
|
|
||||||
- Встановлений Claude Code
|
|
||||||
- Базові знання роботи з терміналом
|
|
||||||
- Базові знання програмування
|
|
||||||
|
|
||||||
### Встановлення
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Клонувати репозиторій
|
|
||||||
git clone https://github.com/luongnv89/claude-howto.git
|
|
||||||
cd claude-howto
|
|
||||||
|
|
||||||
# Скопіювати слеш-команди до вашого проекту
|
|
||||||
mkdir -p .claude/commands
|
|
||||||
cp 01-slash-commands/*.md .claude/commands/
|
|
||||||
```
|
|
||||||
|
|
||||||
## 📚 Структура документації
|
|
||||||
|
|
||||||
Документація поділена на 10 модулів у порядку вивчення:
|
|
||||||
|
|
||||||
1. **[01 — Слеш-команди](01-slash-commands/)** — Ярлики для підвищення продуктивності
|
|
||||||
2. **[02 — Пам'ять](02-memory/)** — Збереження контексту між сесіями
|
|
||||||
3. **[03 — Навички (Skills)](03-skills/)** — Багаторазові можливості
|
|
||||||
4. **[04 — Субагенти](04-subagents/)** — Спеціалізовані AI-помічники
|
|
||||||
5. **[05 — MCP](05-mcp/)** — Model Context Protocol
|
|
||||||
6. **[06 — Хуки](06-hooks/)** — Автоматизація на основі подій
|
|
||||||
7. **[07 — Плагіни](07-plugins/)** — Пакетні розширення
|
|
||||||
8. **[08 — Контрольні точки](08-checkpoints/)** — Знімки сесій
|
|
||||||
9. **[09 — Розширені функції](09-advanced-features/)** — Планування, мислення, фонові завдання
|
|
||||||
10. **[10 — CLI](10-cli/)** — Довідник командного рядка
|
|
||||||
|
|
||||||
## 🔗 Посилання
|
|
||||||
|
|
||||||
- [Англійська версія](../README.md)
|
|
||||||
- [Офіційна документація Claude Code](https://code.claude.com/docs)
|
|
||||||
- [GitHub-репозиторій](https://github.com/luongnv89/claude-howto)
|
|
||||||
|
|
||||||
## 🤝 Як долучитися
|
|
||||||
|
|
||||||
Див. [CONTRIBUTING.md](../CONTRIBUTING.md) для деталей.
|
|
||||||
|
|
||||||
## 📝 Примітки до перекладу
|
|
||||||
|
|
||||||
Див. [TRANSLATION_NOTES.md](TRANSLATION_NOTES.md) для:
|
|
||||||
|
|
||||||
- Глосарію технічних термінів
|
|
||||||
- Правил стилю перекладу
|
|
||||||
- Правил роботи з кодом та командами
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**Переклад у процесі.** Див. [TRANSLATION_QUEUE.md](TRANSLATION_QUEUE.md) для відстеження прогресу.
|
## Зміст
|
||||||
|
|
||||||
**Останнє оновлення:** 2026-04-09
|
- [Проблема](#проблема)
|
||||||
**Мова:** Українська (uk-UA)
|
- [Як 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 ~/.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 ~/.claude/skills/
|
||||||
|
|
||||||
|
# Ціль на вихідні: додати хуки, субагенти, MCP та плагіни
|
||||||
|
# Слідуйте навчальному шляху для керованого налаштування
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Що можна побудувати?
|
||||||
|
|
||||||
|
| Сценарій | Функції, які ви поєднаєте |
|
||||||
|
|----------|--------------------------|
|
||||||
|
| **Автоматичне код-рев'ю** | Слеш-команди + Субагенти + Пам'ять + MCP |
|
||||||
|
| **Онбординг команди** | Пам'ять + Слеш-команди + Плагіни |
|
||||||
|
| **Автоматизація CI/CD** | CLI + Хуки + Фонові завдання |
|
||||||
|
| **Генерація документації** | Навички + Субагенти + Плагіни |
|
||||||
|
| **Аудит безпеки** | Субагенти + Навички + Хуки (режим читання) |
|
||||||
|
| **DevOps-пайплайни** | Плагіни + MCP + Хуки + Фонові завдання |
|
||||||
|
| **Складний рефакторинг** | Контрольні точки + Режим планування + Хуки |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## FAQ
|
||||||
|
|
||||||
|
**Це безкоштовно?**
|
||||||
|
Так. Ліцензія MIT, безкоштовно назавжди. Використовуйте в особистих проєктах, на роботі, у команді — без обмежень, крім включення ліцензії.
|
||||||
|
|
||||||
|
**Це підтримується?**
|
||||||
|
Активно. Довідник синхронізується з кожним релізом Claude Code. Поточна версія: v2.3.0 (квітень 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 ~/.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 ~/.claude/skills/
|
||||||
|
|
||||||
|
# Навички проєкту
|
||||||
|
cp -r 03-skills/code-review /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
|
||||||
|
|||||||
Reference in New Issue
Block a user