checkpoint — команда для Claude Code: что делает и как установить
Команда checkpoint фиксирует контрольные точки в Git во время сессии Claude Code и сравнивает текущее состояние файлов, тестов и сборки с сохранённым срезом.
MIT ★ 6 739 обновлён 2026-01-23
/plugin marketplace add WorldFlowAI/everything-claude-code
/plugin install everything-claude-code@everything-claude-codeЧто делает checkpoint
Команда помогает отслеживать промежуточные этапы работы над задачей. При создании новой точки она сначала запускает /verify quick, чтобы проверить чистоту репозитория, а затем делает коммит или Git stash и записывает метку времени, имя и короткий хэш коммита в .claude/checkpoints.log.
При проверке через /checkpoint verify агент читает лог и сопоставляет текущее состояние рабочей копии с выбранной точкой. В отчёте выводятся добавленные и изменённые файлы, динамика прохождения тестов, процент покрытия кода и статус сборки. Для работы обязателен Git-репозиторий в рабочей директории, иначе создание среза завершится сбоем.
Какие задачи решает
- зафиксировать промежуточное состояние кода перед сложным рефакторингом
- сравнить прохождение тестов и покрытие до и после правок
- просмотреть историю контрольных точек проекта со статусами и Git SHA
- удалить устаревшие снапшоты с сохранением последних пяти записей
Примеры запросов агенту
- /checkpoint create "feature-start"
- /checkpoint verify "core-done"
- /checkpoint list
Как установить checkpoint
1Через маркетплейс плагинов
/plugin marketplace add WorldFlowAI/everything-claude-code/plugin install everything-claude-code@everything-claude-code2Вручную: положить файлы
.claude/commands/checkpoint.mdВызов — /checkpoint. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/checkpoint.mdВызов — /prompts:checkpoint. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/checkpoint.prompt.mdВручную: положить файлы
.gemini/commands/checkpoint.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о checkpoint
Как установить checkpoint в Claude Code?
Выполните в терминале команду /plugin marketplace add WorldFlowAI/everything-claude-code, а затем установите плагин вызовом /plugin install everything-claude-code@everything-claude-code. Альтернативный вариант — разместить файл по пути .claude/commands/checkpoint.md.
Что делает команда checkpoint?
Она сохраняет именованные срезы в Git с записью в .claude/checkpoints.log и даёт возможность сопоставлять файлы, тесты и покрытие с сохранённым шагом.
Что происходит при очистке контрольных точек?
Команда /checkpoint clear удаляет старые записи из журнала, оставляя только последние пять срезов.
Исходный текст
checkpoint.md · MIT
# Checkpoint Command Create or verify a checkpoint in your workflow. ## Usage `/checkpoint [create|verify|list] [name]` ## Create Checkpoint When creating a checkpoint: 1. Run `/verify quick` to ensure current state is clean 2. Create a git stash or commit with checkpoint name 3. Log checkpoint to `.claude/checkpoints.log`: ```bash echo "$(date +%Y-%m-%d-%H:%M) | $CHECKPOINT_NAME | $(git rev-parse --short HEAD)" >> .claude/checkpoints.log ``` 4. Report checkpoint created ## Verify Checkpoint When verifying against a checkpoint: 1. Read checkpoint from log 2. Compare current state to checkpoint: - Files added since checkpoint - Files modified since checkpoint - Test pass rate now vs then - Coverage now vs then 3. Report: ``` CHECKPOINT COMPARISON: $NAME ============================ Files changed: X Tests: +Y passed / -Z failed Coverage: +X% / -Y% Build: [PASS/FAIL] ``` ## List Checkpoints Show all checkpoints with: - Name - Timestamp - Git SHA - Status (current, behind, ahead) ## Workflow Typical checkpoint flow: ``` [Start] --> /checkpoint create "feature-start" | [Implement] --> /checkpoint create "core-done" | [Test] --> /checkpoint verify "core-done" | [Refactor] --> /checkpoint create "refactor-done" | [PR] --> /checkpoint verify "feature-start" ``` ## Arguments $ARGUMENTS: - `create <name>` - Create named checkpoint - `verify <name>` - Verify against named checkpoint - `list` - Show all checkpoints - `clear` - Remove old checkpoints (keeps last 5)
© Affaan Mustafa · MIT · WorldFlowAI/everything-claude-code