Субагенты Claude Code: как они работают, как их определять и как устроены команды агентов

Определение субагента

# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Reviews a diff for correctness, security and test coverage. Use after any non-trivial change.
tools: Read, Grep, Glob, Bash(git diff *)
model: sonnet
---
You are a senior reviewer. Read the staged diff, list concrete defects with file:line,
flag untested paths, and stop. Do not edit files.

name задаёт имя, по которому вы его вызываете; description определяет, когда Claude самостоятельно решает его вызвать, поэтому сформулируйте это как правило выбора («использовать после любого нетривиального изменения»), а не как название должности. tools ограничивает допустимые действия — проверяющий агент, который не может редактировать, безопаснее. model фиксирует уровень модели: haiku для предварительного изучения и классификации, sonnet для большинства задач, opus для сложного этапа или inherit чтобы использовать модель родительской сессии.

Проектные и пользовательские агенты

Файлы в .claude/agents/ принадлежат репозиторию и распространяются вместе с ним: добавьте их в коммит, и у каждого участника команды будут одинаковые агенты для проверки кода, написания тестов и миграций. Файлы в ~/.claude/agents/ принадлежат вам и доступны во всех проектах. При совпадении имён приоритет имеют проектные агенты. /agents внутри сессии позволяет просматривать, создавать и редактировать оба вида без ручного изменения файлов.

Когда Claude делегирует задачи

Есть два способа. Неявный: основной агент читает описание каждого субагента и делегирует задачу, если она ему соответствует — просить «запусти для этого субагента code-reviewer» не нужно, если в описании уже сказано, когда его использовать. Явный: укажите его имя в промпте. В обоих случаях субагент работает в собственном контексте, видит только переданную ему информацию и то, что прочитает сам, и возвращает результат, который основная сессия кратко записывает в свою историю. Субагенты не запускают других субагентов; иерархия имеет только один уровень.

Почему они снижают стоимость сессий

На каждом шаге Claude Code повторно отправляет весь разговор. Субагент, который читает сорок файлов, делает это в собственном контекстном окне; родительский агент получает один абзац. Без субагентов эти сорок файлов оставались бы в основном контексте до конца сессии и отправлялись бы заново на каждом шаге. Поэтому для больших кодовых баз схема такая: исследуйте с помощью субагента Haiku, проверяйте с помощью субагента Sonnet, а контекст родительского агента оставляйте для решений. Токены каждого субагента оплачиваются отдельно — это не бесплатно, но расходы ограничены его контекстом.

Параллельная работа и ограничения частоты запросов

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

Команды агентов

В новых сборках Claude Code появились команды агентов: вместо одного родительского агента, делегирующего задачи кратковременным субагентам, несколько сессий координируют работу как участники с именами, общим списком задач и обменом сообщениями. Руководитель может распределять работу, запрашивать статус и останавливать участника. Это экспериментальная возможность, которая включается отдельной настройкой и меняется от версии к версии — проверяйте claude --help и журнал изменений, чтобы узнать актуальный флаг, вместо того чтобы полагаться на статью в блоге. По сути, это те же субагенты, но с сохранением состояния и обменом сообщениями; модель расходов тоже та же, только умноженная на число участников.

На шлюзе

Субагенты и команды используют ту же конечную точку и тот же ключ, что и родительская сессия, поэтому ANTHROPIC_BASE_URL=https://aiprimetech.io охватывает их всех. На безлимитном тарифе с фиксированной платой параллельная работа становится вопросом добросовестного использования, а не оплаты, поэтому пользователи с высокой нагрузкой от нескольких агентов обычно переходят на такой тариф.

Все безлимитные тарифы →

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Часто задаваемые вопросы

AI Prime Tech — независимый API-шлюз, который не связан с Anthropic, не одобрен и не спонсируется этой компанией. «Claude» и «Claude Code» — товарные знаки Anthropic. Описанные здесь возможности Claude Code соответствуют публичной документации Anthropic на момент написания и часто меняются; цены и списки моделей на этой странице берутся из текущих настроек шлюза.