Агенты в Claude Code: субагенты для новичка пошагово

Что такое субагент простыми словами

Представьте, что Claude Code – это руководитель небольшого отдела. Сам он ведёт с вами разговор и держит в голове всю задачу. А мелкую, но объёмную работу раздаёт помощникам: один перечитывает двадцать файлов и ищет нужное место, другой проверяет текст, третий собирает сведения из интернета. Каждый помощник сидит за своим столом, работает молча и приносит руководителю короткую записку с итогом.

Эти помощники и есть субагенты. В русскоязычных статьях их чаще называют просто «агенты в Claude Code», это одно и то же.

Зачем такая схема, если можно всё делать в одном чате? Причин четыре.

• Чистая голова у главного Claude. У любого разговора есть предел памяти, его называют контекстом. Когда Claude читает десятки страниц, вся эта простыня оседает в разговоре, и к середине дня он начинает путаться. Субагент читает всё в своём отдельном окне, а в общий разговор возвращает только выжимку.
• Узкая специализация. У агента своя инструкция. Редактор постов всегда проверяет одно и то же по одному списку, и вам не нужно каждый раз объяснять заново.
• Ограничения. Агенту можно разрешить только читать файлы. Тогда он физически не сможет ничего испортить.
• Экономия лимита. Простую работу можно отдать быстрой и дешёвой модели Haiku, а сложную оставить Opus.

Часть агентов уже встроена в Claude Code, и вы пользуетесь ими, даже не зная об этом. Explore быстро ищет по файлам и ничего не меняет. Plan собирает сведения, когда вы просите сначала составить план. General-purpose берётся за сложные задачи в несколько шагов, где нужно и найти, и переделать. Claude зовёт их сам, когда видит, что так быстрее. Когда в окне появляется строка вроде Explore(Найти все упоминания цены), это и есть работа субагента.

Свои агенты нужны, когда вы раз за разом даёте Claude одно и то же поручение с одинаковыми пояснениями. Один раз описали помощника, и дальше он работает по вашему стандарту.

Что нужно для старта и сколько стоит

Субагенты живут внутри Claude Code. Значит, понадобится сам Claude Code и платный тариф: на бесплатном Free его нет. Работать можно в терминале или во вкладке Code в приложении Claude для компьютера, агенты подхватываются и там, и там. Если Claude Code у вас ещё не стоит, начните с инструкции как пользоваться Claude Code, а на Windows – с отдельного разбора установки Claude Code на Windows.

Цены взяты с официальной страницы claude.com/pricing. Подробно, какой тариф под какие задачи, – в статье тарифы Claude в рублях.

Одна деталь, о которой мало кто говорит: каждый субагент отправляет свои запросы, и они списываются из того же лимита, что и ваш основной разговор. Пять агентов, запущенных параллельно, съедают лимит в пять раз быстрее. На Pro начинайте с одного-двух агентов на дешёвой модели.

Регистрируйтесь на claude.ai с почтой Gmail или iCloud: российские Яндекс, Mail.ru и Rambler не проходят. Если такой почты нет, заведите новую уже с включённым VPN, чтобы аккаунт с первого дня не был связан с Россией. Весь путь с оплатой расписан в статье доступ к Claude из России, а способы оплаты – в разборе оплата Claude из России.

Первый агент за 10 минут: пошагово

Файлы руками создавать не нужно. Агента вы описываете Claude обычными словами, файл он пишет сам. Для примера возьмём редактора постов: он проверяет текст перед публикацией и ничего не меняет без вас.

Создай субагента redaktor-postov в папке .claude/agents этого проекта.
Задача: проверять готовый пост для Telegram перед публикацией.
Пусть возвращает: список ошибок (опечатки, канцелярит, длинные предложения, повторы) с цитатой и исправлением, оценку первой строки и вариант сильнее.
Файлы он только читает и ничего не меняет. Модель – haiku. Ответ не длиннее 15 строк.

Чтобы агент был доступен сразу во всех ваших проектах, попросите Claude сохранить его в личную папку: «сохрани этого агента в ~/.claude/agents, чтобы он работал во всех проектах». Разница видна в официальной документации:

Папка .claude/agents/ внутри проекта – агент только для этого проекта. Папка ~/.claude/agents/ в вашей домашней папке – агент для всех проектов на компьютере. Если имена совпадут, победит проектный.

