Claude Code для системного аналитика: настройка окружения, CLAUDE.md, сабагенты и MCP
Когда открываешь новый проект, первые дни уходят на онбординг. Где требования? Кто стейкхолдеры? Какой стек, какие соглашения по код-ревью, где лежит документация? Даже опытный аналитик тратит на это неделю. А то и две.
Claude Code режет этот срок до пары часов — если окружение настроено правильно. Без настройки это просто удобный терминал с LLM. С настройкой — ассистент, который знает ваш проект, умеет ходить в Jira, читать Confluence и генерировать спецификации в вашем стиле.
Разница — в трёх вещах: CLAUDE.md, сабагентах и MCP-серверах. Разбираю по порядку.
CLAUDE.md — контекст проекта в одном файле
CLAUDE.md — это текстовый файл в корне проекта, который Claude Code читает при старте каждой сессии. По сути, инструкция для LLM: «вот что ты должен знать о проекте, прежде чем начать работать».
Для аналитика этот файл заменяет ворох вкладок в браузере с документацией, которую всё равно никто не читает.
Что стоит положить в CLAUDE.md:
Описание проекта. Пара абзацев: что за система, кто заказчик, какой домен. Не копируйте устав компании — напишите так, как объяснили бы новому коллеге за кофе.
Соглашения по артефактам. В каком формате пишутся User Story? Как оформляются Use Case — есть ли шаблон в Confluence? Какие поля обязательны в описании задачи Jira? Если команда использует специфичную структуру ТЗ — опишите её здесь. Один раз, чтобы не напоминать LLM в каждом промпте.
Стек и инструменты. Базы данных, брокеры сообщений, API-шлюзы, мониторинг. Не ради красоты — ради того, чтобы LLM не предлагала Kafka, когда у вас RabbitMQ.
Ссылки. Confluence-пространство проекта, доска в Jira, репозиторий схем БД, Swagger-интерфейс. Ссылки, которые вы открываете по 10 раз на дню, — пусть Claude Code открывает их сам.
Правила коммуникации. Язык (русский/английский), стиль ответов (коротко/развёрнуто), формат выдачи (markdown, JSON, таблица). Claude Code по умолчанию многословен. Если вам нужно «дай суть в трёх предложениях» — пропишите это здесь.
Минимальный CLAUDE.md для старта
# CLAUDE.md — Проект «Платёжный шлюз»
## О проектеРазрабатываем шлюз для приёма платежей через СБП и карты.Заказчик — банк «Ромашка». Домен — финтех, эквайринг.
## Артефакты- User Story: формат «Как `\<роль\>`, я хочу `\<действие\>`, чтобы `\<цель\>`»- ТЗ: шаблон в Confluence /display/PSP/TZ+Template- Jira: проект PSP, обязательны поля «Компонент» и «Приоритет»
## Стек- БД: PostgreSQL 15, Oracle (легаси)- Брокер: RabbitMQ- API Gateway: Kong- Мониторинг: Grafana + Prometheus
## Ссылки- Confluence: https://confluence.romashka.ru/display/PSP- Jira: https://jira.romashka.ru/projects/PSP- Swagger: https://api.romashka.ru/swagger- Схема БД: https://dbdocs.romashka.ru/psp
## Стиль- Отвечай на русском- Коротко, без воды- Все артефакты — MarkdownФайл необязательно писать за один присест. Начните с описания проекта и стека — это уже сэкономит время. Ссылки и правила добавляйте по мере того, как ловите себя на мысли «опять объясняю одно и то же».
Сабагенты — узкие специалисты для рутины
Сабагент — это Claude Code-сессия, запущенная с собственным промптом и ограниченным набором инструментов. Решает одну конкретную задачу и возвращает результат основной сессии.
Чем отличается от обычного промпта? Во-первых, сабагент работает в изолированном контексте — не видит всю историю диалога, только свой промпт. Во-вторых, сабагент может использовать инструменты: читать файлы, ходить в MCP-серверы, запускать скрипты.
Собирать сабагенты можно в .claude/agents/ — по одному файлу на агента. Формат:
---name: review-tzdescription: Проверяет ТЗ на противоречия и пропускиtools: Read, Glob, Grep---Прочитай ТЗ из указанного файла. Найди противоречия между разделами.Проверь, что для каждой функции описан сценарий отказа.Выдай список проблем в формате: [раздел] — [проблема].Какие сабагенты нужны аналитику:
Агент требований. Собирает User Story и Use Case из сырых заметок с интервью. На вход — транскрипт или конспект встречи, на выход — структурированный список требований с приоритетами. Экономит 2–3 часа после каждого созвона.
Агент ревью ТЗ. Прогоняет спецификацию по чек-листу: нет ли противоречий между разделами, все ли сценарии отказа описаны, соответствуют ли требования нефункциональным ограничениям. Как вторые глаза перед отправкой разработчикам.
Агент диаграмм. Принимает текстовое описание процесса и выдаёт BPMN, UML-диаграмму последовательности или C4-контейнерную диаграмму — смотря что попросите. Код на Mermaid или PlantUML. Черновик с 80% готовности, не с нуля.
Агент документации. Берёт описание API-эндпоинтов (например, из Swagger) и генерирует человекочитаемую документацию: что делает эндпоинт, какие параметры, примеры запросов и ответов. Может также собирать README для подсистем по шаблону.
Сабагенты не заменяют аналитика. Но убирают самую нудную часть — форматирование, проверку по шаблону, первичную вычитку. Выдаёте задание, получаете структурированный результат, а сами занимаетесь содержанием.
На схеме — архитектура настроенного окружения. В центре Claude Code, который опирается на три группы инструментов. База знаний (CLAUDE.md и Skills) даёт контекст — кто мы, что строим, по каким правилам. Сабагенты выполняют специализированные задачи параллельно основной сессии. MCP-серверы подключают Claude Code к живым системам — бери задачу из Jira, читай спецификацию в Confluence, смотри актуальную схему БД.
Ключевая идея: аналитик не пишет промпты с нуля под каждую задачу. Один раз описывает контекст в CLAUDE.md, один раз настраивает сабагентов и MCP — дальше просто выдаёт задания на естественном языке.
MCP-серверы — мост к живым системам
MCP (Model Context Protocol) — протокол, через который Claude Code подключается к внешним источникам данных. Если CLAUDE.md — память проекта, то MCP-серверы — глаза и руки.
Для аналитика MCP закрывает главную боль: ручной копипаст между системами. Открыл Jira, скопировал описание задачи. Открыл Confluence, скопировал раздел ТЗ. Открыл БД, скопировал структуру таблицы. Всё это — чтобы сформулировать один промпт.
С MCP схема проще:
Jira MCP. Claude Code сам читает описание задачи, комментарии, вложения. Вы говорите: «Возьми задачу PSP-1234 и напиши User Story по шаблону из CLAUDE.md» — и получаете готовый результат.
Confluence MCP. Claude Code читает страницы Confluence, ищет по пространству, сверяет требования с документацией заказчика. Пригождается, когда нужно проверить, не противоречит ли новая фича тому, что описано в соседнем разделе.
PostgreSQL MCP. Прямой доступ к схеме БД. Вместо «опиши структуру таблицы платежей» — Claude Code читает DDL сам и предлагает изменения, не ломающие существующие индексы и внешние ключи.
Git MCP. Доступ к истории коммитов и diff’ам. Аналитик редко лезет в код. Но иногда нужно понять, когда и почему поменялась логика конкретного эндпоинта. Git MCP позволяет задать вопрос: «Покажи изменения в API за последние две недели».
Подробнее про устройство протокола — в обзоре MCP. А если интересует практическая сторона подключения к Jira и Confluence — разбирал это в отдельном посте.
Важный нюанс: MCP-серверы требуют настройки. Для каждого источника — свой сервер, часто с токеном доступа или учётной записью. Но конфигурация делается один раз в claude_desktop_config.json (или .mcp.json для проекта). Дальше работает без участия человека.
Рабочий день с настроенным окружением
Утро. Открываете терминал, запускаете Claude Code. Он читает CLAUDE.md и уже знает: проект — платёжный шлюз, стек — PostgreSQL + RabbitMQ, User Story пишем по шаблону. Вы говорите: «Покажи новые задачи в Jira за сегодня».
Claude Code через Jira MCP вытаскивает список. Одна из задач: «Добавить возврат платежа через СБП». Просите: «Собери контекст по задаче PSP-1291».
Ассистент читает описание задачи в Jira, находит связанную страницу в Confluence с требованиями от заказчика, смотрит схему таблицы payments в базе, проверяет, есть ли уже эндпоинт для возвратов в API. Через минуту — сводка: что есть, чего не хватает, где возможные конфликты.
Дальше: «Напиши User Story и Use Case для возврата через СБП по шаблону из CLAUDE.md». Claude Code вызывает сабагента требований, тот генерирует артефакты. Вы читаете, правите пару формулировок.
Перед отправкой разработчикам: «Проверь ТЗ на противоречия». Сабагент ревью прогоняет документ по чек-листу — три замечания. Два из них реальные проблемы, которые вы бы пропустили. Одно ложное срабатывание, но проверить стоило.
Весь цикл — 40 минут. Без настроенного окружения — полдня, с учётом переключения между Jira, Confluence, БД и редактором.
С чего начать уже сегодня
Настройка окружения Claude Code не делается за вечер. Но начать можно с трёх шагов, которые дадут 80% эффекта:
-
Напишите CLAUDE.md. Даже 10 строк с описанием проекта и стека сэкономят часы на уточняющих вопросах. Положите файл в корень репозитория — Claude Code подхватит его автоматически.
-
Создайте одного сабагента. Самый простой кандидат — агент ревью ТЗ. Опишите чек-лист, по которому проверяете требования, укажите инструменты
Read, Glob. Прогоните через него ближайшую спецификацию. -
Подключите один MCP-сервер. 80% задач приходит из Jira — начните с Jira MCP. Постоянно лезете в Confluence за документацией — с Confluence MCP. Один сервер, одна интеграция — но разница между «скопировал-вставил» и «Claude Code сам всё прочитал» чувствуется сразу.
Дальше — итеративно. Поработали неделю, поняли, что тонете в диаграммах — добавили агента диаграмм. Не хватает доступа к БД — подключили PostgreSQL MCP.
Не пытайтесь настроить всё сразу. Один работающий сабагент полезнее, чем четыре полуготовых. Это не соревнование по количеству интеграций.
И да: если ещё не разобрались с тем, какие вообще скиллы есть у Claude Code, — начните с обзора и топ-10 навыков. Без понимания базовых возможностей CLAUDE.md будет просто текстовым файлом с непонятным назначением.