Продвинутые техники Claude Code:
hooks, headless, голос, Obsidian

1. Hooks — автоматические реакции на события

Hooks — это shell-скрипты, которые Claude Code запускает автоматически при определённых событиях жизненного цикла агента. Они дают полный контроль над тем, что происходит до и после каждого действия.

«Вместо того чтобы писать ограничение в CLAUDE.md (например "никогда не запускай db push"), лучше сделать hook — он будет срабатывать каждый раз. CLAUDE.md игнорируется 1 раз из 30-50, хук — никогда.»

— Ray Amjad, «The Highest Point of Leverage in Claude Code»

Типы hooks

Практический пример: уведомление в Telegram

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "curl -s -X POST https://api.telegram.org/bot$TG_TOKEN/sendMessage -d 'chat_id=$TG_CHAT&text=Claude+завершил+задачу+✅'"
          }
        ]
      }
    ],
    "PostToolCall": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo \"$(date): bash tool called\" >> ~/.claude/audit.log"
          }
        ]
      }
    ]
  }
}

Типичные применения hooks

2. Headless mode — автономная пакетная обработка

Headless mode запускает Claude Code без интерактивного UI. Агент получает задачу, выполняет её автономно и возвращает результат. Это основа для автоматизации, CI/CD и batch-обработки.

«Headless mode — это когда Claude Code работает как фоновый рабочий. Ты пишешь скрипт, который передаёт задачи, и агент молча всё делает. Идеально для обработки большого количества файлов или ночных задач.»

— Ray Amjad

Базовые команды

# Headless: выполнить одну задачу и выйти
claude --print "Что такое технический долг?" --output-format text

# Передать задачу через stdin
echo "Напиши тест для функции sort()" | claude --print

# JSON-вывод для парсинга
claude --print "Проанализируй этот код" --output-format json

# Пропустить разрешения (опасно — только для автоматизации)
claude --dangerously-skip-permissions --print "задача"

Batch-обработка файлов

Паттерн, который Ray Amjad использует для обработки больших коллекций:

#!/bin/bash
# Обработать все Python-файлы: добавить docstrings
for file in src/**/*.py; do
    echo "Обрабатываю: $file"
    claude --print \
      --dangerously-skip-permissions \
      "Добавь docstrings ко всем функциям в файле $file" \
      > /dev/null
    echo "✓ $file готов"
done

SDK — для программного управления

Для сложных сценариев — Claude Code SDK (TypeScript/Python). Запускаешь агента из кода, получаешь стриминг сообщений:

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

// Запустить агента программно
const result = await client.messages.create({
  model: "claude-opus-4-5",
  max_tokens: 4096,
  messages: [{ role: "user", content: "Напиши unit-тесты для этого файла" }],
  tools: [/* инструменты */],
});

3. Голосовой ввод — думай вслух, не печатай

Один из самых недооценённых инструментов рабочего процесса Ray Amjad. Голосовой ввод убирает самый медленный элемент — печать — и позволяет диктовать длинные детальные промпты за секунды.

«Я почти не набираю промпты вручную. Диктую всё через HyperWhisper с настройкой accuracy: highest. Параллельно переключаюсь между сессиями, диктуя в каждую. В разы продуктивнее чем печатать.»

— Ray Amjad, «How I Use Claude Code (After 1,600 Hours)»

Инструменты

Как диктовать эффективно

4. Obsidian как база знаний агента

Ray Amjad использует Obsidian как «второй мозг» для своих AI-проектов. Claude Code читает файлы из Obsidian через файловую систему — это бесплатный, всегда доступный персональный RAG.

Паттерн: Knowledge → Claude

Obsidian MCP плагин

Существует MCP-сервер для Obsidian — даёт Claude Code полный доступ к vault: создание, редактирование, поиск по заметкам. Настраивается через CLAUDE.md или settings.json.

# Через Claude Code MCP manager
claude mcp add obsidian -- npx -y @anthropic/mcp-obsidian

# Или в .claude/settings.json
{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-obsidian"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/Users/you/Obsidian/vault"
      }
    }
  }
}

5. Управление сессиями и контекстом

Контекстное окно — ресурс, который нужно беречь. Ray Amjad называет симптом неправильного управления контекстом «context anxiety» — когда агент начинает сомневаться в своих решениях из-за переполненного окна.

«Context anxiety — когда агент начинает менять уже принятые решения, потому что контекст переполнен. Это сигнал: пора компактировать или начать новую сессию.»

— Ray Amjad

Компактизация контекста

Контекстная гигиена

6. Custom Slash Commands и Skills

Slash commands — это шаблоны промптов, сохранённые как файлы. Они превращают повторяющиеся задачи в одну команду. Ray Amjad называет их «мышечной памятью агента».

Создание кастомной команды

---
description: Провести code review текущих изменений
---

Проведи code review для следующих файлов: $ARGUMENTS

Проверь:
1. Безопасность — SQL injection, XSS, CSRF, открытые секреты
2. Производительность — N+1 запросы, лишние вычисления
3. Читаемость — названия переменных, сложность функций
4. Тесты — покрыты ли крайние случаи

Для каждой проблемы укажи:
- Файл и строку
- Тип проблемы (критично / важно / совет)
- Как исправить

Использование:

/review src/auth.py src/api.py

Проектные vs. Личные команды

Полезные встроенные команды