Source: https://aiprimetech.io/ru/claude-code/subagents/

[Главная](/ru/) › [Claude Code](/ru/claude-code/) › Субагенты

[Обзор](/ru/claude-code/)[Установка](/ru/claude-code/install/)[Справочник CLI](/ru/claude-code/cli/)[Цены и лимиты](/ru/claude-code/pricing/)[Agent SDK](/ru/claude-code/sdk/)[Навыки и плагины](/ru/claude-code/skills/)[GitHub](/ru/claude-code/github/)[Веб, настольное приложение и IDE](/ru/claude-code/web-and-desktop/)[Модели](/ru/claude-code/models/)[Ошибки](/ru/claude-code/errors/)[Открытый исходный код?](/ru/claude-code/open-source/)[Практическое руководство](/ru/claude-code/tutorial/)[Для студентов](/ru/claude-code/for-students/)[Автоматизация QA](/ru/claude-code/qa-automation/)[Сравнение с Cursor](/ru/claude-code/vs-cursor/)[Сравнение с Codex и OpenCode](/ru/claude-code/vs-codex/)[Субагенты](/ru/claude-code/subagents/)[Хуки](/ru/claude-code/hooks/)[MCP](/ru/claude-code/mcp/)[Экосистема](/ru/claude-code/ecosystem/)[VS Code](/ru/claude-code/vscode/)[OpenRouter](/ru/claude-code/openrouter/)[Ограничения частоты запросов](/ru/claude-code/rate-limits/)[Руководство на китайском языке](/claude-code/zh/)

Последнее обновление: 11 октября 2026

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

Субагент — это отдельный исполнитель Claude Code со своим системным промптом, собственными разрешениями на использование инструментов и, что особенно важно, своим контекстным окном. Основная сессия делегирует ему задачу, получает краткий результат, а её контекст остаётся чистым. При грамотном использовании субагенты позволяют сессии работать весь день вместо того, чтобы терять эффективность уже через час.

## TLDR
- Определите субагента как Markdown-файл в .claude/agents/ (для проекта) или ~/.claude/agents/ (пользовательские): метаданные в начале файла задают name, description, tools, model; основной текст служит системным промптом.
- Claude делегирует задачу автоматически, когда она соответствует описанию, или явно, когда вы указываете имя агента.
- У каждого субагента собственный контекст и отдельный расход оплачиваемых токенов; результаты возвращаются в кратком виде.
- /agents создаёт их и управляет ими; команды агентов развивают эту идею до координации сессий.

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

```
# .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 охватывает их всех. На безлимитном тарифе с фиксированной платой параллельная работа становится вопросом добросовестного использования, а не оплаты, поэтому пользователи с высокой нагрузкой от нескольких агентов обычно переходят на такой тариф. 

 | План | Срок действия | Цена

 | Безлимит на 1 час | 1 час | $1

 | Безлимит на 24 часов | 24 часа | $10

 | Безлимит на 1 неделю | 1 неделя | $49

 | Безлимит на 15 дней | 15 дней | $89

[Все безлимитные тарифы →](/ru/plans/)

## Сначала попробуйте бесплатно

Новые аккаунты получают $5 бесплатного баланса для API по коду CLAUDECODE — этого хватит на вечер работы с Claude Code на Sonnet — затем кредиты с балансом в 7.69231 раза больше номинала.

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

[Создать аккаунт с кодом CLAUDECODE](/register?promo=CLAUDECODE)

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

Что такое субагент в Claude Code?

Отдельный агент со своим системным промптом, разрешениями на инструменты, выбранной моделью и контекстным окном, описанный в Markdown-файле в .claude/agents/, которому основная сессия делегирует задачи.Где находится документация по субагентам Claude Code?

Официальный справочник находится в документации Anthropic по Claude Code, в разделе Sub-agents; эта страница — практическое руководство по формату файлов, условиям делегирования и стоимости.Нужно ли доплачивать за субагентов?

Их токены оплачиваются отдельно, как и токены любого запроса. Они экономят деньги в длинных сессиях, не допуская попадания больших объёмов прочитанных данных в родительский контекст, но обходятся дороже, если запускать много субагентов параллельно на Opus.Что такое команды агентов?

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

## Запускайте Claude Code через шлюз

Те же модели, две переменные окружения, кредиты с балансом в 7.69231 раза больше номинала — или безлимитный тариф с фиксированной оплатой. Для новых аккаунтов: $5 бесплатного баланса для API по коду CLAUDECODE.[Получить API-ключ](/register?promo=CLAUDECODE) [Посмотреть безлимитные тарифы](/ru/plans/)

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

## Другие руководства по Claude Code

[Claude Code: полное руководство](/ru/claude-code/)[Как установить Claude Code](/ru/claude-code/install/)[Документация CLI Claude Code: команды и флаги](/ru/claude-code/cli/)[Цены и лимиты Claude Code: подробное объяснение](/ru/claude-code/pricing/)[Claude Code SDK, теперь Claude Agent SDK](/ru/claude-code/sdk/)[Навыки и плагины Claude Code](/ru/claude-code/skills/)[Claude Code в GitHub: App, Action и @claude](/ru/claude-code/github/)[Есть ли у Claude Code веб-интерфейс? Веб-версия, настольное приложение и IDE](/ru/claude-code/web-and-desktop/)[Какую модель использует Claude Code и как её изменить](/ru/claude-code/models/)[Ошибки Claude Code и способы их исправления](/ru/claude-code/errors/)[Открыт ли исходный код Claude Code?](/ru/claude-code/open-source/)[Практическое руководство по Claude Code: ваш первый полноценный сеанс](/ru/claude-code/tutorial/)[Claude для студентов: Claude Code, API и что на самом деле дают образовательные программы](/ru/claude-code/for-students/)[Как использовать Claude Code для автоматизации QA](/ru/claude-code/qa-automation/)[Claude Code и Cursor: что и когда выбрать — и как использовать оба инструмента](/ru/claude-code/vs-cursor/)[Claude Code, Codex и OpenCode: сравнение терминальных агентов](/ru/claude-code/vs-codex/)[Хуки Claude Code: детерминированный контроль над действиями агента](/ru/claude-code/hooks/)[MCP в Claude Code: подключение серверов, области действия, удалённый MCP и реальные примеры](/ru/claude-code/mcp/)[Экосистема Claude Code: маршрутизаторы, фреймворки, плагины и списки, в которых они собраны](/ru/claude-code/ecosystem/)[Claude Code в VS Code: расширение, работа через терминал и ошибки](/ru/claude-code/vscode/)[Как использовать OpenRouter в Claude Code и когда этого делать не стоит](/ru/claude-code/openrouter/)[Ошибка ограничения частоты запросов Claude: что означает «API error: rate limit reached» и как её исправить](/ru/claude-code/rate-limits/)[Как пользоваться Claude Code: от установки до повседневной работы](/claude-code/zh/)