Управление несколькими агентами с помощью представления агентов
Отправляйте и управляйте множеством сеансов Claude Code с одного экрана. Agent view показывает, что делает каждый сеанс и какие из них требуют вашего ввода.
Agent view, открываемое с помощью claude agents, — это один экран для всех ваших фоновых сеансов: что работает, что требует вашего ввода и что завершено. Отправляйте новые сеансы, наблюдайте их состояние с первого взгляда вместо прокрутки стенограмм и вмешивайтесь только когда один из них требует вас. Сеансы продолжают работать в фоне без подключённого терминала.
Используйте agent view, когда у вас есть несколько независимых задач, над которыми Claude может работать одновременно, таких как исправление ошибки, проверка pull request или исследование журнала. Когда вы хотите совместно решить проблему, подключитесь к сеансу и используйте Claude Code интерактивно как обычно.
Сеансы в agent view работают независимо и отчитываются только перед вами. Для сравнения с subagents, agent teams и worktrees см. Запуск агентов параллельно.
На этой странице рассматривается:
- Быстрый старт
- Мониторинг сеансов с помощью agent view, включая значки состояния, просмотр и ответы, подключение, организацию и сочетания клавиш
- Отправка новых агентов из agent view, из внутри сеанса или из оболочки
- Управление сеансами из оболочки
- Как размещаются фоновые сеансы процессом супервизора
Quick start
Это пошаговое руководство открывает agent view, отправляет сеанс, отвечает из панели просмотра и подключается для полной беседы.
Открыть agent view
Из вашей оболочки запустите:
claude agents
Agent view открывается с вводом внизу и таблицей, которая заполняется по мере запуска сеансов. Нажмите Esc в любой момент для выхода. Ваши сеансы продолжают работать.
Отправить сеанс
Введите подсказку в поле ввода и нажмите Enter. Запускается новый сеанс и появляется как строка, показывающая, работает ли он, ждёт ли вас или завершён. Повторите, чтобы запустить столько сеансов параллельно, сколько вам нравится.
Просмотр и ответ
Выберите строку с помощью клавиш со стрелками и нажмите Space, чтобы увидеть, что делает сеанс или что он от вас требует. Введите ответ и нажмите Enter, чтобы отправить его, не покидая agent view.
Подключение и отключение
Нажмите Enter или → на строке для подключения, когда вам нужна полная беседа. Сеанс захватывает терминал точно так же, как если бы вы запустили claude. Нажмите ← на пустой подсказке для отключения и возврата к таблице.
Чтобы перенести существующий интерактивный сеанс в agent view, запустите /bg внутри него или нажмите ← на пустой подсказке, чтобы отправить сеанс в фон и открыть agent view за один шаг. Сеанс продолжает работать в фоне и появляется как строка. Чтобы запустить новый фоновый сеанс прямо из оболочки, запустите claude --bg "<prompt>".
Вы можете использовать claude agents как основную точку входа вместо claude: отправляйте каждую задачу из agent view, подключайтесь, когда вам нужна полная беседа, и нажимайте ← для возврата к таблице.
Monitor sessions with agent view
Запустите claude agents для открытия agent view. Он захватывает весь терминал и перечисляет каждый сеанс, сгруппированный по состоянию, с закреплёнными сеансами и теми, которые требуют вас в верхней части. Каждая строка показывает имя сеанса, текущую активность и как давно он в последний раз изменился.
Список глобален для вашей машины и включает каждый фоновый сеанс независимо от того, в каком проекте или worktree он работает. Интерактивные сеансы, открытые в других терминалах, не появляются до тех пор, пока вы не отправите их в фон, и subagents, работающие внутри сеанса, не указаны как отдельные строки.
Pinned
✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m
Ready for review
∙ jump physics github.com/anthropics/example/pull/2048 2h
Needs input
✻ power-up design needs input: double jump or wall climb? 1m
Working
✽ collision detection Edit src/physics/CollisionSystem.ts 2m
✢ playtest level 3 run 12 · all checkpoints cleared in 4m
Completed
✻ title screen result: menu, options, and credits done 9m
∙ sound effects result: 14 SFX exported to assets/audio 4h
… 6 more
Значок показывает состояние сеанса:
| Значок | Состояние | Что это означает |
|---|---|---|
| Анимированный | Working | Claude активно запускает инструменты или генерирует ответ |
| Жёлтый | Needs input | Claude ждёт вашего ввода, обычно решение о разрешении или ответ |
| Затемнённый | Idle | Сеанс ждёт ввода, но не заблокирован на конкретный вопрос |
| Зелёный | Completed | Задача успешно завершена |
| Красный | Failed | Задача завершилась с ошибкой |
| Серый | Stopped | Сеанс был остановлен с помощью Ctrl+X или claude stop |
Форма значка показывает, работает ли базовый процесс. ✻ или анимированный ✽ во время работы Claude означает, что сеанс активен и вы можете ответить на него немедленно. ∙ означает, что процесс завершился, но вы всё ещё можете просмотреть, ответить или подключиться: Claude перезапускает сеанс с того места, где он остановился. ✢ — это сеанс /loop, спящий между итерациями, со строкой, показывающей количество запусков и обратный отсчёт до следующей итерации.
Фоновые сеансы не требуют открытого терминала для продолжения работы. Отдельный процесс супервизора их запускает, поэтому вы можете закрыть agent view, закрыть оболочку или запустить новый интерактивный сеанс, и ваша отправленная работа продолжает выполняться.
Сеансы сохраняются на диск: закрытие терминала или автоматическое обновление не теряет их, и повторное открытие claude agents показывает их все. Если ваша машина переходит в спящий режим или выключается, работающие сеансы останавливаются; перезапустите их с помощью claude respawn --all.
Однострочное резюме в каждой строке генерируется вашей настроенной моделью класса Haiku, поэтому строка может сказать вам, что делает сеанс, что ему требуется или что он произвёл, без открытия стенограммы. Каждое резюме — это один короткий запрос класса Haiku через вашего обычного поставщика, выставляемый и обрабатываемый в соответствии с теми же условиями использования данных, что и сам сеанс.
Когда сеанс открывает pull request, строка показывает ссылку PR и индикатор статуса для его проверок CI. Для большинства задач эта строка — это то, как вы собираете работу: проверьте и объедините pull request, когда его проверки пройдут.
Peek and reply
Нажмите Space на выбранной строке, чтобы открыть панель просмотра. Она показывает, что требуется сеансу от вас, его последний вывод и любые pull requests, которые он открыл. В большинстве случаев этого достаточно, и вам никогда не нужно открывать полную стенограмму.
Введите ответ в панель просмотра и нажмите Enter, чтобы отправить его этому сеансу. Когда сеанс задаёт вопрос с несколькими вариантами ответов, панель просмотра показывает варианты и вы можете нажать цифровую клавишу для выбора одного. Для других заблокированных сеансов нажмите Tab, чтобы заполнить ввод предложенным ответом, который вы можете отредактировать перед отправкой. Начните ответ с !, чтобы отправить команду Bash вместо этого.
Используйте ↑ и ↓ для просмотра соседних сеансов без закрытия панели или → для подключения.
Attach to a session
Нажмите Enter или → на выбранной строке для подключения или нажмите Alt+1 через Alt+9 для прямого подключения к N-му сеансу в сфокусированной группе. Agent view заменяется полным интерактивным сеансом, точно так же, как если бы вы запустили claude в этом каталоге. При подключении Claude публикует краткое резюме того, что произошло, пока вас не было.
При подключении сеанс ведёт себя как любой другой сеанс Claude Code: каждая команда, сочетание клавиш и функция работают.
Нажмите ← на пустой подсказке для отключения и возврата к agent view. Если диалог имеет фокус и не реагирует на ←, нажмите Ctrl+Z для немедленного отключения.
Отключение никогда не останавливает фоновый сеанс: ←, Ctrl+C, Ctrl+D, Ctrl+Z и /exit оставляют его работающим. Чтобы завершить сеанс изнутри, запустите /stop.
После использования agent view нажатие ← на пустой подсказке работает из любого сеанса Claude Code, а не только из тех, к которым вы подключались. Он открывает agent view с вашим текущим сеансом предварительно выбранным, поэтому вы можете переключаться между сеансами без выхода из терминала.
Organize the list
Agent view группирует сеансы по состоянию, с сеансами, требующими ввода выше сеансов, которые работают или завершены. Нажмите Ctrl+S для переключения на группировку по каталогу вместо этого. Ваш выбор сохраняется между запусками. В группе закрепите сеанс в верхней части с помощью Ctrl+T, переупорядочьте с помощью Shift+↑ и Shift+↓ или нажмите Enter на заголовке группы для её свёртывания. Чтобы удалить сеанс, нажмите Ctrl+X для его остановки и Ctrl+X снова в течение двух секунд для удаления. Нажатие Ctrl+X на заголовке группы удаляет каждый сеанс в этой группе после подтверждения.
Более старые завершённые сеансы складываются в строку "… N more" для сохранения списка коротким. Сбои и сеансы с открытым pull request всегда остаются видимыми.
Filter the list
Введите в поле отправки для фильтрации вместо отправки:
| Фильтр | Показывает |
|---|---|
a:<name> |
Сеансы, запускающие названного агента |
s:<state> |
Сеансы в данном состоянии, такие как s:blocked для сеансов, требующих вас |
#<number> или URL pull request |
Сеанс, работающий над этим pull request |
Keyboard shortcuts
Нажмите ? в agent view, чтобы увидеть каждое сочетание клавиш. Наиболее распространённые:
| Сочетание клавиш | Действие |
|---|---|
↑ / ↓ |
Перемещение между строками |
Enter |
Подключение к выбранному сеансу или отправка, если в поле ввода есть текст |
Space |
Открытие или закрытие панели просмотра для выбранного сеанса |
Shift+Enter |
Отправка и немедленное подключение |
→ |
Подключение к выбранному сеансу |
Alt+1..Alt+9 |
Подключение к N-му сеансу в сфокусированной группе |
Tab |
Просмотр всех subagents или применение выделенного предложения |
Ctrl+S |
Переключение группировки между состоянием и каталогом |
Ctrl+T |
Закрепление или открепление выбранного сеанса |
Ctrl+R |
Переименование выбранного сеанса |
Ctrl+G |
Открытие подсказки отправки в вашем $EDITOR |
Ctrl+X |
Остановка сеанса; нажмите снова в течение двух секунд для удаления |
Shift+↑ / Shift+↓ |
Переупорядочение выбранного сеанса |
Esc |
Закрытие панели просмотра, очистка ввода или выход |
Ctrl+C |
Очистка ввода; нажмите дважды для выхода |
? |
Показать все сочетания клавиш |
Dispatch new agents
Вы можете отправлять новые фоновые сеансы из agent view, отправлять существующий интерактивный сеанс в фон или запустить один прямо из оболочки.
From agent view
Введите подсказку в поле ввода внизу agent view и нажмите Enter для запуска нового фонового сеанса. Сеанс автоматически называется из подсказки. Вы можете переименовать его позже с помощью Ctrl+R. Вставьте изображение в подсказку, чтобы включить снимок экрана или диаграмму с задачей.
Префиксируйте или упомяните части подсказки для управления тем, как запускается сеанс:
| Ввод | Эффект |
|---|---|
<agent-name> <prompt> |
Если первое слово совпадает с именем пользовательского subagent, этот subagent запускается как основной агент сеанса с конфигурацией из его frontmatter |
@<agent-name> |
Упомяните пользовательского subagent в любом месте подсказки для запуска его как основного агента |
@<repo> |
Упомяните репозиторий в каталоге, из которого вы открыли agent view, для запуска сеанса там |
/<skill> |
Предложите skills для отправки как подсказку |
#<number> или URL pull request |
Если сеанс уже работает над этим PR, выберите его вместо отправки |
Shift+Enter |
Отправка и немедленное подключение к новому сеансу |
Введите / для отправки skill. Упаковка повторяющейся задачи как skill позволяет вам запускать один и тот же рабочий процесс много раз из agent view без переввода подсказки. Нажмите Tab на пустом вводе для просмотра каждого dispatchable subagent или для применения выделенного предложения, когда предложения показываются.
Dispatch to a specific directory
Новый сеанс запускается в каталоге, из которого вы открыли agent view. Для целевого другого каталога:
- Откройте
claude agentsв этом каталоге. - Откройте
claude agentsв родительском каталоге, который содержит несколько репозиториев, и упомяните один с@<repo>в подсказке для запуска сеанса там. - Из оболочки
cdв каталог и запуститеclaude --bg "<prompt>".
Когда agent view сгруппирован по каталогу, каталог выделенной строки становится целью отправки, поэтому вы можете прокрутить к группе и отправить в неё без переввода пути.
Isolate file edits in a worktree
Сеансы, отправленные из agent view, по умолчанию используют ваш рабочий каталог, поэтому два агента, редактирующие одни и те же файлы, могут конфликтовать. Чтобы предотвратить это, Claude Code блокирует сеанс, отправленный из agent view, от записи файлов до тех пор, пока он не переместится в изолированный git worktree. Claude обрабатывает это автоматически, когда ему нужно редактировать файлы. Worktree создаётся под .claude/worktrees/ внутри каталога проекта и удаляется при удалении сеанса. Удаление сеанса также удаляет его worktree, поэтому объедините или отправьте изменения, которые вы хотите сохранить, перед удалением.
Чтобы сделать subagent всегда запускаемым в его собственном worktree независимо от того, как он был запущен, установите isolation: worktree в его frontmatter.
From inside a session
Запустите /background или его псевдоним /bg для отключения текущей беседы и её продолжения работы. Передайте подсказку, такую как /bg run the test suite and fix any failures, для отправки одной дополнительной инструкции перед отключением.
From the shell
Передайте --bg для запуска сеанса, который идёт прямо в фон:
claude --bg "investigate the flaky SettingsChangeDetector test"
Чтобы запустить конкретного subagent как основного агента сеанса, объедините --bg с --agent:
claude --agent code-reviewer --bg "address review comments on PR 1234"
После отправки в фон Claude выводит короткий ID сеанса и команды для его управления:
backgrounded · 7c5dcf5d
claude agents list sessions
claude attach 7c5dcf5d open in this terminal
claude logs 7c5dcf5d show recent output
claude stop 7c5dcf5d stop this session
Manage sessions from the shell
Каждый фоновый сеанс имеет короткий ID, который вы можете использовать из оболочки. Эти команды полезны для написания скриптов или когда вы не хотите открывать agent view.
| Команда | Назначение |
|---|---|
claude agents |
Открыть agent view |
claude attach <id> |
Подключиться к сеансу в этом терминале |
claude logs <id> |
Вывести последний вывод сеанса |
claude stop <id> |
Остановить сеанс. Также принимает claude kill |
claude respawn <id> |
Перезапустить остановленный сеанс с его беседой нетронутой |
claude respawn --all |
Перезапустить каждый остановленный сеанс |
claude rm <id> |
Удалить сеанс из списка |
How background sessions are hosted
Фоновые сеансы размещаются процессом супервизора для каждого пользователя, отдельным от вашего терминала и от agent view. Он запускается автоматически в первый раз, когда вы отправляете сеанс в фон или открываете agent view, и вы не управляете им напрямую. Супервизор и его сеансы аутентифицируются с теми же учётными данными, что и ваши интерактивные сеансы, и не делают дополнительных сетевых подключений за пределами API модели.
Каждый фоновый сеанс — это его собственный процесс Claude Code, родительский для супервизора, а не для вашего терминала. Сеанс, который активно работает, ждёт вашего ввода или имеет подключённый терминал, сохраняет свой процесс работающим. После завершения сеанса и его неподключённого состояния примерно час супервизор останавливает его процесс для освобождения ресурсов. Стенограмма и состояние остаются на диске, и в следующий раз, когда вы подключитесь, посмотрите или ответите, супервизор запускает свежий процесс с того места, где он остановился. Когда каждый сеанс завершён и ни один терминал не подключён, сам супервизор выходит и запускается снова в следующий раз, когда вы отправляете сеанс в фон или открываете agent view.
Супервизор наблюдает установленный двоичный файл Claude Code на диске и перезапускается в новую версию после того, как обычный auto-updater его заменит. Это локальное наблюдение файла, а не сетевая проверка. Фоновые сеансы — это отсоединённые процессы, поэтому они продолжают работать через перезагрузку и новый супервизор переподключается к ним.
Состояние сеанса хранится в каталоге конфигурации Claude Code. Если вы установили CLAUDE_CONFIG_DIR, супервизор использует этот каталог вместо ~/.claude и запускается как отдельный экземпляр со своими собственными сеансами.
| Путь | Содержимое |
|---|---|
~/.claude/daemon.log |
Журнал супервизора |
~/.claude/daemon/roster.json |
Список работающих фоновых сеансов, используется для переподключения после перезагрузки |
~/.claude/jobs/<id>/state.json |
Состояние для каждого сеанса, показанное в agent view |
Чтобы полностью отключить фоновых агентов и agent view, установите параметр disableAgentView setting на true или установите переменную окружения CLAUDE_CODE_DISABLE_AGENT_VIEW. Администраторы могут применить это через управляемые настройки.
Troubleshooting
Agent view opens with no sessions
Agent view пуст до тех пор, пока вы не отправите свой первый сеанс. Введите подсказку в поле ввода внизу и нажмите Enter.
Sessions show as stopped after waking your machine
Фоновые сеансы не выживают при спящем режиме или выключении. Подключитесь, посмотрите или ответьте на любой остановленный сеанс, и он перезапустится с того места, где он остановился. Чтобы перезапустить все сразу, запустите claude respawn --all.
A session is slow to respond after attaching
После завершения сеанса и его неподключённого состояния примерно час супервизор останавливает его процесс для освобождения ресурсов. Подключение запускает свежий процесс с того места, где он остановился, что занимает момент. Сеансы, которые работают или ждут вас, никогда не останавливаются таким образом.
.claude/worktrees/ is filling up
Worktrees удаляются при удалении сеанса, который их создал. Если сеанс завершился без очистки, перечислите оставшиеся записи с помощью git worktree list в каталоге проекта и удалите каждую с помощью git worktree remove <path>. См. Clean up worktrees.
Limitations
Agent view — это исследовательский предпросмотр. Текущие ограничения, о которых следует знать:
- Применяются ограничения скорости: фоновые сеансы снижают использование вашей подписки так же, как интерактивные сеансы, поэтому запуск десяти агентов параллельно использует квоту в десять раз быстрее.
- Сеансы локальны: фоновые сеансы работают на вашей машине и останавливаются, если она переходит в спящий режим или выключается.
- Worktrees удаляются с сеансом: объедините или отправьте изменения перед удалением сеанса, который редактировал файлы в его собственном worktree.
Следующие шаги
Теперь, когда вы понимаете agent view, изучите эти связанные функции:
- Запуск агентов параллельно: сравните agent view с subagents, agent teams и worktrees
- Subagents: определите переиспользуемые конфигурации агентов с пользовательскими подсказками, инструментами и изоляцией
- Agent teams: координируйте несколько сеансов, которые обмениваются сообщениями друг с другом
- Claude Code on the web: запускайте сеансы в управляемой облачной среде вместо локально