# Что такое субагент?

URL: https://agentvera.dev/ru/glossary/subagent/

Субагент — это вспомогательный агент, которого основной кодинг-агент запускает, чтобы передать ему конкретную задачу. У него свои контекстное окно, инструкции и права на инструменты, а по завершении он возвращает только краткий итог, поэтому основной диалог не забивается подробностями.

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

**Как описать субагентов в Claude Code.** В Claude Code субагенты — это Markdown-файлы с YAML-frontmatter. Субагенты проекта лежат в .claude/agents/, личные — в ~/.claude/agents/; управлять ими можно и командой /agents.

- name и description: как называется субагент и когда его использовать. Основной агент решает по этому описанию.
- tools: какими инструментами он может пользоваться, например только инструментами чтения для ревьюера.
- model: при желании другая модель для субагента.
- Тело файла — системный промпт субагента.

**Когда субагенты помогают.** Больше всего пользы от субагентов, когда нужно сохранить основной диалог чистым.

- Исследование с чтением множества файлов: подробности остаются в субагенте, а основной контекст небольшим.
- Узкие роли: проверка безопасности, написание тестов, документация.
- Параллельное изучение: несколько субагентов одновременно просматривают разные модули.

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

**Субагенты в AgentVera.** AgentVera делает видимыми субагентов, которых запускает Claude Code. В представлении Subagents окна «тур по проекту и карта кода» перечислены субагенты, запущенные агентом Claude Code.

- **Чем субагент отличается от отдельной сессии агента?** Основной агент запускает субагента и получает его результат; вы обычно видите только итог. Отдельная сессия работает сама по себе, и вы общаетесь с ней напрямую.
- **Экономят ли субагенты токены?** Они сохраняют контекст основного диалога небольшим, что помогает в долгих сессиях. Но собственное чтение субагента тоже стоит токенов, поэтому общий расход может вырасти.
- **Может ли субагент править файлы?** Это зависит от инструментов, разрешённых в его описании. Субагент, которому доступны только Read, Grep и Glob, может читать код, но не менять его.
- **Где хранить файлы субагентов?** Те, которыми должна пользоваться вся команда, кладите в .claude/agents/ в проекте; те, что нужны только вам, — в ~/.claude/agents/. Файлы в папке проекта доходят до команды через git.

---

**Об AgentVera.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/