Управление несколькими агентами с помощью agent view
Отправляйте и управляйте множеством сеансов Claude Code с одного экрана. Agent view показывает, что делает каждый сеанс и какие из них требуют вашего ввода.
Agent view, открываемое с помощью claude agents, — это один экран для всех ваших фоновых сеансов: что работает, что требует вашего ввода и что завершено. Отправляйте новые сеансы, наблюдайте их состояние с первого взгляда вместо прокрутки стенограмм и вмешивайтесь только когда один из них требует вас. Каждый фоновый сеанс — это полная беседа Claude Code, которая продолжает работать без подключённого терминала, поэтому вы можете открыть его, ответить и уйти в любой момент.
Используйте agent view, когда у вас есть несколько независимых задач, над которыми Claude может работать без вашего наблюдения на каждом шаге. Отправьте исправление ошибки, проверку pull request и исследование нестабильного теста как три строки, продолжайте работать в другом окне и проверьте, когда строка показывает, что она требует вас или имеет результат.
Когда вы хотите работать более непосредственно в сеансе любого агента, подключитесь к строке, чтобы войти в полную беседу.
Для сравнения agent view с subagents, agent teams и worktrees см. Запуск агентов параллельно.
Agent view находится в исследовательском предпросмотре. Интерфейс и сочетания клавиш могут измениться по мере развития функции.
Быстрый старт
Это пошаговое руководство охватывает основной цикл agent view: отправьте задачу, смотрите, как её строка обновляется по мере работы Claude, посмотрите, чтобы проверить её и ответить, а затем подключитесь для полной беседы. Сеанс, который вы отправляете, продолжает работать после закрытия agent view, поэтому вы можете уйти и вернуться к нему позже.
Открыть agent view
Из вашей оболочки запустите:
claude agents
Если вы ещё не приняли диалог доверия рабочей области для каталога, Claude Code показывает его перед открытием agent view, тот же диалог, который показывает claude. Примите, чтобы сохранить доверие для рабочей области и продолжить. Если вы отклоните, Claude Code выйдет без открытия agent view.
Agent view открывается с вводом внизу и таблицей, которая заполняется по мере запуска сеансов. Нажмите Esc для возврата в вашу оболочку; если вы открыли agent view путём отправки сеанса в фон с помощью ←, Esc вернёт вас к этой беседе вместо этого. Ваши сеансы продолжают работать, пока вас нет, и снова появляются в следующий раз, когда вы откроете agent view.
Отправить сеанс
Введите подсказку, описывающую задачу, и нажмите Enter. Запускается новый фоновый сеанс для этой задачи и появляется как строка, показывающая, работает ли он, ждёт ли вас или завершён. Новый сеанс использует модель, показанную в заголовке agent view. Какой режим разрешений он запускает зависит от того, как вы открыли agent view.
Каждая подсказка, которую вы вводите здесь, запускает свой собственный новый сеанс. Ввод другой подсказки и нажатие Enter запускает второй сеанс рядом с первым, а не отправляет ему продолжение. Таким образом вы можете запустить несколько параллельно.
Каждый сеанс использует вашу квоту подписки независимо, поэтому см. Ограничения перед отправкой множества сеансов одновременно.
Просмотр и ответ
Выберите строку с помощью клавиш со стрелками и нажмите Space, чтобы открыть панель просмотра. Она показывает самый последний результат сеанса или вопрос, на который он ждёт ответа, а не полную стенограмму. Введите ответ и нажмите Enter, чтобы отправить его, не покидая agent view.
Подключение и отключение
Нажмите Enter или → на строке для подключения, когда вам нужна полная беседа. Сеанс захватывает терминал как полный интерактивный сеанс Claude Code. Нажмите ← на пустой подсказке для отключения и возврата к таблице.
Перенести существующий сеанс
Этот шаг требует запущенного сеанса. Если вы следовали предыдущим шагам, у вас нет открытого сеанса в этом терминале, поэтому откройте обычный сеанс claude в другом терминале и сначала отправьте ему сообщение.
Чтобы переместить сеанс, который у вас уже открыт, в agent view, запустите /bg внутри него или нажмите ← на пустой подсказке, чтобы отправить его в фон и открыть agent view за один шаг. В новом сеансе без сообщений /bg просит вас сначала отправить сообщение, а ← работает сразу же. Сеанс продолжает работать и появляется как строка рядом с теми, которые вы отправили.
Вы можете использовать claude agents как основную точку входа вместо claude: отправляйте каждую задачу из agent view, подключайтесь, когда вам нужна полная беседа, и нажимайте ← для возврата к таблице.
Внутри обычного сеанса claude подсказка в нижнем колонтитуле ← показывает количество фоновых агентов, которые ждут вас, например ← 2 agents, и возвращается к ← for agents, когда никто не требует ввода. Количество выше 99 отображается как 99+. Количество обновляется примерно каждые десять секунд, пока терминал в фокусе, и немедленно, когда фокус возвращается. Оно кратко меняет цвет при изменении и при завершении агента, и когда фоновый сеанс завершается, пока никто не требует вашего ввода, оно кратко показывает количество завершённых, например ← 2 done. Обе вспышки отключены, когда параметр prefersReducedMotion включен, и подсказка скрыта в режиме чтения с экрана.
Мониторинг сеансов с помощью 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, чтобы отправить его этому сеансу. Когда сеанс задаёт вопрос с предопределёнными вариантами, панель просмотра показывает их как нумерованный список и вы можете нажать цифровую клавишу для выбора одного. Запрос разрешения показывается как текст, описывающий то, что сеанс хочет запустить, без нумерованных вариантов. Введите ответ для ответа на него или подключитесь для ответа со стандартным запросом. Для других заблокированных сеансов нажмите Tab, чтобы заполнить ввод предложенным ответом, который вы можете отредактировать перед отправкой. Начните ответ с ! для отправки команды Bash вместо этого.
Когда 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:blocked для всего, что ждёт вас |
#<number> или URL pull или merge request |
Сеанс, работающий над этим pull request или merge request |
| Любой другой URL | Сеанс, первый запрос которого содержал этот URL |
Сочетания клавиш
Нажмите ? в agent view, чтобы увидеть каждое сочетание клавиш в контексте. Таблица ниже их суммирует.
| Сочетание клавиш | Действие |
|---|---|
↑ / ↓ |
Перемещение между строками |
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> |
Если первое слово совпадает с именем пользовательского subagent, этот subagent запускается как основной агент сеанса с конфигурацией из его frontmatter |
@<agent-name> |
Упомяните пользовательского subagent в любом месте подсказки для запуска его как основного агента |
@<repo> |
Упомяните репозиторий для запуска сеанса там. См. Отправка в конкретный каталог для того, какие репозитории указаны |
/<command> |
Предложите skills и commands для отправки как подсказку |
! <command> |
Запустите команду оболочки как фоновое задание вместо запуска сеанса Claude. Задание отображается как строка, к которой вы можете подключиться, наблюдать и отключиться |
#<number> или URL pull или merge request |
Если сеанс уже работает над этим pull request или merge request, Claude Code выбирает его строку вместо отправки нового сеанса |
Небольшой набор команд запускается в самом agent view вместо отправки:
/exitи/quitзакрывают agent view/logoutвыходит из системы/modelустанавливает dispatch model/loginоткрывает диалог входа, чтобы вы могли войти снова без подключения к сеансу- Голый
/resumeили его псевдоним/continueоткрывает средство выбора прошлых сеансов репозитория для возврата одного как фонового сеанса. Требует Claude Code v2.1.212 или позже
Skills, ваши собственные команды и расширяющие подсказку встроенные команды, такие как /init, отправляются в новый фоновый сеанс как его первая подсказка. Другие встроенные команды показывают подсказку attach to a session to run it вместо этого. Всё, что вы вводили, остаётся в поле ввода рядом с подсказкой, чтобы вы могли отредактировать его.
Упаковка повторяющейся задачи как skill позволяет вам запускать один и тот же рабочий процесс из agent view многократно без переввода подсказки.
Когда одно и то же имя @name совпадает как с subagent, так и с соседним репозиторием, subagent имеет приоритет. Совпадение первого слова также применяется, поэтому подсказка, начинающаяся со слова, совпадающего с одним из имён ваших subagent, отправляет этот subagent, а не обрабатывает слово как обычный текст. Используйте форму @ когда вы хотите быть явным, или начните подсказку с другого слова, чтобы избежать совпадения.
Отправка в конкретный каталог
Новый сеанс запускается в каталоге, из которого вы открыли agent view. Для целевого другого каталога используйте любой из этих способов:
-
Откройте
claude agentsв этом каталоге. -
Откройте
claude agentsв родительском каталоге и упомяните дочерний репозиторий с@<repo>в подсказке. Введите@для отображения этих целей:- Git репозитории на один уровень ниже каталога запуска
- Зарегистрированные git worktrees репозитория, из которого вы запустили, которые находятся внутри его дерева каталогов, такие как те, которые Claude создаёт под
.claude/worktrees/, помеченные их проверенной ветвью. Worktrees, добавленные вне репозитория, такие как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, ответ продолжается в фоновом сеансе.
Выход из сеанса, который всё ещё имеет выполняемую фоновую работу, такую как subagents, фоновые команды shell, рабочие процессы или monitors, показывает диалог Background work is running вместо немедленного выхода. Выберите Move to background and exit для отправки сеанса в фон так же, как это делает /background, и возврата в вашу оболочку. Этот вариант не показывается, когда agent view отключен.
Если фоновый сеанс в списке уже имеет имя беседы, Claude Code нумерует имя новой строки, например my-session (2), и оставляет имя существующей строки без изменений. Чтобы переименовать новую строку, выберите её в agent view и нажмите Ctrl+R.
Копирование сеанса с /fork
Запустите /fork для копирования текущей беседы в новый фоновый сеанс, пока оригинал продолжает работать. Копия начинается со всего в беседе до этой точки; см. пункты ниже для того, где копия запускается. Она также переносит модель, permission mode, уровень усилий и любые каталоги или разрешения "не спрашивать снова", которые вы добавили во время сеанса. Копия отображается как её собственная строка в agent view.
После fork две беседы независимы: ничто, что копия делает, не входит в оригинальную беседу самостоятельно, хотя в сеансах, где cross-session messaging включена, Claude любого сеанса может явно отправить сообщение другому.
Копирование сеанса требует Claude Code v2.1.212 или позже; на v2.1.161 через v2.1.211, /fork запускает forked subagent вместо этого, который теперь /subtask. Когда agent view отключен, /fork сохраняет поведение forked-subagent и /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, созданного hook, получает инструкцию; без WorktreeCreate hook копия редактирует на месте. Копия, перемещённая из вашего worktree, также инструктируется никогда не редактировать, не запускать команды в или не входить в этот worktree, независимо от параметра изоляции.
Где копия начинается, зависит от того, где запущен текущий сеанс:
- Как любой отправленный сеанс, копия переходит в свой собственный worktree перед редактированием файлов. В этом случае подтверждение не упоминает, где запускается копия.
- Когда ваш сеанс переместился в его связанный worktree после его запуска, копия начинает обратно там, где сеанс был до перемещения и, если она не редактирует на месте, делает свои изменения кода в worktree своего собственного там. Когда ваш worktree проверен на ветвь, эта инструкция также говорит копии, чья задача основана на вашей работе, основать свою новую ветвь на вашей, так как ваша ветвь остаётся проверенной в вашем worktree. Подтверждение заканчивается с
runs in the origin tree. - Когда вы запустили сеанс внутри связанного worktree репозитория, который имеет основное рабочее дерево, копия начинает в этом основном рабочем дереве, с тем же правилом worktree-of-its-own, но без инструкции ветви. Подтверждение заканчивается с
runs in the origin treeздесь тоже. - Сеанс, запущенный внутри worktree bare-repository layout, не имеет основного рабочего дерева для возврата, поэтому копия остаётся там, где она есть, и подтверждение заканчивается с
edits this checkout. Та же заметка появляется, когда изоляция worktree отключена в сеансе, который не находится внутри связанного worktree, потому что копия затем редактирует файлы, которые вы открыли.
Сеансы, запущенные с флагами запуска, которые копия не наследует, такие как заменённая системная подсказка или --tools allowlist, не могут быть forked; Claude Code говорит об этом вместо создания частичной копии. Сеанс, отправленный из agent view, fork нормально: копия запускается с той же определением агента и добавленными инструкциями, что и сеанс, из которого она пришла.
Что переносится при отправке в фон
Отправка в фон запускает свежий процесс, который возобновляется из сохранённой беседы, и выполняемая работа переходит в него: работающие фоновые команды shell, фоновые subagents, динамические рабочие процессы, запланированные задачи, которые вы создали с помощью /loop, и автоматические ответы Claude на комментарии артефактов все переносятся и продолжают работать там. Subagent переходит вместе со всем, что он запустил, поэтому он переносится только когда вся эта работа может перейти тоже. Чтобы остановить выполняемую работу вместо её переноса, установите переменную окружения CLAUDE_DISABLE_ADOPT=1; Claude Code затем просит вас подтвердить перед отправкой в фон.
Когда динамический рабочий процесс всё ещё имеет работающие subagents, Claude Code спрашивает перед отправкой в фон с диалогом Background this session?, который говорит, сколько subagents перезапустится. Выберите Stay для того, чтобы дать им закончиться сначала. Если вы подтвердите, Claude Code воспроизводит запуск в фоновом сеансе: subagents, которые всё ещё работали, начинают заново с начала, поэтому токены, которые они использовали до сих пор, потрачены снова. См. Resume after a pause для того, какие завершённые subagents возвращают свои сохранённые результаты и какие запускаются снова.
Claude Code останавливает работу, которая не может перейти, такая как работающий monitor, и останавливает фоновый subagent, который владеет монитором, вместе с ним. Когда какая-либо такая работа выполняется, Claude Code показывает диалог Background this session? так, чтобы вы могли подтвердить перед её остановкой.
После отправки в фон сеанс может запускать новые subagents, monitors и фоновые команды, и те продолжают работать при последующем отключении и переподключении.
Флаги конфигурации из исходного запуска переносятся в фоновый сеанс, поэтому его MCP servers, settings и резервная модель остаются в силе:
--mcp-configи--strict-mcp-config--settings--add-dir--plugin-dir--fallback-model--allow-dangerously-skip-permissions
Каталоги, которые вы добавили во время сеанса с помощью /add-dir, также переносятся. Перенос --allow-dangerously-skip-permissions сохраняет bypassPermissions доступным в фоновом сеансе, но это не предоставляет ничего нового: режим по-прежнему требует одноразового интерактивного принятия, описанного в Permission mode, model, and effort.
Из вашей оболочки
Передайте --bg или его длинную форму --background для запуска сеанса, который идёт прямо в фон:
claude --bg "investigate the flaky SettingsChangeDetector test"
Подсказка является позиционным аргументом, а не значением -p. Claude Code отклоняет --bg в сочетании с -p или --print перед созданием любого сеанса, потому что --print никогда не запускает интерактивный сеанс, к которому подключается claude agents.
Чтобы запустить конкретного subagent, который вы определили, такого как code-reviewer, как основного агента сеанса, объедините --bg с --agent:
claude --agent code-reviewer --bg "address review comments on PR 1234"
Если имя не совпадает ни с одним из ваших subagents, запуск не удаётся: Claude Code выводит предупреждение no agent named и всё ещё сообщает сеанс как фоновый, но сеанс выходит немедленно с ошибкой --agent '<name>' not found.
Когда фоновый сеанс позже возобновляется или перезапускается, Claude Code восстанавливает агента и его ограничения инструментов; для его системной подсказки см. System prompt flags in resumed conversations. Он ищет агента в собственном каталоге сеанса в первую очередь, при условии, что вы доверили этому рабочему пространству, поэтому агент с областью действия проекта всё ещё загружается, когда сеанс возобновляется из другого каталога. Если агента больше не существует, сеанс продолжается с инструментами по умолчанию и его стенограмма открывается с предупреждением, называющим агента.
Чтобы продолжить существующую беседу в фоне, передайте её полный 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
Запуск команды оболочки
Чтобы запустить команду оболочки как фоновое задание вместо сеанса Claude, передайте --exec. Следующий пример запускает pytest -x как фоновое задание:
claude --bg --exec 'pytest -x'
Из agent view отправьте тот же вид задания, введя ! как первый символ входа отправки: ! отображается как префикс, всё после него — это команда, и Enter запускает задание.
Команда запускается как задание с поддержкой PTY и отображается как строка в agent view, с самой последней строкой вывода в качестве её статуса. Задание оболочки запускает команду вместо Claude, поэтому модель не вызывается и вывод не отправляется ни в какой сеанс.
Чтобы увидеть вывод, подключитесь к строке, нажмите Space для просмотра без подключения или запустите claude logs <id> из вашей оболочки. Захваченный вывод остаётся в памяти и не записывается на диск. Строка и её вывод автоматически очищаются примерно через пять минут после выхода команды, поэтому прочитайте её до этого, если вам нужен результат.
Как изолируются правки файлов
Каждый фоновый сеанс, запущенный ли из agent view, /bg или claude --bg, запускается в вашем рабочем каталоге. Перед редактированием файлов Claude перемещает сеанс в изолированный git worktree под .claude/worktrees/, поэтому параллельные сеансы могут читать один и тот же checkout, но каждый пишет в свой собственный. После того как сеанс находится в своём worktree, Claude Code применяет изоляцию worktree для сеанса и для любых subagents, которые он порождает.
Claude пропускает worktree когда:
- Сеанс уже находится внутри связанного git worktree, создан ли он Claude под
.claude/worktrees/или вы создали его с помощьюgit worktree addгде-то ещё - Файл, который Claude редактирует, находится внутри связанного git worktree, такого как тот, который сеанс или его subagent создал с помощью
git worktree add - Рабочий каталог не является git репозиторием и нет настроенного
WorktreeCreatehook - Запись находится вне рабочего каталога
Чтобы отключить изоляцию worktree для репозитория, где git worktrees непрактичны, установите worktree.bgIsolation на "none". Фоновые сеансы затем редактируют вашу рабочую копию напрямую без предварительного перемещения в worktree. Добавьте параметр в файл .claude/settings.json проекта:
{
"worktree": {
"bgIsolation": "none"
}
}
Вне git репозитория сеансы пишут в рабочий каталог напрямую и не изолированы друг от друга, поэтому избегайте отправки параллельных сеансов, которые редактируют одни и те же файлы. Если вы используете другую систему контроля версий, настройте WorktreeCreate hook и Claude изолирует правки так же, как это делает для git.
Когда hook не удаётся в каталоге, который не является git репозиторием, Claude пропускает изоляцию для этого каталога и редактирует рабочий каталог на месте. Внутри git репозитория Claude Code блокирует записи в общий checkout до тех пор, пока Claude не переместит сеанс в worktree.
Чтобы найти путь worktree сеанса, посмотрите сеанс или подключитесь и проверьте его рабочий каталог.
Subagent, который фоновый сеанс порождает, наследует рабочий каталог сеанса, поэтому его правки файлов попадают в worktree сеанса, а не в вашу рабочую копию. Чтобы дать subagent его собственный отдельный worktree вместо этого, установите isolation: worktree в его frontmatter или передайте isolation: "worktree" при запуске его.
Когда фоновый сеанс внёс изменения кода в worktree, который Claude вошёл, Claude Code инструктирует Claude сохранить работу перед завершением, поэтому она выживает, если вы удалите сеанс и его worktree:
- Commit и push: Claude фиксирует без вопросов и отправляет ветвь, когда репозиторий имеет удалённый.
- Draft pull request: Claude открывает один, когда задача требует этого, и метка
#Nотображается на строке. - Никогда: отправка на
mainилиmaster, force-push и merge. - Ваши инструкции git имеют приоритет: если задача,
CLAUDE.mdили memory говорит, что вы обрабатываете фиксацию или отправку сами, Claude оставляет git вам.
Сеанс, редактирующий checkout, который он не изолировал сам, всё ещё спрашивает перед фиксацией или переключением ветвей. Это применяется, когда изоляция установлена на "none", когда перемещение worktree не удалось, или когда сеанс запустился внутри worktree, который уже существовал.
Независимо от задачи, Claude заканчивает работу с отчётом, говорящим, что он сделал и где находится работа: путь, ветвь, pull request или сам ответ.
Что удаление сеанса удаляет
Удалите сеанс с Ctrl+X дважды в agent view или с claude rm. За исключением сохранённых случаев ниже, сеанс покидает список. Его стенограмма остаётся на вашей машине через claude --resume, и удаление выживает перезапуски supervisor.
Что происходит с 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 и сколько коммитов не отправлено. Сообщение также предлагает два способа вперёд: отправить коммиты или удалить снова для их отказа.
Коммиты на удалённом не блокируют удаление. Ни коммиты на локальной копии вашего удалённого
originпо умолчанию ветви, пока эта ветвь проверена в вашем основном checkout, самом каталоге репозитория, а не worktree.После этого отказа вы выбираете:
- Чтобы сохранить коммиты, отправьте их или объедините их в эту ветвь по умолчанию, затем удалите сеанс снова.
- Чтобы отказать от них, удалите сеанс снова без отправки: нажмите
Ctrl+Xдважды на его строке в agent view или запустите командуclaude rm <id> --discard-unpushed, которую отказ вывел. Это удаляет сеанс и worktree вместе с его ветвью, отказывая от не отправленных коммитов и любых незафиксированных изменений.
Когда вы удаляете снова, Claude Code отказывает только то, что отказ показал: если worktree получил коммит с тех пор, Claude Code сохраняет его снова и показывает обновленное состояние.
Когда другой завершённый сеанс также называет worktree, он остаётся, когда вы удаляете снова; отправьте коммиты, затем удалите снова.
-
Worktree, который git больше не признаёт, например после
git worktree prune, не блокирует удаление. Claude Code удаляет сеанс и оставляет каталог на диске. -
Когда git или ваш
WorktreeRemovehook не удаляет worktree, Claude Code сохраняет worktree и сеанс, и сообщение называет причину. Для hook сообщение говорит, как он закончился, такой какexited 1, и цитирует начало его stderr. Сообщение также говорит вам, какой из этих вариантов делать дальше:- Удалите сеанс снова для удаления каталога в любом случае, нажав
Ctrl+Xдважды на его строке в agent view или запустив командуclaude rm <id> --force-remove-worktree <worktree-id>, которую отказclaude rmвывел. Claude Code предлагает это только, когда он может подтвердить, что каталог является одним из связанных worktrees репозитория под.claude/worktrees/без незафиксированных изменений отслеживаемых файлов, без вложенного репозитория внутри него и без другого сеанса, называющего его. Ветвь worktree остаётся в репозитории. - Исправьте то, что стоит на пути, такое как фиксация или stashing незафиксированных изменений, закрытие того, что использует каталог, или исправление hook, затем удалите сеанс снова.
- Удалите каталог сами, затем удалите сеанс снова.
- Удалите сеанс снова для удаления каталога в любом случае, нажав
Worktree, который вы создали сами и запустили сеанс внутри, остаётся на месте в любом случае.
Сеанс, чей каталог worktree не принадлежит ни одному git репозиторию, потому что репозиторий был удалён или WorktreeCreate hook создал каталог где-то ещё, всё ещё может быть удалён. Пока файлы остаются в каталоге:
- Agent view спрашивает для того же
Ctrl+Xдвойного нажатия перед отказом от них. Для hook-созданного каталога он запускает вашWorktreeRemovehook вместо этого, и без одного он отказывает удаление и сохраняет сеанс. claude rmсохраняет сеанс и worktree, и называет причину.
Любой путь сохраняет каталог, который другой завершённый сеанс называет.
Установка модели
Имя модели, показанное в заголовке agent view, является стандартом отправки. Новые сеансы, которые вы запускаете из входа, используют эту модель, которая поступает из параметра model setting в ваших пользовательских settings. Установите его, выбрав модель в /model picker, или отредактируйте параметр напрямую.
Чтобы переопределить стандарт отправки для всего сеанса agent view, передайте --model при открытии agent view. См. Permission mode, model, and effort.
Чтобы изменить стандарт отправки из внутри agent view, введите /model с последующим именем модели в входе отправки и нажмите Enter. Заголовок обновляется для отображения этой модели с маркером (session), и сеансы, которые вы отправляете после этого, используют её. Введите /model default для очистки переопределения и возврата к стандарту отправки. Это переопределение длится для остальной части текущего запуска claude agents и не записывается в ваш файл settings. Следующий пример отправляет один сеанс на Opus и следующий на Sonnet:
/model opus
refactor auth
/model sonnet
run the test suite
Каждый фоновый сеанс может работать на другой модели. Чтобы переопределить его для одного сеанса:
- Из оболочки передайте
--modelсclaude --bg. - Подключитесь к работающему сеансу и запустите
/modelдля переключения: выбор из picker или введённый/model <name>сохраняется как ваш стандарт для новых сеансов, если вы не нажмётеsв picker для переключения только для этого сеанса. Переключение только для сеанса сохраняется, если сеанс перезапущен. - Отправьте subagent, чей frontmatter устанавливает поле
model.
Permission mode, model, and effort
Фоновый сеанс берёт свои settings, поставщика, permission mode, модель и усилие из того, где и как вы его отправили. Подразделы ниже охватывают каждый источник и что сохраняется, когда supervisor перезапускает сеанс.
Settings и поставщик
Фоновый сеанс читает свои settings из каталога, в котором он запускается, так же как если бы вы запустили claude там. Это включает значения env в settings проекта, поэтому ANTHROPIC_MODEL или переменная поставщика, установленная там, применяется к каждому фоновому сеансу в этом каталоге.
Фоновый сеанс также запускается с PATH оболочки, из которой вы его отправили, поэтому команды, которые он запускает, находят те же инструменты, что и ваш терминал. Он также сохраняет выбор облачного поставщика этой оболочки, такой как CLAUDE_CODE_USE_BEDROCK или CLAUDE_CODE_USE_VERTEX, вместе с его псевдонимами ANTHROPIC_DEFAULT_*_MODEL и любым переопределением CLAUDE_CODE_EXTRA_BODY, которое вы экспортировали там.
LLM gateway
Если вы маршрутизируете Claude Code через LLM gateway, поместите переменные gateway в блок env файла settings, а не экспортируйте их в вашу оболочку, и фоновые сеансы читают их с остальными своими settings. Set in a settings file показывает блок и какой файл settings использовать для учётных данных.
Если вы экспортируете gateway ANTHROPIC_BASE_URL только в вашу оболочку вместо этого, он достигает фонового сеанса, вместе с ANTHROPIC_CUSTOM_HEADERS и учётными данными, которые вы экспортировали с ним, только когда supervisor сам был запущен из оболочки, которая экспортировала тот же gateway, и только в этих случаях:
- Вы отправляете свой собственный сеанс в фон с
←или/background - Вы отправляете сеанс в каталог, в котором вы находитесь
- Вы пробуждаете остановленный сеанс в каталоге, в котором вы находитесь, путём подключения или ответа на него
Claude Code пересылает gateway перед облачным поставщиком. Если оболочка, из которой вы отправляете, выбирает поставщика и экспортирует его конечную точку gateway с его флагом обхода auth, Claude Code пересылает пару endpoint-and-flag в сеанс при условиях, которые применяются к 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 применяет пересланный gateway только к процессу этого сеанса и никогда не записывает его на диск.
Permission mode
Permission mode зависит от того, как вы запустили сеанс:
- Отправлено в фон с
/bgили←: Claude Code сохраняет permission mode, в котором находился сеанс, поэтому тот, который вы переключили наacceptEditsилиauto, остаётся там после отключения - Отправлено из agent view, который вы открыли с
←: конфигурация цели идёт в первую очередь, и permission mode сеанса, из которого вы пришли, применяется, когда ничто другое не устанавливает один - Отправлено из
claude agents, запущенного в оболочке, или сclaude --bg: новый сеанс запускается так, как новый сеансclaudeв этом каталоге, если вы не отправили его из agent view, который вы открыли с dispatch defaults. Which permission mode a session starts in перечисляет порядок
Для сеанса, который вы отправляете из agent view, открытого с ←, Claude Code берёт permission mode из первого из этих, который применяется:
permissions.defaultModeцелевого каталога. Два правила источника применяются:autoиbypassPermissionsвступают в силу только из управляемых settings, файла--settingsили~/.claude/settings.json.- Claude Code отказывает
defaultModeиз.claude/settings.jsonили.claude/settings.local.jsonпроекта, который выбирает более разрешающий режим, чем сеанс, из которого вы пришли, был в.
- Permission mode сеанса, из которого вы пришли
Когда Claude Code отказывает режиму источника как слишком разрешающему, следующий источник в списке решает. Например, если вы отправляете из сеанса plan-mode в каталог, чьи проверенные settings просят acceptEdits, новый сеанс запускается в plan mode. Если вы переместите этот defaultMode в ~/.claude/settings.json, он применяется независимо от permission mode сеанса, из которого вы пришли.
Разрешающесть идёт plan, затем Manual и dontAsk, затем acceptEdits и auto, которые каждый считаются более разрешающими, чем другой, затем bypassPermissions.
Dispatch defaults
Чтобы установить стандартные значения для каждого сеанса, который вы отправляете из agent view, передайте любой из --permission-mode, --model, --effort или --agent при открытии его:
claude agents --permission-mode plan --model opus --effort high
--effort здесь принимает те же значения, что и флаг top-level --effort, включая ultracode.
--agent устанавливает subagent, используемый, когда подсказка отправки не называет один, либо с @name, либо как первое слово. По умолчанию используется параметр agent setting, если он установлен, иначе встроенный универсальный агент claude. Именование subagent в входе отправки переопределяет оба.
claude agents также принимает --dangerously-skip-permissions как сокращение для --permission-mode bypassPermissions и --allow-dangerously-skip-permissions для того, чтобы сделать bypassPermissions доступным в цикле Shift+Tab каждого отправленного сеанса без запуска в этом режиме. Оба совпадают с флагами CLI верхнего уровня.
Передайте --restricted для запуска каждого сеанса, который вы отправляете из представления в restricted mode, как если бы каждый был запущен с флагом верхнего уровня --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 этих сеансов без запуска их в нём.
Что сохраняется при перезапусках
Permission mode, модель и усилие, которые вы выбрали для фонового сеанса, вместе с флагами конфигурации, которые он переносит, все сохраняются, когда supervisor позже останавливает и перезапускает его процесс. Сеанс, который вы запустили с помощью claude --bg --dangerously-skip-permissions или claude --bg --permission-mode bypassPermissions, остаётся в bypassPermissions после этого перезапуска. Модель или усилие, которые вы изменили во время сеанса с помощью /model или /effort, также сохраняются.
Если сеанс взял своё усилие из ваших settings, а не из --effort или /effort, Claude Code читает ваши settings снова каждый раз, когда он запускает процесс для сеанса. Поэтому, когда вы редактируете сохранённое усилие в settings.json, изменение достигает сеансов, которые вы отправляете в фон с ← или /bg, и их более поздних перезапусков. Сохранённое усилие — это ключ effortLevel или запись modelSettings.
Claude Code также сохраняет имя, которое вы установили с помощью /rename или Ctrl+R, при этом перезапуске, поэтому вы всё ещё можете запустить claude --resume <name> для достижения сеанса.
Подсказка, которую вы спрятали с помощью Ctrl+S во время подключения, также сохраняется с сеансом. Откройте сеанс снова после того, как его процесс был остановлен или перезапущен, и Ctrl+S восстанавливает спрятанный текст. Вставленное содержимое в спрятанное не выживает перезапуск.
Settings, plugins и MCP servers
Agent view принимает те же флаги конфигурации, что и claude для загрузки settings, plugins, MCP servers и дополнительных каталогов. Agent view применяет --settings и --plugin-dir к себе и передаёт каждый флаг конфигурации в сеансы, которые вы отправляете из него, поэтому plugin или MCP server, который вы загружаете таким образом, доступен в этих сеансах.
| Флаг | Эффект |
|---|---|
--settings <file-or-json> |
Переопределить settings для agent view и отправленных сеансов |
--add-dir <path> |
Предоставить доступ к файлам дополнительного каталога |
--plugin-dir <path> |
Загрузить plugin из локального каталога |
--mcp-config <file-or-json> |
Загрузить MCP servers из файла конфигурации или строки JSON |
--strict-mcp-config |
Использовать только MCP servers из --mcp-config, игнорируя другую конфигурацию MCP. См. Exclusive control with managed-mcp.json для того, что флаг делает под управляемым файлом MCP |
Повторите --add-dir, --plugin-dir или --mcp-config один раз для каждого значения. claude agents не поддерживает форму, разделённую пробелами, такую как --add-dir a b c.
Вы можете поместить --settings и --plugin-dir перед или после agents. Держите --add-dir и --mcp-config после agents: если вы поместите любой из них перед agents, claude agents --json не удаётся с ошибкой unknown option.
Следующий пример открывает agent view с переопределением settings и одним дополнительным каталогом:
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 оба говорят, что команда не запускается снова.
Хост терминала умер
На Linux и WSL супервизор проверяет каждый хост-процесс каждые несколько секунд, открыт ли вы сеанс или нет, и отмечает сеанс как неудачный, когда процесс завершился, но его соединение с супервизором никогда не закрывалось.
- В представлении агентов строка показывает
terminal host process died — press Enter to restart. НажмитеEnterна ней, и Claude Code перезапустит сеанс на свежем хост-процессе. - Из оболочки
claude attach <id>перезапускает сеанс, уже отмеченный как неудачный. В противном случае он сообщает причину и выходит, говоря вам запуститьclaude attach <id>снова.
Сеанс не отвечает
Когда супервизор принимает открытие, но никакой вывод не поступает примерно десять секунд, Claude Code завершает попытку и предлагает перезагрузку. Сеанс, который просто зависает, например при переходе машины в спящий режим, не достигает этого предложения: супервизор перезапускает его при открытии сам.
- В представлении агентов нижний колонтитул показывает
Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).НажмитеEnterна той же строке снова, и Claude Code остановит неответивший процесс и перезапустит сеанс; он ничего не останавливает без этого второго нажатия. - Из оболочки
claude attach <id>сообщает причину и выходит, говоря вам запуститьclaude stop <id>, затемclaude attach <id>.
Сеанс не запускается с примечанием `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: координируйте несколько сеансов, которые обмениваются сообщениями друг с другом
- Claude Code on the web: запускайте сеансы в управляемой облачной среде вместо локально
История версий
Agent view быстро развивался во время исследовательского предпросмотра. Если вы находитесь на более старой версии Claude Code, некоторое поведение на этой странице может отличаться; в частности, claude agents отклоняет флаги, которые он ещё не поддерживает, с ошибкой unknown option. Таблица ниже указывает, когда каждый флаг и поведение были добавлены.
| Версия | Изменение |
|---|---|
| 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.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 представлен как исследовательский предпросмотр. |