К основному содержанию
команда CX Codex

verify-setup — команда для Claude Code: проверка и восстановление инфраструктуры

Команда verify-setup для Claude Code проверяет инфраструктуру проекта, находит ошибки в хуках, зависимостях и конфигах и подсказывает, как их исправить.

MIT ★ 10 055 обновлён 2026-07-13

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/verify-setup.md
Открыть на GitHub

Что делает 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/

Вопросы о 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

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
ce-setup EveryInc Скилл ce-setup для Claude Code проверяет инструменты и конфигурацию Compound Engineering в репозитории, создаёт пакеты и обновляет документацию по коду. Запускается при настройке окружения или в CI. CX Codex +1 3 600установок cyrus-setup-prerequisites cyrusagents Скилл cyrus-setup-prerequisites для Claude Code, который проверяет системные зависимости перед установкой Cyrus и ставит пакет cyrus-ai. Работает на Node.js 18+ и не читает секреты из ~/.cyrus/.env. CX Codex +1 1 100установок setup OrchestKit Скилл setup сканирует проект, определяет стек, советует скиллы и MCP-серверы, а затем считает готовность проекта. Есть режимы повторного сканирования и настройки. CX Codex +1 133установок setup-docker-containers davila7 Команда setup-docker-containers настраивает Docker для разработки и production, включая multi-stage сборки, Compose и рабочие процессы контейнеров. CX Codex +1 740установок cursor-setup Chachamaru127 Скилл cursor-setup для Claude Code, который настраивает Cursor как локальный бэкенд и проверяет готовность окружения. Выполняет проверку, установку default-бэкенда для пользователя или проекта и откат настроек. CX Codex +1 ★ 3 219звёзд репо

Из того же набора16

Весь набор →
route-research-for-testing Команда route-research-for-testing собирает список изменённых маршрутов в текущей сессии и запускает их тестирование через cURL. Помогает убедиться, что отредактированные API-эндпоинты работают правильно. CX Codex +1 ★ 10 055звёзд репо source-command-verify-setup Скилл source-command-verify-setup запускает диагностический скрипт инфраструктуры и устраняет ошибки в хуках и конфигурациях. CX Codex +1 ★ 10 055звёзд репо dev-docs-update Команда dev-docs-update сохраняет состояние разработки перед сбросом контекста: обновляет документацию задач, память и заметки для передачи работы. CX Codex +1 ★ 10 055звёзд репо dev-docs Команда dev-docs генерирует детальный план реализации для любой задачи: анализирует кодовую базу, разбивает работу на фазы и создаёт трёхфайловую структуру с чек-листами и зависимостями между задачами. CX Codex +1 ★ 10 055звёзд репо auto-error-resolver auto-error-resolver — субагент Claude Code, который устраняет ошибки компиляции TypeScript по отчётам проверочного хука и перепроверяет сборку через tsc. CX Codex ★ 10 055звёзд репо frontend-error-fixer Субагент frontend-error-fixer разбирает ошибки фронтенда на этапе сборки и в браузере. Подходит для TypeScript, React, сетевых сбоев и проблем отображения. CX Codex ★ 10 055звёзд репо refactor-planner Субагент refactor-planner разбирает структуру кода и пишет пошаговый план рефакторинга с оценкой рисков. Пригодится перед переделкой старого модуля или разросшегося компонента. CX Codex ★ 10 055звёзд репо plan-reviewer Субагент plan-reviewer анализирует планы доработки архитектуры, миграций баз данных и интеграций до написания кода. Помогает найти скрытые риски и пропущенные шаги. CX Codex ★ 10 055звёзд репо

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой