Управление несколькими агентами с помощью представления агентов

Отправляйте и управляйте множеством сеансов 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, из внутри сеанса или из оболочки
• Управление сеансами из оболочки
• Как размещаются фоновые сеансы процессом супервизора

Быстрый старт

Это пошаговое руководство открывает agent view, отправляет сеанс, отвечает из панели просмотра и подключается для полной беседы.

claude agents

Чтобы перенести существующий интерактивный сеанс в agent view, запустите /bg внутри него или нажмите ← на пустой подсказке, чтобы отправить сеанс в фон и открыть agent view за один шаг. Сеанс продолжает работать в фоне и появляется как строка. Чтобы запустить новый фоновый сеанс прямо из оболочки, запустите claude --bg "<prompt>".

Вы можете использовать claude agents как основную точку входа вместо claude: отправляйте каждую задачу из agent view, подключайтесь, когда вам нужна полная беседа, и нажимайте ← для возврата к таблице.

Мониторинг сеансов с помощью agent view

Запустите claude agents для открытия agent view. Он захватывает весь терминал и перечисляет каждый сеанс, сгруппированный по состоянию, с закреплёнными сеансами и теми, которые требуют вас в верхней части. Каждая строка показывает имя сеанса, текущую активность и как давно он в последний раз изменился.

Список охватывает каждый фоновый сеанс в вашей директории конфигурации, независимо от того, в каком проекте или worktree он работает, поэтому сеанс, запущенный в одном репозитории, и другой, запущенный в другом 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

Значок каждой строки несёт два сигнала. Индикатор показывает состояние сеанса, а форма значка показывает, работает ли базовый процесс. Состояния следующие:

Форма значка показывает, работает ли базовый процесс. ✻ или анимированный ✽ во время работы Claude означает, что сеанс активен и вы можете ответить на него немедленно. ∙ означает, что процесс завершился, но вы всё ещё можете просмотреть, ответить или подключиться: Claude перезапускает сеанс с того места, где он остановился. ✢ — это сеанс /loop, спящий между итерациями, со строкой, показывающей количество запусков и обратный отсчёт до следующей итерации.

Фоновые сеансы не требуют открытого терминала для продолжения работы. Отдельный процесс супервизора их запускает, поэтому вы можете закрыть agent view, закрыть оболочку или запустить новый интерактивный сеанс, и ваша отправленная работа продолжает выполняться.

Сеансы сохраняются на диск: закрытие терминала или автоматическое обновление не теряет их, и повторное открытие claude agents показывает их все. Если ваша машина переходит в спящий режим или выключается, работающие сеансы останавливаются; перезапустите их с помощью claude respawn --all.

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

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

Для большинства задач эта строка — это то, как вы собираете результат: проверьте и объедините 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.

После того как вы отправили или отправили сеанс в фон, нажатие ← на пустой подсказке работает из любого сеанса Claude Code, а не только из тех, к которым вы подключались из agent view. Он отправляет текущий сеанс в фон и открывает agent view с этим сеансом предварительно выбранным, поэтому вы можете переключаться между сеансами без выхода из терминала. Вы можете отключить это сочетание клавиш в /config.

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

Введите в поле отправки для фильтрации вместо отправки:

Keyboard shortcuts

Нажмите ? в agent view, чтобы увидеть каждое сочетание клавиш. Наиболее распространённые:

Dispatch new agents

Вы можете отправлять новые фоновые сеансы из agent view, отправлять существующий интерактивный сеанс в фон или запустить один прямо из оболочки.

From agent view

Введите подсказку в поле ввода внизу agent view и нажмите Enter для запуска нового фонового сеанса. Сеанс автоматически называется из подсказки. Вы можете переименовать его позже с помощью Ctrl+R. Вставьте изображение в подсказку, чтобы включить снимок экрана или диаграмму с задачей.

Префиксируйте или упомяните части подсказки для управления тем, как запускается сеанс:

Введите / для отправки skill. Упаковка повторяющейся задачи как skill позволяет вам запускать один и тот же рабочий процесс много раз из agent view без переввода подсказки. Нажмите Tab на пустом вводе для просмотра каждого dispatchable subagent или для применения выделенного предложения, когда предложения показываются.

Когда одно и то же имя @name совпадает как с subagent, так и с соседним репозиторием, subagent имеет приоритет. Форма первого слова без @ также применяется к любому имени subagent, поэтому подсказка, начинающаяся со слова, совпадающего с одним из имён ваших subagent, отправляет этот subagent. Используйте форму @ когда вы хотите быть явным.

Dispatch to a specific directory

Новый сеанс запускается в каталоге, из которого вы открыли agent view. Для целевого другого каталога:

• Откройте claude agents в этом каталоге.
• Откройте claude agents в родительском каталоге, который содержит несколько репозиториев, и упомяните один с @<repo> в подсказке для запуска сеанса там.
• Из оболочки cd в каталог и запустите claude --bg "<prompt>".

Когда agent view сгруппирован по каталогу, каталог выделенной строки становится целью отправки, поэтому вы можете прокрутить к группе и отправить в неё без переввода пути.

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

How file edits are isolated

Каждый фоновый сеанс, запущенный ли из agent view, /bg или claude --bg, запускается в вашем рабочем каталоге, но блокируется от записи файлов туда. Когда сеансу нужно редактировать файлы, Claude автоматически перемещает его в изолированный git worktree под .claude/worktrees/, поэтому параллельные сеансы могут читать один и тот же checkout, но каждый пишет в свой собственный. Блокировка не применяется, когда сеанс уже находится внутри worktree, когда рабочий каталог не является git репозиторием или к записям вне рабочего каталога.

Worktree удаляется при удалении сеанса, поэтому объедините или отправьте изменения, которые вы хотите сохранить, перед удалением. Чтобы найти путь worktree сеанса, посмотрите сеанс или подключитесь и проверьте его рабочий каталог.

Чтобы сделать subagent всегда запускаемым в его собственном worktree независимо от того, как он был запущен, установите isolation: worktree в его frontmatter.

Permission mode and settings

Отправленный сеанс читает свои settings и permission mode из каталога, в котором он запускается, так же как если бы вы запустили claude там. Отправка из входа agent view не передаёт режим разрешений, поэтому сеанс использует defaultMode из settings этого каталога или permissionMode из frontmatter отправленного subagent.

Чтобы установить режим из оболочки, передайте --permission-mode с claude --bg. Использование bypassPermissions или auto таким образом отказывается до тех пор, пока вы не примете этот режим, запустив claude с ним один раз интерактивно, так как эти режимы позволяют сеансу, который вы не наблюдаете, действовать без одобрения.

Manage sessions from the shell

Каждый фоновый сеанс имеет короткий ID, который вы можете использовать из оболочки. Эти команды полезны для написания скриптов или когда вы не хотите открывать agent view.

How background sessions are hosted

Фоновые сеансы размещаются процессом супервизора для каждого пользователя, отдельным от вашего терминала и от agent view. Он запускается автоматически в первый раз, когда вы отправляете сеанс в фон или открываете agent view, и вы не управляете им напрямую. Супервизор и его сеансы аутентифицируются с теми же учётными данными, что и ваши интерактивные сеансы, и не делают дополнительных сетевых подключений за пределами API модели.

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

Супервизор наблюдает установленный двоичный файл Claude Code на диске и перезапускается в новую версию после того, как обычный auto-updater его заменит. Это локальное наблюдение файла, а не сетевая проверка. Фоновые сеансы — это отсоединённые процессы, поэтому они продолжают работать через перезагрузку и новый супервизор переподключается к ним.

Состояние сеанса хранится в каталоге конфигурации Claude Code. Если вы установили CLAUDE_CONFIG_DIR, супервизор использует этот каталог вместо ~/.claude и запускается как отдельный экземпляр со своими собственными сеансами.

Чтобы полностью отключить фоновых агентов и 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.

Ограничения

Agent view — это исследовательский предпросмотр. Текущие ограничения, о которых следует знать:

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

Следующие шаги

Теперь, когда вы понимаете agent view, изучите эти связанные функции:

• Запуск агентов параллельно: сравните agent view с subagents, agent teams и worktrees
• Subagents: определите переиспользуемые конфигурации агентов с пользовательскими подсказками, инструментами и изоляцией
• Agent teams: координируйте несколько сеансов, которые обмениваются сообщениями друг с другом
• Claude Code on the web: запускайте сеансы в управляемой облачной среде вместо локально