VibeCoderzVibeCoderz

Конспекты

Смарт-конспекты YouTube-видео — ключевые идеи и инсайты без необходимости смотреть часовые ролики

Все конспекты
📝 Конспект2026/05/21

Claude Code в больших проектах: Стратегии работы с кодовой базой на 100k+ строк

Практическое руководство по настройке AI-слоя в Claude Code: иерархические правила, MCP-серверы, хуки самообновления и работа с суб-агентами в больших репозиториях.

Содержание (8)+
📝

Смарт-конспект

🎯 О чём этот конспект: Разбор официальных стратегий Anthropic и практических наработок по использованию Claude Code (и других AI-агентов) в сложных, многоуровневых репозиториях. Рассматривается концепция «AI-слоя» (AI layer), который позволяет агенту эффективно ориентироваться в коде без предварительной индексации.

👤 Кому будет полезно: Вайбкодерам и разработчикам, чьи проекты переросли формат «одного файла» и требуют системного подхода к управлению контекстом AI-агента.

✨ Что получите: Готовую архитектуру для настройки Claude Code: от иерархических правил (claud.md) до автоматических хуков самосовершенствования и кастомных MCP-серверов для умного поиска по символам.

1. Концепция AI-слоя (AI Layer)

Контекст: Традиционно кодовая база состоит из кода и тестов. Для эффективной работы AI-агента в больших проектах (миллионы строк) необходим третий компонент — AI-слой. Это набор инструментов и контекста, который «одевается» поверх кода. Вместо того чтобы полагаться только на мощность модели, мы создаем «упряжь» (harness), которая включает глобальные правила, навыки (skills), MCP-серверы и суб-агентов. Это позволяет Claude работать как инженер: не читать всё подряд, а использовать инструменты командной строки для навигации.

Тайминг: ,

Выгода: Агент перестает «галлюцинировать» из-за избытка или недостатка контекста, работая точно в нужных файлах.

Как применить:

  • Шаг 1: Формирование структуры — Создайте в корне проекта файлы конфигурации, которые будут описывать архитектуру и правила.
  • Шаг 2: Настройка инструментов — Подключите MCP-серверы для расширения возможностей поиска (например, поиск по символам через LSP).

Результат: Упорядоченная среда, где AI-агент понимает границы своей ответственности и доступные инструменты.


2. Многоуровневые правила (Lean and Layered Global Rules)

Контекст: Огромные файлы правил (тысячи строк) вредят производительности LLM. Вместо одного гигантского файла в корне, Anthropic рекомендует использовать иерархический подход. Основной файл claud.md в корне содержит только общие сведения (стек, архитектура, команды запуска), а специфические правила размещаются в подпапках. Claude Code автоматически подгружает правила из текущей директории и всех родительских папок при переходе вглубь проекта.

Тайминг: ,

Выгода: Снижение потребления токенов и повышение точности следования правилам за счет «прогрессивного раскрытия» контекста.

Как применить:

  • Шаг 1: Создание корневого файла — В корне проекта создайте claud.md.
# Core Rules
Tech Stack: Next.js, TypeScript, Tailwind
Architecture: Clean Architecture
Testing: Run `npm test` before finishing
  • Шаг 2: Создание локальных правил — В папке /api создайте еще один claud.md.
# API Service Rules
- All routes must be registered in /api/index.ts
- Use Zod for validation
  • Шаг 3: Инициализация в подпапке — Если задача касается только API, запускайте Claude прямо из этой папки:
cd src/api && claude

Результат: Агент видит только тот контекст, который релевантен текущей задаче.


3. Самосовершенствующийся AI-слой через Hooks

Контекст: Правила в claud.md имеют свойство устаревать. Чтобы этого избежать, можно использовать хуки (start/stop hooks). stop hook запускается в конце сессии, анализирует внесенные изменения и предлагает обновить файлы правил, если конвенции изменились. start hook может динамически подгружать контекст, например, из Confluence или историю последних Git-коммитов, чтобы агент понимал текущий статус работ.

Тайминг: ,

Выгода: Поддержание документации для AI в актуальном состоянии без ручного вмешательства.

Как применить:

  • Шаг 1: Настройка в settings.json — Пропишите пути к скриптам хуков в конфигурации Claude Code.
  • Шаг 2: Реализация Stop Hook — Используйте скрипт, который запускает Claude в headless-режиме для анализа изменений.

Результат: После каждой задачи вы получаете Markdown-отчет с предложением: «Я заметил, что мы изменили подход к энумам, обновим claud.md?».


4. Скиллы с ограничением по путям (Scoped Skills)

