SpyBara
Go Premium

agent-view.md 2026-10-01 23:59 UTC to 2026-10-02 22:59 UTC

This page contains 205 additions and 176 deletions.

2026
Thu 1 23:59 Fri 2 22:59

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

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

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

Agent view в терминале. Строка в верхней части подсчитывает сеансы, ожидающие ввода, работающие и завершённые. Четыре сеанса сгруппированы под Требуется ввод, Работает и Завершено. Каждая строка показывает имя сеанса, его последний статус или вопрос и время. В нижней части находится поле ввода для описания новой задачи и строка подсказок сочетаний клавиш. Agent view в терминале. Строка в верхней части подсчитывает сеансы, ожидающие ввода, работающие и завершённые. Четыре сеанса сгруппированы под Требуется ввод, Работает и Завершено. Каждая строка показывает имя сеанса, его последний статус или вопрос и время. В нижней части находится поле ввода для описания новой задачи и строка подсказок сочетаний клавиш.

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

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

Для сравнения agent view с subagents, agent teams и worktrees см. Запуск агентов параллельно. Agent view запускает сеансы на вашей машине и вы отправляете каждый из них; чтобы Claude начал и отслеживал параллельные сеансы в облаке из одной беседы, см. Projects.

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

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

1

Открыть agent view

Из вашей оболочки запустите:

claude agents

Если вы ещё не приняли диалог доверия рабочей области для каталога, Claude Code показывает его перед открытием agent view, тот же диалог, который показывает claude. Примите, чтобы сохранить доверие для рабочей области и продолжить. Если вы отклоните, Claude Code выйдет без открытия agent view.

Agent view открывается с вводом внизу и таблицей, которая заполняется по мере запуска сеансов. Нажмите Esc для возврата в вашу оболочку; если вы открыли agent view путём отправки сеанса в фон с помощью ←, Esc вернёт вас к этой беседе вместо этого. Ваши сеансы продолжают работать, пока вас нет, и снова появляются в следующий раз, когда вы откроете agent view.

2

Отправить сеанс

Введите подсказку, описывающую задачу, и нажмите Enter. Запускается новый фоновый сеанс для этой задачи и появляется как строка, показывающая, работает ли он, ждёт ли вас или завершён. Новый сеанс использует модель, показанную в заголовке agent view. Какой режим разрешений он запускает зависит от того, как вы открыли agent view.

Каждая подсказка, которую вы вводите здесь, запускает свой собственный новый сеанс. Ввод другой подсказки и нажатие Enter запускает второй сеанс рядом с первым, а не отправляет ему продолжение. Таким образом вы можете запустить несколько параллельно.

Каждый сеанс использует вашу квоту подписки независимо, поэтому см. Ограничения перед отправкой множества сеансов одновременно.

3

Просмотр и ответ

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

4

Подключение и отключение

Нажмите Enter или → на строке для подключения, когда вам нужна полная беседа. Сеанс захватывает терминал как полный интерактивный сеанс Claude Code. Нажмите ← на пустой подсказке для отключения и возврата к таблице.

5

Перенести существующий сеанс

Этот шаг требует запущенного сеанса. Если вы следовали предыдущим шагам, у вас нет открытого сеанса в этом терминале, поэтому откройте обычный сеанс claude в другом терминале и сначала отправьте ему сообщение.

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

Внутри обычного сеанса claude подсказка в нижнем колонтитуле ← показывает количество фоновых агентов, которые ждут вас, например ← 2 agents, и возвращается к ← for agents, когда никто не требует ввода. Количество выше 99 отображается как 99+. Количество обновляется примерно каждые десять секунд, пока терминал в фокусе, и немедленно, когда фокус возвращается. Оно кратко меняет цвет при изменении и при завершении агента, и когда фоновый сеанс завершается, пока никто не требует вашего ввода, оно кратко показывает количество завершённых, например ← 2 done. Обе вспышки отключены, когда параметр prefersReducedMotion включен, и подсказка скрыта в режиме чтения с экрана.

Открыть agent view по умолчанию

Чтобы claude без аргументов открывал agent view вместо новой беседы, включите параметр /config.

1

Включить параметр

В обычном сеансе claude запустите /config и включите Open agents view by default. Чтобы пропустить меню, установите ключ defaultToAgentsView напрямую:

/config defaultToAgentsView=true
2

Запустить Claude Code

Выйдите из сеанса, затем запустите claude без аргументов:

claude

Agent view открывается вместо новой беседы.

Чтобы запустить обычный сеанс, пока параметр включен, передайте подсказку: claude "fix the login test". Чтобы отключить параметр, запустите /config defaultToAgentsView=false в обычном сеансе или в сеансе, к которому вы подключаетесь из agent view.

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

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

Имя окрашено цветом, установленным с помощью /color в этом сеансе, включая когда вы отправляете сеанс в фон с помощью ← или /background.

По умолчанию список показывает каждый фоновый сеанс, который вы запустили, во всех ваших проектах. Сеанс, работающий в одном репозитории, и другой в другом worktree, оба появляются здесь, независимо от того, из какого каталога вы открыли agent view. Чтобы ограничить список одним проектом, передайте --cwd:

claude agents --cwd ~/projects/my-app

Это показывает только сеансы, запущенные в этом каталоге. Сеанс, который переместился в worktree под ~/projects/my-app/.claude/worktrees/, всё ещё считается принадлежащим ~/projects/my-app.

Интерактивные сеансы, открытые в других терминалах, не появляются до тех пор, пока вы не отправите их в фон. Subagents и teammates, которых порождает сеанс, не указаны как отдельные строки.

Pinned
  ✽ clawd walk cycle          Drawing the walk-cycle sprite frames          3m

Ready for review
  ∙ jump physics              Opened PR with collision fix                 #2048  2h

Needs input
  ✻ power-up design           double jump or wall climb?                    1m

Working
  ✽ collision detection       Adding swept-AABB checks to CollisionSystem   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 ждёт чего-то, что может предоставить только вы: ответ на вопрос, решение о разрешении или другой запрос, на который может ответить только вы, такой как sandbox запрос на разрешение сетевого хоста или запрос на ввод MCP сервера. Команда, которая требует подключённого терминала, такая как /install-github-app или список параметров /mcp, также удерживает неприслуживаемый сеанс здесь
Idle Затемнённый Сеанс не имеет ничего делать и готов к вашему следующему запросу
Completed Зелёный Задача успешно завершена
Failed Красный Задача завершилась с ошибкой
Stopped Серый Вы остановили сеанс с помощью Ctrl+X или claude stop, его процесс был завершён извне Claude Code, или он завершился, пока фоновая служба была отключена

Отдельно, форма значка показывает, работает ли базовый процесс:

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

Метка #N или !N, которая может появиться в правом краю строки, является ссылкой на pull request или merge request сеанса, а не частью значка состояния.

Заголовок вкладки терминала показывает количество ожидающих ввода, пока agent view открыт: 2 awaiting input · claude agents, когда сеансы требуют ввода, или claude agents, когда они не требуют.

Чтобы прочитать состояние сеанса из скрипта или другой программы, используйте claude agents --json вместо файлов под ~/.claude/jobs/.

Пока agent view открыт, Claude Code также отправляет уведомление через ваш настроенный канал уведомлений терминала, когда локальный фоновый сеанс начинает требовать вашего ввода, завершается или не работает. Сеансы, которые работают по расписанию, такие как сеансы /loop, уведомляют только когда они требуют вашего ввода. Уведомления используют тот же параметр preferredNotifChannel, что и остальная часть Claude Code, и запускают hook Notification с типом agent_needs_input или agent_completed.

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

Состояние сеанса сохраняется на диск через автоматические обновления и перезапуски супервизора. Сеансы также сохраняются, когда ваша машина переходит в спящий режим. Их процессы возобновляются при пробуждении, и супервизор переподключается к ним вместо того, чтобы рассматривать временной разрыв как неактивность. Выключение всё ещё останавливает работающие сеансы; см. Sessions show as failed or stopped after shutdown для того, как их восстановить.

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

Резюме строк

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

Работающая строка показывает, что говорит сеанс, что он делает, и заблокированная строка показывает вопрос, который он задаёт. Во время длительного хода модель также переписывает резюме каждые несколько минут, поэтому занятая строка не продолжает показывать устаревшее резюме. Текст резюме заполняет оставшуюся ширину строки; откройте панель просмотра для чтения предложения, которое край терминала обрезает.

Когда список сгруппирован по каталогу, резюме открывается с состоянием сеанса как цветное слово, такое как Needs input · double jump or wall climb?. При группировке состояния по умолчанию заголовок группы уже называет состояние, поэтому строка показывает только резюме.

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

Статус pull request

Когда сеанс открывает pull request, Claude Code добавляет метку в правом краю строки, связанную с pull request:

  • Claude Code пишет метку как #1234 для pull request и как !1234 для GitLab merge request.
  • Claude Code выдаёт ссылку даже когда не может обнаружить поддержку гиперссылок, например через SSH или tmux. Установите FORCE_HYPERLINK=0 для отображения метки как простого текста.
  • После того как вы отправите дополнение к сеансу, Claude Code сохраняет метку, пока строка возвращается к живому прогрессу.

Сеанс, который работает над существующим pull request, связан с ним таким же образом. Claude Code находит pull request по-разному в зависимости от команды, которую запускает Claude:

  • Когда Claude редактирует, комментирует, закрывает или отмечает pull request как готовый с помощью gh, Claude Code связывает pull request, который называет вывод самой команды. Команда gh, чей захваченный вывод не называет pull request, не создаёт ссылку; gh pr merge — это обычный случай, потому что он печатает результат только в интерактивный терминал.
  • Когда Claude проверяет pull request с помощью gh pr checkout или отправляет в ветку, Claude Code ищет ветку с помощью gh pr view и связывает её открытый pull request.
  • Pull request не должен существовать, когда Claude отправляет: Claude Code повторяет поиск ветки после до пяти последующих команд git, gh, glab или curl, запущенных в том же каталоге, поэтому pull request, созданный после отправки, включая тот, который Claude создаёт через GitHub REST API, связывается, когда повторная попытка его находит.

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

Номер pull request окрашен в соответствии с его статусом:

Цвет Статус pull request
Жёлтый Ожидание проверок или рецензии, или проверки не прошли
Зелёный Проверки пройдены и никакая рецензия не блокирует
Фиолетовый Объединено
Серый Черновик или закрыто

Для задачи, которая заканчивается pull request, проверьте эту метку для результата: проверьте и объедините pull request, когда его номер станет зелёным.

Просмотр и ответ

Нажмите Space на выбранной строке, чтобы открыть панель просмотра. Она открывается с предложением, которое строка усекает на краю терминала, и какое предложение это зависит от состояния сеанса:

  • Сеанс, который ждёт вас: точный вопрос, который он задаёт, выше ввода ответа
  • Завершённый сеанс: его результат
  • Работающий сеанс: его полное предложение статуса

Любые pull request, связанные с сеансом, указаны далее. Для сеанса, который ждёт вас, строка, такая как waiting 3m ниже них, показывает, как долго он ждёт, и это единственное время, показанное на панели. Возраст в правом краю строки — это другое число: он отсчитывается с момента запуска сеанса.

В большинстве случаев панель просмотра достаточна, и вам не нужно открывать полную стенограмму.

Введите ответ на панели просмотра и нажмите Enter, чтобы отправить его этой сессии. Начните ответ с !, чтобы вместо этого отправить команду Bash. Что произойдёт с ответом, зависит от сессии и от того, что вы отправляете:

  • Работающая сессия: ответ попадает в очередь сообщений сессии, не прерывая ответ, и вступает в силу тогда же, когда и ввод из очереди. Команда ждёт окончания хода, даже та, которая выполняется сразу, если ввести её в промпте самой сессии
  • Ответ, состоящий ровно из /stop: немедленно останавливает сессию, а не доставляется ей, независимо от того, работает сессия или ждёт вас
  • Shell-задача: ответ, включая /stop, передаётся в терминал команды как введённый текст

Когда сессия ожидает вас, способ ответа с панели просмотра зависит от того, чего она ждёт:

  • Вопрос с предопределёнными вариантами: панель перечисляет варианты с номерами. При пустом поле ответа нажмите номер варианта, чтобы подставить его, а затем Enter, чтобы отправить, или введите свой собственный ответ
  • Вопрос без предопределённых вариантов: введите ответ. Когда в пустом поле показан предлагаемый ответ, нажмите Tab, чтобы подставить его и отредактировать перед отправкой
  • Запрос разрешения или другое диалоговое окно, например запрос песочницы или запрос на ввод от MCP-сервера: ответ на него не отвечает. Ваш ответ ждёт в очереди. Чтобы ответить на диалоговое окно, подключитесь с помощью →

Когда hook PermissionRequest или PreToolUse возвращает вывод, который Claude Code не может проверить для вызова, который сеанс запрашивает, строка показывает событие hook и hook output invalid: с ошибкой проверки перед текстом ожидающего запроса. Для hook, который не работает другим способом, строка говорит, что hook не работал. Сеанс всё ещё ждёт того же запроса.

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

С включённой голосовой диктовкой, удерживайте или нажимайте клавишу push-to-talk, пока фокус находится на вводе ответа, чтобы продиктовать ответ вместо его ввода. То же самое работает в поле отправки внизу agent view.

Используйте ↑ и ↓ для просмотра соседних сеансов без закрытия панели, или → для подключения.

Подключение к сеансу

Нажмите Enter или → на выбранной строке для подключения. Agent view заменяется полным интерактивным сеансом. При подключении Claude публикует краткое резюме того, что произошло, пока вас не было.

Пока подключены, сеанс ведёт себя как любой другой сеанс Claude Code: команды, сочетания клавиш и функции все работают, с исключениями ниже.

