Logo
Overview

Claude Code для системного аналитика: настройка окружения, CLAUDE.md, сабагенты и MCP

November 16, 2026
7 min read

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-tz
description: Проверяет ТЗ на противоречия и пропуски
tools: Read, Glob, Grep
---
Прочитай ТЗ из указанного файла. Найди противоречия между разделами.
Проверь, что для каждой функции описан сценарий отказа.
Выдай список проблем в формате: [раздел] — [проблема].

Какие сабагенты нужны аналитику:

Агент требований. Собирает User Story и Use Case из сырых заметок с интервью. На вход — транскрипт или конспект встречи, на выход — структурированный список требований с приоритетами. Экономит 2–3 часа после каждого созвона.

Агент ревью ТЗ. Прогоняет спецификацию по чек-листу: нет ли противоречий между разделами, все ли сценарии отказа описаны, соответствуют ли требования нефункциональным ограничениям. Как вторые глаза перед отправкой разработчикам.

Агент диаграмм. Принимает текстовое описание процесса и выдаёт BPMN, UML-диаграмму последовательности или C4-контейнерную диаграмму — смотря что попросите. Код на Mermaid или PlantUML. Черновик с 80% готовности, не с нуля.

Агент документации. Берёт описание API-эндпоинтов (например, из Swagger) и генерирует человекочитаемую документацию: что делает эндпоинт, какие параметры, примеры запросов и ответов. Может также собирать README для подсистем по шаблону.

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

100%
graph TD
  CC["Claude Code в терминале"]

  subgraph Knowledge["База знаний"]
      CMD["CLAUDE.md
инструкции и контекст"]
      Skills["Claude Skills
готовые сценарии"]
  end

  subgraph Agents["Сабагенты"]
      A1["Агент требований"]
      A2["Агент ревью ТЗ"]
      A3["Агент диаграмм"]
      A4["Агент документации"]
  end

  subgraph External["Внешние системы MCP"]
      Jira["Jira API"]
      Conf["Confluence API"]
      DB["PostgreSQL"]
      Git["Git репозиторий"]
  end

  CC --> Knowledge
  CC --> Agents
  CC --> External

  style CC fill:#4a90d9,stroke:#2c5f8a,color:#fff
  style CMD fill:#7b68ee,stroke:#5a4db2,color:#fff
  style Skills fill:#7b68ee,stroke:#5a4db2,color:#fff
  style A1 fill:#50c878,stroke:#3a9a5c,color:#fff
  style A2 fill:#50c878,stroke:#3a9a5c,color:#fff
  style A3 fill:#50c878,stroke:#3a9a5c,color:#fff
  style A4 fill:#50c878,stroke:#3a9a5c,color:#fff
  style Jira fill:#f0a500,stroke:#c88400,color:#fff
  style Conf fill:#f0a500,stroke:#c88400,color:#fff
  style DB fill:#f0a500,stroke:#c88400,color:#fff
  style Git fill:#f0a500,stroke:#c88400,color:#fff

На схеме — архитектура настроенного окружения. В центре 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% эффекта:

  1. Напишите CLAUDE.md. Даже 10 строк с описанием проекта и стека сэкономят часы на уточняющих вопросах. Положите файл в корень репозитория — Claude Code подхватит его автоматически.

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

  3. Подключите один MCP-сервер. 80% задач приходит из Jira — начните с Jira MCP. Постоянно лезете в Confluence за документацией — с Confluence MCP. Один сервер, одна интеграция — но разница между «скопировал-вставил» и «Claude Code сам всё прочитал» чувствуется сразу.

Дальше — итеративно. Поработали неделю, поняли, что тонете в диаграммах — добавили агента диаграмм. Не хватает доступа к БД — подключили PostgreSQL MCP.

Не пытайтесь настроить всё сразу. Один работающий сабагент полезнее, чем четыре полуготовых. Это не соревнование по количеству интеграций.

И да: если ещё не разобрались с тем, какие вообще скиллы есть у Claude Code, — начните с обзора и топ-10 навыков. Без понимания базовых возможностей CLAUDE.md будет просто текстовым файлом с непонятным назначением.