Занятие 2 - MCP, SKILLS

Лекция 2. Продвинутые возможности Claude Code

---

Часть 0. Разбор теории (чек-ин знаний)

Перед новым материалом — сжатый разбор десяти контрольных вопросов прошлой темы. Держите как шпаргалку.

#	Вопрос	Короткий ответ
1	Для чего подходит Pro-подписка Claude?	Умственная работа и небольшой кодинг. Не для полноценной разработки.
2	Как расходовать Pro при жёстких лимитах?	Приоритизировать домашние работы — на всё лимитов не хватит.
3	Какие лимиты учитывать?	5-часовой лимит сессии и недельный лимит.
4	Минимальный тариф для комфортного кодинга?	Хотя бы Max 5 Plan — заметно больше рабочих лимитов.
5	Чем отличается Max 20?	Профессиональная интенсивная работа.
6	Что такое обвязка (harness) по отношению к модели?	Система, которая позволяет модели совершать действия.
7	Чем отличаются обвязки Claude друг от друга?	Тремя вещами: уровень риска, доступ к файлам, набор действий.
8	Рекомендуемая основная модель на подписке?	Opus — всегда.
9	Что такое проекты в Claude Chat?	Способ группировать чаты с общими файлами и инструкциями.
10	Почему Claude Cowork безопасен с файлами?	Работает внутри виртуальной машины (VM).

---

Часть 1. Сдвиг парадигмы: от «сделать проект» к «дирижировать агентами»

Живой пример из лекции (форма для анонса стрима):

1. Спикер выходит гулять в парк, включает на телефоне расшифровку голоса и надиктовывает: «вот такие темы хочу покрыть, по каждой проведи исследование, всё факт-чекни».
2. Агент берёт темы, до-исследует (через сервис ресёрча), находит забытые релизы, собирает структурированный список.
3. Спикер на ходу диктует правки по стилю.
4. Чтобы заполнить веб-форму (нужен компьютер), он использует режим dispatch (диспетчеризация) — с телефона запускает удалённую задачу на своём компьютере: «открой браузер, вбей ссылку, заполни форму, отправь».

flowchart LR
    A["Человек гуляет в парке"] -->|"голосовая диктовка"| B["Агент №1: ресёрч + факт-чек"]
    A -->|"правки по стилю"| C["Агент №2: редактура"]
    A -->|"режим dispatch"| D["Удалённая задача на ПК: браузер заполняет форму"]
    B --> E["Результат собирается без участия рук"]
    C --> E
    D --> E
    E -->|"человек только проверяет узлы"| A

---

Часть 2. Тарифы и лимиты: что реально изменилось

Случай Екатерины (наблюдение из чата): до 8 мая можно было выработать весь 5-часовой лимит, а недельный сдвигался на ~8–9%. С 8 мая 5-часовой за сессию «съедается» на 30%, а недельный — всё на те же 7–8%.

---

Часть 3. Claude Design — отдельный сервис

---

Часть 4. Programmatic Use vs Interactive Use — раскол тарификации

Это важнейшее нововведение, особенно для тех, кто будет встраивать Claude Code в свои продукты.

flowchart TD
    SUB["Ваша подписка"] --> SPLIT{"Тип использования"}
    SPLIT -->|"Interactive — вы за рулём"| INT["Лимиты как раньше<br/>НИЧЕГО не меняется"]
    SPLIT -->|"Programmatic — автоматизации, сторонние инструменты"| PRG["Отдельные доп. КРЕДИТЫ<br/>≈ сумме вашей подписки/мес"]
    PRG --> EX["Пример: \$20 план → +\$20 кредитов сверху<br/>\$200 план → +\$200 кредитов"]

---

Часть 5. Мелочи на полях

---

Часть 6. ⭐ CLAUDE.md vs settings.json — ключевая концепция

Если из всего занятия вы запомните одну вещь — пусть это будет вот эта разница.