Пока вы подключены, /install-github-app и список параметров /mcp работают нормально, так как человек у терминала может завершить их диалоги. Когда никто не подключен, эти команды не могут открыть свои диалоги, поэтому сеанс появляется под Needs input в agent view со строкой, такой как open this session to manage MCP servers, и ответ стенограммы говорит то же самое. Подключитесь и запустите команду снова для продолжения; строка needs-input очищается, когда вы подключаетесь. /mcp reconnect <server>, /mcp enable и /mcp disable работают без подключения в любом случае.

Подключённые сеансы всегда отображаются в полноэкранном режиме, независимо от вашего параметра tui, потому что фоновый сеанс не имеет истории прокрутки терминала для добавления. Прокручивайте с помощью PgUp, PgDn или колеса мыши, и нажмите Ctrl+O для режима стенограммы. Встроенная прокрутка вашего терминала и режим копирования tmux показывают только текущий видимый область, как и при запуске любого полноэкранного приложения.

Нажмите ← на пустой подсказке или запустите /exit, чтобы отключиться и вернуться к agent view, открыли ли вы сеанс из agent view или с помощью claude attach <id> из вашей оболочки.

← также отключает, пока открыта панель /btw. Требуется Claude Code v2.1.257 или позже. Боковой вопрос, который всё ещё отвечает, продолжает работать, пока вас нет. В следующий раз, когда вы подключитесь, панель откроется снова с ним или с его ответом.

На Windows, если вы нажмёте ← в течение примерно половины секунды после подключения, Claude Code показывает Ambiguous ←, press again to detach, потому что в этом окне терминал может переподать нажатие с до подключения. Нажмите ← снова для отключения.

Ctrl+Z также отключает, но возвращается туда, где вы начали вместо этого: к agent view, если вы подключились оттуда, или к вашей оболочке, если вы запустили claude attach. Используйте Ctrl+Z, когда диалог имеет фокус и не реагирует на ←.

Ctrl+C сохраняет своё стандартное поведение прерывания при подключении: оно отменяет выполняемый ответ или команду ! shell вместо отключения. Нажатие Ctrl+C дважды на пустой подсказке отключает, как и в любом сеансе.

Отключение никогда не останавливает фоновый сеанс: ←, Ctrl+Z, /exit и двойное Ctrl+C или двойное Ctrl+D оставляют его работающим. Чтобы завершить сеанс изнутри, запустите /stop.

Переключение сеансов без выхода из терминала

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

Если вы нажмёте ← сразу после удаления последнего текста подсказки или перемещения по истории подсказки, Claude Code просит вас подтвердить: первое нажатие показывает Press ← again to open agents, или Press ← again to go back to agents в подключённом сеансе, и второе нажатие переключает.

Когда ← отправляет сеанс переднего плана в фон, agent view показывает Your conversation moved to the background выше списка, с этой строкой сеанса уже выбранной. Оттуда:

  • Нажмите Enter для повторного открытия разговора.
  • Нажмите Esc для отмены переключения и возврата к разговору. Если Esc показывает Still starting — try again in a moment, фоновый сеанс ещё не готов, поэтому нажмите Esc снова через момент.
  • Нажмите Ctrl+C дважды для выхода в вашу оболочку.

Когда Claude Code не может повторно открыть разговор, он выходит и печатает команду claude --resume, которая его возобновляет.

Список задач Claude перемещается в фоновый сеанс с разговором, поэтому контрольный список остаётся нетронутым, когда вы возвращаетесь к этой строке.

Строка, на которой вы нажали ←, также сохраняет жирное, неприглушённое имя после того, как вы переместите выделение с помощью клавиш со стрелками или мыши, поэтому вы можете сказать, из какого сеанса вы пришли.

Если инструмент работает, когда вы нажимаете ←, Claude Code ждёт примерно десять секунд, чтобы он завершился, прежде чем отправить сеанс в фон, и ответ продолжается в фоновом сеансе. Нажмите ← снова для отправки в фон немедленно вместо ожидания. Когда выполняемая работа не может перейти в фоновый сеанс, Claude Code показывает диалог Background this session? сначала, как и с /background.

Десятисекундный лимит не применяется, пока работают foreground subagents, которые Claude запустил в разговоре. Claude Code продолжает ждать, поэтому их работа переходит, и показывает уведомление Still backgrounding after the current tool, пока ждёт. Нажмите ← снова для отправки в фон без ожидания, что перезапустит эти subagents с начала. Claude Code не ждёт subagents, которые запускает dynamic workflow. Когда workflow имеет работающие subagents, Claude Code показывает диалог Background this session? вместо этого.

Claude Code не отправляет сеанс в фон, пока у вас есть неотправленный текст в вводе подсказки, потому что текст остаётся в поле ввода вашего терминала и не переместится в фоновый сеанс. Если вы введёте текст в ввод, пока Claude Code ждёт отправки сеанса в фон, он отменяет переключение с Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.

Нажатие ← создаёт строку сеанса даже когда разговор не имеет сообщений, поэтому → всё ещё возвращает к нему.

Вы можете отключить это сочетание клавиш с помощью параметра leftArrowOpensAgents в /config.

Организация списка

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 на заголовке группы удаляет каждый сеанс в этой группе после подтверждения.

Второе нажатие удаляет сеанс даже когда попытка остановки не удалась, например потому что фоновая служба не отвечает: подтверждение остаётся активным ещё две секунды, и удаление завершает процесс сеанса самого. Нажмите Esc для отмены подтверждения без удаления.

За исключением сохранённых случаев, охватываемых в What deleting a session removes, удаление удаляет сеанс из списка, и worktree, который Claude создал для него, удаляется, сохраняется или остаётся на месте в зависимости от того, как вы удаляете и что содержит worktree. Стенограмма разговора всегда остаётся на вашем локальном компьютере, доступная через claude --resume.

Чтобы вернуть сеанс на Claude Code v2.1.212 или позже, введите /resume в поле отправки. Открывается выбор с прошлыми сеансами репозитория, из которого вы открыли agent view, новейшие первыми, включая сеансы, которые вы удалили из списка; сеансы, которые уже имеют строку, не указаны. ↑/↓ перемещают выделение, Enter возобновляет выбранный сеанс как фоновый сеанс, поэтому он повторно присоединяется к списку как строка, и Esc закрывает выбор.

Выбор открывается только для голого /resume. Целевое, ограниченное или ограниченное возобновление не может быть обслужено выбором, поэтому agent view показывает подсказку attach to a session to run it вместо этого, когда:

  • /resume называет id или поисковый термин
  • представление ограничено с помощью --cwd
  • представление было запущено с --safe-mode
  • представление было открыто с флагом, таким как --permission-mode или --settings

Завершённые сеансы, которые не помещаются на экран, складываются в строку … N more. Сбои и сеансы с открытым pull request всегда остаются видимыми. Группа Completed заполняет вертикальное пространство, оставшееся после живых групп, и на коротком терминале заголовок сжимается в одну строку резюме, поэтому сеансы, которые работают или требуют ввода, остаются видимыми.

Фильтрация сеансов

Начните ввод в поле отправки с одного из этих фильтров, чтобы сужать список по мере ввода:

Фильтр Показывает
a:<name> Сеансы, запускающие названного агента
s:<state> Сессии в указанном состоянии, например s:working, или под указанным заголовком группы, например s:ready для Ready for review. s:blocked показывает всё, что ждёт вас
n:<text> Сессии, имя или первый промпт которых содержит текст, например n:login. Требуется Claude Code v2.1.287 или новее
o:<text> Сессии, результат которых содержит текст, например o:merged. o: без текста показывает все сессии, сообщившие результат
Номер pull request или merge request, например #1234, или его URL Сессия, работающая над этим pull request или merge request
Любой другой URL Сеанс, первый запрос которого содержал этот URL

Чтобы объединить фильтры, начните с a:, s:, n: или o: и добавьте другие через пробел. Список показывает сессии, соответствующие всем фильтрам. Например, s:blocked a:reviewer показывает сессии reviewer, ожидающие вас.

Пока фильтр активен, свёрнутые вами группы разворачиваются, чтобы показать совпадения, и первое совпадение выбирается, так что нажатие Enter открывает его. Очистите поле ввода, чтобы снять фильтр, и эти группы снова свернутся.

Сочетания клавиш

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

Сочетание клавиш Действие
↑ / ↓ Перемещение между строками
PgUp / PgDn Перемещение вверх или вниз на экран строк
Home / End Переход к первой или последней строке
Enter Подключение к выбранной сессии или отправка текста из поля ввода, если это не фильтр
Space Открытие или закрытие панели просмотра для выбранного сеанса
Shift+Enter Вставка новой строки в поле отправки, как в основной подсказке
Ctrl+Enter Отправка и немедленное подключение в терминалах, где панель ? указывает ctrl+enter to start and open
→ Подключение к выбранному сеансу
Alt+1..Alt+9 Подключение к сеансу 1–9 в каталоге сфокусированного сеанса
Tab На пустом вводе просмотр всех subagents. В противном случае применение выделенного предложения
Ctrl+S Переключение группировки между состоянием и каталогом
Ctrl+T Закрепление или открепление выбранного сеанса
Ctrl+R Переименование выбранного сеанса
Ctrl+G Открытие подсказки отправки в вашем $VISUAL или $EDITOR
Ctrl+J Вставка новой строки в поле отправки
Ctrl+X Остановка сеанса; нажмите снова в течение двух секунд для удаления
Shift+↑ / Shift+↓ Переупорядочение выбранного сеанса
Esc Закрытие панели просмотра, очистка ввода или выход. Когда вы открыли agent view путём отправки вашего сеанса в фон с помощью ←, финальный Esc возвращает к этому разговору вместо выхода. С режимом vim редактора включённым, нажатие Esc в вводе переключает из режима INSERT в режим NORMAL и сохраняет ваш текст, как в основной подсказке
Ctrl+C Очистка ввода; нажмите дважды для выхода
? Показать все сочетания клавиш

Ctrl+S, Ctrl+T и Ctrl+G следуют вашему keybindings.json. Переопределите или отмените привязку Ctrl+S и Ctrl+T с помощью действий agents:switchView и agents:togglePin в контексте Agents, и Ctrl+G через привязку chat:externalEditor контекста Chat. Другие сочетания клавиш в таблице не могут быть переопределены.

Отправка новых агентов

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

Из agent view

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

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

Вставьте изображение в промпт, чтобы приложить к задаче снимок экрана или диаграмму.