Возможно, вы встречали в старых инструкциях команду /agents с мастером настройки. В свежих версиях Claude Code она просто напоминает: попросите Claude или отредактируйте папку агентов. Так что способ через чат сейчас основной.

Проверка: как агент вычитал пост

Я создал этого редактора и дал ему намеренно плохой пост: «Друзья, всем привет! Сегодня я хотел бы рассказать вам о том, что осуществление продаж через консультацию является наиболее эффективным способом получения клиентов для специалистов в сфере услуг. Записывайтесь на консультацию».

Из этой проверки два вывода. Первый: даже дешёвая модель с хорошей инструкцией находит в тексте то, что сами вы уже не видите. Второй: результат агента нужно читать глазами. Помощник старается быть полезным и может «улучшить» текст выдумкой. Допишите в инструкцию строку «не добавляй цифры и факты, которых нет в исходном тексте», и таких сюрпризов станет меньше.

Из чего состоит файл агента

Файл агента – обычный текстовый файл. Вверху, между двумя строками из трёх дефисов, стоят настройки. Ниже – инструкция для агента своими словами. Править его руками не обязательно: скажите Claude, что поменять, он поправит сам. Но понимать, что там внутри, полезно.

Обязательны только два поля: имя и описание. Остальное по желанию.

Как выбрать модель. Haiku – для простого и массового: проверить текст, найти в файлах, разложить по категориям. Sonnet – для большинства рабочих задач: написать черновик, собрать сводку. Opus – когда нужно подумать: разобрать воронку, найти слабое место в оффере. Если не уверены, ставьте inherit, агент возьмёт ту же модель, что и основной разговор.

Про инструменты. Агенту, который только проверяет и советует, хватит Read, Grep и Glob: читать, искать по тексту, искать файлы. Агенту, который должен сам что-то создавать, нужны ещё Write и Edit. Агенту для поиска в интернете – WebSearch и WebFetch. Чем меньше прав, тем спокойнее.

Как вызвать агента и как писать описание

Вызвать агента можно тремя способами.

• Назвать его в сообщении. «Попроси redaktor-postov проверить пост». Claude почти всегда передаст задачу, но решение остаётся за ним.
• Упомянуть через @. Наберите @ и выберите агента из списка, как выбираете файл. Так агент запустится гарантированно.
• Ничего не говорить. Claude сам позовёт агента, если задача совпадёт с его описанием. Для этого описание должно быть точным.

Третий способ самый удобный, и он целиком держится на поле description. Claude читает описания всех агентов и решает, кому что отдать. Хорошее описание отвечает на вопрос «когда звать».

Слабое описание: «Помощник по текстам». Под него подходит что угодно, и Claude будет звать агента невпопад или не звать вовсе.

Сильное описание: «Проверяет готовый пост перед публикацией. Используй, когда просят вычитать, проверить или почистить текст поста». Здесь есть и задача, и слова, по которым Claude поймёт, что пора.

Если хотите, чтобы агент включался сам при любой подходящей задаче, допишите в описание «use proactively» – так рекомендует документация Anthropic. И держите описания короткими: если описания всех ваших агентов вместе становятся слишком длинными, Claude Code покажет предупреждение при запуске. Подробности поведения агента пишите ниже, в инструкции, она загружается только когда агент работает.

Отдельная фишка – агенты работают параллельно. Попросите: «Запусти трёх агентов одновременно: один проверит пост, второй найдёт в папке все упоминания старой цены, третий соберёт сведения о трёх конкурентах». По умолчанию агенты, которых запускает Claude, работают в фоне, а вы в это время продолжаете разговор. В одной сессии одновременно может работать до 20 субагентов, но помните про лимит: каждый тратит его отдельно.

5 агентов для тех, кто продаёт услуги и курсы

Ниже пять помощников, которых стоит собрать первыми. Каждого создаёте одной фразой в чате с Claude, как в разделе выше.

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

Создай субагента razvedchik в ~/.claude/agents, чтобы он работал во всех проектах.
Задача: по списку ссылок на сайты конкурентов собрать таблицу – продукт, цена, главное обещание, формат (курс, консультация, наставничество), бонусы и гарантии.
Инструменты: WebSearch, WebFetch, Read. Файлы не меняет. Модель – sonnet.
Если цену найти не удалось, так и пиши «не указана», ничего не додумывай.