flowchart TB
    subgraph CM["CLAUDE.md — слой ЗНАНИЙ"]
        direction TB
        CM1["Формат: Markdown"]
        CM2["Адресат: LLM (мозг)"]
        CM3["Сила: рекомендация<br/>может не сработать"]
        CM4["Содержит: контекст, стандарты,<br/>команды, нейминг, архитектуру"]
    end
    subgraph SJ["settings.json — слой ОБВЯЗКИ"]
        direction TB
        SJ1["Формат: JSON"]
        SJ2["Адресат: программа Claude Code"]
        SJ3["Сила: жёсткий закон<br/>исполняется на 100%"]
        SJ4["Содержит: deny/allow, hooks,<br/>ENV, sandbox, MCP, модели"]
    end
    CM -. "две НЕ пересекающиеся вещи" .- SJ

Примеры жёстких правил в settings.json:

{
  "permissions": {
    "deny": [
      "Read(./.env)",          // физически не сможет прочитать .env
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(**/credentials)"   // не доберётся до API-ключей
    ],
    "ask": [
      "Bash(git push:*)",      // перед git push ОБЯЗАН спросить
      "Bash(git commit:*)"     // не закоммитит молча
    ]
  }
}

---

Часть 7. Области (scopes) настроек settings.json и их приоритет

Три области, о которых говорит спикер (от высшего приоритета к низшему):

flowchart TB
    L["settings.local.json<br/>ЛОКАЛЬНЫЕ, только ваши"] -->|"бьёт ↓"| P["./.claude/settings.json<br/>ПРОЕКТНЫЕ / командные"]
    P -->|"бьёт ↓"| G["~/.claude/settings.json<br/>ГЛОБАЛЬНЫЕ (на все проекты)"]
    style L fill:#1f6feb,color:#fff
    style P fill:#388bfd,color:#fff
    style G fill:#58a6ff,color:#000

• settings.local.json — git-игнорируется, никогда не попадает в историю версий и на GitHub. Сюда — личные настройки, которые не должны разъехаться по компьютерам команды.
• ./.claude/settings.json (без .local) — попадает в Git репозитория и распространяется на всю команду. Здесь — общекомандные настройки проекта.
• ~/.claude/settings.json (системная папка) — глобальные, применяются ко всем проектам автоматически.

---

Часть 8. Иерархия загрузки CLAUDE.md

flowchart TD
    START(["Запуск Claude Code"]) --> GLOB["Глобальный CLAUDE.md<br/>~/.claude/CLAUDE.md<br/>грузится СРАЗУ, всегда"]
    GLOB --> OPEN{"Открыли проект?"}
    OPEN -->|"да"| PROJ["CLAUDE.md проекта<br/>добавляется к глобальному<br/>(оба активны, СМЕШИВАЮТСЯ)"]
    OPEN -->|"нет"| ONLY["Активен только глобальный"]
    PROJ --> SUB{"Зашли в подпапку<br/>с её CLAUDE.md?"}
    SUB -->|"да, начал там работать"| SUBLOAD["CLAUDE.md подпапки<br/>догружается ПО НЕОБХОДИМОСТИ"]
    SUB -->|"нет"| WAIT["Подпапочный пока не грузится"]

Дополнительно существуют: CLAUDE.local.md (личный, не для команды) и каталоги rules/ с файлами вроде API.md для описания конфигураций — но это уже для очень крупной разработки.

---

Часть 9. Auto-memory и Auto-dream — новая (экспериментальная) концепция

---

---

Часть 10. Как писать CLAUDE.md правильно

Что в нём должно быть:

• Короткое чёткое описание проекта — и не столько что это, сколько почему именно так и для чего.
• Технологический стек — желательно, но не обязательно.
• Правила кодирования, конкретные команды проекта, стиль коммитов.
• Архитектура и структура папок — с точки зрения «что интересного агент тут найдёт».

Чего в нём быть НЕ должно:

