Инструменты Claude Code

# Инструменты Claude Code

Превратите Claude Code в программируемый движок рабочих процессов с помощью хуков, автономных запусков и интеграций MCP.

## Что делает этот плагин

Этот плагин объединяет три компонуемые возможности:

- **Хуки** — Перехватывайте вызовы инструментов (PreToolUse / PostToolUse) для применения правил, проверки вывода или запуска побочных эффектов
- **Автономный режим** — Запускайте Claude Code в неинтерактивном режиме через `claude -p` для пакетной обработки, CI/CD и скриптов
- **MCP** — Создавайте серверы Model Context Protocol, которые предоставляют Claude доступ к внешним системам (базам данных, API, мессенджерам)

Эти три компонента работают вместе: хуки контролируют *что делает Claude*, автономный режим контролирует *когда и как он запускается*, а MCP контролирует *к чему он может получить доступ*.

## Полный пример: автоматизированный конвейер проверки кода

Команда хочет, чтобы каждый PR автоматически проверялся, результаты публиковались в Slack, а нарушения блокировались.

### Шаг 1: MCP-сервер — подключение к внешним системам

Создайте MCP-сервер, который предоставляет доступ к публикации в Slack и данным GitHub PR:

```typescript
// review-mcp/server.ts
const server = new McpServer({ name: "review-tools" });

server.tool("post_slack", { channel: z.string(), message: z.string() },
  async ({ channel, message }) => {
    await slack.chat.postMessage({ channel, text: message });
    return { content: [{ type: "text", text: "Posted" }] };
  }
);

server.tool("get_pr_diff", { pr: z.number() },
  async ({ pr }) => {
    const diff = await octokit.pulls.get({ owner, repo, pull_number: pr });
    return { content: [{ type: "text", text: diff.data.body }] };
  }
);
```

Зарегистрируйте его: `claude mcp add review-tools -- node review-mcp/server.ts`

### Шаг 2: Автономный режим — запуск проверок в CI

```yaml
# .github/workflows/review.yml
- name: AI Code Review
  run: |
    claude -p "Review PR #${{ github.event.pull_request.number }}.       Use get_pr_diff to fetch changes, analyze for bugs and style issues,       then post_slack the summary to #code-review."       --allowedTools "mcp__review-tools__post_slack,mcp__review-tools__get_pr_diff"       --output-format json > review-result.json
```

### Шаг 3: Хуки — применение ограничений

```json
// .claude/settings.json
{
  "hooks": {
    "PreToolUse": [{
      "matcher": "mcp__review-tools__post_slack",
      "hooks": [{
        "type": "command",
        "command": "python3 validate_slack.py "$TOOL_INPUT""
      }]
    }]
  }
}
```

Скрипт хука проверяет, что сообщения в Slack соответствуют правилам форматирования команды. Ненулевой код выхода блокирует вызов инструмента.

**Результат:** PR запускает Claude в автономном режиме → Claude получает diff через MCP → проверяет код → публикует в Slack (проверено хуком) — полностью автоматизировано, полностью отслеживаемо.

## Границы рисков

### Хуки

- Хуки **изменяют поведение Claude по умолчанию**. Неисправный хук PreToolUse может незаметно заблокировать легитимные вызовы инструментов. Всегда тестируйте хуки изолированно перед развертыванием.
- Скрипты хуков выполняются с вашими разрешениями оболочки. Никогда не передавайте ненадежный ввод напрямую в команды хуков без очистки.
- Хуки должны быть быстрыми (< 2 с). Медленные хуки ухудшают интерактивный опыт.

### Автономный режим

- `--dangerously-skip-permissions` удаляет все запросы безопасности. Используйте только в доверенных средах CI с ограниченными разрешениями.
- В автономных запусках нет человека в цикле. Явно ограничьте разрешенные инструменты с помощью `--allowedTools`, чтобы предотвратить нежелательные действия.
- Вывод может быть большим. Всегда устанавливайте `--output-format json` в конвейерах и анализируйте структурированные результаты.

### MCP-серверы

- MCP-серверы работают как отдельные процессы со своими собственными разрешениями. Плохо ограниченный сервер может раскрыть кон sensitive данные или разрешить деструктивные операции.
- Всегда проверяйте входные данные в обработчиках инструментов. Параметры, сгенерированные Claude, не гарантируются безопасными.
- Используйте изоляцию на транспортном уровне: запускайте MCP-серверы в контейнерах или ограниченных учетных записях пользователей для production-развертываний.
- Обрабатывайте ошибки изящно — сбой MCP-сервера посреди разговора оставляет Claude без доступа к этим инструментам до перезапуска.