Claude How To 🌐 **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 ~/.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.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-хвилин)** ---
Швидка навігація — Усі функції | Функція | Опис | Папка | |---------|------|-------| | **Каталог функцій** | Повний довідник з командами встановлення | [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/) |
Порівняння функцій | Функція | Виклик | Постійність | Найкраще для | |---------|--------|------------|-------------| | **Слеш-команди** | Ручний (`/cmd`) | Лише сесія | Швидкі ярлики | | **Пам'ять** | Авто-завантаження | Між сесіями | Довгострокове навчання | | **Навички** | Авто-виклик | Файлова система | Автоматизовані процеси | | **Субагенти** | Авто-делегування | Ізольований контекст | Розподіл завдань | | **Протокол MCP** | Авто-запити | Реальний час | Доступ до живих даних | | **Хуки** | За подіями | Налаштовувані | Автоматизація та валідація | | **Плагіни** | Одна команда | Усі функції | Комплексні рішення | | **Контрольні точки** | Ручний/Авто | Сесійні | Безпечне експериментування | | **Режим планування** | Ручний/Авто | Фаза плану | Складні реалізації | | **Фонові завдання** | Ручний | Час завдання | Тривалі операції | | **Довідник CLI** | Термінальні команди | Сесія/Скрипт | Автоматизація та скриптинг |
Швидкий довідник встановлення ```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 ```
01. Слеш-команди **Розташування**: [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 ```
02. Пам'ять **Розташування**: [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
03. Навички **Розташування**: [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/ ``` **Використання**: Автоматично викликаються за потреби
04. Субагенти **Розташування**: [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/ ``` **Використання**: Автоматичне делегування головним агентом
05. Протокол MCP **Розташування**: [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 після налаштування
06. Хуки **Розташування**: [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`
07. Плагіни **Розташування**: [07-plugins/](07-plugins/) **Що**: Пакетні набори команд, агентів, MCP та хуків **Приклади**: - `pr-review/` — Повний процес рев'ю PR - `devops-automation/` — Розгортання та моніторинг - `documentation/` — Генерація документації **Встановлення**: ```bash /plugin install pr-review /plugin install devops-automation /plugin install documentation ``` **Використання**: Використовуйте пакетні слеш-команди та функції
08. Контрольні точки та відкат **Розташування**: [08-checkpoints/](08-checkpoints/) **Що**: Збереження стану розмови та повернення до попередніх точок для дослідження різних підходів **Ключові поняття**: - **Контрольна точка**: Знімок стану розмови - **Відкат**: Повернення до попередньої контрольної точки - **Точка розгалуження**: Дослідження кількох підходів з однієї точки **Використання**: ``` # Контрольні точки створюються автоматично з кожним промптом # Для відкату натисніть Esc двічі або: /rewind # Потім оберіть: # 1. Відновити код і розмову # 2. Відновити розмову # 3. Відновити код # 4. Підсумувати звідси # 5. Скасувати ```
09. Просунуті функції **Розташування**: [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) для повних конфігурацій.
10. Довідник CLI **Розташування**: [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-пайплайнів, автоматизація скриптів, пакетна обробка, багатосесійні процеси
Приклади робочих процесів ### Повний процес код-рев'ю ```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. Звітує про статус ```
Найкращі практики ### Робіть - Починайте просто зі слеш-команд - Додавайте функції поступово - Використовуйте пам'ять для командних стандартів - Тестуйте конфігурації локально спочатку - Документуйте кастомні реалізації - Контролюйте версії проєктних конфігурацій - Діліться плагінами з командою ### Не робіть - Не створюйте надлишкових функцій - Не хардкодьте облікові дані - Не пропускайте документацію - Не ускладнюйте прості завдання - Не ігноруйте найкращі практики безпеки - Не комітьте чутливі дані
Усунення неполадок ### Функція не завантажується 1. Перевірте розташування та назву файлу 2. Перевірте синтаксис YAML frontmatter 3. Перевірте дозволи файлу 4. Перевірте сумісність з версією Claude Code ### MCP-з'єднання не вдалося 1. Перевірте змінні оточення 2. Перевірте встановлення MCP-сервера 3. Протестуйте облікові дані 4. Перевірте мережеве з'єднання ### Субагент не делегує 1. Перевірте дозволи інструментів 2. Перевірте чіткість опису агента 3. Перевірте складність завдання 4. Протестуйте агента окремо
--- ## Внесок Ми вітаємо внески! Будь ласка, ознайомтесь з [Настановами для контриб'юторів](CONTRIBUTING.md) для деталей. --- ## Ліцензія Ліцензія MIT — див. [LICENSE](LICENSE). Вільне використання, модифікація та розповсюдження. Єдина вимога — включити повідомлення про ліцензію. --- **Останнє оновлення**: Квітень 2026 **Версія Claude Code**: 2.1.97 **Сумісні моделі**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5