Управление несколькими агентами с помощью представления агентов
Отправляйте и управляйте множеством сеансов Claude Code с одного экрана. Agent view показывает, что делает каждый сеанс и какие из них требуют вашего ввода.
Agent view, открываемое с помощью claude agents, — это один экран для всех ваших фоновых сеансов: что работает, что требует вашего ввода и что завершено. Отправляйте новые сеансы, наблюдайте их состояние с первого взгляда вместо прокрутки стенограмм и вмешивайтесь только когда один из них требует вас. Каждый фоновый сеанс — это полная беседа Claude Code, которая продолжает работать без подключённого терминала, поэтому вы можете открыть его, ответить и уйти в любой момент.
Используйте agent view, когда у вас есть несколько независимых задач, над которыми Claude может работать без вашего наблюдения на каждом шаге. Отправьте исправление ошибки, проверку pull request и исследование нестабильного теста как три строки, продолжайте работать в другом окне и проверьте, когда строка показывает, что она требует вас или имеет результат.
Когда вы хотите работать более непосредственно в сеансе любого агента, подключитесь к строке, чтобы войти в полную беседу.
Для сравнения agent view с subagents, agent teams и worktrees см. Запуск агентов параллельно.
На этой странице рассматривается:
- Быстрый старт: дайте Claude задачу для работы в фоне, проверьте её и вмешайтесь, когда это необходимо
- Мониторинг сеансов с помощью agent view, включая значки состояния, просмотр и ответы, подключение, организацию и сочетания клавиш
- Отправка новых агентов из agent view, из внутри сеанса или из вашей оболочки
- Управление сеансами из оболочки
- Как размещаются фоновые сеансы процессом супервизора
Быстрый старт
Это пошаговое руководство охватывает основной цикл agent view: отправьте задачу, смотрите, как её строка обновляется по мере работы Claude, посмотрите, чтобы проверить её, и ответьте, а затем подключитесь для полной беседы. Сеанс, который вы отправляете, продолжает работать после закрытия agent view, поэтому вы можете уйти и вернуться к нему позже.
Открыть agent view
Из вашей оболочки запустите:
claude agents
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. Чтобы ограничить список одним проектом, передайте --cwd (требуется Claude Code v2.1.141 или позже):
claude agents --cwd ~/projects/my-app
Это показывает только сеансы, запущенные в этом каталоге. Сеанс, который переместился в worktree под ~/projects/my-app/.claude/worktrees/, всё ещё считается принадлежащим ~/projects/my-app.
Интерактивные сеансы, открытые в других терминалах, не появляются до тех пор, пока вы не отправите их в фон. Subagents и teammates, которых порождает сеанс, не указаны как отдельные строки.
Pinned
✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m
Ready for review
∙ jump physics github.com/example/game/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
Read session state
Каждая строка начинается со значка, цвет и анимация которого показывают состояние сеанса:
| Состояние | Значок показывает как | Что это означает |
|---|---|---|
| Working | Анимированный | Claude активно запускает инструменты или генерирует ответ |
| Needs input | Жёлтый | Claude ждёт конкретного вопроса или решения о разрешении от вас |
| Idle | Затемнённый | Сеанс не имеет ничего делать и готов к вашему следующему запросу |
| Completed | Зелёный | Задача успешно завершена |
| Failed | Красный | Задача завершилась с ошибкой |
| Stopped | Серый | Сеанс был остановлен с помощью Ctrl+X или claude stop |
Отдельно, форма значка показывает, работает ли базовый процесс:
| Форма | Что это означает |
|---|---|
✻ или анимированный ✽ |
Процесс сеанса активен и отвечает немедленно |
∙ |
Процесс завершился. Вы всё ещё можете просмотреть, ответить или подключиться, и Claude перезапускается с того места, где он остановился |
✢ |
Сеанс /loop, спящий между итерациями. Строка показывает количество запусков и обратный отсчёт |
●, который может появиться в правом краю строки, является индикатором статуса pull request, а не частью значка состояния. Число перед ним — это количество pull request, которые открыл сеанс.
Фоновые сеансы не требуют открытого терминала для продолжения работы. Отдельный процесс супервизора их запускает, поэтому вы можете закрыть agent view, закрыть оболочку или запустить новый интерактивный сеанс, и ваша отправленная работа продолжает выполняться.
Состояние сеанса сохраняется на диск через автоматические обновления и перезапуски супервизора. Сеансы также сохраняются, когда ваша машина переходит в спящий режим. Их процессы возобновляются при пробуждении, и супервизор переподключается к ним вместо того, чтобы рассматривать временной разрыв как неактивность. Выключение всё ещё останавливает работающие сеансы; см. Sessions show as failed after shutdown для того, как их восстановить.
Row summaries
Однострочное резюме в каждой строке генерируется моделью класса Haiku, поэтому строка может сказать вам, что делает сеанс, что ему требуется или что он произвёл, без открытия стенограммы. Пока сеанс активно работает, резюме обновляется не более одного раза каждые 15 секунд, плюс один раз, когда каждый ход заканчивается.
Каждое обновление — это один короткий запрос класса Haiku через вашего обычного поставщика, выставляемый и обрабатываемый в соответствии с теми же условиями использования данных, что и сам сеанс.
Pull request status
Когда сеанс открывает pull request, в правом краю строки появляется точка статуса, связанная с pull request в терминалах, поддерживающих гиперссылки. Когда сеанс открыл более одного pull request, количество появляется перед точкой, а цвет отражает тот, который больше всего нуждается во внимании.
| Цвет точки | Статус pull request |
|---|---|
| Жёлтый | Ожидание проверок или рецензии, или проверки не прошли |
| Зелёный | Проверки пройдены и никакая рецензия не блокирует |
| Фиолетовый | Объединено |
| Серый | Черновик или закрыто |
Для большинства задач эта строка — это то, как вы собираете результат: проверьте и объедините pull request, когда точка станет зелёной.
Peek and reply
Нажмите Space на выбранной строке, чтобы открыть панель просмотра. Она показывает, что требуется сеансу от вас, его последний вывод и любые pull request, которые он открыл. В большинстве случаев этого достаточно, и вам никогда не нужно открывать полную стенограмму.
Введите ответ в панель просмотра и нажмите 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 с этой строкой выбранной, поэтому вы можете переключаться между сеансами без выхода из терминала. Строка создаётся даже из свежего сеанса без истории разговора, поэтому → возвращает к ней. Когда эта строка единственная, agent view показывает подсказку адаптации ниже неё. Вы можете отключить это сочетание клавиш в /config (параметр leftArrowOpensAgents).
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 и удаляет его стенограмму разговора. Если Claude создал worktree для сеанса, удаление удаляет этот worktree тоже, включая любые незафиксированные изменения в нём, поэтому отправьте или зафиксируйте работу, которую вы хотите сохранить, перед удалением. Worktree, который вы создали сами и запустили сеанс внутри, остаётся на месте.
Более старые завершённые сеансы складываются в строку … 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 |
Открытие подсказки отправки в вашем $VISUAL или $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 |
Отправка и немедленное подключение к новому сеансу |
Упаковка повторяющейся задачи как skill позволяет вам запускать один и тот же рабочий процесс из agent view многократно без переввода подсказки.
Когда одно и то же имя @name совпадает как с 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, для отправки одной дополнительной инструкции перед этим.
Переведение в фон из интерактивного сеанса запускает свежий процесс, который возобновляется из сохранённой беседы, поэтому запуск subagent, monitors и фоновых команд не переносится в него. Claude просит вас подтвердить перед переводом в фон, когда какие-либо из них работают. После перевода в фон сеанс может запускать новые subagent, monitors и фоновые команды, и они продолжают работать при последующем отключении и переподключении.
Флаги конфигурации из исходного запуска переносятся в фоновый сеанс, поэтому его MCP servers, settings и резервная модель остаются в силе:
--mcp-configи--strict-mcp-config--settings--add-dir--plugin-dir--fallback-model--allow-dangerously-skip-permissions
Перенос --allow-dangerously-skip-permissions сохраняет bypassPermissions доступным в фоновом сеансе, но это не предоставляет ничего нового. Режим по-прежнему требует того же одноразового интерактивного принятия, описанного в Permission mode, model, and effort, прежде чем любой сеанс сможет его использовать.
From your shell
Передайте --bg для запуска сеанса, который идёт прямо в фон:
claude --bg "investigate the flaky SettingsChangeDetector test"
Чтобы запустить конкретного subagent как основного агента сеанса, объедините --bg с --agent:
claude --agent code-reviewer --bg "address review comments on PR 1234"
Передайте --name для установки отображаемого имени сеанса в agent view вместо автоматически сгенерированного:
claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"
После переведения в фон 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, но каждый пишет в свой собственный.
Claude пропускает worktree когда:
- Сеанс уже находится внутри связанного git worktree, создан ли он Claude под
.claude/worktrees/или вы создали его с помощьюgit worktree addгде-то ещё - Рабочий каталог не является git репозиторием
- Запись находится вне рабочего каталога
Чтобы отключить изоляцию worktree для репозитория, где git worktrees непрактичны, установите worktree.bgIsolation на "none". Фоновые сеансы затем редактируют вашу рабочую копию напрямую без предварительного перемещения в worktree. Добавьте параметр в файл .claude/settings.json проекта:
{
"worktree": {
"bgIsolation": "none"
}
}
Вне git репозитория сеансы пишут в рабочий каталог напрямую и не изолированы друг от друга, поэтому избегайте отправки параллельных сеансов, которые редактируют одни и те же файлы.
Удаление сеанса в agent view (Ctrl+X дважды) удаляет worktree, созданный Claude для него, включая любые незафиксированные изменения, поэтому объедините или отправьте изменения, которые вы хотите сохранить, перед удалением. Удаление из оболочки с помощью claude rm сохраняет worktree, который имеет незафиксированные изменения, и выводит его путь, чтобы вы могли очистить его самостоятельно. 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 из каталога, в котором он запускается, так же как если бы вы запустили claude там.
Permission mode зависит от того, как вы запустили сеанс. Переведение существующего сеанса в фон с помощью /bg или ← сохраняет текущий permission mode, поэтому сеанс, который вы переключили на acceptEdits или auto, остаётся в этом режиме после отключения. Отправка из входа agent view или запуск claude --bg из вашей оболочки использует defaultMode из settings этого каталога или permissionMode из frontmatter отправленного subagent.
Permission mode, с которым вы запускаете фоновый сеанс, сохраняется, когда supervisor позже останавливает и перезапускает процесс сеанса. Сеанс, который вы запустили с помощью claude --bg --dangerously-skip-permissions или claude --bg --permission-mode bypassPermissions, остаётся в bypassPermissions после этого перезапуска вместо возврата к defaultMode каталога.
Чтобы установить стандартные значения для каждого сеанса, который вы отправляете из agent view, передайте любой из --permission-mode, --model или --effort при открытии его:
claude agents --permission-mode plan --model opus --effort high
claude agents также принимает --dangerously-skip-permissions как сокращение для --permission-mode bypassPermissions и --allow-dangerously-skip-permissions для того, чтобы сделать bypassPermissions доступным в цикле Shift+Tab каждого отправленного сеанса без запуска в этом режиме. Оба совпадают с флагами CLI верхнего уровня.
Активные стандартные значения отображаются в нижнем колонтитуле под входом отправки.
Без этих флагов сеанс использует 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 и дополнительных каталогов. Эти флаги требуют Claude Code v2.1.142 или позже. Каждый флаг применяется к самому 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 и одним дополнительным каталогом:
claude agents --settings ./ci-settings.json --add-dir ../shared-lib
Управление сеансами из оболочки
Каждый фоновый сеанс имеет короткий ID, который вы можете использовать из оболочки. ID выводится при запуске сеанса с помощью claude --bg, и ID каждого сеанса — это имя его каталога в ~/.claude/jobs/. Эти команды полезны для написания скриптов или когда вы не хотите открывать agent view.
| Команда | Назначение |
|---|---|
claude agents |
Открыть agent view |
claude agents --cwd <path> |
Открыть agent view с областью действия сеансов, запущенных в <path> |
claude attach <id> |
Подключиться к сеансу в этом терминале |
claude logs <id> |
Вывести последний вывод сеанса |
claude stop <id> |
Остановить сеанс. Также принимает claude kill |
claude respawn <id> |
Перезапустить сеанс, работающий или остановленный, с его беседой нетронутой, например, чтобы подобрать обновленный бинарный файл Claude Code |
claude respawn --all |
Перезапустить каждый работающий сеанс, например, чтобы переместить все сеансы на обновленный бинарный файл Claude Code одновременно |
claude rm <id> |
Удалить сеанс и его стенограмму. Удаляет worktree, созданный Claude для сеанса, если в нем нет незафиксированных изменений; в противном случае выводит путь worktree, чтобы вы могли его очистить. Оставляет на месте worktree, созданный вами самостоятельно |
claude daemon status |
Вывести состояние supervisor, версию, каталог сокета и количество рабочих процессов |
Как размещаются фоновые сеансы
Каждый сеанс, указанный в представлении агента, считается фоновым сеансом, независимо от того, подключены ли вы к нему в данный момент. В отличие от этого, сеанс, запущенный путём прямого запуска 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 |
Состояние для каждого сеанса, показанное в представлении агента |
Чтобы проверить это состояние без прямого чтения файлов, запустите claude daemon status. Он сообщает, доступен ли супервизор, его идентификатор процесса и версию, каталог сокета и сколько фоновых сеансов активны. /doctor включает сводку той же проверки. В Windows claude daemon status выводит основную ошибку файла, когда файл ключа pipe супервизора заблокирован или нечитаем, вместо того чтобы сообщать об общей ошибке подключения.
Отключение представления агента
Чтобы полностью отключить фоновых агентов и представление агента, установите параметр 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/worktrees/ заполняется
Удаление сеанса в представлении агентов удаляет рабочее дерево, которое Claude создал для него. claude rm сохраняет рабочее дерево, которое имеет незафиксированные изменения, и выводит его путь. Перечислите оставшиеся записи с помощью git worktree list в каталоге проекта и удалите каждую с помощью git worktree remove <path>. См. Clean up worktrees.
Ограничения
Agent view находится в исследовательском предпросмотре со следующими ограничениями:
- Применяются ограничения скорости: фоновые сеансы потребляют использование вашей подписки так же, как интерактивные сеансы, поэтому запуск десяти агентов параллельно использует квоту примерно в десять раз быстрее, чем запуск одного.
- Сеансы локальны: фоновые сеансы работают на вашей машине. Они сохраняются при переходе в спящий режим, но останавливаются при выключении машины.
- Worktrees, созданные Claude, удаляются с сеансом в agent view: объедините или отправьте изменения перед удалением сеанса, который редактировал файлы в его собственном worktree.
claude rmсохраняет worktree, который имеет незафиксированные изменения; worktree, который вы создали сами, остаётся на месте.
Связанные ресурсы
Для других способов запуска Claude параллельно см.:
- Запуск агентов параллельно: сравните agent view с subagents, agent teams и worktrees
- Agent teams: координируйте несколько сеансов, которые обмениваются сообщениями друг с другом
- Claude Code on the web: запускайте сеансы в управляемой облачной среде вместо локально