Проверщик лендинга – тот случай, когда стоит потратить лимит на Opus. Слабое место в оффере стоит дороже пары лишних запросов:

Создай субагента proverka-lendinga в этом проекте.
Задача: прочитать страницу продаж по ссылке глазами человека, который видит её впервые, и вернуть:
1) понятно ли за 5 секунд, что продаётся и кому;
2) три главных возражения, на которые страница не отвечает;
3) где теряется призыв к действию;
4) пять конкретных правок с новым текстом.
Инструменты: WebFetch, Read. Модель – opus. Не придумывай отзывы и цифры.

Разборщик отзывов работает с тем, что у вас уже есть. Сложите в папку проекта выгрузку отзывов, ответы из анкет, переписку с клиентами и скажите:

Создай субагента golos-klienta в этом проекте.
Задача: прочитать все файлы в папке «Отзывы» и вернуть 10 болей клиентов их собственными словами (дословные цитаты), 5 частых возражений и 5 формулировок результата, которые клиенты используют сами.
Инструменты: Read, Grep, Glob. Модель – sonnet. Ничего не перефразируй, только цитаты.

Дальше эти цитаты идут в посты, лендинг и рекламу. В программе «Маркетинг и нейросети» я отдаю клиентам 21 готовый скилл для Claude Code и Codex: они делают посты, монтаж видео, баннеры, презентации и рекламу. Агенты хорошо работают с ними в паре: скилл задаёт порядок работы, агент берёт на себя объёмную часть. Начать можно с одного своего агента, отдельно за него платить не нужно.

Если хочется собрать агента, который работает сам по расписанию, без вашего участия, – это уже следующий уровень. Начните со статьи как сделать ИИ-агента без кода, а когда агенту понадобится работать круглосуточно, загляните в разбор как поставить Claude Code на свой сервер.

Когда агент не нужен

Агентов легко начать плодить на всё подряд. Документация Anthropic прямо советует оставаться в основном разговоре в трёх случаях.

Первый – задача требует частых уточнений. Вы пишете пост и пять раз просите «короче», «теплее», «добавь пример». Агент каждый раз начинает с чистого листа и не помнит, о чём вы договорились минуту назад. Здесь быстрее работать напрямую.

Второй – быстрая точечная правка. Поменять цену в одном месте проще самому, чем ждать, пока агент соберёт контекст.

Третий – несколько этапов, которые опираются на общий разговор: сначала обсудили стратегию, потом пишем по ней тексты. Если отдать тексты агенту, придётся пересказывать ему всю стратегию.

Ещё одна путаница: субагенты и скиллы. Скилл – это записанная инструкция, которую Claude выполняет прямо в основном разговоре, всё видно и можно поправить по ходу. Субагент выполняет работу в отдельном окне и возвращает итог. Правило простое: нужен повторяемый порядок действий с вашим участием – скилл. Нужно отдать объёмную самостоятельную работу и получить сводку – агент.

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

Если что-то пошло не так

Если агент работает странно, а причину не видно, спросите у самого Claude: «покажи файл агента redaktor-postov и объясни, почему он сделал вот так». Чаще всего ответ в описании или в инструкции, и Claude сам предложит правку.

Памятка

Весь путь за минуту. Скопируйте себе.

1. Нужен Claude Code на платном тарифе (Pro от 20 долларов), из России – с VPN.
2. Открыть папку проекта и описать агента Claude обычными словами.
3. В описании: задача, когда звать, какие права, какая модель, чего не делать.
4. Агент для одного проекта – .claude/agents, для всех проектов – ~/.claude/agents.
5. Агент не находится – перезапустить Claude Code.
6. Звать по имени в сообщении или через @, чтобы запустился наверняка.
7. Проверяющим агентам – только чтение, простым задачам – модель haiku.
8. Итог агента читать глазами: он может добавить то, чего не было.
9. Частые уточнения и быстрые правки – в основном разговоре, без агента.

Источники

• Anthropic: документация Claude Code, субагенты, проверено 12.11.2026
• Anthropic: документация Claude Code, скиллы, проверено 12.11.2026
• Anthropic: тарифы Claude, проверено 12.11.2026
• Anthropic: страны, где доступен Claude, проверено 12.11.2026
• Банк России: официальные курсы валют, курс на 12.11.2026