Вставленный текст длиннее 800 символов или более трёх строк сворачивается в заполнитель [Pasted text #N], чтобы поле ввода оставалось однострочным; при отправке передаётся полный текст. Чтобы просмотреть или отредактировать свёрнутый текст перед отправкой, вставьте тот же текст ещё раз, и заполнитель развернётся обратно в поле ввода.

С помощью префиксов или упоминаний в промпте можно управлять тем, как запускается сессия:

Ввод Результат
<agent-name> <prompt> Если первое слово совпадает с именем пользовательского субагента, этот субагент запускается как основной агент сессии с конфигурацией из его frontmatter
@<agent-name> Упомяните пользовательского субагента в любом месте промпта, чтобы запустить его как основного агента
@<repo> Упомяните репозиторий, чтобы запустить сессию в нём. О том, какие репозитории отображаются в списке, см. в разделе Отправка в конкретный каталог
/<command> Предлагает скиллы и команды для отправки в качестве промпта
! <command> Запускает shell-команду как фоновое задание вместо сессии Claude. Задание отображается строкой, к которой можно подключиться, за которой можно наблюдать и от которой можно отключиться
#<number> или URL pull request или merge request Если над этим pull request или merge request уже работает какая-либо сессия, Claude Code выделяет её строку вместо отправки новой сессии

Небольшой набор команд выполняется в самом agent view, а не отправляется:

  • /exit и /quit закрывают agent view
  • /logout выполняет выход из учётной записи
  • /model задаёт модель для отправки
  • /login открывает диалоговое окно входа, чтобы вы могли войти снова без подключения к сессии
  • /resume без аргументов или его псевдоним /continue открывает список прошлых сессий репозитория, чтобы вернуть одну из них как фоновую сессию. Требуется Claude Code v2.1.212 или новее

Скиллы, ваши собственные команды и встроенные команды, разворачивающиеся в промпт, такие как /init, отправляются в новую фоновую сессию как её первый промпт. Для остальных встроенных команд вместо этого отображается подсказка attach to a session to run it. Всё, что вы ввели, остаётся в поле ввода рядом с подсказкой, чтобы вы могли это отредактировать.

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

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

Отправка в конкретный каталог

Новая сессия запускается в каталоге, из которого вы открыли agent view. Чтобы выбрать другой каталог, используйте любой из этих способов:

  • Откройте claude agents в этом каталоге.

  • Откройте claude agents в родительском каталоге и упомяните дочерний репозиторий с помощью @<repo> в промпте. При вводе @ отображаются следующие цели:

    • Git-репозитории на один уровень ниже каталога запуска
    • Зарегистрированные git worktree репозитория, из которого вы запустили agent view, расположенные внутри его дерева каталогов, например те, которые Claude создаёт в .claude/worktrees/; они помечены извлечённой в них веткой. Worktree, добавленные за пределами репозитория, например с помощью git worktree add ../feature, не отображаются
    • Любой каталог, для которого в списке уже есть сессия

    Каталог, имя которого содержит пробел, не отображается.

  • Из оболочки перейдите в каталог с помощью cd и выполните claude --bg "<prompt>".

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

Изнутри сессии

Две команды переносят работу из текущей сессии в фон: /background отправляет туда текущий диалог и освобождает терминал, а /fork отправляет копию, пока вы продолжаете работать на месте.

Отправка сессии в фон

Выполните /background или его псевдоним /bg, чтобы перенести текущий диалог в фоновую сессию. Передайте промпт, например /bg run the test suite and fix any failures, чтобы сначала дать ещё одну инструкцию. Если Claude отвечает в момент выполнения /bg, ответ продолжится в фоновой сессии.

При выходе из сессии, в которой ещё выполняется фоновая работа — субагенты, фоновые shell-команды, рабочие процессы или мониторы, — вместо немедленного выхода отображается диалоговое окно Background work is running. Выберите Move to background and exit, чтобы отправить сессию в фон так же, как это делает /background, и вернуться в оболочку. Этот вариант не отображается, если agent view отключён.

Если у фоновой сессии в списке уже есть такое же имя, как у диалога, Claude Code добавляет номер к имени новой строки, например my-session (2), а имя существующей строки не меняет. Чтобы переименовать новую строку, выделите её в agent view и нажмите Ctrl+R.

Копирование сессии с помощью /fork

Выполните /fork, чтобы скопировать текущий диалог в новую фоновую сессию, пока исходная продолжает работать. Копия начинается со всего содержимого диалога до этого момента; где именно запускается копия, описано в пунктах ниже. В неё также переносятся модель, режим разрешений, уровень effort и все каталоги или разрешения «больше не спрашивать», добавленные во время сессии. Копия отображается в agent view отдельной строкой.

После ответвления два диалога независимы: ничто из того, что делает копия, само по себе не попадает в исходный диалог, хотя в сессиях, где включён обмен сообщениями между сессиями, Claude в любой из сессий может явно отправить сообщение другой.

Копирование сессии требует Claude Code v2.1.212 или новее; в версиях с v2.1.161 по v2.1.211 /fork вместо этого запускает ответвлённого субагента, что теперь делает /subtask. Когда agent view отключён, /fork сохраняет поведение с ответвлённым субагентом, а /subtask недоступна.

Передайте промпт, например /fork open a draft pull request with the work so far, и копия сразу начнёт над ним работать. Без промпта копия ждёт первой инструкции: выделите её строку в claude agents и нажмите Space, чтобы отправить инструкцию, или выполните claude attach <id>. Пока копия ждёт, в выделенной строке отображается space to send it a prompt.

Подтверждение /fork — это одна строка, показывающая состояние копии, например session running, имя её строки в agent view и её ID сессии для claude attach. Щёлкните имя, чтобы переключиться на копию: текущая сессия уходит в фон, как при нажатии ←, а agent view открывает сессию копии.

Кроме случаев, когда копия редактирует файлы на месте, Claude Code указывает ей создать собственный worktree перед внесением изменений в код. Вне Git-репозитория такую инструкцию получает только копия, вынесенная из worktree, созданного хуком; без хука WorktreeCreate копия редактирует файлы на месте. Копии, вынесенной из вашего worktree, также указывается никогда не редактировать файлы в этом worktree, не запускать в нём команды и не входить в него, независимо от настройки изоляции.

Место запуска копии зависит от того, где выполняется текущая сессия:

  • Как и любая отправленная сессия, копия переходит в собственный worktree перед редактированием файлов. В этом случае в подтверждении не указывается, где запускается копия.
  • Если ваша сессия перешла в свой связанный worktree уже после запуска, копия начинает работу там, где сессия находилась до перехода, и, если только она не редактирует файлы на месте, вносит изменения в код в собственном worktree. Если в вашем worktree извлечена ветка, эта инструкция также указывает копии, чья задача основана на вашей работе, создать новую ветку на основе вашей, поскольку ваша ветка остаётся извлечённой в вашем worktree. Подтверждение заканчивается на runs in the origin tree.
  • Если вы запустили сессию внутри связанного worktree репозитория, у которого есть основное рабочее дерево, копия запускается в этом основном рабочем дереве с тем же правилом о собственном worktree, но без инструкции о ветке. Подтверждение и здесь заканчивается на runs in the origin tree.
  • У сессии, запущенной внутри worktree в структуре с bare-репозиторием, нет основного рабочего дерева, куда можно вернуться, поэтому копия остаётся на месте, а подтверждение заканчивается на edits this checkout. То же примечание появляется, когда изоляция в worktree отключена в сессии, которая не находится внутри связанного worktree, поскольку тогда копия редактирует открытые вами файлы.

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

Что переносится при отправке в фон

При отправке в фон запускается новый процесс, который возобновляет работу из сохранённого диалога, и выполняющаяся работа переходит в него: запущенные фоновые shell-команды, субагенты в фоне, динамические рабочие процессы, запланированные задачи, созданные с помощью /loop, и автоматические ответы Claude на комментарии к артефактам — всё это переносится и продолжает выполняться там. Субагент переходит вместе со всем, что он запустил, поэтому он переносится, только если вся эта работа тоже может перейти. Чтобы останавливать выполняющуюся работу вместо переноса, задайте переменную окружения CLAUDE_DISABLE_ADOPT=1; тогда Claude Code будет просить подтверждения перед отправкой в фон.

Если в динамическом рабочем процессе ещё выполняются субагенты, Claude Code перед отправкой в фон показывает диалоговое окно Background this session?, в котором указано, сколько субагентов будет перезапущено. Выберите Stay, чтобы сначала дать им завершиться. Если вы подтвердите, Claude Code воспроизведёт запуск в фоновой сессии: субагенты, которые ещё выполнялись, начнут работу с самого начала, поэтому уже израсходованные ими токены будут потрачены снова. О том, какие завершённые субагенты возвращают сохранённые результаты, а какие запускаются заново, см. в разделе Возобновление после паузы.

Claude Code останавливает работу, которую нельзя перенести, например запущенный монитор, а вместе с ним — и субагента в фоне, которому принадлежит монитор. Если такая работа выполняется, Claude Code показывает диалоговое окно Background this session?, чтобы вы подтвердили её остановку.

Уже находясь в фоне, сессия может запускать новых субагентов, мониторы и фоновые команды, и они продолжают работать при последующих отключениях и повторных подключениях.

Флаги конфигурации из исходного запуска переносятся в фоновую сессию, поэтому её MCP-серверы, настройки и резервная модель продолжают действовать:

  • --mcp-config и --strict-mcp-config
  • --settings
  • --setting-sources
  • --add-dir
  • --plugin-dir
  • --fallback-model
  • --allow-dangerously-skip-permissions

Каталоги, добавленные во время сессии с помощью /add-dir, тоже переносятся. Перенос --allow-dangerously-skip-permissions сохраняет доступность bypassPermissions в фоновой сессии, но не даёт ничего нового: режим по-прежнему требует однократного интерактивного согласия, описанного в разделе Режим разрешений, модель и effort.

Из оболочки

Передайте --bg или его полную форму --background, чтобы запустить сессию, которая сразу уходит в фон:

claude --bg "investigate the flaky SettingsChangeDetector test"

Промпт передаётся позиционным аргументом, а не значением -p. Claude Code отклоняет сочетание --bg с -p или --print ещё до создания сессии, поскольку --print никогда не запускает интерактивную сессию, к которой подключается claude agents.

Если вы запускаете claude --bg из терминала в каталоге, которому вы ещё не доверяете, сначала появляется диалоговое окно доверия рабочему пространству, и сессия запускается после вашего согласия. Если вы откажетесь, Claude Code завершит работу, не запуская сессию. Там, где диалоговое окно появиться не может, например в скрипте, команда вместо этого завершается с ошибкой Workspace not trusted.

Чтобы запустить определённого вами субагента, например code-reviewer, как основного агента сессии, используйте --bg вместе с --agent:

claude --agent code-reviewer --bg "address review comments on PR 1234"

Если имя не совпадает ни с одним из ваших субагентов, запуск не удаётся: Claude Code выводит предупреждение no agent named и всё равно сообщает, что сессия отправлена в фон, но сессия сразу завершается с ошибкой --agent '<name>' not found.

Когда фоновая сессия позже возобновляется или перезапускается, Claude Code восстанавливает агента и его ограничения на инструменты; о его системном промпте см. в разделе Флаги системного промпта в возобновлённых диалогах. Сначала агент ищется в собственном каталоге сессии, при условии что вы доверяете этому рабочему пространству, поэтому агент уровня проекта загружается, даже если сессия возобновлена из другого каталога. Если агента больше не существует, сессия продолжается со стандартными инструментами, а её транскрипт открывается предупреждением с именем агента.

Чтобы продолжить существующий диалог в фоне, передайте его полный ID сессии с помощью --resume:

claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"

В Claude Code v2.1.257 или новее Claude Code либо продолжает эту сессию под тем же ID, либо запускает копию под новым ID и выводит строку note: с объяснением, почему не удалось продолжить на месте. Когда сессия продолжается на месте, claude agents показывает для неё одну строку.

Если вы сочетаете --bg с --continue, с --resume без аргумента или с --resume с именем или путём к файлу, Claude Code всегда запускает такую копию. Добавьте --fork-session, чтобы намеренно запустить копию без примечания.

Передайте --name, чтобы задать отображаемое имя сессии в agent view вместо автоматически сгенерированного:

claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

После отправки в фон Claude выводит короткий ID сессии и команды для управления ею. Если служба, в которой работают фоновые сессии, ещё не запущена, --bg может сначала вывести Starting background service… над этим выводом. Если вы передали --name, имя отображается после короткого ID:

backgrounded · 7c5dcf5d · flaky-test-fix
  claude agents             list sessions
  claude attach 7c5dcf5d    open in this terminal
  claude logs 7c5dcf5d      show recent output
  claude stop 7c5dcf5d      stop this session

Запуск shell-команды

Чтобы запустить shell-команду как фоновое задание вместо сессии Claude, передайте --exec. В следующем примере pytest -x запускается как фоновое задание:

claude --bg --exec 'pytest -x'

В agent view такое же задание можно отправить, введя ! первым символом в поле ввода: ! отображается как префикс, всё после него — это команда, а Enter запускает задание.

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

Чтобы увидеть вывод, подключитесь к строке, нажмите Space для просмотра без подключения или выполните claude logs <id> из оболочки. Захваченный вывод хранится в памяти и не записывается на диск. Строка и её вывод автоматически удаляются примерно через пять минут после завершения команды, поэтому, если вам нужен результат, прочитайте его до этого.

Как изолируются правки файлов

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

Claude не использует worktree, когда:

  • Вы отправили уже открытую сессию в фон с помощью ← или /background. Эта сессия продолжает редактировать файлы там, где уже работала
  • Сессия уже находится внутри связанного git worktree, независимо от того, создал ли его Claude в .claude/worktrees/ или вы создали его в другом месте с помощью git worktree add
  • Файл, который редактирует Claude, находится внутри связанного git worktree, например созданного сессией или её субагентом с помощью git worktree add
  • Рабочий каталог не является Git-репозиторием и хук WorktreeCreate не настроен
  • Запись выполняется за пределами рабочего каталога

Чтобы отключить изоляцию в worktree для репозитория, где git worktree неудобны, задайте для worktree.bgIsolation значение "none". Тогда фоновые сессии редактируют вашу рабочую копию напрямую, не переходя сначала в worktree. Добавьте настройку в файл .claude/settings.json проекта:

{
  "worktree": {
    "bgIsolation": "none"
  }
}

Вне Git-репозитория сессии пишут непосредственно в рабочий каталог и не изолированы друг от друга, поэтому не отправляйте параллельные сессии, редактирующие одни и те же файлы. Если вы используете другую систему контроля версий, настройте хук WorktreeCreate, и Claude будет изолировать правки так же, как для Git.

Если хук завершается с ошибкой в каталоге, который не является Git-репозиторием, Claude пропускает изоляцию для этого каталога и редактирует рабочий каталог на месте. Внутри Git-репозитория сессия, которую Claude переносит в worktree перед редактированием, не может редактировать файлы в общей рабочей копии, пока этот перенос не произойдёт.

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

Субагент, порождённый фоновой сессией, наследует рабочий каталог сессии. Когда сессия находится в worktree, правки файлов субагента попадают в этот worktree, а не в вашу рабочую копию. Чтобы вместо этого выделить субагенту отдельный worktree, задайте isolation: worktree в его frontmatter или передайте isolation: "worktree" при его запуске.

Когда фоновая сессия внесла изменения в код в worktree, в который перешёл Claude, Claude Code указывает Claude сохранить работу перед завершением, чтобы она уцелела, если вы удалите сессию и её worktree:

  • Коммит и push: Claude делает коммит, не спрашивая, и выполняет push ветки, если у репозитория есть удалённый репозиторий.
  • Черновой pull request: Claude открывает его, когда этого требует задача, и в строке появляется метка #N.
  • Никогда: push в main или master, принудительный push и слияние.
  • Ваши инструкции по Git имеют приоритет: если в задаче, CLAUDE.md или памяти сказано, что коммиты или push вы выполняете сами, Claude оставляет работу с Git вам.

Сессия, которая редактирует рабочую копию, не изолированную ею самой, по-прежнему спрашивает перед коммитом или переключением веток. Это относится к случаям, когда для изоляции задано "none", когда перенос в worktree не удался или когда сессия запустилась внутри уже существовавшего worktree.

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

Что удаляется при удалении сессии

Удалите сессию двойным нажатием Ctrl+X в agent view или с помощью claude rm. За исключением описанных ниже случаев, когда она сохраняется, сессия исчезает из списка. Её транскрипт остаётся на вашем компьютере и доступен через claude --resume, а удаление сохраняется после перезапусков супервизора.

Что происходит с worktree, который Claude создал для сессии:

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

  • claude rm сохраняет его вместе со строкой сессии, если в нём есть незафиксированные изменения.

  • Ни agent view, ни claude rm не удаляют worktree, который использует или заблокировала другая работающая сессия, и повторное удаление этого не меняет. Claude Code сохраняет worktree и сессию и называет сохранённый каталог и причину; в agent view в строке сессии отображается not deleted. Закройте другую сессию, затем удалите снова.

  • Если вы удаляете сессию, в worktree которой есть коммиты, о которых Claude Code не может подтвердить, что они сохранены где-то ещё, Claude Code сохраняет worktree и сессию, а в сообщении указываются ветка worktree и количество коммитов без push. Сообщение также предлагает два варианта дальнейших действий: выполнить push коммитов или удалить снова, чтобы отбросить их.

    Коммиты в удалённом репозитории не блокируют удаление. Не блокируют его и коммиты в локальной копии ветки по умолчанию вашего удалённого репозитория origin, если эта ветка извлечена в основной рабочей копии, то есть в самом каталоге репозитория, а не в worktree.

    После такого отказа вы выбираете:

    • Чтобы сохранить коммиты, выполните их push или слейте их в эту ветку по умолчанию, затем снова удалите сессию.
    • Чтобы отбросить их, снова удалите сессию без push: дважды нажмите Ctrl+X на её строке в agent view или выполните команду claude rm <id> --discard-unpushed, выведенную в сообщении об отказе. Это удаляет сессию и worktree вместе с его веткой, отбрасывая коммиты без push и все незафиксированные изменения.

    При повторном удалении Claude Code отбрасывает только то, что было показано в сообщении об отказе: если с тех пор в worktree появился новый коммит, Claude Code снова сохраняет его и показывает обновлённое состояние.

    Если этот worktree упоминается и в записях другой завершённой сессии, он остаётся при повторном удалении; выполните push коммитов, затем удалите снова.

  • Worktree, который Git больше не распознаёт, например после git worktree prune, не блокирует удаление. Claude Code удаляет сессию и оставляет каталог на диске.

  • Если Git или ваш хук WorktreeRemove не может удалить worktree, Claude Code сохраняет worktree и сессию, а в сообщении указывается причина. Для хука сообщение указывает, как он завершился, например exited 1, и приводит начало его stderr. Сообщение также подсказывает, что из этого сделать дальше:

    • Снова удалите сессию, чтобы всё равно удалить каталог: дважды нажмите Ctrl+X на её строке в agent view или выполните команду claude rm <id> --force-remove-worktree <worktree-id>, выведенную в сообщении об отказе claude rm. Ветка worktree остаётся в репозитории.

      Claude Code предлагает это, только если может подтвердить всё следующее:

      • Каталог является одним из связанных worktree репозитория в .claude/worktrees/
      • Ни в worktree, ни в извлечённом подмодуле нет незафиксированных изменений отслеживаемых файлов
      • Каталог не упоминается в записях никакой другой сессии

      Если Claude Code не может проверить состояние извлечённого подмодуля, например заменённого отдельным Git-репозиторием, он этот вариант тоже не предлагает.

    • Устраните препятствие, например сделайте коммит незафиксированных изменений или уберите их в stash, перенесите отдельный Git-репозиторий из worktree, закройте то, что использует каталог, или исправьте хук, затем снова удалите сессию.

    • Удалите каталог самостоятельно, затем снова удалите сессию.

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

Сессию, каталог worktree которой не принадлежит ни одному Git-репозиторию — потому что репозиторий был удалён или хук WorktreeCreate создал каталог в другом месте, — всё равно можно удалить. Пока в каталоге остаются файлы:

  • Agent view запрашивает то же двойное нажатие Ctrl+X, прежде чем отбросить их. Для каталога, созданного хуком, вместо этого запускается ваш хук WorktreeRemove, а если его нет, удаление отклоняется и сессия сохраняется.
  • claude rm сохраняет сессию и worktree и называет причину.

В обоих случаях сохраняется каталог, упомянутый в записях другой завершённой сессии.

Выбор модели

Имя модели в заголовке agent view — это модель по умолчанию для отправки. Новые сессии, запускаемые из поля ввода, используют эту модель, которая берётся из настройки model в ваших пользовательских настройках. Задайте её, выбрав модель в меню /model, или отредактируйте настройку напрямую.

Чтобы переопределить модель по умолчанию для отправки на весь сеанс работы с agent view, передайте --model при открытии agent view. См. раздел Режим разрешений, модель и effort.

Чтобы изменить модель по умолчанию для отправки прямо в agent view, введите в поле ввода /model и имя модели и нажмите Enter. Заголовок обновится и покажет эту модель с пометкой (session), и сессии, отправленные после этого, будут её использовать. Введите /model default, чтобы сбросить переопределение и вернуться к модели по умолчанию для отправки. Это переопределение действует до конца текущего запуска claude agents и не записывается в файл настроек. В следующем примере одна сессия отправляется на Opus, а следующая — на Sonnet:

/model opus
refactor auth
/model sonnet
run the test suite

Каждая фоновая сессия может работать на своей модели. Чтобы переопределить модель для одной сессии:

  • Из оболочки передайте --model вместе с claude --bg.
  • Подключитесь к работающей сессии и выполните /model, чтобы переключиться: выбор в меню или введённая команда /model <name> сохраняется как модель по умолчанию для новых сессий, если только вы не нажмёте s в меню, чтобы переключиться только для этой сессии. Переключение только для сессии сохраняется, если процесс сессии запускается заново.
  • Отправьте субагента, в frontmatter которого задано поле model.

Режим разрешений, модель и effort

Фоновая сессия получает настройки, провайдера, режим разрешений, модель и уровень effort в зависимости от того, где и как вы её отправили. В подразделах ниже описан каждый источник, а также то, что сохраняется, когда супервизор перезапускает сессию.

Настройки и провайдер

Фоновая сессия читает свои настройки из каталога, в котором она работает, так же как если бы вы запустили там claude с перенесёнными в неё флагами конфигурации. Сюда входят значения env в настройках проекта, поэтому заданная там ANTHROPIC_MODEL или переменная провайдера применяется ко всем фоновым сессиям в этом каталоге.

Фоновая сессия также работает с PATH той оболочки, из которой вы её отправили, поэтому запускаемые ею команды находят те же инструменты, что и ваш терминал. Она также сохраняет выбор облачного провайдера этой оболочки, например CLAUDE_CODE_USE_BEDROCK или CLAUDE_CODE_USE_VERTEX, вместе с псевдонимами ANTHROPIC_DEFAULT_*_MODEL и любым экспортированным там переопределением CLAUDE_CODE_EXTRA_BODY.

LLM-шлюз

Если вы направляете Claude Code через LLM-шлюз, поместите переменные шлюза в блок env файла настроек, а не экспортируйте их в оболочке, и фоновые сессии прочитают их вместе с остальными настройками. В разделе Задание в файле настроек показан этот блок и указано, какой файл настроек использовать для учётных данных.

Если же вы экспортируете ANTHROPIC_BASE_URL шлюза только в оболочке, он попадает в фоновую сессию вместе с экспортированными с ним ANTHROPIC_CUSTOM_HEADERS и учётными данными, только если супервизор сам был запущен из оболочки, экспортировавшей тот же шлюз, и только в следующих случаях:

  • Вы отправляете собственную сессию в фон с помощью ← или /background
  • Вы отправляете сессию в каталог, в котором находитесь
  • Вы пробуждаете остановленную сессию в каталоге, в котором находитесь, подключаясь к ней или отвечая ей

Claude Code передаёт и шлюз, стоящий перед облачным провайдером. Если оболочка, из которой вы отправляете сессию, выбирает провайдера и экспортирует эндпоинт его шлюза вместе с флагом обхода аутентификации, Claude Code передаёт эту пару из эндпоинта и флага в сессию на тех же условиях, что и ANTHROPIC_BASE_URL, вместе с ANTHROPIC_CUSTOM_HEADERS. Например, экспортируйте CLAUDE_CODE_USE_VERTEX=1 вместе с ANTHROPIC_VERTEX_BASE_URL и CLAUDE_CODE_SKIP_VERTEX_AUTH=1, и Claude Code передаст этот эндпоинт и флаг.

Claude Code применяет переданный шлюз только к работающему процессу этой сессии и никогда не записывает его на диск.

Режим разрешений

Режим разрешений зависит от того, как вы запустили сессию:

  • Отправлена в фон с помощью /bg или ←: Claude Code сохраняет режим разрешений, в котором находилась сессия, поэтому сессия, переключённая вами на acceptEdits или auto, остаётся в нём после отключения
  • Отправлена из agent view, открытого с помощью ←: сначала применяется собственная конфигурация целевого каталога, а режим разрешений исходной сессии применяется, если больше ничто его не задаёт
  • Отправлена из claude agents, запущенного в оболочке, или с помощью claude --bg: новая сессия запускается так же, как новая сессия claude в этом каталоге, если только вы не отправили её из agent view, открытого со значениями по умолчанию для отправки. Порядок приведён в разделе В каком режиме разрешений запускается сессия

Для сессии, отправленной из agent view, открытого с помощью ←, Claude Code берёт режим разрешений из первого подходящего источника:

  1. permissions.defaultMode целевого каталога. Действуют два правила об источниках:
  2. Режим разрешений исходной сессии

Когда Claude Code отклоняет режим источника как слишком разрешительный, решение принимает следующий источник в списке. Например, если вы отправляете сессию из сессии в режиме планирования в каталог, в зафиксированных в репозитории настройках которого запрошен acceptEdits, новая сессия запускается в режиме планирования. Если перенести этот defaultMode в ~/.claude/settings.json, он применяется независимо от режима разрешений исходной сессии.

По степени разрешительности режимы идут так: plan, затем Manual и dontAsk, затем acceptEdits и auto, каждый из которых считается более разрешительным, чем другой, затем bypassPermissions.

Значения по умолчанию для отправки

Чтобы задать значения по умолчанию для всех сессий, отправляемых из agent view, передайте при его открытии любой из флагов --permission-mode, --model, --effort или --agent:

claude agents --permission-mode plan --model opus --effort high

--effort здесь принимает те же значения, что и флаг --effort верхнего уровня, включая ultracode.

--agent задаёт субагента, который используется, когда промпт отправки не называет субагента ни через @name, ни первым словом. По умолчанию используется настройка agent, если она задана, иначе — встроенный универсальный агент claude. Указание субагента в поле ввода переопределяет оба варианта.

claude agents также принимает --dangerously-skip-permissions как сокращение для --permission-mode bypassPermissions, а --allow-dangerously-skip-permissions — чтобы сделать bypassPermissions доступным в цикле Shift+Tab каждой отправленной сессии, не запуская её в этом режиме. Оба флага соответствуют флагам CLI верхнего уровня.

Передайте --restricted, чтобы каждая сессия, отправленная из этого представления, запускалась в ограниченном режиме, как если бы она была запущена с флагом --restricted верхнего уровня. Требуется Claude Code v2.1.248 или новее.

Действующие значения по умолчанию отображаются в нижней строке под полем ввода.

Claude Code отклоняет claude --bg --permission-mode bypassPermissions, пока вы не примете предупреждение об обходе разрешений, один раз интерактивно выполнив claude --dangerously-skip-permissions, поскольку этот режим позволяет сессии, за которой вы не наблюдаете, действовать без подтверждения. Передача --dangerously-skip-permissions или --permission-mode bypassPermissions в claude agents показывает то же предупреждение, если вы не принимали его ранее, и после согласия bypassPermissions применяется к сессиям, которые вы запускаете из этого представления. Передача --allow-dangerously-skip-permissions тоже показывает это предупреждение, и после согласия bypassPermissions становится доступным в цикле Shift+Tab этих сессий, но они в нём не запускаются.

Что сохраняется при перезапусках

Выбранные для фоновой сессии режим разрешений, модель и уровень effort, а также переносимые ею флаги конфигурации сохраняются, когда супервизор позже останавливает и перезапускает её процесс. Сессия, запущенная с помощью claude --bg --dangerously-skip-permissions или claude --bg --permission-mode bypassPermissions, остаётся в bypassPermissions после такого перезапуска. Модель или уровень effort, изменённые во время сессии с помощью /model или /effort, тоже сохраняются.

Если сессия взяла уровень effort из ваших настроек, а не из --effort или /effort, Claude Code заново читает настройки при каждом запуске процесса для этой сессии. После того как вы отредактируете сохранённый уровень effort в settings.json, изменение применяется к сессиям, которые вы отправляете в фон с помощью ← или /bg, и к их последующим перезапускам. Сохранённый уровень effort — это ключ effortLevel или запись modelSettings.

Claude Code также сохраняет при таком перезапуске имя, заданное с помощью /rename или Ctrl+R, поэтому вы по-прежнему можете выполнить claude --resume <name>, чтобы перейти к сессии.

Промпт, отложенный с помощью Ctrl+S во время подключения, тоже сохраняется вместе с сессией. Снова откройте сессию после того, как её процесс был остановлен или перезапущен, и нажмите Ctrl+S, чтобы восстановить отложенный текст. Вставленное содержимое в отложенном промпте после перезапуска не сохраняется.

Настройки, плагины и MCP-серверы

Agent view принимает те же флаги конфигурации, что и claude, для загрузки настроек, плагинов, MCP-серверов и дополнительных каталогов. Agent view применяет --settings, --setting-sources и --plugin-dir к себе и передаёт все флаги конфигурации в сессии, которые вы из него отправляете, поэтому плагин или MCP-сервер, загруженный таким образом, доступен в этих сессиях.

Флаг Результат
--settings <file-or-json> Переопределяет настройки для agent view и отправленных сессий
--setting-sources <sources> Загружает только указанные источники настроек в agent view и отправленных сессиях
--add-dir <path> Предоставляет доступ к файлам в дополнительном каталоге
--plugin-dir <path> Загружает плагин из локального каталога
--mcp-config <file-or-json> Загружает MCP-серверы из файла конфигурации или строки JSON
--strict-mcp-config Использует только MCP-серверы из --mcp-config, игнорируя остальную конфигурацию MCP. О том, как действует этот флаг при наличии управляемого файла MCP, см. в разделе Исключительный контроль с помощью managed-mcp.json

Повторяйте --add-dir, --plugin-dir или --mcp-config для каждого значения. claude agents не поддерживает форму со значениями через пробел, например --add-dir a b c.

--settings, --setting-sources и --plugin-dir можно указывать до или после agents. --add-dir и --mcp-config указывайте после agents: если поставить любой из них перед agents, claude agents --json завершится с ошибкой unknown option.

В следующем примере agent view открывается с переопределением настроек и одним дополнительным каталогом:

claude agents --settings ./ci-settings.json --add-dir ../shared-lib

--settings принимает путь к файлу или встроенную строку JSON. Путь к файлу должен указывать на существующий файл; в противном случае Claude Code завершает работу с ошибкой Settings file not found.

Управление сеансами из оболочки

Каждый фоновый сеанс имеет короткий ID, который вы можете использовать из оболочки. ID выводится при запуске сеанса с помощью claude --bg, и ID каждого сеанса — это имя его каталога в ~/.claude/jobs/. Эти команды полезны для написания скриптов или когда вы не хотите открывать agent view.

Команда Назначение
claude agents Открыть agent view
claude agents --cwd <path> Открыть agent view с областью действия сеансов, запущенных в <path>
claude agents --json Вывести сеансы в виде массива JSON и выйти. См. Вывод сеансов в виде JSON
claude attach <id> Подключиться к сеансу в этом терминале
claude logs <id> Вывести последний вывод сеанса
claude stop <id> Остановить сеанс. Также принимает claude kill
claude respawn <id> Перезапустить сеанс, работающий или остановленный, например, чтобы подобрать обновленный бинарный файл Claude Code. Перезапущенный сеанс возобновляет сохраненную беседу; когда её нет на диске, он снова запускает исходный prompt как новую беседу
claude respawn --all Перезапустить каждый работающий сеанс, например, чтобы переместить все сеансы на обновленный бинарный файл Claude Code одновременно
claude rm <id> Удалить сеанс из списка вместе с worktree, созданным Claude для него, когда это безопасно удалить; см. Что удаляет удаление сеанса. Стенограмма беседы остается на вашем локальном компьютере и остается доступной через claude --resume
claude rm <id> --discard-unpushed <commit>@<worktree-id> Удалить сеанс, чье удаление было отклонено из-за незафиксированных коммитов, отбросив worktree вместе с его веткой и коммитами. Передайте точное значение, которое вывело отклонение; см. Что удаляет удаление сеанса. Требуется v2.1.260 или позже
claude rm <id> --force-remove-worktree <worktree-id> Удалить сеанс, чье удаление было отклонено, потому что git или hook WorktreeRemove не смогли удалить его worktree, удалив каталог worktree в любом случае и оставив его ветку в репозитории. Передайте точное значение, которое вывело отклонение; см. Что удаляет удаление сеанса. Требуется v2.1.268 или позже
claude daemon status Вывести состояние supervisor, версию, каталог сокета и количество рабочих процессов
claude daemon stop --any Остановить процесс supervisor и фоновые сеансы, которые он размещает. Передайте --keep-workers, чтобы оставить фоновые сеансы работающими, чтобы следующий supervisor переподключился к ним. Следующий claude agents или claude --bg запускает новый supervisor

Вывод сеансов в виде JSON

claude agents --json выводит активные сеансы в виде массива JSON и выходит: каждый живой сеанс, плюс фоновые сеансы, которые все ещё работают или заблокированы, даже если их процесс завершился. Добавьте --all, чтобы также включить завершенные фоновые сеансы, и --cwd <path>, чтобы ограничить список сеансами, запущенными в этом каталоге.

Каждая запись описывает один сеанс:

Поле Присутствует Описание
cwd, kind, startedAt Всегда Рабочий каталог, interactive или background, и время начала в миллисекундах Unix
id Фоновые сеансы Короткий ID, используемый с claude attach, claude logs и claude stop
state Фоновые сеансы Одно из working, blocked, done, failed или stopped. См. Чтение состояния сеанса из скрипта для объяснения каждого значения
pid, status Пока процесс активен ID процесса и одно из busy, waiting или idle
waitingFor Когда status равен waiting На что заблокирован сеанс: permission prompt для одобрения, input needed для вопроса от Claude или запроса ввода от сервера MCP, sandbox request, worker request или dialog open
sessionId, name Когда установлены sessionId — это полный UUID сеанса, используемый с claude --resume. Имя интерактивного сеанса — это его имя отображения по умолчанию до тех пор, пока вы не назовете сеанс или не примете в нем план

Чтение состояния сеанса из скрипта

claude agents --json — это поддерживаемый способ чтения состояния сеанса извне Claude Code, например из строки состояния, планировщика или другого сеанса Claude, который контролирует фоновую работу. Опрашивайте claude agents --json --all, который продолжает выводить сеансы, чей процесс завершился, и читайте state, status и waitingFor каждой записи.

state Что это означает
working Выполняется ход, или сеанс находится между шагами работы, которую он выполняет самостоятельно, такой как итерация /loop или ожидание CI. status показывает, занят ли его процесс прямо сейчас
blocked Сеанс ждет вас: вопрос, который он задал, решение о разрешении или sandbox, ошибка, которую может исправить только вы, такая как истекший вход, или его первый prompt, если вы запустили его без него. Когда ожидание — это открытый prompt в живом процессе, waitingFor его называет
done Последний ход завершил то, что вы просили, и сеанс готов к вашему следующему prompt, независимо от того, активен ли его процесс
failed, stopped Задача завершилась с ошибкой или сеанс был остановлен

Сеанс, который завершил свой ход и ждет вашей следующей инструкции, читает done, а не blocked. blocked всегда означает, что сеансу нужно что-то от вас, прежде чем он сможет продолжить.

Файлы в ~/.claude/jobs/<id>/ не являются стабильным интерфейсом. Значения, которые сеанс или другая программа записывает в state, detail, tempo или needs, заменяются при следующем обновлении.

Если вы хотите, чтобы сеанс сообщал о прогрессе своими словами, попросите его написать свой собственный файл, например в $CLAUDE_JOB_DIR/tmp, вместо редактирования state.json.

Как размещаются фоновые сеансы

Claude Code рассматривает каждый сеанс, указанный в представлении агента, как фоновый сеанс, независимо от того, подключены ли вы к нему в данный момент. В отличие от этого, сеанс, запущенный путём прямого запуска claude, привязан к этому терминалу и завершается при его закрытии, если вы не отправите его в фон.

Чтобы проверить, какой тип сеанса вы используете, запустите /status. Строка Session kind показывает background job · attached или background job · unattended в фоновом сеансе, в зависимости от того, подключён ли терминал, и interactive в любом другом сеансе.

Процесс супервизора

Супервизор — это фоновая служба, которая запускает ваши фоновые сеансы, чтобы они продолжали работать после закрытия представления агента или вашего терминала. Claude Code запускает его в первый раз, когда вы отправляете сеанс в фон или открываете представление агента, и вам не нужно управлять им самостоятельно.

Каждый сеанс — это собственный процесс Claude Code под супервизором, и то, что происходит с этим процессом, зависит от состояния сеанса:

  • Работает, приостановлен на запросе разрешения или другом диалоге, или подключён: процесс продолжает работать. Работающий подагент, рабочий процесс или монитор считается работой.
  • Завершён или ожидает вашего следующего сообщения, и не подключён примерно час: супервизор останавливает процесс для освобождения ресурсов. Сеанс, который завершил свой ход, задав вам вопрос, считается ожидающим вашего следующего сообщения. Разговор остаётся на диске, и в следующий раз, когда вы подключитесь или ответите, сеанс возобновляется с того места, где он остановился. Закрепите сеанс с помощью Ctrl+T, чтобы его процесс продолжал работать.
  • Неожиданно завершился, пока супервизор работает: супервизор перезапускает процесс. Завершение сеанса, который вы отправили в фон самостоятельно, с помощью ← или /background, например с помощью kill, отмечает его как остановленный вместо перезагрузки. Для сеансов, которые завершились с выключением, см. Sessions show as failed or stopped after shutdown.
  • После автоматического обновления: супервизор перезапускает себя на новую версию и перемещает неактивные сеансы в фон. Сеансы, которые работают, ожидают вас или подключены, не прерываются.

Когда процесс сеанса останавливается или перезапускается, фоновые команды оболочки, динамические рабочие процессы и фоновые подагенты, которые Claude запустил в нём, переносятся в его следующий процесс; работающие мониторы и команды оболочки, которые запустил подагент, останавливаются вместе с процессом. Удаление сеанса останавливает всё, что он перенёс. Чтобы остановить всё это вместе с процессом вместо переноса, установите CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF на 1.

Супервизор и его сеансы аутентифицируются с теми же сохранённые учётные данные, что и ваши интерактивные сеансы. Для того, какие параметры и переменные оболочки достигают сеанса, включая PATH, см. Settings and provider. Для конечных точек шлюза см. LLM gateway.

Где хранится состояние

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

Путь Содержимое
~/.claude/daemon.log Журнал супервизора
~/.claude/daemon/roster.json Список работающих фоновых сеансов, используется для переподключения после перезагрузки
~/.claude/jobs/<id>/state.json Состояние для каждого сеанса, показанное в представлении агента. Читайте его через claude agents --json вместо анализа файла
~/.claude/jobs/<id>/tmp/ Каталог временных файлов для каждого сеанса. Записи Claude Write и Edit здесь не требуют разрешения. Удаляется при удалении сеанса

Каждый фоновый сеанс имеет переменную окружения CLAUDE_JOB_DIR, установленную в его каталог ~/.claude/jobs/<id>, поэтому команды оболочки, которые запускает сеанс, могут записывать временные файлы в $CLAUDE_JOB_DIR/tmp без конфликтов с параллельными сеансами.

Чтобы проверить это состояние без прямого чтения файлов, запустите claude daemon status. Он сообщает, доступен ли супервизор, его идентификатор процесса и версию, каталог сокета и сколько фоновых сеансов активны.

Команда также предупреждает, когда работающий супервизор находится на другой версии, чем claude, который вы вызвали, что происходит после обновления, в которое супервизор ещё не перезагрузился. Предупреждение показывает обе версии и говорит вам запустить claude daemon stop --any для получения новой версии. Когда Claude Code установлен как служба ОС, предлагаемая команда — это claude daemon stop без флага.

Сеансы сохраняют эту версию несовпадения нетронутыми: более старая версия Claude Code, которая обновляет state.json сеанса, сохраняет поля, которые она не распознаёт, и сохраняет сеанс в списке. Список сеансов в roster.json следует тому же правилу, поэтому сеансы, запущенные более новой версией, остаются доступными и продолжают принимать ввод после перезагрузки супервизора.

Отключение представления агента

Чтобы полностью отключить фоновых агентов и представление агента, установите параметр disableAgentView setting на true или установите переменную окружения CLAUDE_CODE_DISABLE_AGENT_VIEW. Администраторы могут применить это через управляемые настройки.

Troubleshooting

`claude agents` выводит список подагентов вместо открытия представления агентов

Если claude agents выводит количество, за которым следует список ваших настроенных подагентов, а затем завершает работу, представление агентов недоступно в вашей среде. Запустите claude update, чтобы установить последнюю версию.

Если представление агентов по-прежнему не открывается после обновления, проверьте, было ли оно отключено параметром или переменной окружения.

Agent view открывается без сеансов

До отправки вашего первого сеанса представление агентов показывает пустые заголовки разделов с описанием под каждым, плюс однострочное объяснение над вводом вместо списка сеансов. Введите подсказку в поле ввода внизу и нажмите Enter, чтобы отправить ваш первый сеанс.

Backgrounding показывает диалог `Background this session?`

Если нажатие ← для отправки текущего сеанса в фоновый режим показывает диалог Background this session?, сеанс имеет выполняемую работу, которая может быть остановлена, перезапущена или оставлена работающей без присмотра при отправке в фоновый режим, и Claude Code запрашивает подтверждение перед выполнением любого из этих действий:

  • Работа, которая не может быть перемещена: сеанс имеет работу, которая не может быть перемещена в фоновый сеанс, такую как работающий monitor. Диалог называет работу, которую Claude Code остановит, и отдельно считает задачи, которые переносятся.
  • Workflow с работающими подагентами: динамический workflow по-прежнему имеет работающих подагентов. Сам workflow переносится, но его работающие подагенты перезапускаются с начала, и диалог указывает, сколько их.
  • Автоматические ответы на артефакты: Claude отвечает на комментарии к артефакту самостоятельно. Эти ответы продолжаются в фоновом сеансе, и диалог об этом говорит.

Запустите /tasks, чтобы увидеть всё, что работает, затем подтвердите отправку в фон или выберите Stay, чтобы позволить работе завершиться сначала. См. What carries over when you background для того, какие типы работы переносятся и какие Claude Code останавливает.

Подсказка отклонена как слишком короткая

Поле ввода отправки ожидает описание задачи, а не разговорное начало. Подсказка короче четырёх символов отклоняется с подсказкой Too short, чтобы случайное нажатие клавиши не запустило сеанс. Опишите, что вы хотите, чтобы сеанс делал, например investigate the flaky checkout test.

Сеансы отображаются как неудачные или остановленные после выключения

Выключение или перезагрузка вашей машины останавливает работающие фоновые сеансы. Сеанс, который ожидал вашего ввода, остаётся под Needs input при возврате. Для любого другого работающего сеанса то, что показывает представление агентов, зависит от того, как давно он в последний раз добился прогресса:

  • В течение 48 часов сеанс отображается как неудачный. Подключитесь или ответьте на него, и он перезапустится с того места, где остановился.
  • Более 48 часов, например после того, как машина была выключена несколько дней, сеанс отображается как остановленный с ended while the background service was off. Нажмите Enter на строке, и нижний колонтитул показывает Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it. Нажмите Enter на той же строке снова, чтобы возобновить его сохранённую беседу. Ответ или claude attach <id> возобновляет его без этого подсказки нижнего колонтитула.

Когда очистка транскрипта удалила сохранённую беседу остановленного сеанса, Claude Code отказывается открывать строку: сообщение говорит, что нечего возобновлять. claude rm <id> удаляет строку, кроме сохранённых случаев, описанных выше, и claude respawn <id> запускает его исходную подсказку снова. См. This session's saved conversation is no longer on disk.

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

Открытие сеанса говорит, что беседа уже открыта

Два процесса не могут писать в один и тот же транскрипт. Когда сохранённая беседа остановленного сеанса уже открыта в другом работающем процессе Claude Code, Claude Code отказывается запустить процесс сеанса. То, что вы видите, зависит от того, что удерживает беседу:

  • Терминал, в котором вы возобновили беседу, например с помощью claude --resume или /resume: строка показывает Open in a terminal с подсказкой продолжить её там, и открытие строки показывает Can't open — this session is running in another terminal. Продолжайте в этом терминале или выйдите из него и откройте строку снова.
  • Другой неинтерактивный процесс Claude Code, например фоновый рабочий процесс для той же беседы, который ещё не завершился: открытие строки показывает This conversation is already open in another running Claude session. Используйте этот процесс или дождитесь его выхода и откройте строку снова.

Claude Code сохраняет ответ, который вы набрали при отказе, и отправляет его при следующем запуске сеанса.

Открытие сеанса говорит, что у него нет сохранённого транскрипта

Остановленный сеанс, который был отправлен в фоновый режим из другой беседы и остановлен до завершения его первого ответа, не имеет ничего для возобновления: до завершения этого первого ответа беседа по-прежнему существует только в сеансе, из которого она была отправлена в фоновый режим. claude attach отказывает открыть его с This session has no saved transcript.

В представлении агентов открытие этой строки показывает Press enter again to restart this session fresh ниже списка. Нажмите Enter на той же строке снова, чтобы перезапустить сеанс с пустой беседой, или запустите claude respawn <id> из оболочки.

Исходная беседа остаётся нетронутой; возобновите её с помощью claude --resume или продолжайте работать в ней. См. справочник по ошибкам для получения подробной информации.

Хост терминала умер или сеанс перестал отвечать

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

Claude Code никогда не перезапускает строку, работающую команду оболочки, из Enter или из claude attach, потому что это запустит команду снова; сообщение строки и claude attach оба говорят, что команда не запускается снова.

Сеанс не запускается с примечанием `possibly low memory`

Когда процесс фонового сеанса завершается до завершения запуска и хост имеет низкий объём памяти, статус строки называет выход и добавляет possibly low memory — free some up and retry.

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

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

Agent view говорит, что фоновый сервис не ответил

Если подключение, просмотр или claude logs сообщает, что фоновый сервис не ответил, процесс супервизора, вероятно, зависает. Остановите его и позвольте следующему claude agents запустить свежий. Чтобы сохранить ваши фоновые сеансы работающими во время перезагрузки, передайте --keep-workers:

claude daemon stop --any --keep-workers

Новый супервизор переподключается к работающим сеансам. Без --keep-workers команда также завершает фоновые сеансы. Флаг --any подтверждает, что вы хотите остановить супервизор, который был запущен по требованию, а не как установленный сервис, что является значением по умолчанию.

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

Если команда вместо этого выходит, говоря, что записанный процесс не может быть проверен как супервизор, проверьте сообщённый идентификатор процесса: если это супервизор, которым вы владеете, остановите его самостоятельно, затем удалите ~/.claude/daemon.lock, чтобы следующий claude agents запустился свежим.

На Windows, если супервизор не реагирует на запрос остановки, команда выводит его идентификатор процесса. Завершите этот процесс с помощью taskkill /PID <pid>, чтобы завершить восстановление. Фоновые сеансы по-прежнему сохраняются, если вы передали --keep-workers.

Dispatch fails with `Could not resolve authentication method`

Если фоновая отправка завершается с ошибкой Could not resolve authentication method, в то время как интерактивные сеансы аутентифицируются нормально, рабочий процесс, который получил отправку, не подхватил учётные данные. Фоновые сеансы получают свои учётные данные от супервизора, поэтому эта ошибка означает, что для самого процесса супервизора не было доступных сохранённых учётных данных. Подтвердите, что вы запустили /login или настроили ключ API, затем остановите супервизор:

claude daemon stop --any --keep-workers

Следующий claude agents или claude --bg запускает свежий супервизор, который читает ваши сохранённые учётные данные. Если вы аутентифицируетесь с помощью переменной окружения, такой как ANTHROPIC_API_KEY, а не /login, запустите эту следующую команду из оболочки, где переменная установлена.

См. справочник по ошибкам для полного списка причин и исправлений.

Фоновые сеансы не могут читать Desktop, Documents или Downloads на macOS

На macOS хост фонового сеанса работает как отдельный процесс и запрашивает доступ к защищённым папкам отдельно от вашего терминала. Если фоновый сеанс сообщает Operation not permitted при чтении ~/Desktop, ~/Documents, ~/Downloads или другого защищённого местоположения, предоставьте доступ в System Settings в разделе Privacy & Security > Files and Folders или включите Full Disk Access для записи.

При использовании встроенного установщика запись отображается как Claude Code и разрешение сохраняется при обновлениях. При других методах установки, таких как Homebrew или npm, запись показывает путь к двоичному файлу и может потребоваться предоставить разрешение снова после обновления.

Фоновые сеансы не могут достичь хостов локальной сети на macOS

На macOS 15 и более поздних версиях система блокирует процесс от доступа к устройствам в вашей локальной сети, пока вы не предоставите разрешение Local Network, поэтому команда, нацеленная на адрес LAN, может завершиться с ошибкой connect: no route to host в фоновом сеансе, даже если она работает в переднем терминале. Первая команда в фоновом сеансе, которая подключается к адресу локальной сети, запускает запрос разрешения macOS Local Network для Claude Code. Предоставьте его один раз, и эти команды будут достигать хостов LAN так же, как они это делают в переднем терминале.

Сеанс медленно реагирует после подключения

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

Пока процесс запускается, Claude Code показывает хвост транскрипта сеанса, отформатированный так, как его отображает живой сеанс, с markdown, выделенными блоками кода и вызовами инструментов как затемнённые строки, над затемнённой областью подсказки с примечанием Session is starting. Живой сеанс заменяет его, как только он будет готов.

`.claude/worktrees/` заполняется

Удаление сеанса в представлении агентов удаляет рабочее дерево, которое Claude создал для него, но некоторые удаления сохраняют рабочее дерево или оставляют его каталог на диске, поэтому оставшиеся каталоги могут накапливаться. Каталоги, которые git больше не распознаёт, не отображаются в git worktree list, поэтому удалите их вручную.

Перечислите оставшиеся записи с помощью git worktree list в каталоге проекта и удалите каждую с помощью git worktree remove <path>. См. Clean up worktrees.

Ограничения

Agent view находится в исследовательском предпросмотре со следующими ограничениями:

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

Для других способов запуска Claude параллельно и для передачи результатов между запускаемыми сеансами см.:

  • Запуск агентов параллельно: сравните agent view с subagents, agent teams и worktrees
  • Обмен сообщениями между сеансами: позволяйте вашим сеансам передавать результаты друг другу
  • Agent teams: координируйте несколько сеансов, которые обмениваются сообщениями друг с другом
  • Use Claude Code in the cloud: запускайте сеансы в управляемой облачной среде вместо локально
  • Projects: позволяйте Claude координировать параллельные облачные сеансы из одного разговора и сообщайте вам, какие из них вам нужны

История версий

Agent view быстро развивался во время исследовательского предпросмотра. Если вы находитесь на более старой версии Claude Code, некоторое поведение на этой странице может отличаться; в частности, claude agents отклоняет флаги, которые он ещё не поддерживает, с ошибкой unknown option. Таблица ниже указывает, когда каждый флаг и поведение были добавлены.

Версия Изменение
v2.1.287 Фильтр n:<text> находит сессии по имени или первому промпту. Пока активен любой фильтр, свёрнутые вами группы разворачиваются, показывая свои совпадения, и выбирается первое совпадение, поэтому Enter открывает его.
v2.1.287 Команда, отправленная как ответ из панели просмотра, выполняется, когда завершается текущий ход сессии, включая команды, которые выполняются сразу при вводе в собственном промпте сессии. Ответ, состоящий ровно из /stop, немедленно останавливает сессию.
v2.1.281 Ограничение --setting-sources переносится в сеанс, который вы отправляете в фон с помощью ← или /bg, и в сеансы, которые вы отправляете из agent view. До этого выпуска запущенный сеанс загружал каждый источник параметров.
v2.1.281 claude --bg и команды, которые перезагружают сеанс, проверяют доверие рабочей области для каталога сеанса в первую очередь. Из терминала в этом каталоге диалог доверия появляется, если вы его ещё не приняли; где диалог не может появиться, например в скрипте, команда выходит с ошибкой Workspace not trusted.
v2.1.274 После автоматического обновления agent view, от которого вы были в отсутствии примерно час, может перезагрузиться на новую сборку. Когда это происходит, он сохраняет значения отправки по умолчанию, с которыми вы его открыли: --model, --effort, --permission-mode, --allow-dangerously-skip-permissions и --agent. До этого выпуска перезагруженный view сохранял только --cwd и флаги конфигурации, такие как --settings и --mcp-config, поэтому сеансы, которые вы отправляли впоследствии, запускались без этих значений по умолчанию.
v2.1.274 Когда удаление отклоняется, потому что git или ваш hook WorktreeRemove не смог удалить worktree, проверенный подмодуль, который Claude Code проверяет, не имеет незафиксированных изменений отслеживаемых файлов, не блокирует предложение удалить снова и удалить каталог в любом случае. Незафиксированная работа внутри проверенного подмодуля считается незафиксированными изменениями, и сообщение называет подмодуль. До этого выпуска любая проверка подмодуля в worktree блокировала предложение, с сообщением, говорящим, что worktree содержит вложенный репозиторий.
v2.1.268 Когда удаление отклоняется, потому что git или ваш hook WorktreeRemove не смог удалить worktree, сообщение называет причину, включая то, как завершился hook и начало его stderr. Для связанного worktree в каталоге .claude/worktrees/ репозитория без незафиксированных изменений отслеживаемых файлов, без вложенного репозитория внутри него и без записи другого сеанса, называющей его, удаление сеанса снова удаляет каталог в любом случае, из agent view или с помощью claude rm <id> --force-remove-worktree <worktree-id>. До этого выпуска строка показывала только worktree could not be removed (WorktreeRemove hook failed) или ошибку git, stderr hook переходил только в журнал отладки, и удаление снова было отклонено таким же образом.
v2.1.268 После того как первый ← показывает Press ← again to open agents или Press ← again to go back to agents в присоединённом сеансе, первое нажатие, которое приходит по крайней мере через секунду позже, переключается, даже когда более быстрые нажатия между ними были проигнорированы. До этого выпуска каждое проигнорированное нажатие перезапускало ожидание, поэтому нажатие ← снова в устойчивом темпе не переключалось до тех пор, пока вы не делали паузу более чем на секунду.
v2.1.260 Когда вы отправляете сеанс в фон, список агентов ваших других сеансов показывает разговор один раз как его фоновый сеанс, и их сообщения ему больше не достигают терминала, с которого вы его переместили. До этого выпуска этот терминал мог остаться указанным как второй интерактивный сеанс под названием разговора, и сеанс, который отправил сообщение разговору до перемещения, продолжал доставлять на этот терминал.
v2.1.260 Когда удаление отклоняется из-за неотправленных коммитов, сообщение называет ветвь worktree и количество неотправленных коммитов, и удаление сеанса снова отбрасывает worktree и его коммиты. До этого выпуска отказ говорил только worktree has commits that are not pushed anywhere, удаление снова было отклонено таким же образом, и удаление сеанса требовало отправки коммитов или удаления worktree вручную.
v2.1.257 ← отсоединяется от присоединённого сеанса, пока открыто наложение /btw, даже в середине ответа, и наложение снова открывается при следующем присоединении. До этого выпуска ← не отсоединялся, пока наложение было открыто.
v2.1.257 Когда вы запускаете claude --resume <session-id> --bg, Claude Code продолжает этот сеанс под его собственным ID или запускает копию под новым ID и выводит строку note:, объясняющую почему. --continue, голый --resume и --resume с именем или путём запускают копию с той же заметкой. До этого выпуска --resume с --bg всегда запускал копию под новым ID и ничего не говорил.
v2.1.257 Когда вы отправляете сеанс из agent view, который вы открыли с помощью ←, Claude Code запускает его в режиме разрешений, который настраивает целевой каталог через permissions.defaultMode. Когда каталог не устанавливает его, применяется режим разрешений сеанса, из которого вы пришли. До этого выпуска отправленный сеанс всегда запускался в режиме разрешений сеанса, из которого вы пришли, переопределяя его.
v2.1.257 Ctrl+S, Ctrl+T и Ctrl+G в agent view следуют вашему keybindings.json: Ctrl+S и Ctrl+T через действия agents:switchView и agents:togglePin контекста Agents, и Ctrl+G через привязку chat:externalEditor контекста Chat. До этого выпуска agent view игнорировал keybindings.json и эти клавиши были зафиксированы.
v2.1.257 Запуск фонового сервиса восстанавливается от двух причин сбоя. При установке npm на macOS запуск во время самообновления ожидает завершения установки вместо запуска заполнителя, который npm кладёт при замене двоичного файла. На Windows устаревший daemon.lock, написанный до последней загрузки машины, или чей записанный ID процесса теперь принадлежит другому процессу, заменяется. До этого выпуска запуск macOS не удался с Error: claude native binary not installed. во время окна установки, и блокировка Windows заставляла каждый запуск не удаться с exited before it became reachable до удаления ~/.claude/daemon.lock.
v2.1.257 Когда вы открываете или отправляете фоновый сеанс, пока другой процесс Claude Code загружает обновление npm, Claude Code продолжает ждать до двух минут, пока выполняется установка, затем не удаётся с сообщением Claude Code is being updated by npm on this machine. До этого выпуска ожидание остановилось через десять секунд, поэтому открытие не удалось с Couldn't start the background service, пока загрузка всё ещё выполнялась.
v2.1.257 Фоновый сеанс, содержащий кросс-сеансовое сообщение для вашего одобрения, показывает approve message from на его строке Needs input, с адресом отправителя и именем, которое заявляет отправитель. До этого выпуска строка переместилась в Needs input, но сохранила свой предыдущий текст, поэтому ничего в claude agents не называло ожидающее сообщение или его отправителя.
v2.1.257 Подсказка, сохранённая с помощью Ctrl+S внутри открытого фонового сеанса, сохраняется с сеансом, поэтому Ctrl+S восстанавливает её после остановки и перезапуска процесса сеанса. До этого выпуска сохранение жило только в запущенном процессе и было потеряно, когда сеанс оставался неактивным достаточно долго, чтобы его процесс остановился, или когда он был остановлен и затем переоткрыт.
v2.1.251 В фоновом сеансе, который не переместился в worktree, Claude и подагенты, которые он порождает, могут редактировать файлы внутри связанного git worktree.
v2.1.251 Claude Code пересылает шлюз облачного провайдера, экспортированный в оболочку, из которой вы отправляете, такой как ANTHROPIC_VERTEX_BASE_URL или ANTHROPIC_BEDROCK_BASE_URL с его флагом обхода аутентификации, рабочему процессу сеанса на тех же условиях, что и ANTHROPIC_BASE_URL. До этого выпуска, если вы отправили в фон или отправили из оболочки, аутентифицированной только через такой шлюз, каждый запрос, который сеанс сделал, не удался, потому что конечная точка и флаг были удалены из его окружения.
v2.1.251 Когда фоновый сеанс запускается, пока другой процесс Claude Code обновляет marketplace плагинов, такой как родственный сеанс, запускающий автоматическое обновление marketplace, Claude Code сохраняет плагины этого marketplace доступными. До этого выпуска такой сеанс мог запуститься без каких-либо skills, agents, hooks и MCP серверов этого marketplace и оставаться таким на протяжении всего его запуска.
v2.1.248 Shift+Enter в поле отправки вставляет новую строку, соответствуя основной подсказке, и Ctrl+Enter отправляет и присоединяется немедленно в терминалах, где наложение ? перечисляет ctrl+enter to start and open. До этого выпуска Shift+Enter отправлял и присоединялся.
v2.1.248 Удаление сеанса успешно, когда коммиты worktree уже находятся на локальной копии ветви по умолчанию вашего удалённого репозитория origin и ваша основная проверка имеет эту ветвь; до этого выпуска удаление было отклонено с has commits that are not pushed anywhere.
v2.1.248 Сеанс, отправленный в фон с помощью ← или /background, держит git worktree lock на его worktree, пока он работает; до этого выпуска отправка в фон освобождала блокировку, и очистка или git worktree remove могли удалить worktree под запущенным сеансом.
v2.1.248 Фоновый сеанс, который не ждал вашего ввода и найден мёртвым более чем через 48 часов после его последней активности, например после отключения машины на дни, показывается как остановленный с ended while the background service was off, и Enter на нём спрашивает перед возобновлением его сохранённого разговора. До этого выпуска такой сеанс снова появлялся как свежий сбой, отсортированный в верхнюю часть списка, и одиночный Enter вытягивал недельный разговор на передний план.
v2.1.248 Открытие остановленной строки, чей разговор вы возобновили в другом терминале, отклоняется с Can't open — this session is running in another terminal, и строка показывает Open in a terminal вместо отображения под Working. До этого выпуска открытие строки запускало второй процесс, пишущий в тот же разговор.
v2.1.248 Фоновый сеанс, ожидающий решения разрешения, пока hook PermissionRequest или PreToolUse вывел неверный ответ, называет событие hook и ошибку схемы на его строке. До этого выпуска строка показывала только ожидающий запрос.
v2.1.248 На Windows claude agents реагирует на клавиатуру при запуске в вкладке терминала, которую более ранняя программа оставила в режиме win32-input-mode. До этого выпуска Claude Code не декодировал записи ключей, которые такая вкладка отправляет.
v2.1.247 На Linux и WSL сеанс, чей процесс хоста терминала умер, не удаётся в течение нескольких секунд с причиной. Открытие, которое не производит вывода, заканчивается примерно через десять секунд с предложением перезагрузки, и Enter на строке перезагружает сеанс с его разговором; claude attach <id> сообщает причину и выходит. До этого выпуска открытие такого сеанса показывало opening… · esc to cancel неопределённо долго и claude attach <id> ждал без сообщения об ошибке.
v2.1.246 При установке npm, когда фоновый сервис не удаётся запустить, пока npm install -g @anthropic-ai/claude-code заменяет двоичный файл, Claude Code ждёт до десяти секунд завершения установки и повторяет попытку перед сообщением EACCES: permission denied.
v2.1.246 Когда процесс фонового сервиса умирает после вывода ошибки, Claude Code сообщает об ошибке и цитирует первую строку ошибки сервиса.
v2.1.246 Если ваша машина спит, пока фоновый сервис запускается, Claude Code повторяет попытку запуска один раз вместо сбоя.
v2.1.246 Claude Code ждёт примерно две минуты вместо 45 секунд для вновь запущенного фонового сервиса, который живой, но медленно принимает подключения.
v2.1.246 Фоновый сервис запускается из вашего домашнего каталога, поэтому на macOS и Linux запускаемый каталог, который был удалён или перемещён, больше не блокирует запуск.
v2.1.246 /fork копирует полный разговор из сеанса, который сам запустился как копия и не записал новую подсказку с тех пор: копия /fork, к которой вы присоединились, сеанс переприсоединённый после ← или /background, переместивший его в фон, или сеанс, запущенный с claude --resume <id> --fork-session. До этого выпуска, если вы запустили /fork в таком сеансе перед отправкой ему новой подсказки, Claude Code вывел обычное подтверждение, но запустил копию с пустым разговором. Перемещение такого сеанса в фон с помощью ← или /background потеряло разговор таким же образом.
v2.1.246 Когда вы открываете сеанс, который вы только что отправили, пока его рабочий процесс всё ещё запускается, например нажав Enter на его строке, Claude Code ждёт процесса и затем присоединяется. До этого выпуска, если вы нажали Enter, пока процесс всё ещё запускался, Claude Code мог остановить сеанс с Session <id> was stopped while the respawn was in flight.
v2.1.246 Когда вы отправляете в фон именованный сеанс, Claude Code перечисляет его один раз, и когда вы отправляете в фон тот же разговор снова, он нумерует имя новой строки, например my-session (2), с существующей строкой, сохраняющей своё имя. До этого выпуска терминал, в котором вы нажали ←, мог появиться в claude agents --json как второй сеанс под тем же именем, и если вы отправили в фон тот же разговор снова, Claude Code добавил ещё одну строку под идентичным именем.
v2.1.239 С режимом редактора vim включённым, нажатие Esc в поле ввода agent view переключается из режима INSERT в режим NORMAL и сохраняет ваш текст, соответствуя основной подсказке; в режиме NORMAL с текстом всё ещё в поле ввода, нажатие Esc очищает его, и нажатие Esc на пустом вводе выходит, как описывает ярлык Esc. До этого выпуска Esc очищал ввод.
v2.1.233 Для сеанса, связанного с запросом слияния GitLab, Claude Code пишет ярлык строки в синтаксис ссылки GitLab !1234. Вы также можете вставить URL запроса слияния в поле отправки, чтобы выбрать этот сеанс. До этого выпуска ярлык отображался как #1234, и вставленный URL запроса слияния совпадал с сеансом только когда его первая подсказка содержала URL.
v2.1.227 Удаление сеанса сохраняет сеанс и его worktree, пока другой живой сеанс Claude Code работает внутри этого каталога worktree. Agent view показывает not deleted на строке и причину в нижнем колонтитуле, и claude rm выводит kept <id> с причиной, которая называет ID процесса другого сеанса. До этого выпуска удаление сеанса удаляло worktree, пока другой сеанс всё ещё работал в нём.
v2.1.225 claude agents в каталоге, который вы не доверили, показывает то же диалог доверия рабочей области, что и claude показывает при запуске, перед открытием agent view. Принятие сохраняет доверие для этой рабочей области; отклонение выходит без открытия agent view. До этого выпуска claude agents открывался без вопроса, поэтому сеансы, которые вы отправили из него, работали в каталоге, который вы никогда не были просили доверять.

Со списком, сгруппированным по каталогам, наведение мыши на строку выделяет её без изменения цели отправки; выбор строки с клавишами со стрелками или щелчком всё ещё изменяет цель. До этого выпуска перемещение мыши над сеансом в другом проекте молча изменяло каталог, в который запускался следующий отправленный сеанс.
v2.1.221 /status показывает строку Session kind: background job · attached или background job · unattended в фоновом сеансе, в зависимости от того, присоединён ли терминал, и interactive в любом другом сеансе. До этого выпуска /status не сообщал вид сеанса.

/fork: Claude Code инструктирует копию изолировать свою работу от оригинального сеанса: копия создаёт свой собственный worktree перед внесением изменений кода, остаётся вне worktree оригинального сеанса и основывает новую ветвь на ветви оригинала, когда его задача строится на этой работе. Смотрите связанный раздел для точных условий. До этого выпуска копия не получала инструкцию изоляции и могла закончить редактированием worktree или проверкой оригинального сеанса, который всё ещё работал в нём.

С режимом редактора vim включённым, нажатие ← сразу после отмены подсказки обратно в пусто с помощью u спрашивает то же подтверждение, что и удаление текста или перемещение через историю подсказок, и переключается только при втором нажатии; до этого выпуска нажатие переключалось немедленно.
v2.1.219 С режимом редактора vim включённым, нажатие ← на пустой подсказке открывает agent view из режима NORMAL, а также INSERT, и подсказка нижнего колонтитула ← показывает в режиме NORMAL; до этого выпуска жест и подсказка были только INSERT, и в режиме NORMAL ← на пустой подсказке ничего не делал. Ввод текста в поле ввода, пока Claude Code ждёт отправки сеанса в фон, отменяет переключение с Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again., поэтому черновик не потеряется.
v2.1.218 Нажатие ← в течение двух секунд после удаления, которое опустошило подсказку, или перемещения через историю подсказок, показывает Press ← again to open agents или Press ← again to go back to agents в присоединённом сеансе, и переключается только при втором нажатии по крайней мере через секунду позже; до этого выпуска нажатие переключалось немедленно. ←, который прибывает внутри вставленного или написанного скриптом ввода, больше не запускает переключение. Отправка сеанса переднего плана в фон с помощью ← показывает Your conversation moved to the background выше списка, и Esc в корне agent view возвращается к этому разговору вместо выхода в shell, с двойным Ctrl+C, остающимся выходом; если разговор не может быть переоткрыт, Claude Code выходит и выводит команду claude --resume для него. На Windows ←, нажатый в течение примерно половины секунды после присоединения, показывает Ambiguous ←, press again to detach и отсоединяется при втором нажатии.
v2.1.217 Значок запроса на слияние на строке сеанса отображается как гиперссылка даже когда Claude Code не может обнаружить поддержку гиперссылок терминала, например через SSH или tmux; установите FORCE_HYPERLINK=0, чтобы отобразить его как простой текст. До этого выпуска значок отображался как простой текст, когда поддержка не была обнаружена.
v2.1.216 /fork: подтверждение — это одна строка, показывающая состояние копии, имя её строки agent-view и её ID сеанса для claude attach, заканчивающаяся с runs in the origin tree или edits this checkout только когда копия работает в основном рабочем дереве или редактирует проверку, которую вы открыли. Щелчок по имени отправляет этот сеанс в фон и открывает agent view в сеансе копии. Подтверждение больше не повторяет унаследованный режим разрешений копии; более ранние версии выводили многострочное подтверждение без щелкаемого имени.

Needs input: /install-github-app и список параметров /mcp, запущенные, пока никто не присоединён, показывают сеанс под Needs input со строкой, называющей команду, и присоединение и повторный запуск команды продолжаются; с v2.1.208 по v2.1.215 они были отклонены в этом состоянии.

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

Ctrl+X: нажатие его дважды удаляет сеанс даже когда попытка остановки не удаётся, вместо того чтобы неудачная остановка отменила ожидающее удаление, и удалённый сеанс, чей рабочий процесс умер, больше не появляется при следующем обновлении.

Удаление Worktree: сеанс, чей каталог worktree не принадлежит никакому репозиторию git, может быть удалён; до этого выпуска каждая попытка удалить такой сеанс была отклонена. Каталог, который уже исчез, очищается немедленно. Двойное нажатие agent view удаляет каталог, который всё ещё имеет файлы, запуская ваш hook WorktreeRemove для созданного hook каталога, если только другой сеанс не называет его. claude rm сохраняет такой каталог, когда остаются файлы.
v2.1.214 Сеанс, отправленный в фон с помощью ← или /background и оставленный неактивным без ничего работающего, имеет его процесс остановленным, как любой другой неактивный сеанс, вместо сохранения его процесса и фонового сервиса, работающего неопределённо долго. Завершённый сеанс может быть удалён с помощью claude rm или из agent view после того, как фоновый сервис перейдёт в режим ожидания, и сеанс, который вошёл в worktree после отправки из каталога, который не является репозиторием git, такой как папка многорепозиториального рабочего пространства, может быть удалён из agent view, когда сам worktree принадлежит репозиторию git, потому что очистка разрешена из worktree вместо каталога, из которого был отправлен сеанс; оба удаления были отклонены при каждой попытке до. Переоткрытие остановленного сеанса восстанавливает его сохранённый разговор даже когда папка в хранилище стенограмм не может быть прочитана.
v2.1.213 /install-github-app, список параметров /mcp и действия аутентификации MCP работают в фоновом сеансе, пока терминал присоединён, и отклоняются только когда никто не присоединён, с сообщением, говорящим вам присоединиться и запустить команду снова; с v2.1.208 по v2.1.212 они были отклонены даже с присоединённым терминалом.
v2.1.212 /fork в интерактивном сеансе копирует разговор в новый фоновый сеанс, который появляется как его собственная строка, названная в честь сеанса, из которого он пришёл, или для подсказанного fork неименованного сеанса, в честь подсказки fork, пока оригинал продолжает работать; более ранее поведение forked-subagent /fork переместилось в /subtask. С отключённым agent view, /fork сохраняет поведение forked-subagent. Сфокусированная строка, которая ждёт своей первой подсказки, показывает space to send it a prompt. Ctrl+J вставляет новую строку в поле отправки на терминалах с расширенной отчётностью о ключах, где нажатие клавиши было ранее проигнорировано, и наложение ? перечисляет ярлык. Подсказка нижнего колонтитула ← в интерактивном сеансе кратко показывает N done, когда фоновый сеанс завершается, пока ни один не нуждается в вашем вводе. Ввод голого /resume в agent view открывает средство выбора прошлых сеансов репозитория, из которого вы открыли agent view, включая удалённые из списка сеансы, и выбор одного возобновляет его как фоновый сеанс; до этого выпуска /resume не был доступен в agent view и удалённые сеансы были доступны только с claude --resume или /resume из интерактивного сеанса. Целевые, ограниченные и ограниченные формы сохраняют подсказку attach to a session to run it, которую более ранние версии показывали для каждой формы. Сеансы, ожидающие на подсказке сетевого хоста sandbox, запросе ввода MCP или подсказке управляемых параметров, показываются как Needs input вместо Working, в agent view и в claude agents --json, и вопрос от Claude сообщает waitingFor: input needed вместо permission prompt. Присоединение к сеансу, чей процесс остановился, показывает его стенограмму отформатированной так, как её отображает живой сеанс, вместо как необработанный текст. Остановленный сеанс, чья стенограмма находится в неожиданном месте, возобновляется из неё через сканирование последней попытки ваших сохранённых стенограмм, и открытие строки, которая не имеет сохранённой стенограммы, показывает Press enter again to restart this session fresh, перезагружая её свежей при втором нажатии; v2.1.211 показал отказ без способа перезагрузки из agent view.
v2.1.211 Пробуждение остановленного сеанса путём присоединения или ответа из каталога, в котором он работает, пересылает шлюз вашей оболочки ANTHROPIC_BASE_URL снова, на тех же условиях, что и свежая отправка, поэтому сеанс, аутентифицированный через шлюз ANTHROPIC_AUTH_TOKEN, возобновляется на шлюзе вместо сообщения Not logged in. Присоединение к остановленному сеансу, который был отправлен в фон из другого разговора перед завершением его первого ответа, отклоняется с This session has no saved transcript вместо молчаливого запуска пустого разговора под тем же ID сеанса; открытие той же строки из agent view показало отказ в нижнем колонтитуле. Завершение процесса сеанса ← или /background извне Claude Code отмечает его остановленным вместо перезапуска супервизором, остановка уже записанная на диск соблюдается, если только ответ, который вы отправили, всё ещё ждёт доставки, сеанс перезагруженный после сбоя сообщается о перезагрузке, и перезагруженный сеанс ← или /background не возобновляет прерванный ответ старше примерно часа. Ответ, называющий сеанс, который отвечает или отказывает подсказку вместо её маркировки, например для подсказки, которая в основном является ссылкой, отбрасывается и строка сохраняет имя, взятое из текста подсказки. Удаление сеанса, чей worktree git больше не признаёт, успешно, оставляя каталог worktree на диске и называя его путь, вместо того чтобы каждая попытка была отклонена. Отклонённое удаление показывает причину на строке сеанса, включая основную ошибку git, когда worktree не мог быть удалён, вместо молчаливого переоткрытия строки.
v2.1.210 claude attach ждёт, пока фоновый сервис запускается или переподключается, вместо сбоя с ошибкой job not found или still starting, сообщает сеанс, который завершился во время присоединения, как вышедший, и применяет изменение размера терминала, сделанное во время медленного присоединения, когда присоединение завершается. Подсказка нижнего колонтитула ← счёт needs-input появляется на каждом провайдере, включая сторонних провайдеров, которые ранее показывали простую форму ← for agents. Отправка сеанса в фон с помощью ← переносит список задач Claude в фоновый сеанс вместо его отбрасывания. Строка, на которой вы нажали ←, сохраняет жирное, неприглушённое имя после перемещения выделения. claude agents --effort принимает ultracode вместо молчаливого отклонения.
v2.1.208 Присоединение к сеансу, процесс которого остановился, показывает последний экран его стенограммы во время запуска процесса, вместо только заметки Session is starting. Ответ, который не может быть доставлен, потому что фоновый сервис недоступен или отправка не удаётся, сохраняется и отправляется как следующая подсказка сеанса при перезапуске его процесса; до этого выпуска ответ, потерянный, пока фоновый сервис был недоступен, был отброшен. Процесс, чей собственный двоичный файл был заменён обновлением, всё ещё может запустить супервизор из установленного средства запуска claude или самой новой версии на диске, вместо сбоя до перезагрузки Claude Code. Супервизор, работающий на более старой версии, никогда не перезапускает неактивный сеанс, запущенный более новой версией, на его собственный более старый двоичный файл. Удаление сеанса удаляет его worktree даже после того, как сеанс переместил worktree на другую ветвь, и сохраняет worktree вместе со строкой сеанса, когда worktree имеет коммиты, которые не отправлены никуда, или другой сеанс требует его, вместо уничтожения коммитов или оставления worktree без владельца. /install-github-app и список параметров /mcp и его действия аутентификации отклоняются в фоновом сеансе с сообщением, называющим альтернативу; только в v2.1.208 средство выбора /model было отклонено таким же образом и введённая команда /model <name> переключала только этот сеанс вместо также сохранения вашей модели по умолчанию.
v2.1.207 Панель просмотра открывается с предложением, которое строка усекает, например точный вопрос для сеанса, ожидающего вас, и показывает, как долго заблокированный сеанс ждёт, как одна строка waiting 3m вместо добавления одного и того же временного штампа к предложению статуса и вопросу. Вставка одного и того же текста снова в поле отправки расширяет свёрнутый заполнитель [Pasted text #N] вместо добавления второго. Фоновый сеанс, названный путём принятия плана, показывает это имя на его строке. Фоновый сеанс, который переместился в worktree, сохраняет свой разговор при перезапуске его процесса из agent view.
v2.1.206 Резюме строк заполняют оставшуюся ширину строки и усекаются только на правом краю терминала вместо 64 столбцов. После перезапуска супервизора в новую версию Claude Code он перезапускает оставшиеся неактивные фоновые сеансы на эту версию в фоне вместо нескольких в минуту. Удаление сеанса с помощью Ctrl+X или claude rm также очищает его из списка сеансов супервизора, поэтому строка больше не появляется после перезапуска супервизора. Переопределение тела запроса CLAUDE_CODE_EXTRA_BODY, экспортированное в оболочке отправки, достигает фоновых сеансов вместо игнорирования.
v2.1.205 Подсказка нижнего колонтитула ← в обычном сеансе claude считает фоновых агентов, ожидающих вас, например ← 2 agents. Резюме строк показывают собственный однострочный отчёт сеанса, усечённый на 64 столбцах, вместо необработанного вызова инструмента или счётчика done/total; строки, сгруппированные по каталогам, открываются с цветным словом состояния. Панель просмотра открывается с полным предложением статуса и, для сеанса, ожидающего вас, его точный вопрос выше поля ввода ответа. Сеансы, которые редактируют, комментируют, закрывают или отмечают pull request как готовый с помощью gh, связаны с ним, а не только те, которые создают или проверяют pull request; push связывает pull request даже когда имя локальной ветви не совпадает, и pull request, чей вывод команды создания превысил встроенный лимит, также связан. Ход без читаемого текста сохраняет предыдущее состояние сеанса вместо того, чтобы вернуть его обратно в Working. claude attach ждёт до примерно 60 секунд сеанс, который перезагружается, со строкой статуса, указывающей причину, вместо сбоя.
v2.1.203 Шлюз ANTHROPIC_BASE_URL, экспортированный в оболочке отправки, достигает сеансов, отправленных из неё в тот же каталог, когда супервизор делится этой переменной окружения шлюза, вместо того чтобы быть отброшенным, в то время как экспортированный вместе с ним ключ API был сохранён. PATH оболочки отправки применяется к каждому рабочему процессу сеанса. Нажатие ← во время выполнения подагентов ожидает их вместо перезапуска через десять секунд. Пустой список всегда показывает заголовки разделов с описанием под каждым. Ввод @ в поле отправки также перечисляет зарегистрированные git worktrees репозитория запуска, которые находятся внутри его дерева каталогов. Усилие, унаследованное от параметра effortLevel, следует более поздним редактированиям этого параметра вместо того, чтобы быть зафиксированным при отправке. Открытие остановленного сеанса, чей разговор уже открыт в другом запущенном сеансе, отклоняется с сообщением вместо сбоя строки. Команда, которая недоступна в agent view, оставляет введённый текст в поле ввода. Hook WorktreeCreate, который не удаётся вне репозитория git, больше не блокирует сеанс от редактирования файлов.
v2.1.202 Имя, установленное с помощью /rename или Ctrl+R в фоновом сеансе, сохраняется при остановке и перезапуске процесса супервизора вместо возврата к имени, с которым был отправлен сеанс.
v2.1.200 Более старая версия Claude Code, которая переписывает список сеансов в roster.json, сохраняет поля, написанные более новой версией, соответствуя существующей гарантии state.json, поэтому сеансы, запущенные более новой версией, продолжают принимать ввод после перезапуска супервизора. Когда вы открываете сеанс, который перестал отвечать, супервизор перезапускает его процесс и сеанс продолжает прерванный ответ с того места, где он остановился. Agent view применяет флаг --plugin-dir, размещённый после agents, к своему собственному подагенту и автодополнению skills в поле отправки, а также отправленным сеансам.
v2.1.199 Фоновый сеанс, процесс которого завершается до завершения запуска на хосте с низкой памятью, показывает possibly low memory — free some up and retry в статусе его строки вместо только простой причины выхода. Отправка сеанса в фон с помощью ← или /background переносит его /color в новую строку.
v2.1.198 Agent view отправляет уведомление через preferredNotifChannel, когда фоновому сеансу требуется ввод, он завершается или не удаётся, и запускает hook Notification с типом agent_needs_input или agent_completed. ← и /exit внутри claude attach <id> возвращаются к agent view вместо выхода в shell; Ctrl+Z возвращается в shell. Фоновый сеанс, который изолировал свою работу в worktree, фиксирует, отправляет свою собственную изолированную ветвь, никогда не main или master, и открывает черновик pull request при завершении вместо предварительного запроса. /login запускается в agent view и открывает диалог входа. Диалог выхода Background work is running предлагает Move to background and exit. Передача выхода также охватывает фоновые подагенты, которые возобновляются из своей стенограммы при следующем пробуждении вместо того, чтобы быть отмеченными как неудачные. claude --bg в сочетании с -p или --print отклоняется с ошибкой. Хост фонового сеанса запрашивает разрешение macOS Local Network при первом доступе LAN вместо сбоя с connect: no route to host.
v2.1.196 Одиночное нажатие ← отправляет сеанс переднего плана в фон; более ранние версии требовали двух нажатий, с подсказкой в нижнем колонтитуле и подтверждением. --dangerously-skip-permissions, переданный в claude agents, показывает отказ от ответственности за обход вместо молчаливого отклонения. Интерактивные сеансы, которые вы никогда не называли, имеют стандартное имя, такое как my-app-3f, в списках сеансов и claude agents --json. Фоновые команды shell и динамические рабочие процессы выживают при остановке, перезапуске или обновлении процесса сеанса, включая на Windows; установите CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1, чтобы отключить передачу. Стенограмма, неправильно прочитанная как пустая при перезапуске, переименовывается с суффиксом .orphaned- вместо удаления.
v2.1.195 Выполняемая работа переносится, когда вы отправляете сеанс в фон на Windows тоже; установите CLAUDE_DISABLE_ADOPT=1, чтобы остановить её вместо этого. Группа Completed заполняет оставшееся вертикальное пространство и заголовок сжимается на коротких терминалах. Более старая версия Claude Code больше не отклоняет поля state.json более новых сеансов и не скрывает эти сеансы из claude agents. Подключение к остановленному сеансу переключается немедленно вместо показа пустого экрана до пяти секунд. Супервизор, который не может принять подключения, выходит и освобождает свою блокировку самостоятельно.
v2.1.191 claude --bg с именем --agent, которое не совпадает ни с одним из ваших подагентов, не удаётся при запуске: сеанс выходит немедленно с ошибкой --agent '<name>' not found вместо запуска с агентом по умолчанию.
v2.1.174 Фоновые сеансы больше не наследуют переменные конечной точки шлюза, такие как ANTHROPIC_BASE_URL, из оболочки запуска супервизора; супервизор предоставляет свежий снимок учётных данных предварительно прогретым рабочим процессам, исправляя ошибки Could not resolve authentication method.
v2.1.172 Команда /model в поле отправки устанавливает переопределение модели отправки с областью действия сеанса.
v2.1.161 Резюме строк показывают счётчик done/total для параллельных рабочих элементов; панель просмотра называет самый долгоживущий параллельный рабочий элемент.
v2.1.157 Команда claude agents принимает --agent; отправленные сеансы соблюдают параметр agent.
v2.1.145 Голосовая диктовка поддерживается в входе ответа панели просмотра и входе отправки.
v2.1.143 Параметр worktree.bgIsolation добавлен; claude agents принимает --allow-dangerously-skip-permissions.
v2.1.142 Команда claude agents принимает --permission-mode, --model, --effort, --dangerously-skip-permissions, --settings, --add-dir, --plugin-dir, --mcp-config и --strict-mcp-config.
v2.1.141 Команда claude agents принимает --cwd для ограничения списка одним проектом.
v2.1.139 Agent view представлен как исследовательский предпросмотр.