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

install-hook — команда для Claude Code: что делает и как установить

Команда install-hook встраивает сгенерированные хуки в глобальный или проектный файл настроек Claude Code с автоматической проверкой безопасности и бэкапом.

MIT ★ 907 обновлён 2025-11-12

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

Что делает install-hook

Команда переносит конфигурацию из hook.json в settings.json. Она умеет записывать правила на уровне пользователя в ~/.claude/settings.json или для текущей рабочей папки в .claude/settings.json. Если уровень не передан аргументом, команда ищет локальный конфиг и спрашивает подтверждение.

Перед изменением настроек запускается проверка. Скрипт проверяет валидность JSON, корректность структуры событий и блокирует деструктивные вызовы вроде rm -rf или git push --force. Также контролируется изоляция путей и наличие тихого завершения через || exit 0.

Перед любой записью создаётся резервная копия settings.json.backup в том же каталоге. Новые триггеры объединяются со старыми записями без перезаписи других параметров, но для вступления хука в силу потребуется перезапуск Claude Code.

Какие задачи решает

  • добавить готовый хук в глобальные или локальные настройки Claude Code
  • проверить конфигурацию хука на деструктивные команды и уязвимости путей
  • объединить новые триггеры с существующими без повреждения settings.json
  • сохранить автоматическую резервную копию конфигурации перед её правкой

Примеры запросов агенту

  • /install-hook generated-hooks/auto-format-python user
  • /install-hook generated-hooks/test-runner project
  • /install-hook generated-hooks/git-auto-add

Как установить install-hook

Вручную: положить файлы

.claude/commands/install-hook.md

Вызов — /install-hook. Для всех проектов — ~/.claude/commands/

Вопросы об install-hook

Как установить команду install-hook в Claude Code?

Сохраните файл команды по пути .claude/commands/install-hook.md в каталоге вашего проекта.

Что делает команда install-hook?

Она валидирует файл hook.json, создаёт резервную копию настроек и добавляет секцию хука в ~/.claude/settings.json или локальный .claude/settings.json.

Что делать, если хук не сработал сразу после установки?

Для применения добавленных хуков обязательно перезапустите сессию Claude Code через claude --continue.

Исходный текст

install-hook.md · MIT
# /install-hook - Install Generated Hook to Settings

**Install a generated hook to Claude Code settings (user-level or project-level).**

---

## Usage

```
/install-hook generated-hooks/my-hook
/install-hook generated-hooks/my-hook user
/install-hook generated-hooks/my-hook project
```

---

## What This Command Does

Installs hook.json configuration to:
- **User-level** (`~/.claude/settings.json`) - Applies to all projects
- **Project-level** (`.claude/settings.json`) - Current project only

**Installation process**:
1. ✅ Validates hook.json structure
2. ✅ Checks for safety violations
3. ✅ Backs up existing settings.json
4. ✅ Merges with existing hooks (preserves other settings)
5. ✅ Saves and displays confirmation

---

## Examples

### Install User-Level Hook (All Projects)

```
/install-hook generated-hooks/auto-format-python user
```

**Performs**:
1. Reads `generated-hooks/auto-format-python/hook.json`
2. Validates JSON structure and safety
3. Creates backup: `~/.claude/settings.json.backup`
4. Opens `~/.claude/settings.json`
5. Adds hook to appropriate event type section
6. Saves changes

**Output**:
```
Installing hook: auto-format-python
Location: User-level (~/.claude/settings.json)

✅ Hook validation PASSED
   - JSON structure: Valid
   - Safety checks: All passed
   - Event type: PostToolUse

Creating backup...
✅ Backup created: ~/.claude/settings.json.backup

Installing to PostToolUse hooks...
✅ Hook installed successfully!

Event type: PostToolUse
Matcher: tool_names=["Write", "Edit"], paths=["**/*.py"]
Command: Auto-format Python with Black

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Next steps:
1. Restart Claude Code (required)
2. Test by editing a .py file
3. Verify hook runs automatically

To test:
claude --continue
> Edit any Python file
> Check if Black formatting runs
```

---

### Install Project-Level Hook (Current Project Only)

```
/install-hook generated-hooks/test-runner project
```

**Installs to**: `.claude/settings.json` (current project)

