feat(uk): translate Module 01 and Module 08 READMEs

Module 01: Slash Commands (565 lines)
Module 08: Checkpoints and Rewind (320 lines)
Update TRANSLATION_QUEUE.md with P1 completion.

Progress: 7/67 files (P1: 5/5 DONE, P2: 2/10)

Ref: luongnv89/claude-howto#63
This commit is contained in:
Evgenij I
2026-04-09 13:45:06 +03:00
parent 9efa5dd9b8
commit 8684be223d
3 changed files with 946 additions and 93 deletions
+585
View File
@@ -0,0 +1,585 @@
<!-- i18n-source: 01-slash-commands/README.md -->
<!-- i18n-source-sha: 63a1416 -->
<!-- i18n-date: 2026-04-09 -->
<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>
# Слеш-команди
## Огляд
Слеш-команди — це ярлики, що керують поведінкою Claude під час інтерактивної сесії. Вони бувають кількох типів:
- **Вбудовані команди**: Надаються Claude Code (`/help`, `/clear`, `/model`)
- **Навички (Skills)**: Користувацькі команди, створені як файли `SKILL.md` (`/optimize`, `/pr`)
- **Команди плагінів**: Команди з встановлених плагінів (`/frontend-design:frontend-design`)
- **MCP-промпти**: Команди з MCP-серверів (`/mcp__github__list_prs`)
> **Примітка**: Кастомні слеш-команди об'єднані з навичками. Файли в `.claude/commands/` все ще працюють, але навички (`.claude/skills/`) — рекомендований підхід. Обидва створюють ярлики `/command-name`. Див. [Посібник з навичок](../03-skills/) для повного довідника.
## Довідник вбудованих команд
Вбудовані команди — це ярлики для типових дій. Доступно **60+ вбудованих команд** та **5 вбудованих навичок**. Введіть `/` у Claude Code для повного списку, або `/` з літерами для фільтрації.
| Команда | Призначення |
|---------|------------|
| `/add-dir <path>` | Додати робочий каталог |
| `/agents` | Управління конфігураціями агентів |
| `/branch [name]` | Розгалужити розмову в нову сесію (аліас: `/fork`). Примітка: `/fork` перейменовано на `/branch` у v2.1.77 |
| `/btw <question>` | Побічне запитання без додавання в історію |
| `/chrome` | Налаштування інтеграції з Chrome |
| `/clear` | Очистити розмову (аліаси: `/reset`, `/new`) |
| `/color [color\|default]` | Встановити колір рядка промпту |
| `/compact [instructions]` | Компактизувати розмову з необов'язковими інструкціями фокусу |
| `/config` | Відкрити налаштування (аліас: `/settings`) |
| `/context` | Візуалізація використання контексту кольоровою сіткою |
| `/copy [N]` | Скопіювати відповідь у буфер; `w` записує у файл |
| `/cost` | Показати статистику використання токенів |
| `/desktop` | Продовжити в десктопному застосунку (аліас: `/app`) |
| `/diff` | Інтерактивний перегляд незакомічених змін |
| `/doctor` | Діагностика стану встановлення |
| `/effort [low\|medium\|high\|max\|auto]` | Встановити рівень зусиль. `max` потребує Opus 4.6 |
| `/exit` | Вийти з REPL (аліас: `/quit`) |
| `/export [filename]` | Експортувати розмову у файл або буфер |
| `/extra-usage` | Налаштування додаткового використання для лімітів |
| `/fast [on\|off]` | Перемкнути швидкий режим |
| `/feedback` | Надіслати відгук (аліас: `/bug`) |
| `/help` | Показати довідку |
| `/hooks` | Переглянути конфігурації хуків |
| `/ide` | Управління IDE-інтеграціями |
| `/init` | Ініціалізувати `CLAUDE.md`. `CLAUDE_CODE_NEW_INIT=1` для інтерактивного потоку |
| `/insights` | Згенерувати звіт аналізу сесії |
| `/install-github-app` | Налаштувати GitHub Actions |
| `/install-slack-app` | Встановити Slack-застосунок |
| `/keybindings` | Відкрити налаштування клавіш |
| `/login` | Змінити обліковий запис Anthropic |
| `/logout` | Вийти з облікового запису Anthropic |
| `/mcp` | Управління MCP-серверами та OAuth |
| `/memory` | Редагувати `CLAUDE.md`, перемкнути автопам'ять |
| `/mobile` | QR-код для мобільного (аліаси: `/ios`, `/android`) |
| `/model [model]` | Вибір моделі зі стрілками вліво/вправо для рівня зусиль |
| `/passes` | Поділитися безкоштовним тижнем Claude Code |
| `/permissions` | Переглянути/оновити дозволи (аліас: `/allowed-tools`) |
| `/plan [description]` | Увійти в режим планування |
| `/plugin` | Управління плагінами |
| `/powerup` | Інтерактивні уроки з анімованими демо |
| `/privacy-settings` | Налаштування приватності (Pro/Max) |
| `/release-notes` | Переглянути журнал змін |
| `/reload-plugins` | Перезавантажити активні плагіни |
| `/remote-control` | Віддалене керування з claude.ai (аліас: `/rc`) |
| `/remote-env` | Налаштування стандартного віддаленого середовища |
| `/rename [name]` | Перейменувати сесію |
| `/resume [session]` | Відновити розмову (аліас: `/continue`) |
| `/review` | **Застаріла** — встановіть плагін `code-review` |
| `/rewind` | Відкат розмови та/або коду (аліас: `/checkpoint`) |
| `/sandbox` | Перемкнути режим пісочниці |
| `/schedule [description]` | Створити/управляти хмарними запланованими завданнями |
| `/security-review` | Аналіз гілки на вразливості безпеки |
| `/skills` | Список доступних навичок |
| `/stats` | Візуалізація щоденного використання, сесій, серій |
| `/stickers` | Замовити стікери Claude Code |
| `/status` | Показати версію, модель, обліковий запис |
| `/statusline` | Налаштування рядка стану |
| `/tasks` | Список/управління фоновими завданнями |
| `/terminal-setup` | Налаштування клавіш терміналу |
| `/theme` | Змінити колірну тему |
| `/ultraplan <prompt>` | Створити план в ultraplan-сесії, переглянути в браузері |
| `/upgrade` | Відкрити сторінку оновлення тарифу |
| `/usage` | Показати ліміти плану та статус обмежень |
| `/voice` | Перемкнути голосовий ввід push-to-talk |
### Вбудовані навички
Ці навички поставляються з Claude Code і викликаються як слеш-команди:
| Навичка | Призначення |
|---------|------------|
| `/batch <instruction>` | Оркестрація масштабних паралельних змін через worktrees |
| `/claude-api` | Завантажити довідник Claude API для мови проекту |
| `/debug [description]` | Увімкнути налагоджувальне логування |
| `/loop [interval] <prompt>` | Запускати промпт повторно за інтервалом |
| `/simplify [focus]` | Перевірити змінені файли на якість коду |
### Застарілі команди
| Команда | Статус |
|---------|--------|
| `/review` | Застаріла — замінена плагіном `code-review` |
| `/output-style` | Застаріла з v2.1.73 |
| `/fork` | Перейменована на `/branch` (аліас працює, v2.1.77) |
| `/pr-comments` | Видалена в v2.1.91 — запитайте Claude напряму |
| `/vim` | Видалена в v2.1.92 — використовуйте /config → Editor mode |
### Останні зміни
- `/fork` перейменовано на `/branch`, `/fork` залишено як аліас (v2.1.77)
- `/output-style` застаріла (v2.1.73)
- `/review` застаріла на користь плагіна `code-review`
- Додано команду `/effort` з рівнем `max` для Opus 4.6
- Додано команду `/voice` для голосового вводу push-to-talk
- Додано команду `/schedule` для запланованих завдань
- Додано команду `/color` для кастомізації рядка промпту
- `/pr-comments` видалена в v2.1.91
- `/vim` видалена в v2.1.92
- Додано `/ultraplan` для перегляду плану в браузері
- Додано `/powerup` для інтерактивних уроків
- Додано `/sandbox` для режиму пісочниці
- Вибір `/model` тепер показує зрозумілі назви (наприклад, "Sonnet 4.6") замість ID моделей
- `/resume` підтримує аліас `/continue`
- MCP-промпти доступні як команди `/mcp__<server>__<prompt>` (див. [MCP-промпти як команди](#mcp-промпти-як-команди))
## Кастомні команди (тепер навички)
Кастомні слеш-команди **об'єднані з навичками**. Обидва підходи створюють команди, які викликаються через `/command-name`:
| Підхід | Розташування | Статус |
|--------|-------------|--------|
| **Навички (Рекомендовано)** | `.claude/skills/<n>/SKILL.md` | Поточний стандарт |
| **Legacy-команди** | `.claude/commands/<n>.md` | Все ще працює |
Якщо навичка і команда мають однакове ім'я, **навичка має пріоритет**. Наприклад, коли існують і `.claude/commands/review.md`, і `.claude/skills/review/SKILL.md`, використовується версія навички.
### Шлях міграції
Існуючі файли `.claude/commands/` продовжують працювати без змін. Для міграції на навички:
**До (Команда):**
```
.claude/commands/optimize.md
```
**Після (Навичка):**
```
.claude/skills/optimize/SKILL.md
```
### Чому навички?
Навички пропонують додаткові можливості порівняно з legacy-командами:
- **Структура каталогів**: Пакування скриптів, шаблонів та довідкових файлів
- **Автовиклик**: Claude може запускати навички автоматично за потреби
- **Контроль виклику**: Вибір — користувач, Claude, або обидва можуть викликати
- **Виконання в субагенті**: Запуск навичок в ізольованих контекстах з `context: fork`
- **Прогресивне розкриття**: Завантаження додаткових файлів лише за потреби
### Створення кастомної команди як навички
Створіть каталог з файлом `SKILL.md`:
```bash
mkdir -p .claude/skills/my-command
```
**Файл:** `.claude/skills/my-command/SKILL.md`
```yaml
---
name: my-command
description: Що робить ця команда і коли її використовувати
---
# My Command
Інструкції для Claude при виклику цієї команди.
1. Перший крок
2. Другий крок
3. Третій крок
```
### Довідник фронтматеру
| Поле | Призначення | За замовчуванням |
|------|------------|-----------------|
| `name` | Ім'я команди (стає `/name`) | Ім'я каталогу |
| `description` | Короткий опис (допомагає Claude знати коли використовувати) | Перший абзац |
| `argument-hint` | Очікувані аргументи для автодоповнення | Немає |
| `allowed-tools` | Інструменти без запиту дозволу | Успадковується |
| `model` | Конкретна модель для використання | Успадковується |
| `disable-model-invocation` | Якщо `true`, тільки користувач може викликати | `false` |
| `user-invocable` | Якщо `false`, сховати з меню `/` | `true` |
| `context` | `fork` для запуску в ізольованому субагенті | Немає |
| `agent` | Тип агента при `context: fork` | `general-purpose` |
| `hooks` | Хуки на рівні навички (PreToolUse, PostToolUse, Stop) | Немає |
### Аргументи
Команди можуть отримувати аргументи:
**Усі аргументи з `$ARGUMENTS`:**
```yaml
---
name: fix-issue
description: Fix a GitHub issue by number
---
Fix issue #$ARGUMENTS following our coding standards
```
Використання: `/fix-issue 123``$ARGUMENTS` стає "123"
**Окремі аргументи з `$0`, `$1` тощо:**
```yaml
---
name: review-pr
description: Review a PR with priority
---
Review PR #$0 with priority $1
```
Використання: `/review-pr 456 high``$0`="456", `$1`="high"
### Динамічний контекст з shell-командами
Виконуйте bash-команди перед промптом з допомогою `` !`command` ``:
```yaml
---
name: commit
description: Create a git commit with context
allowed-tools: Bash(git *)
---
## Context
- Current git status: !`git status`
- Current git diff: !`git diff HEAD`
- Current branch: !`git branch --show-current`
- Recent commits: !`git log --oneline -5`
## Your task
Based on the above changes, create a single git commit.
```
### Посилання на файли
Включайте вміст файлів з `@`:
```markdown
Review the implementation in @src/utils/helpers.js
Compare @src/old-version.js with @src/new-version.js
```
## Команди плагінів
Плагіни можуть надавати кастомні команди:
```
/plugin-name:command-name
```
Або просто `/command-name`, якщо немає конфліктів імен.
**Приклади:**
```bash
/frontend-design:frontend-design
/commit-commands:commit
```
## MCP-промпти як команди
MCP-сервери можуть надавати промпти як слеш-команди:
```
/mcp__<server-name>__<prompt-name> [arguments]
```
**Приклади:**
```bash
/mcp__github__list_prs
/mcp__github__pr_review 456
/mcp__jira__create_issue "Bug title" high
```
### Синтаксис дозволів MCP
Контроль доступу до MCP-серверів у дозволах:
- `mcp__github` — Доступ до всього GitHub MCP-сервера
- `mcp__github__*` — Wildcard-доступ до всіх інструментів
- `mcp__github__get_issue` — Доступ до конкретного інструменту
## Архітектура команд
```mermaid
graph TD
A["User Input: /command-name"] --> B{"Command Type?"}
B -->|Built-in| C["Execute Built-in"]
B -->|Skill| D["Load SKILL.md"]
B -->|Plugin| E["Load Plugin Command"]
B -->|MCP| F["Execute MCP Prompt"]
D --> G["Parse Frontmatter"]
G --> H["Substitute Variables"]
H --> I["Execute Shell Commands"]
I --> J["Send to Claude"]
J --> K["Return Results"]
```
## Життєвий цикл команди
```mermaid
sequenceDiagram
participant User
participant Claude as Claude Code
participant FS as File System
participant CLI as Shell/Bash
User->>Claude: Types /optimize
Claude->>FS: Searches .claude/skills/ and .claude/commands/
FS-->>Claude: Returns optimize/SKILL.md
Claude->>Claude: Parses frontmatter
Claude->>CLI: Executes !`command` substitutions
CLI-->>Claude: Command outputs
Claude->>Claude: Substitutes $ARGUMENTS
Claude->>User: Processes prompt
Claude->>User: Returns results
```
## Доступні команди в цьому каталозі
Ці приклади команд можна встановити як навички або legacy-команди.
### 1. `/optimize` — Оптимізація коду
Аналізує код на проблеми продуктивності, витоки пам'яті та можливості оптимізації.
**Використання:**
```
/optimize
[Вставте ваш код]
```
### 2. `/pr` — Підготовка Pull Request
Проводить через чекліст підготовки PR, включаючи лінтинг, тестування та форматування комітів.
**Використання:**
```
/pr
```
**Скріншот:**
![/pr](../../01-slash-commands/pr-slash-command.png)
### 3. `/generate-api-docs` — Генератор API-документації
Генерує комплексну API-документацію з вихідного коду.
**Використання:**
```
/generate-api-docs
```
### 4. `/commit` — Git-коміт з контекстом
Створює git-коміт з динамічним контекстом вашого репозиторію.
**Використання:**
```
/commit [необов'язкове повідомлення]
```
### 5. `/push-all` — Stage, Commit та Push
Stage всіх змін, створення коміту та push на remote з перевірками безпеки.
**Використання:**
```
/push-all
```
**Перевірки безпеки:**
- Секрети: `.env*`, `*.key`, `*.pem`, `credentials.json`
- API-ключі: Виявлення реальних ключів vs. заповнювачів
- Великі файли: `>10MB` без Git LFS
- Артефакти збірки: `node_modules/`, `dist/`, `__pycache__/`
### 6. `/doc-refactor` — Реструктуризація документації
Реструктуризує документацію проекту для ясності та доступності.
**Використання:**
```
/doc-refactor
```
### 7. `/setup-ci-cd` — Налаштування CI/CD-пайплайну
Впроваджує pre-commit хуки та GitHub Actions для контролю якості.
**Використання:**
```
/setup-ci-cd
```
### 8. `/unit-test-expand` — Розширення покриття тестами
Збільшує покриття тестами, націлюючись на непротестовані гілки та крайові випадки.
**Використання:**
```
/unit-test-expand
```
## Встановлення
### Як навички (Рекомендовано)
Скопіюйте у каталог навичок:
```bash
# Створити каталог навичок
mkdir -p .claude/skills
# Для кожного файлу команди створити каталог навички
for cmd in optimize pr commit; do
mkdir -p .claude/skills/$cmd
cp 01-slash-commands/$cmd.md .claude/skills/$cmd/SKILL.md
done
```
### Як legacy-команди
Скопіюйте у каталог команд:
```bash
# На рівні проекту (команда)
mkdir -p .claude/commands
cp 01-slash-commands/*.md .claude/commands/
# Персональне використання
mkdir -p ~/.claude/commands
cp 01-slash-commands/*.md ~/.claude/commands/
```
## Створення власних команд
### Шаблон навички (Рекомендовано)
Створіть `.claude/skills/my-command/SKILL.md`:
```yaml
---
name: my-command
description: What this command does. Use when [trigger conditions].
argument-hint: [optional-args]
allowed-tools: Bash(npm *), Read, Grep
---
# Command Title
## Context
- Current branch: !`git branch --show-current`
- Related files: @package.json
## Instructions
1. First step
2. Second step with argument: $ARGUMENTS
3. Third step
## Output Format
- How to format the response
- What to include
```
### Команда лише для користувача (без автовиклику)
Для команд з побічними ефектами, які Claude не повинен запускати автоматично:
```yaml
---
name: deploy
description: Deploy to production
disable-model-invocation: true
allowed-tools: Bash(npm *), Bash(git *)
---
Deploy the application to production:
1. Run tests
2. Build application
3. Push to deployment target
4. Verify deployment
```
## Найкращі практики
| Робіть | Не робіть |
|--------|-----------|
| Використовуйте чіткі, орієнтовані на дію назви | Не створюйте команди для одноразових завдань |
| Додавайте `description` з умовами тригеру | Не вбудовуйте складну логіку в команди |
| Тримайте команди зосередженими на одному завданні | Не хардкодьте чутливу інформацію |
| Використовуйте `disable-model-invocation` для побічних ефектів | Не пропускайте поле description |
| Використовуйте `!` для динамічного контексту | Не вважайте, що Claude знає поточний стан |
| Організуйте пов'язані файли в каталогах навичок | Не кладіть все в один файл |
## Усунення неполадок
### Команда не знайдена
**Рішення:**
- Перевірте, що файл у `.claude/skills/<n>/SKILL.md` або `.claude/commands/<n>.md`
- Перевірте поле `name` у фронтматері
- Перезапустіть сесію Claude Code
- Запустіть `/help` для перегляду доступних команд
### Команда працює не як очікувалось
**Рішення:**
- Додайте більш конкретні інструкції
- Включіть приклади у файл навички
- Перевірте `allowed-tools` при використанні bash-команд
- Спочатку тестуйте з простими вхідними даними
### Конфлікт навички та команди
Якщо обидві існують з однаковим ім'ям, **навичка має пріоритет**. Видаліть одну або перейменуйте.
## Пов'язані посібники
- **[Навички](../03-skills/)** — Повний довідник навичок (автоматично викликані можливості)
- **[Пам'ять](../02-memory/)** — Постійний контекст з CLAUDE.md
- **[Субагенти](../04-subagents/)** — Делеговані AI-агенти
- **[Плагіни](../07-plugins/)** — Пакетні набори команд
- **[Хуки](../06-hooks/)** — Автоматизація на основі подій
## Додаткові ресурси
- [Офіційна документація інтерактивного режиму](https://code.claude.com/docs/en/interactive-mode) — Довідник вбудованих команд
- [Офіційна документація навичок](https://code.claude.com/docs/en/skills) — Повний довідник навичок
- [Довідник CLI](https://code.claude.com/docs/en/cli-reference) — Опції командного рядка
---
**Останнє оновлення**: 9 квітня 2026
**Версія Claude Code**: 2.1.97
**Сумісні моделі**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5
*Частина серії посібників [Claude How To](../)*
+335
View File
@@ -0,0 +1,335 @@
<!-- i18n-source: 08-checkpoints/README.md -->
<!-- i18n-source-sha: 63a1416 -->
<!-- i18n-date: 2026-04-09 -->
<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>
# Контрольні точки та відкат
Контрольні точки дозволяють зберігати стан розмови та повертатися до попередніх моментів у сесії Claude Code. Це незамінно для дослідження різних підходів, відновлення після помилок або порівняння альтернативних рішень.
## Огляд
Контрольні точки — це знімки стану вашої розмови, що включають:
- Усі повідомлення розмови
- Модифікації файлів
- Історію використання інструментів
- Контекст сесії
Контрольні точки незамінні при дослідженні різних підходів, відновленні після помилок або порівнянні альтернативних рішень.
## Ключові поняття
| Поняття | Опис |
|---------|------|
| **Контрольна точка (Checkpoint)** | Знімок стану розмови, включаючи повідомлення, файли та контекст |
| **Відкат (Rewind)** | Повернення до попередньої контрольної точки з відкиданням подальших змін |
| **Точка розгалуження (Branch Point)** | Контрольна точка, з якої досліджуються кілька підходів |
## Доступ до контрольних точок
Ви можете отримати доступ та управляти контрольними точками двома способами:
### Клавіатурне скорочення
Натисніть `Esc` двічі (`Esc` + `Esc`), щоб відкрити інтерфейс контрольних точок та переглянути збережені точки.
### Слеш-команда
Використовуйте команду `/rewind` (аліас: `/checkpoint`) для швидкого доступу:
```bash
# Відкрити інтерфейс відкату
/rewind
# Або використайте аліас
/checkpoint
```
## Варіанти відкату
При відкаті вам пропонується меню з п'яти варіантів:
1. **Відновити код і розмову** — Повернути і файли, і повідомлення до цієї контрольної точки
2. **Відновити розмову** — Відкотити лише повідомлення, залишити поточний код як є
3. **Відновити код** — Повернути зміни файлів, зберегти повну історію розмови
4. **Підсумувати звідси** — Стиснути розмову від цієї точки вперед в AI-згенерований підсумок, звільняючи контекстне вікно. Повідомлення до обраної точки залишаються недоторканими. Жодні файли на диску не змінюються. Оригінальні повідомлення зберігаються в транскрипті сесії. Можна додатково вказати інструкції для фокусування підсумку на конкретних темах.
5. **Скасувати** — Скасувати та повернутися до поточного стану
> **Примітка**: Після відновлення розмови або підсумовування оригінальний промпт з обраного повідомлення відновлюється в полі вводу, щоб ви могли повторно надіслати або відредагувати його.
## Автоматичні контрольні точки
Claude Code автоматично створює контрольні точки:
- **Кожен промпт користувача** — Нова контрольна точка створюється з кожним введенням
- **Постійні** — Контрольні точки зберігаються між сесіями
- **Автоочищення** — Контрольні точки автоматично очищуються через 30 днів
Це означає, що ви завжди можете повернутися до будь-якого попереднього моменту розмови — від кількох хвилин тому до днів.
## Сценарії використання
| Сценарій | Процес |
|----------|--------|
| **Дослідження підходів** | Зберегти → Спробувати A → Зберегти → Відкат → Спробувати B → Порівняти |
| **Безпечний рефакторинг** | Зберегти → Рефакторити → Тест → Якщо не вдалось: Відкат |
| **A/B тестування** | Зберегти → Дизайн A → Зберегти → Відкат → Дизайн B → Порівняти |
| **Відновлення після помилки** | Помітити проблему → Відкат до останнього робочого стану |
## Використання контрольних точок
### Перегляд та відкат
Натисніть `Esc` двічі або використайте `/rewind`, щоб відкрити браузер контрольних точок. Ви побачите список усіх доступних точок з мітками часу. Оберіть будь-яку для відкату.
### Деталі контрольної точки
Кожна контрольна точка показує:
- Мітку часу створення
- Модифіковані файли
- Кількість повідомлень у розмові
- Використані інструменти
## Практичні приклади
### Приклад 1: Дослідження різних підходів
```
User: Let's add a caching layer to the API
Claude: I'll add Redis caching to your API endpoints...
[Makes changes at checkpoint A]
User: Actually, let's try in-memory caching instead
Claude: I'll rewind to explore a different approach...
[User presses Esc+Esc and rewinds to checkpoint A]
[Implements in-memory caching at checkpoint B]
User: Now I can compare both approaches
```
### Приклад 2: Відновлення після помилки
```
User: Refactor the authentication module to use JWT
Claude: I'll refactor the authentication module...
[Makes extensive changes]
User: Wait, that broke the OAuth integration. Let's go back.
Claude: I'll help you rewind to before the refactoring...
[User presses Esc+Esc and selects the checkpoint before the refactor]
User: Let's try a more conservative approach this time
```
### Приклад 3: Безпечне експериментування
```
User: Let's try rewriting this in a functional style
[Creates checkpoint before experiment]
Claude: [Makes experimental changes]
User: The tests are failing. Let's rewind.
[User presses Esc+Esc and rewinds to the checkpoint]
Claude: I've rewound the changes. Let's try a different approach.
```
### Приклад 4: Розгалуження підходів
```
User: I want to compare two database designs
[Takes note of checkpoint - call it "Start"]
Claude: I'll create the first design...
[Implements Schema A]
User: Now let me go back and try the second approach
[User presses Esc+Esc and rewinds to "Start"]
Claude: Now I'll implement Schema B...
[Implements Schema B]
User: Great! Now I have both schemas to choose from
```
## Збереження контрольних точок
Claude Code автоматично управляє контрольними точками:
- Контрольні точки створюються автоматично з кожним промптом
- Старі контрольні точки зберігаються до 30 днів
- Автоматичне очищення запобігає необмеженому зростанню сховища
## Патерни процесів
### Стратегія розгалуження для дослідження
При дослідженні кількох підходів:
```
1. Початкова реалізація → Контрольна точка A
2. Спроба Підходу 1 → Контрольна точка B
3. Відкат до Контрольної точки A
4. Спроба Підходу 2 → Контрольна точка C
5. Порівняння результатів B та C
6. Вибір найкращого підходу та продовження
```
### Патерн безпечного рефакторингу
При значних змінах:
```
1. Поточний стан → Контрольна точка (авто)
2. Початок рефакторингу
3. Запуск тестів
4. Якщо тести пройшли → Продовжити роботу
5. Якщо тести не пройшли → Відкат та спроба іншого підходу
```
## Найкращі практики
Оскільки контрольні точки створюються автоматично, ви можете зосередитися на роботі, не турбуючись про ручне збереження стану. Але пам'ятайте:
### Ефективне використання контрольних точок
**Робіть:**
- Переглядайте доступні контрольні точки перед відкатом
- Використовуйте відкат для дослідження різних напрямків
- Зберігайте контрольні точки для порівняння підходів
- Розумійте, що робить кожен варіант відкату
**Не робіть:**
- Не покладайтесь лише на контрольні точки для збереження коду
- Не очікуйте, що контрольні точки відстежують зовнішні зміни файлової системи
- Не використовуйте контрольні точки замість git-комітів
## Конфігурація
Контрольні точки — вбудована поведінка Claude Code за замовчуванням, не потребує конфігурації. Кожен промпт автоматично створює контрольну точку.
Єдине налаштування — `cleanupPeriodDays`, що контролює тривалість зберігання:
```json
{
"cleanupPeriodDays": 30
}
```
- `cleanupPeriodDays`: Кількість днів зберігання історії сесій та контрольних точок (за замовчуванням: `30`)
## Обмеження
Контрольні точки мають такі обмеження:
- **Bash-команди НЕ відстежуються** — Операції `rm`, `mv`, `cp` у файловій системі не фіксуються
- **Зовнішні зміни НЕ відстежуються** — Зміни, зроблені поза Claude Code (у редакторі, терміналі тощо), не фіксуються
- **Не заміна системі контролю версій** — Використовуйте git для постійних, аудитованих змін
## Усунення неполадок
### Відсутні контрольні точки
**Проблема**: Очікувана контрольна точка не знайдена
**Рішення**:
- Перевірте, чи контрольні точки не були очищені
- Перевірте дисковий простір
- Переконайтесь, що `cleanupPeriodDays` встановлено достатньо високо (за замовчуванням: 30 днів)
### Невдалий відкат
**Проблема**: Не вдається відкотити до контрольної точки
**Рішення**:
- Переконайтесь, що немає конфліктуючих незакомічених змін
- Перевірте, чи контрольна точка не пошкоджена
- Спробуйте відкат до іншої контрольної точки
## Інтеграція з Git
Контрольні точки доповнюють (але не замінюють) git:
| Характеристика | Git | Контрольні точки |
|----------------|-----|-----------------|
| Область | Файлова система | Розмова + файли |
| Постійність | Постійна | На рівні сесії |
| Деталізація | Коміти | Будь-яка точка |
| Швидкість | Повільніше | Миттєво |
| Спільний доступ | Так | Обмежено |
Використовуйте обидва разом:
1. Контрольні точки для швидкого експериментування
2. Git-коміти для фіналізованих змін
3. Створення контрольної точки перед git-операціями
4. Коміт успішних станів до git
## Швидкий старт
### Базовий процес
1. **Працюйте як зазвичай** — Claude Code створює контрольні точки автоматично
2. **Хочете повернутись?** — Натисніть `Esc` двічі або `/rewind`
3. **Оберіть контрольну точку** — Виберіть зі списку
4. **Оберіть що відновити** — Код і розмову, лише розмову, лише код, підсумувати або скасувати
5. **Продовжуйте роботу** — Ви повернулись до тієї точки
### Клавіатурні скорочення
- **`Esc` + `Esc`** — Відкрити браузер контрольних точок
- **`/rewind`** — Альтернативний спосіб доступу
- **`/checkpoint`** — Аліас для `/rewind`
## Коли відкочуватися: Моніторинг контексту
Контрольні точки дозволяють повернутись — але як зрозуміти, *коли* це потрібно? З ростом розмови контекстне вікно Claude заповнюється, і якість моделі непомітно знижується. Ви можете відправляти код, згенерований напівсліпою моделлю, навіть не усвідомлюючи цього.
**[cc-context-stats](https://github.com/luongnv89/cc-context-stats)** вирішує це, додаючи **зони контексту** в реальному часі до рядка стану Claude Code. Інструмент відстежує, де ви знаходитесь у контекстному вікні — від **Plan** (зелений, безпечно планувати та кодити) через **Code** (жовтий, уникайте нових планів) до **Dump** (оранжевий, завершуйте та відкочуйте). Коли бачите зміну зони — час створити контрольну точку та почати заново.
## Пов'язані концепції
- **[Розширені функції](../09-advanced-features/)** — Режим планування та інші просунуті можливості
- **[Управління пам'яттю](../02-memory/)** — Управління історією розмови та контекстом
- **[Слеш-команди](../01-slash-commands/)** — Ярлики користувача
- **[Хуки](../06-hooks/)** — Автоматизація на основі подій
- **[Плагіни](../07-plugins/)** — Пакетні розширення
## Додаткові ресурси
- [Офіційна документація контрольних точок](https://code.claude.com/docs/en/checkpointing)
- [Посібник з розширених функцій](../09-advanced-features/) — Розширене мислення та інші можливості
## Підсумок
Контрольні точки — автоматична функція Claude Code, що дозволяє безпечно досліджувати різні підходи без страху втратити роботу. Кожен промпт автоматично створює нову контрольну точку, тож ви можете відкотитися до будь-якого попереднього моменту сесії.
Ключові переваги:
- Безстрашне експериментування з кількома підходами
- Швидке відновлення після помилок
- Порівняння різних рішень пліч-о-пліч
- Безпечна інтеграція з системами контролю версій
Пам'ятайте: контрольні точки не замінюють git. Використовуйте контрольні точки для швидкого експериментування, а git — для постійних змін коду.
---
**Останнє оновлення**: 9 квітня 2026
**Версія Claude Code**: 2.1.97
**Сумісні моделі**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5
+26 -93
View File
@@ -2,111 +2,44 @@
# Прогрес перекладу українською
**Загальний прогрес:** 0/67 файлів (0%)
**Загальний прогрес:** 5/67 файлів (7%)
**Статус:** 🚧 В ПРОЦЕСІ
**Статус:** 🚧 В ПРОЦЕСІ — P1 ядро завершено ✅
## Пріоритет 1 — Ядро (5 файлів)
## Пріоритет 1 — Ядро (5 файлів)
| Файл | Статус | Дата | Перекладач |
|------|--------|------|------------|
| README.md | ✅ Готово | 2026-04-09 | edocltd |
| INDEX.md | ⏳ Очікує | | |
| CATALOG.md | ⏳ Очікує | | |
| QUICK_REFERENCE.md | ⏳ Очікує | | |
| LEARNING-ROADMAP.md | ⏳ Очікує | | |
| Файл | Статус | Дата |
|------|--------|------|
| README.md | ✅ | 2026-04-09 |
| INDEX.md | ✅ | 2026-04-09 |
| CATALOG.md | ✅ | 2026-04-09 |
| QUICK_REFERENCE.md | ✅ | 2026-04-09 |
| LEARNING-ROADMAP.md | ✅ | 2026-04-09 |
**Прогрес P1:** 1/5 (20%)
**Прогрес P1:** 5/5 (100%)
## Пріоритет 2 — Модулі README (10 файлів)
| Модуль | Файл | Статус | Дата |
|--------|------|--------|------|
| 01 | 01-slash-commands/README.md | ⏳ Очікує | |
| 02 | 02-memory/README.md | ⏳ Очікує | |
| 03 | 03-skills/README.md | ⏳ Очікує | |
| 04 | 04-subagents/README.md | ⏳ Очікує | |
| 05 | 05-mcp/README.md | ⏳ Очікує | |
| 06 | 06-hooks/README.md | ⏳ Очікує | |
| 07 | 07-plugins/README.md | ⏳ Очікує | |
| 08 | 08-checkpoints/README.md | ⏳ Очікує | |
| 09 | 09-advanced-features/README.md | ⏳ Очікує | |
| 10 | 10-cli/README.md | ⏳ Очікує | |
| Модуль | Рядків | Статус | Дата |
|--------|--------|--------|------|
| 01 slash-commands | 565 | ⏳ | |
| 02 memory | 1156 | ⏳ | |
| 03 skills | 811 | ⏳ | |
| 04 subagents | 1142 | ⏳ | |
| 05 mcp | 1113 | ⏳ | |
| 06 hooks | 1170 | ⏳ | |
| 07 plugins | 949 | ⏳ | |
| 08 checkpoints | 320 | ⏳ | |
| 09 advanced | 1945 | ⏳ | |
| 10 cli | 837 | ⏳ | |
**Прогрес P2:** 0/10 (0%)
## Пріоритет 3 — Приклади модулів (47 файлів)
## Пріоритет 3 — Приклади (47 файлів) · P4 — Допоміжні (5 файлів)
### Модуль 01 — Слеш-команди (8 файлів)
Деталі — див. попередню версію цього файлу.
| Файл | Статус | Дата |
|------|--------|------|
| commit.md | ⏳ | |
| doc-refactor.md | ⏳ | |
| generate-api-docs.md | ⏳ | |
| optimize.md | ⏳ | |
| pr.md | ⏳ | |
| push-all.md | ⏳ | |
| setup-ci-cd.md | ⏳ | |
| unit-test-expand.md | ⏳ | |
### Модуль 02 — Пам'ять (3 файли)
| Файл | Статус | Дата |
|------|--------|------|
| directory-api-CLAUDE.md | ⏳ | |
| personal-CLAUDE.md | ⏳ | |
| project-CLAUDE.md | ⏳ | |
### Модуль 03 — Навички (6 файлів)
| Файл | Статус | Дата |
|------|--------|------|
| blog-draft/SKILL.md | ⏳ | |
| brand-voice/SKILL.md | ⏳ | |
| brand-voice/tone-examples.md | ⏳ | |
| claude-md/SKILL.md | ⏳ | |
| code-review/SKILL.md | ⏳ | |
| doc-generator/SKILL.md | ⏳ | |
| refactor/SKILL.md | ⏳ | |
### Модуль 04 — Субагенти (8 файлів)
| Файл | Статус | Дата |
|------|--------|------|
| clean-code-reviewer.md | ⏳ | |
| code-reviewer.md | ⏳ | |
| data-scientist.md | ⏳ | |
| debugger.md | ⏳ | |
| documentation-writer.md | ⏳ | |
| implementation-agent.md | ⏳ | |
| performance-optimizer.md | ⏳ | |
| secure-reviewer.md | ⏳ | |
| test-engineer.md | ⏳ | |
### Модуль 05-10 — Приклади
Код-файли (`.sh`, `.py`, `.json`) **не копіюються** — посилаємося на оригінали.
Файли прикладів перекладаються за потреби.
| Файл | Статус | Дата |
|------|--------|------|
| 08-checkpoints/checkpoint-examples.md | ⏳ | |
| 09-advanced-features/planning-mode-examples.md | ⏳ | |
**Прогрес P3:** 0/47 (0%)
## Пріоритет 4 — Допоміжні документи (5 файлів)
| Файл | Статус | Дата |
|------|--------|------|
| CONTRIBUTING.md | ⏳ Очікує | |
| SECURITY.md | ⏳ Очікує | |
| CODE_OF_CONDUCT.md | ⏳ Очікує | |
| STYLE_GUIDE.md | ⏳ Очікує | |
| CHANGELOG.md | ⏳ Очікує | |
**Прогрес P4:** 0/5 (0%)
**Прогрес P3:** 0/47 · **P4:** 0/5
---