Claude Code: настройка MCP, Hooks и Skills в 2026 — мой рабочий сетап

Claude Code — это AI-агент от Anthropic, который живёт в терминале. Читает файлы, выполняет команды, ходит в интернет, дёргает API. Ты описываешь что нужно, он разбирается как. Я пользуюсь каждый день уже 4 месяца, и это мой реальный сетап — не пересказ документации, а то, как я реально работаю.

Что такое Claude Code (и чем он не является)

Claude Code — это не чат-бот. Не автодополнение. По сути это while True цикл в терминале — получил задачу, выбрал инструмент, выполнил, посмотрел что получилось, решил что делать дальше. И так пока не сделает или не застрянет и не спросит.

Инструменты настоящие: доступ к файлам, bash, веб-поиск, MCP-серверы. Никакой IDE между тобой и агентом. Заходишь в директорию проекта, пишешь claude — всё, ты общаешься с штукой, которая видит весь кодбейс и реально может что-то с ним делать.

Цены: $20/мес — Pro план с лимитами. $100/мес (Max) — без лимитов, я на нём. Бесплатного Claude Code нет. Нужна подписка Claude, потом ставишь через npm install -g @anthropic-ai/claude-code.

Как я использую Claude Code каждый день

Мой рабочий день не похож на обычную разработку. Я записываю голосовое в Телеграм с описанием того, что нужно. Мой серверный агент (Claude Code на VPS Hetzner, работает 24/7) подхватывает расшифровку и начинает делать.

Для аналитики — описываю вопрос, и агент просто идёт делать. Пишет SQL для Dune, тянет данные, рисует графики, собирает отчёт. Раньше на это уходило 3-4 часа ручного SQL и ковыряния с форматированием. Теперь 20 минут речи и ревью.

С кодом то же самое. Описываю что нужно, он читает файлы, пишет реализацию, гоняет тесты, коммитит. Смотрю дифф — обычно принимаю. Иногда прошу переделать, обычным текстом.

Раньше у меня было 15 вкладок в браузере: доки, Stack Overflow, GitHub issues, API reference. Теперь одно окно терминала. Агент читает доки за меня.

Мой CLAUDE.md — файл, который всё запускает

В каждом проекте Claude Code есть файл CLAUDE.md в корне. Когда агент стартует, он читает его первым. Это не промпт — это операционная система для агента.

Вот кусок моего (всего 106 строк):

# Personal Obsidian Vault

## Architecture
- **Keep files short** (<150 lines). Use [[links]] for navigation.
- **AI never edits raw content.** Voice notes stay pristine.

## Голосовые сообщения
При получении голосовухи:
- Если про конкретный проект → в проект: projects/X/ai-docs/
- Если личное → в personal/diary/

Далее:
1. Добавь теги и ссылки на проекты
2. Извлеки TODO → в tasks.md
3. Факты → в overview.md

Этот файл маршрутизирует всё. Голосовые, задачи, креды, структура проектов — агент по этим правилам разбирается куда что. Обновляю где-то раз в неделю, когда что-то в воркфлоу меняется.

Ключевой инсайт: CLAUDE.md не про то, кем агент является. Он про то, как устроен твой мир. Структура проектов, конвенции, где что лежит, что трогать нельзя. Подробнее я писал в Второй мозг с Obsidian и Claude Code.

MCP-серверы, которые я использую каждый день

MCP (Model Context Protocol) — это способ дать Claude Code доступ к внешним сервисам. Прописываешь серверы в .mcp.json, и у агента появляются новые возможности помимо стандартных файлов и баша.

Мой реальный .mcp.json:

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "@masonator/coolify-mcp"],
      "env": {
        "COOLIFY_ACCESS_TOKEN": "${COOLIFY_ACCESS_TOKEN}",
        "COOLIFY_BASE_URL": "${COOLIFY_BASE_URL}"
      }
    },
    "telegram": {
      "command": "python",
      "args": ["telegram_mcp_proxy.py"],
      "env": {}
    }
  }
}

Как подключить MCP к Claude Code

1. Выбери MCP-сервер под конкретную задачу: деплой, базу данных, Telegram, браузер или внутренний API.
2. Добавь его в .mcp.json проекта или в глобальный конфиг Claude Code. Секреты держи в env-переменных, а не в репозитории.
3. Перезапусти claude и попроси агента проверить доступ к инструментам маленькой безопасной командой.
4. Опиши в CLAUDE.md, когда пользоваться этим MCP и какие действия запрещены без подтверждения.
5. Для продакшена добавь hooks: блокировку секретов, запрет опасных команд и обязательный прогон тестов перед коммитом.

