Агенты Claude Code: как создать

Что такое Claude Code агенты и чем субагент отличается от основного?

Коротко: Claude Code агенты - это субагенты, отдельные помощники внутри одной сессии, которым основной агент отдаёт побочную задачу. У каждого своё окно контекста, свой системный промпт, свои инструменты и разрешения. Работу субагент делает у себя и возвращает в разговор только итог. Ты говоришь с основным агентом, он раздаёт поручения.

Когда ищут «claude code агенты», почти всегда имеют в виду субагентов. Название программы при этом пишут кто как: латиницей, «клод код», «клауд код» - программа одна. Что значит слово «агент» в целом, разобрано в словаре.

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

Своя связка агентов появилась у меня весной 2026 года, вместе с первым продуктом: код писал агент, я ставил задачи. Всё ниже сверено 21 сентября 2026 года: версию 2.1.278 на macOS и справку claude agents я проверил сам, остальное - по документации Anthropic.

Своего агента собрать несложно, но начинать проще с готовых. Восемь агентов, от юриста до монтажёра роликов, лежат в ClaudeBase вместе с инструкцией, как их поставить.

Где вы сейчас

Коротко: Статья идёт от простого к сложному: встроенные агенты, свой агент, вызов, параллельная работа, стоимость. Если часть уже пройдена, прыгай к нужному разделу. Ниже четыре ситуации и куда идти в каждой.

• Программы пока нет. Сначала установка по шагам.
• Стоит, хочу понять, что такое агенты. Читай подряд со встроенных агентов.
• Набрал /agents и увидел одну строку вместо меню. Раздел про /agents, потом шаг 1.
• Свой агент есть, нужно несколько сразу. Разделы про параллельную работу и стоимость.

Какие агенты уже встроены в Claude Code?

Коротко: Три агента работают без всякой настройки: Explore ищет по файлам, Plan собирает сведения в режиме плана, general-purpose берёт сложные задачи с правками. Claude зовёт их сам, когда задача подходит. Служебные агенты запускаются под конкретные команды, звать их руками не нужно.

Explore и Plan не читают CLAUDE.md и статус git, так поиск быстрее и дешевле. Остальные агенты правила проекта получают - как их писать, разобрано в статье про CLAUDE.md.

В русских гайдах до сих пор пишут, что Explore работает на отдельной быстрой модели. С версии 2.1.198 он берёт модель основного разговора. Держать поиск на дешёвой модели можно своим агентом с именем Explore и полем model: haiku: он заменит встроенного.

Почему команда /agents больше не открывает меню?

Коротко: Мастер создания агентов убрали в версии 2.1.198, она вышла 1 июля 2026 года. Теперь команда /agents печатает напоминание: попроси Claude создать агента или отредактируй папку .claude/agents/ сам. Файлы агентов и их поля при этом не поменялись. Меню из старых инструкций искать бесполезно.

Строка из журнала изменений версии 2.1.198:

Removed the /agents wizard; ask Claude to create or manage subagents, or edit .claude/agents/ directly

«Мастер /agents удалён: просите Claude создавать агентов и управлять ими или правьте .claude/agents/ напрямую.»

• Anthropic, журнал изменений Claude Code

В русских инструкциях из выдачи до сих пор встречается меню с пунктом «Create new agent» из версий до 2.1.197. Открывается меню - значит, Claude Code давно не обновлялся. Проверь версию:

claude --version

У меня 21 сентября команда ответила 2.1.278 (Claude Code).

Не путай две похожие команды. /agents набирается внутри сессии. claude agents запускается из терминала и открывает agent view, экран фоновых сессий; в справке он подписан «Manage background agents».

Шаг 1. Попросить Claude создать агента

Коротко: Самый короткий путь - описать агента словами прямо в сессии и сказать, куда его сохранить. Claude сам напишет файл с именем, описанием, списком инструментов, моделью и инструкцией. Тебе остаётся открыть файл и сверить, что в нём то, что ты просил.

Запрос из документации в переводе:

Создай личного субагента code-improver в ~/.claude/agents/. Пусть он
просматривает файлы и предлагает улучшения: читаемость, скорость,
лучшие практики. По каждой находке - объяснение, текущий код и
исправленный вариант. Сделай его только для чтения и поставь модель Sonnet.

Файл ляжет в ~/.claude/agents/code-improver.md, а агент будет работать во всех проектах на этой машине. Агент без всякого кода, только для одного проекта, описывается так же:

Создай в .claude/agents/ этого проекта субагента text-checker. Пусть он
вычитывает черновики статей: опечатки, повторы, слишком длинные
предложения. Править файлы ему нельзя, только читать и возвращать
список замечаний. Модель - haiku.

Потом открой файл и сверь шапку с просьбой. Если Claude не находит нового агента, перезапусти Claude Code: так бывает, когда папки ~/.claude/agents/ не было до старта сессии.

