From 118fd4018391c635c5307ebf899140f32703d1b2 Mon Sep 17 00:00:00 2001 From: Evgenij I Date: Thu, 9 Apr 2026 13:28:06 +0300 Subject: [PATCH] feat(uk): translate QUICK_REFERENCE.md to Ukrainian Complete Ukrainian translation of QUICK_REFERENCE.md - the quick reference card for all Claude Code features. - Installation quick commands for all features - Feature cheat sheet with paths and usage - Common use cases (code review, docs, DevOps, CI/CD) - File locations reference diagram - Learning path (Day 1 through Week 3+) - New features (March 2026) section - Tips, FAQ, and getting started checklist Progress: 4/67 files (P1: 4/5 core documents) Ref: luongnv89/claude-howto#63 --- uk/QUICK_REFERENCE.md | 545 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 545 insertions(+) create mode 100644 uk/QUICK_REFERENCE.md diff --git a/uk/QUICK_REFERENCE.md b/uk/QUICK_REFERENCE.md new file mode 100644 index 0000000..6461f87 --- /dev/null +++ b/uk/QUICK_REFERENCE.md @@ -0,0 +1,545 @@ + + + + + + + Claude How To + + +# Приклади Claude Code — Картка швидкого довідника + +## 🚀 Команди швидкого встановлення + +### Слеш-команди + +```bash +# Встановити всі +cp 01-slash-commands/*.md .claude/commands/ + +# Встановити конкретну +cp 01-slash-commands/optimize.md .claude/commands/ +``` + +### Пам'ять + +```bash +# Пам'ять проекту +cp 02-memory/project-CLAUDE.md ./CLAUDE.md + +# Персональна пам'ять +cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md +``` + +### Навички (Skills) + +```bash +# Персональні навички +cp -r 03-skills/code-review ~/.claude/skills/ + +# Навички проекту +cp -r 03-skills/code-review .claude/skills/ +``` + +### Субагенти + +```bash +# Встановити всі +cp 04-subagents/*.md .claude/agents/ + +# Встановити конкретного +cp 04-subagents/code-reviewer.md .claude/agents/ +``` + +### MCP + +```bash +# Встановити облікові дані +export GITHUB_TOKEN="your_token" +export DATABASE_URL="postgresql://..." + +# Встановити конфігурацію (рівень проекту) +cp 05-mcp/github-mcp.json .mcp.json + +# Або рівень користувача: додати в ~/.claude.json +``` + +### Хуки + +```bash +# Встановити хуки +mkdir -p ~/.claude/hooks +cp 06-hooks/*.sh ~/.claude/hooks/ +chmod +x ~/.claude/hooks/*.sh + +# Налаштувати в settings (~/.claude/settings.json) +``` + +### Плагіни + +```bash +# Встановити з прикладів (якщо опубліковані) +/plugin install pr-review +/plugin install devops-automation +/plugin install documentation +``` + +### Контрольні точки + +```bash +# Контрольні точки створюються автоматично з кожним промптом +# Для відкату натисніть Esc двічі або скористайтесь: +/rewind + +# Потім оберіть: Відновити код і розмову, Відновити розмову, +# Відновити код, Підсумувати звідси, або Скасувати +``` + +### Розширені функції + +```bash +# Налаштувати в settings (.claude/settings.json) +# Див. 09-advanced-features/config-examples.json + +# Режим планування +/plan Task description + +# Режими дозволів (прапорець --permission-mode) +# default - Запитувати дозвіл на ризиковані дії +# acceptEdits - Автоприйняття редагувань, запит на інше +# plan - Лише аналіз, без змін (тільки читання) +# dontAsk - Приймати все, крім ризикованого +# auto - Фоновий класифікатор вирішує автоматично +# bypassPermissions - Приймати все (потребує --dangerously-skip-permissions) + +# Управління сесіями +/resume # Відновити попередню розмову +/rename "name" # Назвати поточну сесію +/fork # Розгалужити поточну сесію +claude -c # Продовжити останню розмову +claude -r "session" # Відновити сесію за назвою/ID +``` + +--- + +## 📋 Шпаргалка по функціях + +| Функція | Шлях встановлення | Використання | +|---------|------------------|-------------| +| **Слеш-команди (55+)** | `.claude/commands/*.md` | `/command-name` | +| **Пам'ять** | `./CLAUDE.md` | Автозавантаження | +| **Навички** | `.claude/skills/*/SKILL.md` | Автовиклик | +| **Субагенти** | `.claude/agents/*.md` | Автоделегування | +| **MCP** | `.mcp.json` (проект) або `~/.claude.json` (користувач) | `/mcp__server__action` | +| **Хуки (25 подій)** | `~/.claude/hooks/*.sh` | Тригер на подію (4 типи) | +| **Плагіни** | Через `/plugin install` | Пакет всього | +| **Контрольні точки** | Вбудовано | `Esc+Esc` або `/rewind` | +| **Режим планування** | Вбудовано | `/plan <завдання>` | +| **Режими дозволів (6)** | Вбудовано | `--allowedTools`, `--permission-mode` | +| **Сесії** | Вбудовано | `/session <команда>` | +| **Фонові завдання** | Вбудовано | Run in background | +| **Віддалене керування** | Вбудовано | WebSocket API | +| **Веб-сесії** | Вбудовано | `claude web` | +| **Git Worktrees** | Вбудовано | `/worktree` | +| **Автопам'ять** | Вбудовано | Автозбереження в CLAUDE.md | +| **Список завдань** | Вбудовано | `/task list` | +| **Вбудовані навички (5)** | Вбудовано | `/simplify`, `/loop`, `/claude-api`, `/voice`, `/browse` | + +--- + +## 🎯 Типові сценарії використання + +### Ревʼю коду + +```bash +# Спосіб 1: Слеш-команда +cp 01-slash-commands/optimize.md .claude/commands/ +# Використання: /optimize + +# Спосіб 2: Субагент +cp 04-subagents/code-reviewer.md .claude/agents/ +# Використання: Автоделегування + +# Спосіб 3: Навичка +cp -r 03-skills/code-review ~/.claude/skills/ +# Використання: Автовиклик + +# Спосіб 4: Плагін (найкращий) +/plugin install pr-review +# Використання: /review-pr +``` + +### Документація + +```bash +# Слеш-команда +cp 01-slash-commands/generate-api-docs.md .claude/commands/ + +# Субагент +cp 04-subagents/documentation-writer.md .claude/agents/ + +# Навичка +cp -r 03-skills/doc-generator ~/.claude/skills/ + +# Плагін (комплексне рішення) +/plugin install documentation +``` + +### DevOps + +```bash +# Повний плагін +/plugin install devops-automation + +# Команди: /deploy, /rollback, /status, /incident +``` + +### Командні стандарти + +```bash +# Пам'ять проекту +cp 02-memory/project-CLAUDE.md ./CLAUDE.md + +# Відредагуйте під вашу команду +vim CLAUDE.md +``` + +### Автоматизація та хуки + +```bash +# Встановити хуки (25 подій, 4 типи: command, http, prompt, agent) +mkdir -p ~/.claude/hooks +cp 06-hooks/*.sh ~/.claude/hooks/ +chmod +x ~/.claude/hooks/*.sh + +# Приклади: +# - Тести перед комітом: pre-commit.sh +# - Автоформатування коду: format-code.sh +# - Сканування безпеки: security-scan.sh + +# Auto Mode для повністю автономних процесів +claude --enable-auto-mode -p "Refactor and test the auth module" +# Або циклічна зміна режимів інтерактивно з Shift+Tab +``` + +### Безпечний рефакторинг + +```bash +# Контрольні точки створюються автоматично перед кожним промптом +# Спробуйте рефакторинг +# Якщо вдалось: продовжуйте +# Якщо не вдалось: натисніть Esc+Esc або /rewind для відкату +``` + +### Складна реалізація + +```bash +# Використайте режим планування +/plan Implement user authentication system + +# Claude створить детальний план +# Перегляньте та затвердіть +# Claude реалізує систематично +``` + +### Інтеграція з CI/CD + +```bash +# Запуск у headless-режимі (неінтерактивно) +claude -p "Run all tests and generate report" + +# З режимом дозволів для CI +claude -p "Run tests" --permission-mode dontAsk + +# З Auto Mode для повністю автономних CI-завдань +claude --enable-auto-mode -p "Run tests and fix failures" + +# З хуками для автоматизації +# Див. 09-advanced-features/README.md +``` + +### Навчання та експериментування + +```bash +# Режим plan для безпечного аналізу +claude --permission-mode plan + +# Експериментуйте безпечно — контрольні точки створюються автоматично +# Для відкату: натисніть Esc+Esc або /rewind +``` + +### Команди агентів + +```bash +# Увімкнути команди агентів +export CLAUDE_AGENT_TEAMS=1 + +# Або в settings.json +{ "agentTeams": { "enabled": true } } + +# Почніть з: "Implement feature X using a team approach" +``` + +### Заплановані завдання + +```bash +# Запускати команду кожні 5 хвилин +/loop 5m /check-status + +# Одноразове нагадування +/loop 30m "remind me to check the deploy" +``` + +--- + +## 📁 Довідник розташування файлів + +``` +Ваш проект/ +├── .claude/ +│ ├── commands/ # Слеш-команди тут +│ ├── agents/ # Субагенти тут +│ ├── skills/ # Навички проекту тут +│ └── settings.json # Налаштування проекту (хуки тощо) +├── .mcp.json # Конфігурація MCP (рівень проекту) +├── CLAUDE.md # Пам'ять проекту +└── src/ + └── api/ + └── CLAUDE.md # Пам'ять для конкретного каталогу + +Домашній каталог/ +├── .claude/ +│ ├── commands/ # Персональні команди +│ ├── agents/ # Персональні агенти +│ ├── skills/ # Персональні навички +│ ├── hooks/ # Скрипти хуків +│ ├── settings.json # Налаштування користувача +│ ├── managed-settings.d/ # Керовані налаштування (enterprise/org) +│ └── CLAUDE.md # Персональна пам'ять +└── .claude.json # Персональна конфігурація MCP (рівень користувача) +``` + +--- + +## 🔍 Пошук прикладів + +### За категорією + +- **Слеш-команди**: `01-slash-commands/` +- **Пам'ять**: `02-memory/` +- **Навички**: `03-skills/` +- **Субагенти**: `04-subagents/` +- **MCP**: `05-mcp/` +- **Хуки**: `06-hooks/` +- **Плагіни**: `07-plugins/` +- **Контрольні точки**: `08-checkpoints/` +- **Розширені функції**: `09-advanced-features/` +- **CLI**: `10-cli/` + +### За сценарієм + +- **Продуктивність**: `01-slash-commands/optimize.md` +- **Безпека**: `04-subagents/secure-reviewer.md` +- **Тестування**: `04-subagents/test-engineer.md` +- **Документація**: `03-skills/doc-generator/` +- **DevOps**: `07-plugins/devops-automation/` + +### За складністю + +- **Просто**: Слеш-команди +- **Середньо**: Субагенти, Пам'ять +- **Просунуто**: Навички, Хуки +- **Комплексно**: Плагіни + +--- + +## 🎓 Навчальний шлях + +### День 1 + +```bash +# Прочитати огляд +cat README.md + +# Встановити команду +cp 01-slash-commands/optimize.md .claude/commands/ + +# Спробувати +/optimize +``` + +### Дні 2-3 + +```bash +# Налаштувати пам'ять +cp 02-memory/project-CLAUDE.md ./CLAUDE.md +vim CLAUDE.md + +# Встановити субагента +cp 04-subagents/code-reviewer.md .claude/agents/ +``` + +### Дні 4-5 + +```bash +# Налаштувати MCP +export GITHUB_TOKEN="your_token" +cp 05-mcp/github-mcp.json .mcp.json + +# Спробувати MCP-команди +/mcp__github__list_prs +``` + +### Тиждень 2 + +```bash +# Встановити навичку +cp -r 03-skills/code-review ~/.claude/skills/ + +# Дозвольте автовиклик +# Просто скажіть: "Review this code for issues" +``` + +### Тиждень 3+ + +```bash +# Встановити повний плагін +/plugin install pr-review + +# Використати вбудовані функції +/review-pr +/check-security +/check-tests +``` + +--- + +## Нові функції (березень 2026) + +| Функція | Опис | Використання | +|---------|------|-------------| +| **Auto Mode** | Повністю автономна робота з фоновим класифікатором | Прапорець `--enable-auto-mode`, `Shift+Tab` для зміни режимів | +| **Канали** | Інтеграція з Discord та Telegram | Прапорець `--channels`, боти Discord/Telegram | +| **Голосовий ввід** | Голосові команди та контекст для Claude | Команда `/voice` | +| **Хуки (26 подій)** | Розширена система хуків з 4 типами | Типи: command, http, prompt, agent | +| **MCP Elicitation** | MCP-сервери можуть запитувати ввід під час виконання | Автозапит при потребі сервера | +| **Plugin LSP** | Підтримка Language Server Protocol для плагінів | `userConfig`, змінна `${CLAUDE_PLUGIN_DATA}` | +| **Віддалене керування** | Керування Claude Code через WebSocket API | `claude --remote` для зовнішніх інтеграцій | +| **Веб-сесії** | Браузерний інтерфейс Claude Code | `claude web` для запуску | +| **Десктопний застосунок** | Нативний десктопний застосунок | Завантаження з claude.ai/download | +| **Список завдань** | Управління фоновими завданнями | `/task list`, `/task status ` | +| **Автопам'ять** | Автоматичне збереження з розмов | Claude автозберігає контекст у CLAUDE.md | +| **Git Worktrees** | Ізольовані робочі простори для паралельної розробки | `/worktree` для створення | +| **Вибір моделі** | Перемикання між Sonnet 4.6 та Opus 4.6 | `/model` або прапорець `--model` | +| **Команди агентів** | Координація кількох агентів | Увімкнути з `CLAUDE_AGENT_TEAMS=1` | +| **Заплановані завдання** | Повторювані завдання з `/loop` | `/loop 5m /command` або CronCreate | +| **Інтеграція з Chrome** | Автоматизація браузера | Прапорець `--chrome` або `/chrome` | +| **Кастомізація клавіатури** | Налаштування клавіш | Команда `/keybindings` | + +--- + +## Поради та хитрощі + +### Кастомізація + +- Почніть з прикладів як є +- Модифікуйте під ваші потреби +- Тестуйте перед поширенням в команді +- Тримайте конфігурації під контролем версій + +### Найкращі практики + +- Використовуйте пам'ять для командних стандартів +- Використовуйте плагіни для комплексних процесів +- Використовуйте субагентів для складних завдань +- Використовуйте слеш-команди для швидких завдань + +### Усунення неполадок + +```bash +# Перевірити розташування файлів +ls -la .claude/commands/ +ls -la .claude/agents/ + +# Перевірити YAML-синтаксис +head -20 .claude/agents/code-reviewer.md + +# Перевірити MCP-з'єднання +echo $GITHUB_TOKEN +``` + +--- + +## 📊 Матриця функцій + +| Потреба | Використовуйте | Приклад | +|---------|---------------|---------| +| Швидкий ярлик | Слеш-команда (55+) | `01-slash-commands/optimize.md` | +| Командні стандарти | Пам'ять | `02-memory/project-CLAUDE.md` | +| Автоматичний процес | Навичка | `03-skills/code-review/` | +| Спеціалізоване завдання | Субагент | `04-subagents/code-reviewer.md` | +| Зовнішні дані | MCP (+ Elicitation) | `05-mcp/github-mcp.json` | +| Автоматизація подій | Хук (26 подій, 4 типи) | `06-hooks/pre-commit.sh` | +| Комплексне рішення | Плагін (+ LSP) | `07-plugins/pr-review/` | +| Безпечний експеримент | Контрольна точка | `08-checkpoints/checkpoint-examples.md` | +| Повна автономія | Auto Mode | `--enable-auto-mode` або `Shift+Tab` | +| Чат-інтеграції | Канали | `--channels` (Discord, Telegram) | +| CI/CD-пайплайн | CLI | `10-cli/README.md` | + +--- + +## 🔗 Швидкі посилання + +- **Головний посібник**: `README.md` +- **Повний покажчик**: `INDEX.md` +- **Каталог**: `CATALOG.md` +- **Оригінальний посібник**: `claude_concepts_guide.md` + +--- + +## 📞 Поширені запитання + +**П: Що обрати?** +В: Почніть зі слеш-команд, додавайте функції за потребою. + +**П: Чи можна комбінувати функції?** +В: Так! Вони працюють разом. Пам'ять + Команди + MCP = потужна зв'язка. + +**П: Як поділитися з командою?** +В: Закомітьте каталог `.claude/` до git. + +**П: А що з секретами?** +В: Використовуйте змінні оточення, ніколи не хардкодьте. + +**П: Чи можна змінювати приклади?** +В: Безумовно! Це шаблони для кастомізації. + +--- + +## ✅ Чекліст + +Чекліст для початку роботи: + +- [ ] Прочитати `README.md` +- [ ] Встановити 1 слеш-команду +- [ ] Спробувати команду +- [ ] Створити `CLAUDE.md` проекту +- [ ] Встановити 1 субагента +- [ ] Налаштувати 1 MCP-інтеграцію +- [ ] Встановити 1 навичку +- [ ] Спробувати повний плагін +- [ ] Кастомізувати під свої потреби +- [ ] Поділитися з командою + +--- + +**Швидкий старт**: `cat README.md` + +**Повний покажчик**: `cat INDEX.md` + +**Ця картка**: Тримайте під рукою для швидкого довідника! + +--- + +**Останнє оновлення**: 9 квітня 2026 +**Версія Claude Code**: 2.1.97