verify-setup — команда для Claude Code: проверка и восстановление инфраструктуры
Команда verify-setup для Claude Code проверяет инфраструктуру проекта, находит ошибки в хуках, зависимостях и конфигах и подсказывает, как их исправить.
MIT ★ 10 055 обновлён 2026-07-13
.claude/commands/verify-setup.mdЧто делает verify-setup
verify-setup проверяет здоровье проекта: наличие зависимостей, права доступа на скрипты, валидность JSON в .claude/settings.json и .claude/skills/skill-rules.json, регистрацию хуков. Команда выдаёт список ошибок с подсказками по исправлению.
При каждой ошибке скрипт предлагает конкретный шаг: установить пакеты через npm install, добавить права выполнения скриптам chmod +x, исправить синтаксис JSON (обычно это запятая перед закрывающей скобкой). Если хуки не зарегистрированы в settings.json, команда спросит, копировать ли их из showcase-репозитория или удалить мёртвые регистрации.
Предупреждения [WARN] указывают на опциональные функции (session intelligence, jq-трекинг файлов, ключи для ИИ-классификации) — их установку скрипт не выполняет, а только перечисляет, чтобы вы выбрали сами.
Какие задачи решает
- Диагностировать поломки в
.claude/settings.jsonи скриптах - Восстановить права доступа к файлам в
.claude/hooks/ - Установить недостающие зависимости проекта
- Проверить регистрацию хуков и очистить мёртвые ссылки
- Найти и исправить синтаксические ошибки в JSON-конфигах
Примеры запросов агенту
- Запусти диагностику и покажи, что сломалось в проекте
- Проверь инфраструктуру Claude Code и исправь всё красное
- Выполни verify-setup и помоги разобраться с ошибками
Как установить verify-setup
Вручную: положить файлы
.claude/commands/verify-setup.mdВызов — /verify-setup. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/verify-setup.mdВызов — /prompts:verify-setup. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/verify-setup.prompt.mdВручную: положить файлы
.gemini/commands/verify-setup.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о verify-setup
Как установить verify-setup в Claude Code?
Скопируй файл .claude/commands/verify-setup.md в корень проекта. Для Codex положи ~/.codex/prompts/verify-setup.md в домашнюю папку; для GitHub Copilot — .github/prompts/verify-setup.prompt.md в репозиторий; для Gemini CLI — .gemini/commands/verify-setup.toml в конфиг.
Что делает verify-setup?
Проверяет состояние инфраструктуры: зависимости, права доступа, JSON-синтаксис, регистрацию хуков. Если находит ошибки, выдаёт инструкции по их исправлению.
Что значит [WARN] в результатах?
Это опциональные функции (session intelligence, классификация через ИИ), которые команда не включает автоматически. Вы сами решаете, устанавливать их или нет.
Исходный текст
verify-setup.md · MIT
--- description: Run the infrastructure health check and fix anything that fails argument-hint: (no arguments needed) --- Run the Claude Code infrastructure health check and get it fully green. ## Steps 1. Run the health check from the project root: ```bash bash .claude/scripts/verify-setup.sh ``` 2. For every `[FAIL]` line, apply the printed fix. Common fixes: - Dependencies missing: `cd .claude/hooks && npm install` - Scripts not executable: `chmod +x .claude/hooks/*.sh` - Invalid JSON in `.claude/settings.json` or `.claude/skills/skill-rules.json`: read the file, find the syntax error (usually a trailing comma), and repair it without changing any settings values - Missing hook scripts registered in settings.json: ask the user whether to copy them from the showcase repo (https://github.com/diet103/claude-code-infrastructure-showcase) or remove the dead registrations 3. Re-run the script after each fix until it reports 0 failed. 4. `[WARN]` lines are optional features (session intelligence, jq-based file tracking, AI classification keys). Do NOT install API keys or system packages on the user's behalf - summarize what each warning means and let the user decide. 5. Report the final result to the user: what was broken, what you fixed, and what (if anything) remains as a warning.
© diet103 · MIT · diet103/claude-code-infrastructure-showcase