Шаг 2. Какие поля нужны в файле агента?

Коротко: Агент - обычный текстовый файл .md. Сверху шапка с настройками между двумя строками из трёх дефисов, ниже инструкция агенту простым текстом. Обязательных полей два: name и description. Остальное по желанию: инструменты, модель, режим разрешений, скиллы, память. Файл кладут в .claude/agents/ проекта или в ~/.claude/agents/.

Агент из шага 1, написанный руками:

---
name: text-checker
description: Вычитывает черновики статей и возвращает список замечаний. Звать после каждого нового черновика.
tools: Read, Grep, Glob
model: haiku
---

Ты редактор. Прочитай указанный файл и найди опечатки, повторы и
предложения длиннее 30 слов. Файлы не меняй. Верни список замечаний:
строка, что не так, как исправить.

Текст под шапкой становится системным промптом агента, а общий системный промпт Claude Code субагент не получает.

Где лежит файл и чей агент главнее при одинаковом имени:

Поля шапки:

Как написать скилл для поля skills, разобрано в статье про скиллы Claude Code.

Перезапуск после правки не нужен: Claude Code подхватывает изменение за несколько секунд. А вот файл без name или description, с шапкой не с первой строки, с двоеточием в имени или со сломанной разметкой YAML пропускается без сообщения в сессии. Причину чаще всего видно только в отладочном журнале при запуске claude --debug. Проверить папку можно командой (версия 2.1.233 и новее):

claude plugin validate .claude/agents

Файл с читаемой шапкой, но без поля name команда не отмечает, его ищи глазами.

Шаг 3. Как позвать своего агента?

Коротко: Claude зовёт агента сам, когда задача совпадает с его описанием. Можно назвать агента в запросе, и Claude обычно отдаст задачу ему. С упоминанием через @ задачу берёт именно этот агент. А флаг --agent запускает от лица агента всю сессию. Ниже все четыре способа с примерами.

Сам, по описанию. Claude выбирает агента по тексту description. Чтобы агента звали чаще, документация советует дописать туда «use proactively».

По имени. Особого синтаксиса нет:

Используй субагента text-checker, чтобы вычитать черновик drafts/post.md

Через @. Набери @ и выбери агента из подсказок, как выбираешь файл:

@"text-checker (agent)" вычитай drafts/post.md

Упоминание решает только, какой агент возьмёт задачу, само поручение всё равно пишет основной Claude. Руками то же набирается как @agent-text-checker.

На всю сессию. Флаг --agent из справки claude --help отдаёт сессии системный промпт, инструменты и модель агента:

claude --agent text-checker

Работа агента видна в ленте строкой с его именем и кратким описанием задачи, например code-improver(Suggest code improvements).

Как раздать задачи нескольким агентам параллельно?

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

Параллельно отдельными субагентами: проверь ссылки на странице
services.html, выпиши вопросы клиентов из faq.md и найди в папке
drafts статьи без заголовка. Каждому - короткий отчёт.

Если второму агенту нужен итог первого, проси цепочкой: «используй code-reviewer, чтобы найти проблемы, потом optimizer, чтобы их исправить».

Что полезно знать про параллельную работу:

1. В интерактивной сессии субагенты по умолчанию уходят в фон. Когда фоновому агенту нужно разрешение, вопрос всплывает в основной сессии с его именем.
2. /tasks показывает фоновую работу сессии, включая закончивших агентов.
3. Одновременно по умолчанию работает до 20 субагентов, предел меняет переменная CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS.
4. Субагент может запускать своих, до трёх уровней ниже основного разговора.
5. /subtask запускает форк - субагента, который получает весь текущий разговор.
6. Скилл /batch дробит большую правку на 5-30 частей, каждую в отдельной копии репозитория.

Итог каждого агента возвращается в основной разговор, поэтому проси короткие отчёты.

Агенты в ClaudeBase. В базе восемь готовых агентов: юрист, финансовый, ресёрч, разведчик трендов, монтажёр вертикальных роликов, монтажёр длинных записей, аналитик ботов и ассистент. Как сводить нескольких агентов в одну работу, разобрано в материале «Сценарии (Workflows): когда одного агента мало», а как агент работает на деле - во втором уроке первого модуля. Всё это открывается с доступом к базе.

Когда нужны команда агентов, agent view или workflow?

Коротко: Субагенты - самый лёгкий из пяти способов параллельной работы в Claude Code. Кроме них есть agent view для фоновых сессий, команды агентов, динамические workflows на десятки агентов и проекты в облаке. Часть из них пока в статусе эксперимента или беты. Новичку почти всегда хватает субагентов.

План у субагентов держит Claude по ходу разговора, у workflow - скрипт, у команды - ведущая сессия. Команды включаются переменной в settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Документация советует начинать с трёх-пяти напарников: каждый расходует токены как отдельная сессия. Готовый workflow - встроенная команда /deep-research: поиск по нескольким направлениям со сверкой источников и отчётом со ссылками.