• Никаких API-ключей и секретов.
• Не дублировать то, что лучше вынести в Skills: если процесс повторяется (например, ваш способ тестировать баги), не описывайте его в CLAUDE.md — создайте Skill и в CLAUDE.md напишите лишь: «для тестирования багов используй bug-test-skill».

Лайфхак №1 — ссылки вместо «простыней». В 100 строк всё не уместить, и не нужно. Вместо лишнего текста давайте ссылки на другие файлы:

- Меняешь backend → читай docs/backend.md
- Работаешь с дизайном → читай docs/design.md
- Трогаешь БД → читай docs/database-schema.md

Агент сходит и прочитает по необходимости. Главное — не перегружать его всем сразу.

Лайфхак №2 — блоки important if. Некоторые куски можно оборачивать в псевдо-код-акцент:

**IMPORTANT IF** ты тестируешь на Mac:
  - <здесь критичные инструкции именно для Mac>

Claude хорошо считывает такой акцент — вы как бы подсвечиваете ему условие.

Лайфхак №3 — как создавать. Можно командой /init, но лучше: попросить Claude создать черновик → прочитать, что он сгенерировал → вручную подредактировать. Это один из важнейших файлов, и он должен быть выверен.

---

Часть 11. Экосистема Claude Code: карта компонентов

flowchart TB
    subgraph KNOW["🧠 ЗНАНИЯ"]
        K1["CLAUDE.md<br/>всегда в контексте"]
        K2["Skills<br/>знания по запросу"]
    end
    subgraph EXEC["🦾 ИСПОЛНИТЕЛИ"]
        E1["Субагенты<br/>изолированные задачи"]
        E2["Agent Teams<br/>команда агентов, делегируют друг другу"]
    end
    subgraph BORDER["⚡ Пограничные"]
        B1["MCP<br/>ближе к ЗНАНИЯМ:<br/>доступ к внешним сервисам"]
        B2["Hooks<br/>ближе к ИСПОЛНИТЕЛЯМ:<br/>авто-действия на события"]
    end
    KNOW --> PLUG["📦 ПЛАГИНЫ — контейнер для дистрибуции"]
    EXEC --> PLUG
    BORDER --> PLUG
    PLUG --> NOTE["Skills + субагенты + MCP + Hooks<br/>пакуются в плагин.<br/>CLAUDE.md обычно НЕ пакуется"]

---

Часть 12. MCP — Model Context Protocol

Краткая история (с исправлением «дат-опечаток»)³

timeline
    title Хронология MCP
    Ноябрь 2024 : Anthropic запускает MCP : огромный прорыв, все говорят про MCP
    Март 2025 : OpenAI добавляет поддержку MCP : протокол становится индустриальным
    Октябрь 2025 : Дебаты «Skills важнее MCP» : умные модели вызывают сервисы напрямую через CLI
    Декабрь 2025 : MCP передан в Agentic AI Foundation под эгидой Linux Foundation : вендоро-нейтральное управление
    Март 2026 : Дебаты «MCP мёртв, главное CLI» : и так, и не совсем так

Skills vs MCP — что произошло

Но MCP не умер — у него осталась своя ниша как инфраструктурного слоя:

• Безопасность и изоляция. Пример: Cowork работает в изолированном пространстве и не может пользоваться CLI/командной строкой (иначе перестал бы быть безопасным). Зато он может использовать MCP — поэтому у него есть коннекторы. Если строите сервис, где человек не должен натворить лишнего, — дайте ему только MCP и запретите всё остальное.
• Кроссплатформенность. CLI работает не везде; MCP работает везде, даже на мобильном.
• OAuth. MCP поддерживает OAuth-авторизацию через браузер (некоторые CLI тоже, зависит от реализации).