Контекст: Скиллы (Skills) — это переиспользуемые промпты и рабочие процессы. В больших проектах не все скиллы нужны везде. Claude Code позволяет ограничивать область действия скилла конкретными путями (параметр path).

Тайминг: ,

Выгода: Агент не будет пытаться применить скилл «Создание API-роута», если вы работаете над фронтенд-компонентом.

Как применить:

  • Шаг 1: Определение скилла — Создайте файл скилла с метаданными.
  • Шаг 2: Ограничение области — Укажите путь в конфигурации скилла.
# Skill: Add API Route
# Path: src/api/**/*
[Инструкции по созданию роута...]

Результат: Автоматическая активация нужных инструментов при переходе в соответствующие папки.


5. Использование LSP через MCP для глубокого поиска

Контекст: В проектах на 100k+ строк обычный grep работает медленно и неэффективно. Использование Language Server Protocol (LSP) через MCP-сервер позволяет Claude искать не просто строки, а символы (определения классов, ссылок на переменные). Это дает агенту те же возможности навигации, что и разработчику в VS Code (переход к определению по Ctrl+Click).

Тайминг: ,

Выгода: Точный поиск зависимостей в огромном коде без раздувания контекстного окна лишними файлами.

Как применить:

  • Шаг 1: Подключение MCP-сервера — Используйте готовый сервер для поиска по кодовой базе.
  • Шаг 2: Запрос на поиск — Просите Claude использовать символьный поиск.
Find every place where 'monthly_total_cents' is referenced using symbol-level approach.

Результат: Агент находит все упоминания переменной во всем репозитории за секунды, используя инструменты навигации, а не чтение всех файлов.


6. Разделение исследования и редактирования (Sub-agents)

Контекст: Исследовательские задачи (изучение архитектуры, поиск места для фикса) могут «съесть» сотни тысяч токенов. Если делать это в основной сессии, к моменту написания кода контекстное окно будет перегружено. Решение — делегировать исследование суб-агентам.

Тайминг: ,

Выгода: Чистое контекстное окно для основной работы и экономия токенов.

Как применить:

  • Шаг 1: Запуск суб-агента — Попросите Claude запустить исследователя.
Spin up a sub-agent to explore the backend and find where authentication is handled. Return only a summary.
  • Шаг 2: Получение резюме — Суб-агент проводит анализ, закрывается и возвращает краткий отчет.

Результат: Основной агент получает готовую инструкцию: «Правь файлы A и B», не тратя память на процесс поиска.


Claude Code в больших проектах: ответы на частые вопросы

В: Зачем нужны локальные claud.md, если есть один глобальный? О: Глобальный файл быстро переполняется. Локальные файлы позволяют давать Claude специфические инструкции (например, правила валидации только для API) только тогда, когда он находится в этой папке. Это экономит токены и предотвращает путаницу в правилах.

В: Как Claude Code понимает, какой MCP-инструмент использовать? О: Через описание инструментов в MCP-сервере. Если вы просите «найти все ссылки на класс», Claude видит инструмент find_references в вашем кастомном MCP-сервере и выбирает его вместо обычного поиска по тексту.

В: Можно ли использовать эти стратегии в Cursor или Windsurf? О: Да, концепция иерархических правил (.cursorrules или аналоги) и использование MCP-серверов для контекста применимы к большинству современных AI-агентов, хотя Claude Code имеет наиболее продвинутую нативную поддержку этих функций.

В: Что такое "Quiet Investment Period" при внедрении AI в команду? О: Это период, когда небольшая группа инженеров (чемпионов) настраивает AI-слой: пишет базовые правила, создает скиллы и настраивает MCP. Это нужно, чтобы остальные разработчики получили готовый, работающий инструмент и не разочаровались в AI из-за плохих результатов на старте.

В: Как работает автоматическое обновление правил через хуки? О: Скрипт на onSessionStop берет диффы (изменения) вашего кода, отправляет их отдельному инстансу Claude в фоновом режиме и спрашивает: «Нужно ли обновить наши стандарты в claud.md на основе этого кода?». Если да — он генерирует предложение по обновлению.


Claude Code в больших проектах: инструменты и ссылки из видео

  • Статья Anthropic — Оригинальный гайд по работе с большими кодовыми базами — упомянута в видео.
  • Demo Repo (Helpline AI Layer) — Репозиторий с примерами хуков, скиллов и MCP-сервером — упомянут в видео.
  • JetBrains Academy — Курсы по AI и LLM инженерии — JetBrains Academy.
  • Claude Code Plugin Marketplace — Команда для установки плагинов — claude /plugin marketplace add.

Конспект создан на основе видео «Claude Code: Strategies for Large Codebases» канала Cole Medin. Все права на оригинальный материал принадлежат авторам. Источник: https://youtu.be/efRIrLXoOVA

Редактор конспекта

Максим Наговицын

Маркетинг-стратег, IT-предприниматель, ментор по вайбкодингу

10+ лет в маркетинге, 300+ клиентских проектов: сайты, реклама, боты. Создатель GoBanana (228K+ пользователей, 11.6 млн ₽ выручки) и VibeCoderz. Делаю AI-продукты сам через Claude Code, Cursor, Windsurf и консультирую тех, кто хочет так же.

Об авторе →
Все конспекты

Источник

КаналCole Medin
Конспект добавлен2026/05/21
Смотреть на YouTube

Инструменты из конспекта

Похожие конспекты

📝 Конспект

Claude Code + Paper MCP: Как создавать UI/UX агентского уровня и верстать лендинги без шаблонов

Пошаговый гайд по созданию агентского UI/UX и верстке лендингов с помощью Claude Code, Paper MCP и реальных бренд-китов без шаблонного AI-стиля.

2026/11/02
📝 Конспект

Автомонтаж Reels через Claude Code и MCP: Создание готовых проектов CapCut и DaVinci

Пошаговый гайд по автомонтажу Reels в Claude Code с Higgsfield MCP. Генерация B-roll, нарезка по Whisper, субтитры и экспорт в CapCut и DaVinci.

2026/11/02
📝 Конспект

Вайбкодинг iOS-приложений: Как сделать $41 000 в месяц на утилите с помощью Claude и SEO-агентов

Пошаговый разбор создания iOS-утилиты без бэкенда на Swift с доходом $41,000/мес с помощью Claude, MCP и автоматического SEO.

2026/11/02
📝 Конспект

Генерация кинематографичного видео из стикманов: Пайплайн Claude Code, Python и Higgsfield Katana

Пошаговый пайплайн создания AI-фильмов: генерация раскадровки стикманов на Python через Claude Code и рендеринг в кино с Higgsfield Katana.

2026/11/02
📝 Конспект

Поиск связок через SpyTrend и AI: Полный гайд по автоматизации парсинга креативов через MCP

Пошаговый гайд по подключению SpyTrend к AI-агенту через MCP: находите скрытые связки в FB/TikTok и скачивайте топовые креативы по одному промпту.

2026/11/02
📝 Конспект

Claude Code и AI-агенты: Полный гид по переходу от чат-промптов к автономным системам

Практический гид по переходу от чатов к AI-агентам: настройка Claude Code, интеграция через MCP, браузерная автоматизация и мультиагентные системы.

2026/11/02

Читать далее

📢 Новость

Экосистема Anthropic 2026: от чат-бота к автономному агенту Claude Code

Разбор взрывного роста Anthropic в 2026 году: 29 релизов за 5 месяцев, переход к многорепозиторному кодингу и автономным агентам.

2026/06/01
📢 Новость

Claude Code против OpenCode: битва терминальных AI-агентов 2026 года

Разбираем, что выбрать вайбкодеру: закрытую экосистему Anthropic или опенсорсную свободу OpenCode с поддержкой 75+ провайдеров.

2026/06/01
📢 Новость

BMAD + Claude Code: Новый фреймворк для системной iOS-разработки

Разбираем связку BMAD и Claude Code для создания iOS-приложений на SwiftUI: от генерации PRD до чистого кода.

2026/05/29
📄 Статья

Claude Code: советы от создателя. Конспект доклада Бориса Черни из Anthropic

Борис Черни, автор Claude Code, показал на конференции Anthropic, как реально пользоваться инструментом: с чего начать, зачем CLAUDE.md, какие горячие клавиши никто не знает и как запускать несколько агентов параллельно. Конспект доклада с командами и разбором.

2026/08/1411 мин
📄 Статья

Плейбук основателя: как построить AI-нативный стартап в 2026

Раскроем, как в 2026 году AI‑нативные стартапы ускоряют путь от идеи до масштабирования: от превращения кода в агента до практических советов по использованию Claude и его инструментов.

2026/06/1721 мин
📄 Статья

Qwen 3.8 Max 2026 обзор, доступ и как запустить локально

Qwen 3.8 Max стала первой моделью линейки Max, у которой Alibaba открыла веса. 12 августа 2026 года чекпоинт на 2,4 трлн параметров появился на Hugging Face, и скачать его может любой. А вот запустить дома не выйдет: даже 1-битная версия весит 397 ГБ…

2026/10/1212 мин