Если нужен пример отдельного сервера, я подробно разбирал Telegram MCP Server. А подборку связки инструментов собрал в посте про лучшие skills и MCP для Claude Code.

Coolify MCP — мой деплой-сервер. Агент деплоит приложения, рестартует сервисы, смотрит логи, управляет базами. Когда обновляю конфиг агента, он передеплоивает сам себя. AI-агент, который деплоит себя в прод.

Telegram MCP — полный доступ к Телеграму. Чтение сообщений, отправка, управление каналами. Серверный агент через него отвечает на вопросы в обсуждении моего канала, пока я сплю.

Ещё использую Codex MCP для dual-review. Claude пишет план, отправляет в Codex от OpenAI на независимую проверку, потом учитывает фидбек. Два AI-агента проверяют друг друга. Писал об этом в Claude Code + Codex — Dual Review.

Skills — маркдаун, который даёт агенту суперспособности

Скилл — это .md файл в ~/.claude/skills/. Никаких SDK, API, билдов. Пишешь инструкции в маркдауне, Claude Code подхватывает их когда тема релевантна.

Важный момент: skills экономят контекст. Если каждый раз вставлять в чат длинные правила, примеры и чеклисты, свободного окна остаётся меньше. А когда свободного контекста мало, модель хуже держит задачу целиком: чаще забывает ограничения, хуже планирует и начинает делать локально правильные, но системно странные правки. Поэтому повторяемые инструкции я выношу в skills.

Скиллы, которые я реально считаю важными:

• office-hours из GStack, /goal и office hours — помогает вести рабочие сессии: сформулировать цель, разложить её на шаги, удерживать фокус и закрыть петлю в конце.
• improve-codebase-architecture — ревьюит архитектуру кодбейса, ищет связность, дубли, слишком большие файлы и места, где агенту потом будет тяжело работать.
• skillify — превращает повторяемый воркфлоу в новый skill: берёт удачный диалог или инструкцию, выжимает алгоритм, чеклист, типичные ошибки и сохраняет это как компактную процедуру.
• ton-analyst — пишет Dune SQL запросы для анализа TON блокчейна. Знает схему, подводные камни вроде фильтра direction = 'in', умеет поллить Dune API.

Файл скилла обычно занимает 100–300 строк маркдауна: цель, когда применять, шаблоны, API-эндпоинты, частые ошибки, примеры хорошего результата. Кода там может вообще не быть — Claude Code интерпретирует инструкцию и сам решает, какими инструментами выполнить задачу.

Я наделал кучу ошибок, когда их создавал. Если начинаете — прочитайте 7 ошибок при написании скиллов Claude Code и подборку про лучшие skills и MCP.

Hooks — код, который запускается на каждое действие

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

Пример из моего сетапа — pre-commit хук, запрещающий коммит чувствительных файлов:

# .claude/hooks/pre-commit.sh
# Block commits that include credential files
if git diff --cached --name-only | grep -qE '\.(env|key|pem)$|creds\.md'; then
  echo "BLOCKED: Attempting to commit sensitive files"
  exit 1
fi

Именно хуки позволяют запускать Claude Code без присмотра. Мой серверный агент крутится 24/7, и я не парюсь что он сольёт креды или пушнет не в ту ветку — хуки просто не дадут.

Субагенты и команды

Claude Code умеет запускать суб-агентов — по сути лид, который делегирует. Главный агент дробит задачу, раскидывает по воркерам, они работают параллельно каждый в своём контексте.

Я использую это для блокчейн-ресёрча. Лид получает вопрос типа «проанализируй активность кошелька за 30 дней». Запускает:

• Дата-агента — пишет и выполняет SQL на Dune
• Профайлинг-агента — проверяет по нашей базе кошельков
• Репорт-агента — берёт оба аутпута и собирает финальный анализ

Три агента параллельно, каждый со своим контекстом. Лид координирует. То, на что уходило полдня, делается за 15 минут. Но контекст не бесконечный: когда окно забивается логами и промежуточными выводами, качество падает. Про /compact и контекст Claude Code я отдельно разбирал, потому что это влияет на результат сильнее, чем кажется.

Команды (Teams) идут дальше — несколько именованных агентов с общим списком задач, работающих над одним проектом. Использовал для больших ресёрч-отчётов: один агент собирает данные, другой пишет секции, третий делает ревью.

Claude Code vs Cursor — когда что использовать

Cursor у меня до сих пор стоит. Вот когда что:

Cursor побеждает:

• Быстрые инлайн-правки — видишь код, выделяешь блок, просишь изменить. Визуально и быстро.
• Изучение незнакомого кодбейса — UI Cursor позволяет кликать по файлам, пока AI объясняет.
• Когда точно знаешь что и где менять — ткнуть пальцем быстрее, чем описывать.