flowchart LR
    Q{"Что выбрать для доступа к сервису?"}
    Q -->|"есть CLI у сервиса<br/>(Cloudflare, Vercel, Notion...)"| CLI["CLI + Skill<br/>✅ быстро, надёжно<br/>✅ экономит токены<br/>✅ не нужна поддержка MCP"]
    Q -->|"нужна изоляция / OAuth /<br/>работа везде, вкл. мобильный"| MCP["MCP<br/>✅ безопасность<br/>✅ кроссплатформенность<br/>✅ OAuth"]

Tool Search — как решили проблему «забитого контекста»

flowchart TB
    subgraph OLD["❌ РАНЬШЕ: всё грузится сразу"]
        O1["Системный промпт ~5k"]
        O2["ВСЕ MCP ~72k 😱"]
        O3["Свободно: мало"]
    end
    subgraph NEW["✅ СЕЙЧАС: Tool Search"]
        N1["Системный промпт ~5k"]
        N2["Tool Search Tool ~0.5k"]
        N3["Инструкции сервера ~2k"]
        N4["Свободно: почти всё окно 🎉"]
        N5["MCP подгружаются ПО ОДНОМУ, по запросу"]
    end
    OLD --> NEW

---

Часть 13. Передача контекста между сессиями, задачами и агентами

Сценарий: у вас закончились лимиты в одной сессии, и нужно переехать на другой аккаунт, в Codex, в Gemini, Cursor, Antigravity — куда угодно, сохранив контекст текущей работы.

---

Часть 14. ⭐ Skills (навыки) — главная тема

Прогрессивная подгрузка. Сначала грузится только маленькая «шапка» Skill; остальное (а там обычно много ссылок на конкретные файлы — как и в CLAUDE.md) подтягивается, только если LLM решит, что нужно.

flowchart LR
    U["Промпт пользователя"] --> KW{"Есть ключевое слово<br/>навыка? (напр. FastAPI, Pydantic)"}
    KW -->|"нет"| SKIP["Skill не трогаем"]
    KW -->|"да"| HEAD["Грузится короткая шапка Skill"]
    HEAD --> NEED{"LLM решает: нужно глубже?"}
    NEED -->|"да"| BODY["Догружаются файлы по ссылкам:<br/>правила, примеры, доки"]
    NEED -->|"нет"| STOP["Работает по шапке"]
    BODY --> APPLY["Применяет правила как АБСОЛЮТНУЮ ИСТИНУ"]

Безопасность Skills

Навыки, которые упоминает спикер: Brainstorming (рекомендует всем), Cloudflare, Playground (визуализация работы кода — пригодится на след. занятии), FFmpeg (управление видео), Last 30 days (ищет свежие упоминания по Reddit/X), OpenClaw VPS Setup (собственный, безопасный), QMD, Remotion Best Practices (motion-графика прямо в Claude Code), Vercel, Ralph (запуск ревью через Codex).

Новая механика подгрузки навыков

---

Часть 15. Как создавать Skills: цикл «генерация → эвалы → улучшение»

flowchart TB
    H1["👤 Человек: задумать, КАК навык должен работать"] --> H2["👤 Человек: подобрать ЭТАЛОНЫ (gold standard)"]
    H2 --> S1["1) Skill Creator ГЕНЕРИРУЕТ навык"]
    S1 --> S2["2) Прогон ЭВАЛОВ (тестов) на эталонах"]
    S2 --> S3["3) УЛУЧШЕНИЕ навыка по результатам"]
    S3 --> CHECK{"Достигнут уровень эталона?"}
    CHECK -->|"нет"| S1
    CHECK -->|"да / максимально близко"| DONE["✅ Готовый навык"]
    S2 -.->|"иногда"| ASK["спрашивает экспертное мнение человека"]
    ASK -.-> S3

Демо в лекции: навык-генератор цветных, визуально разных QR-кодов под разные ссылки (LinkedIn / Telegram / веб-сайт — каждый со своим оформлением). Запрос включал: «сделай эталоны, гоняй эвалы, улучшай сам, пока не получишь реально хороший результат». На итерациях видно, как HTML-результат от первой версии к следующей становится заметно красивее — итерации и есть ключ ко всему.

