Agent view, открываемое с помощьюDocumentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
claude agents, — это один экран для всех ваших фоновых сеансов: что работает, что требует вашего ввода и что завершено. Отправляйте новые сеансы, наблюдайте их состояние с первого взгляда вместо прокрутки стенограмм и вмешивайтесь только когда один из них требует вас. Каждый фоновый сеанс — это полная беседа Claude Code, которая продолжает работать без подключённого терминала, поэтому вы можете открыть его, ответить и уйти в любой момент.
Agent view находится в исследовательском предпросмотре и требует Claude Code v2.1.139 или позже. Проверьте вашу версию с помощью
claude --version. Интерфейс и сочетания клавиш могут измениться по мере развития функции.- Быстрый старт: дайте Claude задачу для работы в фоне, проверьте её и вмешайтесь, когда это необходимо
- Мониторинг сеансов с помощью agent view, включая значки состояния, просмотр и ответы, подключение, организацию и сочетания клавиш
- Отправка новых агентов из agent view, из внутри сеанса или из вашей оболочки
- Управление сеансами из оболочки
- Как размещаются фоновые сеансы процессом супервизора
Быстрый старт
Это пошаговое руководство охватывает основной цикл agent view: отправьте задачу, смотрите, как её строка обновляется по мере работы Claude, посмотрите, чтобы проверить её, и ответьте, а затем подключитесь для полной беседы. Сеанс, который вы отправляете, продолжает работать после закрытия agent view, поэтому вы можете уйти и вернуться к нему позже.Открыть agent view
Из вашей оболочки запустите:Agent view открывается с вводом внизу и таблицей, которая заполняется по мере запуска сеансов. Нажмите
Esc в любой момент для возврата в вашу оболочку. Ваши сеансы продолжают работать, пока вас нет, и снова появляются в следующий раз, когда вы откроете agent view.Отправить сеанс
Введите подсказку, описывающую задачу, и нажмите
Enter. Запускается новый фоновый сеанс для этой задачи и появляется как строка, показывающая, работает ли он, ждёт ли вас или завершён. Новый сеанс использует модель, показанную в заголовке agent view, и тот же режим разрешений, который вы получили бы при запуске claude в этом каталоге.Каждая подсказка, которую вы вводите здесь, запускает свой собственный новый сеанс. Ввод другой подсказки и нажатие Enter запускает второй сеанс рядом с первым, а не отправляет ему продолжение. Таким образом вы можете запустить несколько параллельно.Каждый сеанс использует вашу квоту подписки независимо, поэтому см. Ограничения перед отправкой множества сеансов одновременно.Просмотр и ответ
Выберите строку с помощью клавиш со стрелками и нажмите
Space, чтобы открыть панель просмотра. Она показывает самый последний результат сеанса или вопрос, на который он ждёт ответа, а не полную стенограмму. Введите ответ и нажмите Enter, чтобы отправить его, не покидая agent view.Подключение и отключение
Нажмите
Enter или → на строке для подключения, когда вам нужна полная беседа. Сеанс захватывает терминал точно так же, как если бы вы запустили claude. Нажмите ← на пустой подсказке для отключения и возврата к таблице.Перенести существующий сеанс
Чтобы переместить сеанс, который у вас уже открыт, в agent view, запустите
/bg внутри него или нажмите ← на пустой подсказке, чтобы отправить его в фон и открыть agent view за один шаг. Сеанс продолжает работать и появляется как строка рядом с теми, которые вы отправили.claude agents как основную точку входа вместо claude: отправляйте каждую задачу из agent view, подключайтесь, когда вам нужна полная беседа, и нажимайте ← для возврата к таблице.
Мониторинг сеансов с помощью agent view
Запуститеclaude agents для открытия agent view. Он захватывает весь терминал и перечисляет каждый сеанс, сгруппированный по состоянию, с закреплёнными сеансами и теми, которые требуют вас в верхней части. Каждая строка показывает имя сеанса, текущую активность и как давно он в последний раз изменился.
Список охватывает каждый фоновый сеанс, который вы запустили, во всех ваших проектах. Сеанс, работающий в одном репозитории, и другой в другом worktree, оба появляются здесь, независимо от того, из какого каталога вы открыли agent view. Интерактивные сеансы, открытые в других терминалах, не появляются до тех пор, пока вы не отправите их в фон. Subagents и teammates, которых порождает сеанс, не указаны как отдельные строки.
Read session state
Каждая строка начинается со значка, цвет и анимация которого показывают состояние сеанса:| Состояние | Значок показывает как | Что это означает |
|---|---|---|
| Working | Анимированный | Claude активно запускает инструменты или генерирует ответ |
| Needs input | Жёлтый | Claude ждёт конкретного вопроса или решения о разрешении от вас |
| Idle | Затемнённый | Сеанс не имеет ничего делать и готов к вашему следующему запросу |
| Completed | Зелёный | Задача успешно завершена |
| Failed | Красный | Задача завершилась с ошибкой |
| Stopped | Серый | Сеанс был остановлен с помощью Ctrl+X или claude stop |
| Форма | Что это означает |
|---|---|
✻ или анимированный ✽ | Процесс сеанса активен и отвечает немедленно |
∙ | Процесс завершился. Вы всё ещё можете просмотреть, ответить или подключиться, и Claude перезапускается с того места, где он остановился |
✢ | Сеанс /loop, спящий между итерациями. Строка показывает количество запусков и обратный отсчёт |
claude respawn --all.
Row summaries
Однострочное резюме в каждой строке генерируется моделью класса Haiku, поэтому строка может сказать вам, что делает сеанс, что ему требуется или что он произвёл, без открытия стенограммы. Пока сеанс активно работает, резюме обновляется не более одного раза каждые 15 секунд, плюс один раз, когда каждый ход заканчивается. Каждое обновление — это один короткий запрос класса Haiku через вашего обычного поставщика, выставляемый и обрабатываемый в соответствии с теми же условиями использования данных, что и сам сеанс.Pull request status
Когда сеанс открывает pull request, в правом краю строки появляется точка статуса, связанная с pull request в терминалах, поддерживающих гиперссылки. Когда сеанс открыл более одного pull request, количество появляется перед точкой, а цвет отражает тот, который больше всего нуждается во внимании.| Цвет точки | Статус pull request |
|---|---|
| Жёлтый | Ожидание проверок или рецензии, или проверки не прошли |
| Зелёный | Проверки пройдены и никакая рецензия не блокирует |
| Фиолетовый | Объединено |
| Серый | Черновик или закрыто |
Peek and reply
НажмитеSpace на выбранной строке, чтобы открыть панель просмотра. Она показывает, что требуется сеансу от вас, его последний вывод и любые pull requests, которые он открыл. В большинстве случаев этого достаточно, и вам никогда не нужно открывать полную стенограмму.
Введите ответ в панель просмотра и нажмите Enter, чтобы отправить его этому сеансу. Когда сеанс задаёт вопрос с несколькими вариантами ответов, панель просмотра показывает варианты и вы можете нажать цифровую клавишу для выбора одного. Для других заблокированных сеансов нажмите Tab, чтобы заполнить ввод предложенным ответом, который вы можете отредактировать перед отправкой. Начните ответ с !, чтобы отправить команду Bash вместо этого.
Используйте ↑ и ↓ для просмотра соседних сеансов без закрытия панели или → для подключения.
Attach to a session
НажмитеEnter или → на выбранной строке для подключения. 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 группирует сеансы так, чтобы те, которые требуют ввода, находились в верхней части, сReady for review и Needs input выше Working и Completed. Эти названия групп не соответствуют один-к-одному состояниям выше: сеанс переходит в Ready for review, когда у него есть открытый pull request, и Completed собирает завершённые, неудачные и остановленные сеансы вместе. Нажмите Ctrl+S для группировки по каталогу вместо этого. Ваш выбор сохраняется между запусками.
В группе:
- Нажмите
Ctrl+Tдля закрепления сеанса в верхней части - Нажмите
Shift+↑илиShift+↓для переупорядочения сеансов - Нажмите
Ctrl+Rдля переименования сеанса - Нажмите
Enterна заголовке группы для её свёртывания
Ctrl+X для его остановки и Ctrl+X снова в течение двух секунд для удаления. Нажатие Ctrl+X на заголовке группы удаляет каждый сеанс в этой группе после подтверждения.
Удаление удаляет сеанс из agent view и очищает его worktree, включая любые незафиксированные изменения в нём, поэтому отправьте или зафиксируйте работу, которую вы хотите сохранить, перед удалением. Стенограмма разговора остаётся на диске и остаётся доступной через claude --resume.
Более старые завершённые сеансы складываются в строку … N more для сохранения списка коротким. Сбои и сеансы с открытым pull request всегда остаются видимыми.
Filter sessions
Введите в поле отправки для фильтрации вместо отправки:| Фильтр | Показывает |
|---|---|
a:<name> | Сеансы, запускающие названного агента |
s:<state> | Сеансы в данном состоянии, такие как s:working. Также принимает s:blocked для всего, что ждёт вас |
#<number> или URL pull request | Сеанс, работающий над этим pull request |
Keyboard shortcuts
Нажмите? в agent view, чтобы увидеть каждое сочетание клавиш в контексте. Таблица ниже их суммирует.
| Сочетание клавиш | Действие |
|---|---|
↑ / ↓ | Перемещение между строками |
Enter | Подключение к выбранному сеансу или отправка, если в поле ввода есть текст |
Space | Открытие или закрытие панели просмотра для выбранного сеанса |
Shift+Enter | Отправка и немедленное подключение |
→ | Подключение к выбранному сеансу |
Alt+1..Alt+9 | Подключение к сеансу 1–9 в текущей группе |
Tab | На пустом вводе просмотр всех subagents. В противном случае применение выделенного предложения |
Ctrl+S | Переключение группировки между состоянием и каталогом |
Ctrl+T | Закрепление или открепление выбранного сеанса |
Ctrl+R | Переименование выбранного сеанса |
Ctrl+G | Открытие подсказки отправки в вашем $EDITOR |
Ctrl+X | Остановка сеанса; нажмите снова в течение двух секунд для удаления |
Shift+↑ / Shift+↓ | Переупорядочение выбранного сеанса |
Esc | Закрытие панели просмотра, очистка ввода или выход |
Ctrl+C | Очистка ввода; нажмите дважды для выхода |
? | Показать все сочетания клавиш |
Отправка новых агентов
Вы можете отправлять новые фоновые сеансы из 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 | Отправка и немедленное подключение к новому сеансу |
@name совпадает как с subagent, так и с соседним репозиторием, subagent имеет приоритет. Совпадение первого слова также применяется, поэтому подсказка, начинающаяся со слова, совпадающего с одним из имён ваших subagent, отправляет этот subagent, а не обрабатывает слово как обычный текст. Используйте форму @ когда вы хотите быть явным, или начните подсказку с другого слова, чтобы избежать совпадения.
Dispatch to a specific directory
Новый сеанс запускается в каталоге, из которого вы открыли agent view. Для целевого другого каталога:- Откройте
claude agentsв этом каталоге. - Откройте
claude agentsв родительском каталоге, который содержит несколько репозиториев, и упомяните один с@<repo>в подсказке для запуска сеанса там. - Из оболочки выполните
cdв каталог и запуститеclaude --bg "<prompt>".
From inside a session
Запустите/background или его псевдоним /bg для перемещения текущей беседы в фоновый сеанс. Передайте подсказку, такую как /bg run the test suite and fix any failures, для отправки одной дополнительной инструкции перед этим.
Переведение в фон из интерактивного сеанса запускает свежий процесс, который возобновляется из сохранённой беседы, поэтому запуск subagent, monitors и фоновых команд не переносится в него. Claude просит вас подтвердить перед переводом в фон, когда какие-либо из них работают. После перевода в фон сеанс может запускать новые subagent, monitors и фоновые команды, и они продолжают работать при последующем отключении и переподключении.
From your shell
Передайте--bg для запуска сеанса, который идёт прямо в фон:
--bg с --agent:
How file edits are isolated
Каждый фоновый сеанс, запущенный ли из agent view,/bg или claude --bg, запускается в вашем рабочем каталоге. Перед редактированием файлов Claude перемещает сеанс в изолированный git worktree под .claude/worktrees/, поэтому параллельные сеансы могут читать один и тот же checkout, но каждый пишет в свой собственный. Claude пропускает это, когда сеанс уже находится под .claude/worktrees/, когда рабочий каталог не является git репозиторием или для записей вне рабочего каталога.
Вне git репозитория сеансы пишут в рабочий каталог напрямую и не изолированы друг от друга, поэтому избегайте отправки параллельных сеансов, которые редактируют одни и те же файлы.
Worktree удаляется при удалении сеанса, поэтому объедините или отправьте изменения, которые вы хотите сохранить, перед удалением. Чтобы найти путь worktree сеанса, посмотрите сеанс или подключитесь и проверьте его рабочий каталог.
Чтобы сделать subagent всегда запускаемым в его собственном worktree независимо от того, как он был запущен, установите isolation: worktree в его frontmatter.
Set the model
Имя модели, показанное в заголовке agent view, является стандартом отправки. Новые сеансы, которые вы запускаете из входа, используют эту модель, которая является тем же параметром, который/model контролирует в любом сеансе. Чтобы переопределить его для всего сеанса agent view, передайте --model при открытии agent view. См. Permission mode, model, and effort.
Каждый фоновый сеанс может работать на другой модели. Чтобы переопределить его для одного сеанса:
- Из оболочки передайте
--modelсclaude --bg. - Подключитесь к работающему сеансу и запустите
/modelтам. Изменение сохраняется, если сеанс перезапущен. - Отправьте subagent, чей frontmatter устанавливает поле
model.
Permission mode, model, and effort
Отправленный сеанс читает свои settings и permission mode из каталога, в котором он запускается, так же как если бы вы запустилиclaude там.
Чтобы установить стандартные значения для каждого сеанса, который вы отправляете из agent view, передайте любой из --permission-mode, --model или --effort при открытии его:
defaultMode из settings этого каталога или permissionMode из frontmatter отправленного subagent, и модель, показанную в заголовке agent view.
Использование bypassPermissions или auto отказывается до тех пор, пока вы не примете этот режим, запустив claude с ним один раз интерактивно, так как эти режимы позволяют сеансу, который вы не наблюдаете, действовать без одобрения. То же самое применяется независимо от того, передаёте ли вы режим в claude agents или в claude --bg --permission-mode.
Settings, plugins, and MCP servers
Agent view принимает те же флаги конфигурации, что иclaude для загрузки settings, plugins, MCP servers и дополнительных каталогов. Каждый флаг применяется к самому agent view и передаётся каждому сеансу, который вы отправляете из него, поэтому plugin или MCP server, который вы загружаете таким образом, доступен в этих сеансах тоже.
| Флаг | Эффект |
|---|---|
--settings <file-or-json> | Переопределить settings для agent view и отправленных сеансов |
--add-dir <path> | Предоставить доступ к файлам дополнительного каталога |
--plugin-dir <path> | Загрузить plugin из локального каталога |
--mcp-config <file-or-json> | Загрузить MCP servers из файла конфигурации или строки JSON |
--strict-mcp-config | Использовать только MCP servers из --mcp-config, игнорируя другую конфигурацию MCP |
--add-dir, --plugin-dir или --mcp-config один раз для каждого значения. Форма, разделённая пробелами, такая как --add-dir a b c, не поддерживается с claude agents.
Следующий пример открывает agent view с переопределением settings и одним дополнительным каталогом:
Управление сеансами из оболочки
Каждый фоновый сеанс имеет короткий ID, который вы можете использовать из оболочки. ID выводится при запуске сеанса с помощьюclaude --bg, и ID каждого сеанса — это имя его каталога в ~/.claude/jobs/. Эти команды полезны для написания скриптов или когда вы не хотите открывать 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> | Удалить сеанс из списка. Очищает его worktree, если нет незафиксированных изменений |
Как размещаются фоновые сеансы
Каждый сеанс, указанный в представлении агента, считается фоновым сеансом, независимо от того, подключены ли вы к нему в данный момент. В отличие от этого, сеанс, запущенный путём прямого запускаclaude, привязан к этому терминалу и завершается при его закрытии, если вы не отправите его в фон.
Процесс супервизора
Фоновые сеансы размещаются процессом супервизора для каждого пользователя, отдельным от вашего терминала и от представления агента. Супервизор запускается автоматически в первый раз, когда вы отправляете сеанс в фон или открываете представление агента, и вы не управляете им напрямую. Супервизор и его сеансы аутентифицируются с теми же учётными данными, что и ваши интерактивные сеансы, и не делают дополнительных сетевых подключений за пределами API модели. Каждый фоновый сеанс — это его собственный процесс Claude Code, управляемый супервизором, а не привязанный к вашему терминалу. Сеанс, который активно работает, ждёт вашего ввода или имеет подключённый терминал, сохраняет свой процесс работающим. После завершения сеанса и его неподключённого состояния примерно час супервизор останавливает его процесс для освобождения ресурсов. Стенограмма и состояние остаются на диске, и в следующий раз, когда вы подключитесь, посмотрите или ответите, супервизор запускает свежий процесс с того места, где он остановился. Когда каждый сеанс завершён и ни один терминал не подключён, сам супервизор выходит и запускается снова в следующий раз, когда вам это потребуется. Супервизор наблюдает установленный двоичный файл Claude Code на диске и перезапускается в новую версию после того, как обычный auto-updater его заменит. Это локальное наблюдение файла, а не сетевая проверка. Фоновые сеансы — это отсоединённые процессы, поэтому они продолжают работать через перезагрузку и новый супервизор переподключается к ним.Где хранится состояние
Состояние сеанса хранится в каталоге конфигурации Claude Code. Если вы установилиCLAUDE_CONFIG_DIR, супервизор использует этот каталог вместо ~/.claude и запускается как отдельный экземпляр со своими собственными сеансами.
| Путь | Содержимое |
|---|---|
~/.claude/daemon.log | Журнал супервизора |
~/.claude/daemon/roster.json | Список работающих фоновых сеансов, используется для переподключения после перезагрузки |
~/.claude/jobs/<id>/state.json | Состояние для каждого сеанса, показанное в представлении агента |
Отключение представления агента
Чтобы полностью отключить фоновых агентов и представление агента, установите параметрdisableAgentView setting на true или установите переменную окружения CLAUDE_CODE_DISABLE_AGENT_VIEW. Администраторы могут применить это через управляемые настройки.
Troubleshooting
claude agents выводит список подагентов вместо открытия представления агентов
Если claude agents выводит количество, за которым следует список ваших настроенных подагентов, а затем завершает работу, представление агентов недоступно в вашей среде. Более ранние версии не открывали представление агентов в каждой среде, включая подключение через Bedrock, Vertex AI или Foundry. Запустите claude update, чтобы установить последнюю версию.
Если представление агентов по-прежнему не открывается после обновления, проверьте, было ли оно отключено параметром или переменной окружения.
Agent view открывается без сеансов
Представление агентов пусто до тех пор, пока вы не отправите свой первый сеанс. Введите подсказку в поле ввода внизу и нажмитеEnter.
Невозможно открыть агентов, так как выполняются фоновые задачи
Если нажатие← для перевода текущего сеанса в фоновый режим показывает Cannot open agents — N background task(s) running, сеанс имеет незавершённую работу, такую как подагент, рабочий процесс или фоновую команду оболочки, и сочетание клавиш не будет молча её отменять. Запустите /tasks, чтобы увидеть, что выполняется, затем /bg, чтобы подтвердить отмену. См. From inside a session, чтобы узнать, что передаётся и что не передаётся при переводе сеанса в фоновый режим.
Подсказка отклонена как слишком короткая
Поле ввода отправки ожидает описание задачи, а не разговорное начало. Подсказка короче четырёх символов отклоняется с подсказкойToo short, чтобы случайное нажатие клавиши не запустило сеанс. Опишите, что вы хотите, чтобы сеанс делал, например investigate the flaky checkout test.
Сеансы отображаются как неудачные после пробуждения вашей машины
Фоновые сеансы не выживают при спящем режиме или выключении, поэтому сеансы, которые были запущены, отображаются как неудачные после пробуждения. Подключитесь, посмотрите или ответьте на любой из них, и сеанс перезапустится с того места, где он остановился. Чтобы перезапустить все сразу, запуститеclaude respawn --all.
Сеанс медленно реагирует после подключения
После завершения сеанса и его неподключённого состояния примерно час супервизор останавливает его процесс для освобождения ресурсов. Подключение запускает свежий процесс с того места, где он остановился, что занимает момент. Сеансы, которые работают или ждут вас, никогда не останавливаются таким образом..claude/worktrees/ заполняется
Worktrees удаляются при удалении сеанса, который их создал. Если сеанс завершился без очистки, перечислите оставшиеся записи с помощью git worktree list в каталоге проекта и удалите каждую с помощью git worktree remove <path>. См. Clean up worktrees.
Ограничения
Agent view находится в исследовательском предпросмотре со следующими ограничениями:- Применяются ограничения скорости: фоновые сеансы потребляют использование вашей подписки так же, как интерактивные сеансы, поэтому запуск десяти агентов параллельно использует квоту примерно в десять раз быстрее, чем запуск одного.
- Сеансы локальны: фоновые сеансы работают на вашей машине и останавливаются, если она переходит в спящий режим или выключается.
- Worktrees удаляются с сеансом: объедините или отправьте изменения перед удалением сеанса, который редактировал файлы в его собственном worktree.
Связанные ресурсы
Для других способов запуска Claude параллельно см.:- Запуск агентов параллельно: сравните agent view с subagents, agent teams и worktrees
- Agent teams: координируйте несколько сеансов, которые обмениваются сообщениями друг с другом
- Claude Code on the web: запускайте сеансы в управляемой облачной среде вместо локально