Claude Code побеждает:

• Мульти-тул операции — когда задача включает чтение файлов + bash + API + редактирование кода. Cursor так не может.
• Автономные воркфлоу — фоновые агенты, серверные деплои, крон-задачи. Cursor требует твоё присутствие.
• Масштабные изменения — рефакторинг 20 файлов, тесты после каждого изменения. Терминал быстрее GUI.
• Интеграция с внешними системами — MCP позволяет агенту работать с Телеграмом, деплоить в прод, дёргать базы.

Моё соотношение: 90% Claude Code, 10% Cursor. Но я в основном занимаюсь аналитикой и оркестрацией агентов, а не UI. Если бы пилил React-компоненты весь день, Cursor, возможно, победил бы.

Стоимость — стоит ли $100 в месяц?

Claude Pro ($20/мес) даёт ограниченный доступ к Claude Code. Хорошо для попробовать, изучить воркфлоу, запускать простые задачи. В тяжёлые дни упрёшься в лимиты.

Claude Max ($100/мес) снимает лимиты. Я перешёл через 2 недели на Pro, потому что упирался в потолок ежедневно. На $100 я вообще не думаю про использование — просто работаю.

Окупается ли? Мой час работы стоит сильно больше $50. Если инструмент экономит хотя бы 2 часа в месяц — уже окупился. А реально он экономит ближе к 2 часам в день. Одни SQL-запросы раньше жрали часы. Форматирование, графики, отчёты — теперь агент делает всё это сам.

Реальные цифры за февраль 2026: запустил агента на блокчейн-ресёрч, получил 30-страничный отчёт с 15 графиками и 40+ SQL запросами. Вручную — это полная рабочая неделя. Агент сделал за вечер, пока я ревьюил выход.

Паттерн «Второй мозг»

Всё выше связывается одной идеей: агент живёт внутри моего Obsidian vault. Заметки, файлы проектов, задачи, расшифровки голосовых — всё в одной директории. Claude Code читает и знает, над чем я работаю, что в бэклоге, как устроены проекты.

Называю это «второй мозг», потому что это буквально так. Сбрасываю мысли в голосовые, агент их организует. Идея в 2 ночи — агент подхватит утром. Контекст проекта никогда не теряется — он в маркдаун-файлах, которые читаем и я, и агент.

Более глубокая версия — упаковка всей профессиональной идентичности в формат, с которым может работать AI — это то, о чём я писал в dania.zip: Packaging Yourself for AI Agents.

Что реально изменилось

Через 4 месяца главное изменение — не продуктивность. Я перестал переключать контексты. Раньше жонглировал SQL-редактором, терминалом, браузером, Slack, Notion и кодовым редактором. Теперь сижу в одном терминале и описываю что нужно. Агент делает остальное.

Я не стал меньше писать код — я вообще перестал его писать для большинства задач. Агент пишет, я ревьюю. Роль теперь не про набор кода, а про понимание что нужно построить и проверку что это сделано правильно.

Если хотите полный разбор воркфлоу — мой пост про воркфлоу. Про интеграцию с Obsidian — пост про второй мозг. Про скиллы — начните отсюда.

FAQ

Нужен ли MCP для Claude Code?

Не обязателен. Для работы с файлами, bash и кодом Claude Code полезен и без MCP. MCP нужен, когда агент должен ходить во внешние системы: Telegram, деплой, базы данных, CRM, браузер или внутренние API.

Чем skills отличаются от CLAUDE.md?

CLAUDE.md описывает проект и правила работы в нём. Skill описывает повторяемую процедуру: как делать ресёрч, архитектурное ревью, office hours или генерацию нового workflow. Я держу в CLAUDE.md только базовую карту мира, а длинные инструкции выношу в skills.

Почему важно экономить контекст?

Чем меньше свободного контекста остаётся модели, тем хуже она держит глобальную задачу. Начинаются забытые ограничения, лишние файлы в диффе, слабое планирование. Skills, короткий CLAUDE.md, субагенты и периодический /compact помогают не забивать окно мусором.

Что подключить первым?

Я бы начал с трёх вещей: аккуратный CLAUDE.md, один MCP под реальную боль и один skill под повторяемый воркфлоу. Например, office hours из GStack для фокуса или improve-codebase-architecture для ревью кодовой базы.

Даниил Охлопков — Head of Analytics в TON Foundation. Строю AI-агентные воркфлоу, инструменты блокчейн-аналитики, и пишу об этом.

Telegram · Twitter/X · YouTube · Instagram