Files
claude-howto/uk/QUICK_REFERENCE.md
T
Luong NGUYEN 1e16914a8d docs: sync to Claude Code v2.1.257 (#180)
* docs: sync to Claude Code v2.1.257

Audit against Claude Code v2.1.257 (repo baseline was v2.1.245, 12 releases
behind). Facts verified against the official docs and cross-checked against
the locally installed 2.1.257 binary.

Critical (P0):
- lesson-quiz L06 Q9 asked how many hook events exist, offering 16/25/31/40.
  With the real answer now 33, no option was correct. Option C 31 -> 33;
  answer letter unchanged.
- 03-skills taught SKILL.md `name`/`description` as required. Official docs
  now state all frontmatter fields are optional and `name` defaults to the
  directory name. Corrected in all five languages.

Hook events 31 -> 33 (PreModelSwitch/PostModelSwitch, v2.1.251) across 30
occurrences in 22 files, including three that read 25. Delta proved by
set-diff against the official event table: no phantom events. Both events
added to the 06-hooks tables with matcher, blocking behavior and 30s timeout,
plus detailed per-event sections.

CLI corrections verified against the binary:
- `claude plugin tag` takes a path, not a version
- `claude plugin init` / `validate` require their arguments
- `plugin init` scaffolds at ~/.claude/skills/<name>/, not project-local
- `--channels` entries must be tagged plugin:<name>@<marketplace>
- `--remote` is a deprecated alias for `--cloud`
- no `claude remote-control` subcommand exists, only the --remote-control flag

Also: CATALOG summary-table totals recomputed in all five languages (column 4
is a derived total, so the count change invalidated it); stale Opus 4.6/4.7
rosters aligned to canonical; self-assessment Advanced Features rescored 0-3
to stop a real gap being graded as mastery; 9 dangling quiz Review pointers
repaired; new features documented (--restricted, Fable 5.1,
experimental.cacheTtl, CLAUDE_CODE_SUBAGENT_MODEL_FORCE).

Deliberately out of scope: pre-existing translation staleness whose fix is
translation authorship rather than correction (ja/uk April-2026 root-doc
bodies, zh stubs, vi/README stub, translated CATALOG "New Features").

Claude-Session: https://claude.ai/code/session_01128xfEd8W7c2cMRw6N7uiF

* fix(hooks): complete the 31 → 33 hook-event propagation across all languages

The v2.1.257 sync bumped the hook-event count in the lesson and catalog
summaries but left 14 files still asserting 31, four of which the same
commit restamped 2.1.257. It also bumped the prose count in
claude_concepts_guide.md without adding the two rows, making that file
contradict itself where it had been internally consistent before.

Adds PreModelSwitch and PostModelSwitch (v2.1.251) everywhere an
exhaustive enumeration exists, and corrects the count wherever a list is
deliberately partial:

- README.md / INDEX.md in en, ja, zh, uk and vi/INDEX.md — count 31 → 33
  and both events added to the lifecycle group
- resources.md in all five languages — count only; these lists end in
  "and more" and are partial by design
- claude_concepts_guide.md — the two missing table rows

Also brings every hook-event table up to the 33 its own summary row
claims. The English CATALOG.md listed 29; the translated catalogs listed
25 and the ja/uk concept guides 27 and 28. Completing them required
translating six events that had never reached the mirrors: Setup,
UserPromptExpansion, PermissionDenied, PostToolBatch, MessageDisplay and
DirectoryAdded.

Summary-table arithmetic is untouched — those columns count example
scripts, not events.

Verified: no stale count survives outside CHANGELOG history, every
exhaustive enumeration lists exactly 33, and pre-commit passes 23/23.

Claude-Session: https://claude.ai/code/session_01UXmqJZNk1BR4uerJA85NiW
2026-09-02 10:35:08 +02:00

20 KiB
Raw Blame History

Claude How To

Приклади Claude Code — Картка швидкого довідника

🚀 Команди швидкого встановлення

Слеш-команди

# Встановити всі
cp 01-slash-commands/*.md .claude/commands/

# Встановити конкретну
cp 01-slash-commands/optimize.md .claude/commands/

Пам'ять

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

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

Навички (Skills)

# Персональні навички
cp -r 03-skills/code-review-specialist ~/.claude/skills/

# Навички проекту
cp -r 03-skills/code-review-specialist .claude/skills/

Субагенти

# Встановити всі
cp 04-subagents/*.md .claude/agents/

# Встановити конкретного
cp 04-subagents/code-reviewer.md .claude/agents/

MCP

# Встановити облікові дані
export GITHUB_TOKEN="your_token"
export DATABASE_URL="postgresql://..."

# Встановити конфігурацію (рівень проекту)
cp 05-mcp/github-mcp.json .mcp.json

# Або рівень користувача: додати в ~/.claude.json

Хуки

# Встановити хуки
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

# Налаштувати в settings (~/.claude/settings.json)

Плагіни

# Встановити з прикладів (якщо опубліковані)
/plugin install pr-review
/plugin install devops-automation
/plugin install documentation

Контрольні точки

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

# Потім оберіть: Відновити код і розмову, Відновити розмову,
# Відновити код, Підсумувати звідси, або Скасувати

Розширені функції

# Налаштувати в 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
Хуки (33 події) ~/.claude/hooks/*.sh Тригер на подію (5 типів)
Плагіни Через /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

🎯 Типові сценарії використання

Ревʼю коду

# Спосіб 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-specialist ~/.claude/skills/
# Використання: Автовиклик

# Спосіб 4: Плагін (найкращий)
/plugin install pr-review
# Використання: /review-pr

Документація

# Слеш-команда
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

# Повний плагін
/plugin install devops-automation

# Команди: /deploy, /rollback, /status, /incident

Командні стандарти

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

# Відредагуйте під вашу команду
vim CLAUDE.md

Автоматизація та хуки

# Встановити хуки (33 події, 5 типів: command, http, mcp_tool, 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

Безпечний рефакторинг

# Контрольні точки створюються автоматично перед кожним промптом
# Спробуйте рефакторинг
# Якщо вдалось: продовжуйте
# Якщо не вдалось: натисніть Esc+Esc або /rewind для відкату

Складна реалізація

# Використайте режим планування
/plan Implement user authentication system

# Claude створить детальний план
# Перегляньте та затвердіть
# Claude реалізує систематично

Інтеграція з CI/CD

# Запуск у 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

Навчання та експериментування

# Режим plan для безпечного аналізу
claude --permission-mode plan

# Експериментуйте безпечно — контрольні точки створюються автоматично
# Для відкату: натисніть Esc+Esc або /rewind

Команди агентів

# Увімкнути команди агентів
export CLAUDE_AGENT_TEAMS=1

# Або в settings.json
{ "agentTeams": { "enabled": true } }

# Почніть з: "Implement feature X using a team approach"

Заплановані завдання

# Запускати команду кожні 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

# Прочитати огляд
cat README.md

# Встановити команду
cp 01-slash-commands/optimize.md .claude/commands/

# Спробувати
/optimize

Дні 2-3

# Налаштувати пам'ять
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
vim CLAUDE.md

# Встановити субагента
cp 04-subagents/code-reviewer.md .claude/agents/

Дні 4-5

# Налаштувати MCP
export GITHUB_TOKEN="your_token"
cp 05-mcp/github-mcp.json .mcp.json

# Спробувати MCP-команди
/mcp__github__list_prs

Тиждень 2

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

# Дозвольте автовиклик
# Просто скажіть: "Review this code for issues"

Тиждень 3+

# Встановити повний плагін
/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
Хуки (33 події) Розширена система хуків з 5 типами Типи: command, http, mcp_tool, 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 <id>
Автопам'ять Автоматичне збереження з розмов Claude автозберігає контекст у CLAUDE.md
Git Worktrees Ізольовані робочі простори для паралельної розробки /worktree для створення
Вибір моделі Перемикання між Fable 5.1, Fable 5, Opus 5, Sonnet 5, Sonnet 4.6, Opus 4.8 та Haiku 4.5 /model або прапорець --model
Команди агентів Координація кількох агентів Увімкнути з CLAUDE_AGENT_TEAMS=1
Заплановані завдання Повторювані завдання з /loop /loop 5m /command або CronCreate
Інтеграція з Chrome Автоматизація браузера Прапорець --chrome або /chrome
Кастомізація клавіатури Налаштування клавіш Команда /keybindings

Поради та хитрощі

Кастомізація

  • Почніть з прикладів як є
  • Модифікуйте під ваші потреби
  • Тестуйте перед поширенням в команді
  • Тримайте конфігурації під контролем версій

Найкращі практики

  • Використовуйте пам'ять для командних стандартів
  • Використовуйте плагіни для комплексних процесів
  • Використовуйте субагентів для складних завдань
  • Використовуйте слеш-команди для швидких завдань

Усунення неполадок

# Перевірити розташування файлів
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-specialist/
Спеціалізоване завдання Субагент 04-subagents/code-reviewer.md
Зовнішні дані MCP (+ Elicitation) 05-mcp/github-mcp.json
Автоматизація подій Хук (33 події, 5 типів) 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

Ця картка: Тримайте під рукою для швидкого довідника!


Останнє оновлення: 2 вересня 2026 Версія Claude Code: 2.1.257 Джерела: