Команда Anthropic выпустила подробный разбор продвинутой работы с Claude Code — терминальным агентом для разработчиков. Ключевая архитектура строится вокруг папки .claude/: двухуровневая система конфигурации (проектный уровень в репозитории + глобальный в ~/.claude/), где живут CLAUDE.md, Skills, субагенты и правила. Это не просто конфиг — это накопленная экспертиза команды.
Контекст
Борис Черни и команда Claude Code сформулировали один принцип, который перестраивает весь рабочий процесс: дай агенту способ верифицировать свою работу. По данным команды, это одно изменение даёт улучшение качества в 2–3 раза — Claude итерирует сам, пока не получит работающий результат, а не ждёт обратной связи от человека. Без самопроверки человек остаётся единственным контуром обратной связи. С ней — нет.
Cat Wu из команды Claude Code:
«Модель работает лучше всего, если относиться к ней как к инженеру, которому делегируют задачу, а не как к напарнику по программированию, которого ведут построчно.»Это меняет модель взаимодействия: сформулируй задание чётко — потом отходи.
Экосистема к середине 2026 года: 1000+ плагинов в 75+ маркетплейсах, репозиторий mattpocock/skills набрал около 100 тысяч звёзд, официальный маркетплейс Anthropic предлагает готовые скиллы для кодревью, TDD, отладки и автоматизированного тестирования через Playwright.
Аналитика
Система .claude/ — это слоистая архитектура знания, которую команда накапливает итеративно. CLAUDE.md обновляется после каждой ошибки: «Обнови CLAUDE.md, чтобы не повторять этого». Борис Черни называет это «компаундирующей инженерией» — каждый PR-ревью становится улучшением файла. Через несколько недель у тебя кураторский список всех подводных камней проекта, написанный самим же агентом из его собственных провалов. Раздел «Gotchas» в CLAUDE.md — самый ценный: не стайл-гайды, не описание архитектуры, а конкретные ошибки, которые система допускала реально.
Skills — единица переиспользуемой экспертизы. Папка под .claude/skills/, которая становится слэш-командой. Прогрессивное раскрытие: при старте сессии Claude загружает только описания (~100 токенов на скилл), полное содержимое — только когда скилл реально вызван. Можно держать десятки скиллов без перегрузки контекста. Флаг disable-model-invocation: true гарантирует: /ship деплоит только когда ты это явно напечатал, а не когда агент сам решил, что пора.
Субагенты решают проблему засорения главного контекста. Субагент работает в своём окне, читает 50 файлов, возвращает сводку — основная сессия остаётся чистой. Критический паттерн: агент-ревьюер с правами только на чтение (Read, Grep, Glob) — так он не может модифицировать код и не испытывает предвзятости в пользу своих правок. Флаг isolation: worktree запускает субагента в отдельном git-worktree — идеально для параллельного фана миграций.
Кейсы применения в бизнесе
B2B-SaaS стартап, команда 5–15 человек. Создать командный .claude/ с CLAUDE.md (команды сборки, порядок тестов, архитектурные ограничения) и набором Skills для стандартных операций: добавление эндпоинта, написание миграции, PR-ревью. Новый разработчик клонирует репозиторий и сразу получает накопленные практики. Скилл /go-handler или /api-endpoint заменяет неделю онбординга — шаблоны, типичные ошибки, примеры уже внутри.
Корпорация с legacy-кодом. CLAUDE.local.md для персональных замечаний: каждый ревьюер оставляет комментарии — они попадают в файл немедленно после PR. Через несколько недель Claude знает паттерны, которые конкретный разработчик систематически пропускает, и закрывает их автоматически. Субагент /pr-review на более тяжёлой модели ловит баги до human-ревьюеров: строгий список «Do NOT flag» держит соотношение сигнал/шум высоким.
SMB и цифровые студии в КР и СНГ. Глобальные Skills (~/.claude/skills/) для стандартизации без общего репозитория: /client-brief превращает брифы заказчиков в архитектурные задачи, /localize адаптирует контент под локальный рынок. Час на настройку — экономия на повторяющихся задачах в каждом следующем проекте.
Кейсы в личной жизни
Разработчик. CLAUDE.local.md как личный дневник ошибок: после каждого PR-ревью — замечания туда немедленно. Через месяц Claude перестаёт воспроизводить паттерны, которые раньше вылетали автоматически. Скилл /diagnose для отладки по протоколу — воспроизвести → минимизировать → гипотеза → исправить → регрессия — вместо хаотичного дебаггинга.
Контент-мейкер и фрилансер. Skills для повторяющихся форматов: /newsletter, /thread, /brief. Каждый скилл содержит шаблон, требования к стилю, типичные ошибки. Субагент /research работает в своём контексте — собирает материал, не засоряя сессию редактирования.
Студент. /grill-me из mattpocock/skills — интервью о плане перед написанием кода. Скилл задаёт вопросы, выявляет пробелы в мышлении, заставляет думать архитектурно до начала реализации. /tdd обеспечивает red-green-refactor: не даёт писать код без тестов. Результат — навыки, а не просто сгенерированный код.
Как применить сегодня
- Создай .claude/CLAUDE.md с тремя секциями: команды сборки и тестов, архитектурные ограничения, пустой раздел «Gotchas» — заполняй его по мере работы, командой «Обнови CLAUDE.md».
- Создай CLAUDE.local.md в корне проекта (добавь в .gitignore) — перенеси туда замечания с последнего PR-ревью прямо сейчас.
- Установи mattpocock/skills:
npx skills@latest add mattpocock/skills. Попробуй /grill-me перед следующей задачей. - Включи режим планирования (Shift+Tab дважды) перед любой задачей, затрагивающей больше одного файла. Отредактируй план через Ctrl+G до начала выполнения.
- Напиши первый субагент по паттерну /pr-review: права только на чтение, чёткий раздел «Do NOT flag», вердикт в конце — SHIP / FIX FIRST / REWORK.