Сколько стоит субагент и когда он не нужен?

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

Цифры четыре и пятнадцать - из инженерного блога Anthropic, статья How we built our multi-agent research system от 13 июня 2025 года.

Что ещё документация Claude Code говорит про расход:

• команда агентов, чьи напарники работают в режиме плана, тратит примерно в 7 раз больше токенов, чем обычная сессия;
• десять фоновых сессий в agent view расходуют квоту примерно в десять раз быстрее одной;
• для простых задач агенту советуют model: haiku;
• на тарифах Pro, Max, Team и Enterprise /usage показывает долю расхода на субагентов.

Где смотреть остаток лимита - в статье про лимиты Claude Code.

Субагент не нужен для задач с частыми уточнениями, для этапов с общим контекстом и для быстрой точечной правки. Не нужен он и там, где важна скорость: субагент стартует с нуля и собирает контекст заново. Вопрос по открытому разговору проще задать через /btw - ответ учитывает весь контекст и не попадает в историю. Повторяемую инструкцию оформляют скиллом.

ИИ-агент на Claude: что это значит?

Коротко: Под «ИИ-агентом на Claude» понимают три вещи. Это сам Claude Code на твоём компьютере, субагенты внутри него, о которых эта статья, и свой агент в своём продукте на Agent SDK или Managed Agents. Во всех трёх модель сама решает, какие шаги делать и какими инструментами. Непрограммисту подходят первые два варианта.

В статье Anthropic Building effective agents агентом названа система, где языковая модель сама управляет ходом работы и выбором инструментов. Под это определение попадают все три варианта:

1. Claude Code читает файлы, запускает команды и правит проект на твоей машине. С чего начать - в статье что такое Claude Code.
2. Субагенты берут отдельные поручения внутри сессии, их настраиваешь ты.
3. Agent SDK - библиотека на Python и TypeScript с тем же рабочим циклом, что у Claude Code, для агента внутри своего сервиса или бота. Managed Agents - отдельный продукт, где агента и песочницу запускает сама Anthropic. Оба варианта требуют программирования.

Сколько агент делает без человека, разобрано на соседнем примере - агент Codex.

Частые ошибки с агентами

Коротко: Четыре сообщения, которые Claude Code печатает при сбоях с субагентами, дословно по справочнику ошибок Anthropic, и что делать с каждым. Все чинятся правкой файла агента или ожиданием.

Agent descriptions are over the 15.0k-token limit

Описания всех твоих агентов вместе длиннее 15 000 токенов. Агенты загружаются, но описания занимают контекст. Сократи поля description, подробности перенеси в текст под шапкой: он грузится, только когда агент работает.

Agent would be spawned with zero tools

Ни одна строка в tools не совпала с настоящим инструментом, например из-за опечатки Grpe вместо Grep. Исправь названия или удали поле tools: тогда агент получит все инструменты, доступные субагентам.

Concurrent subagent limit reached

Одновременно уже работают 20 субагентов. Дождись, пока часть закончит, или подними предел переменной CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS.

Agent terminated early due to an API error

Субагент остановился на ошибке API, например упёрся в лимит использования; причина идёт после двоеточия. Когда ошибка пройдёт, попроси Claude повторить задачу или продолжить работу этого агента.

Агента нет совсем - проверь шапку файла и перезапусти сессию, если папка agents появилась уже после её старта.

Чек-лист

Коротко: По шести пунктам ниже видно, на месте ли твои Claude Code агенты и работают ли они как задумано. Каждый закрывается прямо в сессии Claude Code. Пункт не сходится - смотри разделы про поля файла и про ошибки.

1. claude --version показывает 2.1.198 или новее, и меню /agents ты не ищешь.
2. Файл агента лежит в .claude/agents/ проекта или в ~/.claude/agents/, в шапке есть name и description.
3. description в одну-две фразы говорит, когда звать агента.
4. В tools только нужные инструменты: проверяльщику текстов хватит Read, Grep, Glob.
5. Агент откликается на @-упоминание, в ленте видна строка с его именем.
6. Параллельный запрос запускает нескольких агентов, а /tasks их показывает.

Агент работает - что дальше?

Коротко: Дальше агенту нужны правила, инструменты и готовые наработки. Правила он берёт из CLAUDE.md, сервисы подключаются по MCP, готовые агенты приходят в плагинах. Три ближайших шага - ниже.

1. Напиши правила проекта: их получают и основной агент, и твои субагенты. Порядок - в статье про CLAUDE.md.
2. Дай агенту доступ к сервисам через MCP в Claude Code или возьми готовых агентов из плагинов.
3. Держи под рукой шпаргалку команд: /tasks, /btw, /subtask и остальное.

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