**Output**:
```
Installing hook: test-runner
Location: Project-level (.claude/settings.json)

✅ Hook validation PASSED
✅ Backup created: .claude/settings.json.backup
✅ Hook installed successfully!

Event type: SubagentStop
Matcher: (empty - runs for all agents)
Command: Run pytest after agent completes

This hook will only run in this project.

Next steps:
1. Restart Claude Code
2. Run any Task agent
3. Hook will automatically run tests when agent completes
```

---

### Auto-Detect Installation Level

```
/install-hook generated-hooks/git-auto-add
```

**Auto-detection logic**:
- If `.claude/settings.json` exists → Install to project
- Otherwise → Ask user: "Install to user or project level?"

---

## Safety Validation

**Before installation, the hook is validated for**:

1. **JSON Structure**:
   - ✅ Valid JSON syntax
   - ✅ Required fields present (matcher, hooks)
   - ✅ Correct data types

2. **Safety Patterns**:
   - ✅ Tool detection for external commands
   - ✅ Silent failure mode (`|| exit 0`)
   - ✅ No destructive operations (rm -rf, git push --force, etc.)
   - ✅ File path safety (no path traversal, proper quoting)

3. **Event Type Validation**:
   - ✅ Appropriate timeout for event type
   - ✅ Matcher matches event requirements
   - ✅ Command complexity appropriate

**If validation fails**:
```
❌ Hook validation FAILED

Issues found:
1. Missing tool detection for "black"
2. Path traversal detected (..)
3. No silent failure mode

Fix these issues before installation:
/validate-output hook generated-hooks/auto-format-python

Then regenerate the hook or fix manually.
```

---

## Settings Merge Behavior

**Existing hooks are preserved**:

**Before installation**:
```json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": {"tool_names": ["Write"]},
        "hooks": [{"type": "command", "command": "existing hook"}]
      }
    ]
  }
}
```

**After installing new hook**:
```json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": {"tool_names": ["Write"]},
        "hooks": [{"type": "command", "command": "existing hook"}]
      },
      {
        "matcher": {"tool_names": ["Write", "Edit"], "paths": ["**/*.py"]},
        "hooks": [{"type": "command", "command": "new hook"}]
      }
    ]
  }
}
```

**Key points**:
- ✅ Existing hooks preserved
- ✅ Other settings untouched
- ✅ Proper event type grouping
- ✅ Backup created before changes

---

## Backup and Recovery

**Automatic backups**:
- Created before every installation
- Named: `settings.json.backup`
- Location: Same directory as settings.json

**Restore from backup**:
```bash
# User-level
cp ~/.claude/settings.json.backup ~/.claude/settings.json

# Project-level
cp .claude/settings.json.backup .claude/settings.json
```

**After restore**: Restart Claude Code

---

## Uninstalling Hooks

**Manual uninstallation**:

1. Open settings file:
   ```bash
   # User-level
   vim ~/.claude/settings.json

   # Project-level
   vim .claude/settings.json
   ```

2. Find and remove the hook entry under its event type

3. Save and restart Claude Code

**Future**: Automated `/uninstall-hook` command planned

---

## Related Commands

**Before installing**:
- `/build hook` - Generate hook configuration
- `/validate-output hook` - Validate before installation

**After installing**:
- `/factory-status` - See all installed hooks
- `/test-factory` - Test hook functionality

**Managing hooks**:
- Run `/hooks` in Claude Code to view and manage all hooks
- Use Claude Code's settings menu to edit hook configuration

---

## Common Workflows

### Build → Validate → Install → Test

```bash
# 1. Build hook
/build hook

[Answer questions, hook generated]

# 2. Validate (CRITICAL for security)
/validate-output hook generated-hooks/my-hook

# 3. Install
/install-hook generated-hooks/my-hook user

# 4. Restart Claude Code
claude --continue

# 5. Test
[Trigger the hook event - e.g., edit a file for PostToolUse]
```

---

### Quick Install (If Already Validated)

```bash
# Already validated during generation
/install-hook generated-hooks/auto-format-python project
[Restart Claude Code]
```

---

## Tips

**Choosing user vs project level**:
- **User-level**: For hooks you want in ALL projects (formatters, notifications)
- **Project-level**: For project-specific hooks (tests, deployment, custom workflows)