---

Часть 16. Пять паттернов Skills

Паттерн	Идея	Когда применять
1. Обёртка над инструментом (Tool Expert / Wrapper)	Ключевое слово (напр. FastAPI, Pydantic) активирует навык → динамическая загрузка → правила применяются как абсолютная истина, без сомнений	У вас есть инструмент/документация — оберните её
2. Генератор (Generator)	Навык-«менеджер» генерит контент по шаблону и стилю: читает style-guide и примеры, спрашивает тему/аудиторию → выдаёт документ	Нужно штамповать контент по заданному образцу
3. Ревьюер (Reviewer)	Вы задаёте чек-лист, по которому навык обязан пройти и проверить ваш артефакт (код, отчёт — что угодно), и структурированно показывает результат	Нужна систематическая проверка «всё ли на месте»
4. Интервьюер / Инверсия (Inversion / Interview)	Агент сначала опрашивает пользователя (что генерим, для кого, какая аудитория) и только потом работает по ответам	Генерация, где сначала нужно собрать вводные (презентации, резюме)
5. Пайплайн (Pipeline)	Целый многошаговый процесс с подтверждениями на каждом этапе	Сложные навыки с чёткой последовательностью

Пример пайплайна (генерация API-референса):

flowchart TB
    P1["Шаг 1: анализ кода — извлечь публичные классы/функции/константы"] --> C1{"Пользователь подтверждает список?"}
    C1 -->|"нет"| P1
    C1 -->|"да"| P2["Шаг 2: для каждой функции что-то сгенерировать"]
    P2 --> C2{"Подтверждает?"}
    C2 -->|"нет"| P2
    C2 -->|"да"| P3["Шаг 3: собрать всё в единый API-референс"]
    P3 --> P4["Шаг 4: проверить символы, описания, примеры"]
    P4 --> FIN["✅ Финальный документ"]
    REF["Референсные файлы стиля"] -.-> P2
    REF -.-> P3

---

🎯 Домашнее задание

---

🧾 Итоговая шпаргалка

Footnotes

1. DevOps / сисадмин — специалисты, которые сами не пишут продукт, а настраивают окружение, в котором работают другие. Спикер проводит прямую аналогию: настройка Claude Code в компаниях станет именно такой отдельной ролью. ↩

2. Claude Mythos — топовая модель верхнего («Mythos») тира Anthropic, недоступная широкой публике. На момент лекции доступ к моделям этого тира (Mythos 5 / Fable 5) ограничен экспортной директивой — это подтверждается официальными материалами Anthropic. Пример CloudFlare показывает практику: под такую модель имеет смысл писать собственный harness. ↩

3. В исходной расшифровке годы искажены распознаванием речи («1924», «1925», «1926»). Здесь восстановлены корректные годы: запуск MCP — ноябрь 2024, поддержка OpenAI — март 2025, передача в AAIF под Linux Foundation — декабрь 2025. ↩

4. Сцена из «Матрицы» (1999): Нео загружают боевые программы прямо в мозг, после чего он произносит «I know kung fu». Каноничная метафора мгновенного приобретения навыка — ровно то, что Skills делают с LLM. ↩

5. Prompt-инъекция (prompt injection) — атака, при которой вредоносные инструкции прячут во внешних данных (веб-страница, файл), чтобы перехватить поведение агента. Поэтому любой навык, читающий недоверенный контент из интернета, по определению несёт этот риск — и пометка warn в аудите тут ожидаема, а не обязательно тревожна. ↩

6. Речь о геймпаде от Valve/Steam с «пасхалкой»: при падении устройство издаёт «крик» из встроенных динамиков. Пример того, как необязательная деталь создаёт ощущение, что продукт делали люди, которым не всё равно. ↩