**Testing hooks**:
- Start small: Install to project level first
- Test thoroughly before installing user-level
- Use `/hooks` command in Claude Code to view active hooks

**Managing multiple hooks**:
- Install one at a time
- Test each hook individually
- Check `/factory-status` to see all installed hooks

**Troubleshooting**:
- If hook doesn't run: Check event type matches your action
- If errors occur: Check hook validation with `/validate-output hook`
- If conflicts: Review settings.json manually
- Always check backup if something goes wrong

---

## Platform Notes

**macOS**:
- Hooks can use `osascript`, `afplay` for notifications/sounds
- Settings location: `~/.claude/settings.json`

**Linux**:
- Hooks can use `notify-send`, `paplay` for notifications/sounds
- Settings location: `~/.claude/settings.json`

**Windows**:
- Settings location: `%USERPROFILE%\.claude\settings.json`
- Use cross-platform tools (git, language-specific formatters)

---

**Safe hook installation with automatic validation!** 🔧✅

© alirezarezvani · MIT · alirezarezvani/claude-code-skill-factory

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

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
workflow-automation HubSpot Скилл workflow-automation учит агента управлять автоматизациями HubSpot через агентский CLI hubspot. Помогает создавать, читать, обновлять и удалять сценарии v4 flows API прямо из терминала. CX Codex +1 1 900установок install-loop Cobus Greyling Скилл install-loop для Claude Code устанавливает Loop Engineering в проект через единую CLI-команду. Он выбирает шаблон цикла по проблеме и оставляет запуск в режиме отчётов на первую неделю. CX Codex +1 ★ 11 819звёзд репо workflows-install zapier Скилл workflows-install готовит окружение для работы с Zapier Workflows Early Access. Ставит Zapier SDK CLI и шесть вспомогательных скиллов. CX Codex +1 475установок tooluniverse-install-skills mims-harvard Проверяет, установлены ли исследовательские скиллы ToolUniverse, и ставит их автоматически, если их нет. Запускается при миграции между клиентами или когда скиллы не загружаются. CX Codex +1 365установок rule2hook qdhenry Команда rule2hook переводит текстовые правила проекта из CLAUDE.md в исполняемые хуки для Claude Code и сохраняет их в hooks.json. CX Codex +1 ★ 1 357звёзд репо install-skill aeonfun Скилл install-skill устанавливает community skill pack из GitHub, проверяет его и оформляет изменения через PR с автообъединением. Подходит для добавления одного или нескольких скиллов. CX Codex +1 ★ 797звёзд репо

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

Весь набор →
install-skill Команда install-skill печатает пошаговую инструкцию, как поставить сгенерированный скилл или агент Claude на место, и предлагает выбрать способ установки. CX Codex +1 ★ 907звёзд репо factory-guide Субагент factory-guide маршрутизирует запросы на создание скиллов, промптов, агентов и хуков, передавая задачу специализированным субагентам. CX Codex ★ 907звёзд репо test-factory Команда test-factory помогает проверить созданные скиллы, субагентов и промпты: предлагает тестовые сценарии и подсказывает, что проверить в результате. CX Codex +1 ★ 907звёзд репо factory-status Команда factory-status собирает один отчёт по всему, что уже наделала фабрика скиллов: что прошло проверку, что установлено и какой шаг делать дальше. CX Codex +1 ★ 907звёзд репо sync-todos-to-github Команда sync-todos-to-github переносит список задач TodoWrite в план-задачу GitHub и запускает автоматическое создание связанных задач. Подходит для спринтов и контрольных точек. CX Codex +1 ★ 907звёзд репо validate-output Команда validate-output проверяет только что сгенерированный скилл, промпт, субагента или хук по чек-листу и говорит, что чинить. Скилл при успехе уезжает в ZIP. CX Codex +1 ★ 907звёзд репо agent-factory Скилл agent-factory генерирует готовые файлы субагентов для Claude Code с метаданными в YAML, правилами вызова инструментов и подключением MCP-серверов. CX Codex +1 ★ 907звёзд репо content-trend-researcher Скилл content-trend-researcher для Claude Code анализирует тренды и намерения аудитории на разных платформах и помогает составить план статьи. Проверяет тему и находит пробелы в контенте. CX Codex +1 ★ 907звёзд репо

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

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