Gestionar múltiples agentes con la vista de agentes

Distribuya y gestione muchas sesiones de Claude Code desde una pantalla. La vista de agentes muestra qué está haciendo cada sesión y cuáles necesitan su entrada.

La vista de agentes, abierta con claude agents, es una pantalla para todas sus sesiones en segundo plano: qué se está ejecutando, qué necesita su entrada y qué está hecho. Distribuya nuevas sesiones, observe su estado de un vistazo en lugar de desplazarse por transcripciones, e intervenga solo cuando una lo necesite. Las sesiones siguen ejecutándose en segundo plano sin una terminal conectada.

Utilice la vista de agentes cuando tenga varias tareas independientes en las que Claude pueda trabajar simultáneamente, como corregir un error, revisar una solicitud de extracción o investigar un registro. Cuando desee trabajar en un problema juntos, conéctese a una sesión y use Claude Code de forma interactiva como de costumbre.

Las sesiones en la vista de agentes se ejecutan de forma independiente e informan solo a usted. Para comparar con subagentes, equipos de agentes y worktrees, consulte Ejecutar agentes en paralelo.

Esta página cubre:

• Inicio rápido
• Monitorear sesiones con la vista de agentes, incluidos iconos de estado, vista previa y respuesta, conexión, organización y atajos de teclado
• Distribuir nuevos agentes desde la vista de agentes, desde dentro de una sesión o desde el shell
• Gestionar sesiones desde el shell
• Cómo se alojan las sesiones en segundo plano por el proceso supervisor

Inicio rápido

Este tutorial abre la vista de agentes, distribuye una sesión, responde desde el panel de vista previa y se conecta para la conversación completa.

claude agents

Para llevar una sesión interactiva existente a la vista de agentes, ejecute /bg dentro de ella, o presione ← en un mensaje vacío para enviar la sesión al segundo plano y abrir la vista de agentes en un paso. La sesión sigue ejecutándose en segundo plano y aparece como una fila. Para iniciar una nueva sesión en segundo plano directamente desde el shell, ejecute claude --bg "<prompt>".

Puede usar claude agents como su punto de entrada principal en lugar de claude: distribuya cada tarea desde la vista de agentes, conéctese cuando desee la conversación completa, y presione ← para volver a la tabla.

Monitorear sesiones con la vista de agentes

Ejecute claude agents para abrir la vista de agentes. Toma el control de la terminal completa y enumera cada sesión agrupada por estado, con sesiones fijadas y las que lo necesitan en la parte superior. Cada fila muestra el nombre de la sesión, la actividad actual y cuánto tiempo hace que cambió por última vez.

La lista cubre cada sesión en segundo plano bajo su directorio de configuración, independientemente de qué proyecto o worktree esté trabajando, por lo que una sesión iniciada en un repositorio y otra iniciada en un worktree diferente aparecen juntas. Las sesiones interactivas que tiene abiertas en otras terminales no aparecen hasta que las envíe al segundo plano, y los subagentes que se ejecutan dentro de una sesión no se enumeran como filas separadas.

Pinned
  ✽ clawd walk cycle          Write assets/sprites/clawd-walk.png           3m

Ready for review
  ∙ jump physics              github.com/anthropics/example/pull/2048    ●  2h

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

Working
  ✽ collision detection       Edit src/physics/CollisionSystem.ts           2m
  ✢ playtest level 3          run 12 · all checkpoints cleared           in 4m

Completed
  ✻ title screen              result: menu, options, and credits done       9m
  ∙ sound effects             result: 14 SFX exported to assets/audio       4h
  … 6 more

El icono de cada fila lleva dos señales. El indicador le indica el estado de la sesión, y la forma del icono le indica si el proceso subyacente sigue ejecutándose. Los estados son:

La forma del icono le indica si el proceso subyacente sigue ejecutándose. Un ✻, o un ✽ animado mientras Claude está funcionando, significa que la sesión está activa y puede responder inmediatamente. Un ∙ significa que el proceso ha salido, pero aún puede echar un vistazo, responder o conectarse: Claude reinicia la sesión desde donde se quedó. Un ✢ es una sesión /loop durmiendo entre iteraciones, con la fila mostrando su recuento de ejecución y una cuenta regresiva para la próxima iteración.

Las sesiones en segundo plano no necesitan ninguna terminal abierta para seguir funcionando. Un proceso supervisor separado las ejecuta, por lo que puede cerrar la vista de agentes, cerrar su shell o iniciar una nueva sesión interactiva y su trabajo distribuido sigue adelante.

Las sesiones persisten en el disco: cerrar su terminal o una actualización automática no las pierde, y reabriendo claude agents las muestra todas. Si su máquina se duerme o se apaga, las sesiones en ejecución se detienen; reinícielas con claude respawn --all.

El resumen de una línea en cada fila es generado por su modelo de clase Haiku configurado, por lo que la fila puede decirle qué está haciendo la sesión, qué necesita o qué produjo sin abrir la transcripción. Mientras una sesión está funcionando activamente, el resumen se actualiza como máximo una vez cada 15 segundos, más una vez cuando cada turno termina. Cada actualización es una solicitud corta de clase Haiku a través de su proveedor normal, facturada y manejada bajo los mismos términos de uso de datos que la sesión misma.

Cuando una sesión abre una solicitud de extracción, aparece un punto de estado en el borde derecho de la fila, vinculado a la solicitud de extracción en terminales que admiten hipervínculos. Cuando la sesión ha abierto más de una solicitud de extracción, el recuento aparece antes del punto y el color refleja cuál necesita más atención.

Para la mayoría de las tareas, esta fila es donde recopila el resultado: revise y fusione la solicitud de extracción cuando el punto se vuelva verde.

Echar un vistazo y responder

Presione Space en una fila seleccionada para abrir el panel de vista previa. Muestra qué necesita la sesión de usted, su salida más reciente y cualquier solicitud de extracción que haya abierto. La mayoría de las veces esto es suficiente, y nunca necesita abrir la transcripción completa.

Escriba una respuesta en el panel de vista previa y presione Enter para enviarla a esa sesión. Cuando la sesión está haciendo una pregunta de opción múltiple, el panel de vista previa muestra las opciones y puede presionar una tecla numérica para elegir una. Para otras sesiones bloqueadas, presione Tab para llenar la entrada con una respuesta sugerida que puede editar antes de enviar. Prefije una respuesta con ! para enviar un comando Bash en su lugar.

Use ↑ y ↓ para echar un vistazo a sesiones adyacentes sin cerrar el panel, o → para conectarse.

Conectarse a una sesión

Presione Enter o → en una fila seleccionada para conectarse, o presione Alt+1 a Alt+9 para conectarse directamente a la enésima sesión en el grupo enfocado. La vista de agentes es reemplazada por la sesión interactiva completa, exactamente como si hubiera ejecutado claude en ese directorio. Cuando se conecta, Claude publica un breve resumen de lo que sucedió mientras estaba fuera.

Mientras está conectado, la sesión se comporta como cualquier otra sesión de Claude Code: cada comando, atajo de teclado y función funciona.

Presione ← en un mensaje vacío para desconectarse y volver a la vista de agentes. Si un diálogo tiene el enfoque y no responde a ←, presione Ctrl+Z para desconectarse inmediatamente.

Desconectarse nunca detiene una sesión en segundo plano: ←, Ctrl+C, Ctrl+D, Ctrl+Z y /exit la dejan ejecutándose. Para terminar una sesión desde dentro de ella, ejecute /stop.

Después de haber distribuido o enviado una sesión al segundo plano, presionar ← en un mensaje vacío funciona desde cualquier sesión de Claude Code, no solo desde las que se conectó desde la vista de agentes. Envía la sesión actual al segundo plano y abre la vista de agentes con esa sesión preseleccionada, por lo que puede cambiar de sesión sin salir de la terminal. Puede desactivar este atajo en /config.

Organizar la lista

La vista de agentes agrupa sesiones por estado, con sesiones que necesitan entrada por encima de sesiones que están funcionando o hechas. Presione Ctrl+S para cambiar a agrupar por directorio en su lugar. Su elección se guarda entre ejecuciones. Dentro de un grupo, fije una sesión en la parte superior con Ctrl+T, reordene con Shift+↑ y Shift+↓, o presione Enter en un encabezado de grupo para contraerlo. Para eliminar una sesión, presione Ctrl+X para detenerla y Ctrl+X nuevamente dentro de dos segundos para eliminarla. Presionar Ctrl+X en un encabezado de grupo elimina cada sesión en ese grupo después de la confirmación.

Las sesiones completadas más antiguas se pliegan en una fila "… N más" para mantener la lista corta. Los fallos y las sesiones con una solicitud de extracción abierta siempre permanecen visibles.

Filtrar la lista

Escriba en la entrada de distribución para filtrar en lugar de distribuir:

Atajos de teclado

Presione ? en la vista de agentes para ver cada atajo. Los más comunes:

Distribuir nuevos agentes

Puede distribuir nuevas sesiones en segundo plano desde la vista de agentes, enviar una sesión interactiva existente al segundo plano o iniciar una directamente desde el shell.

Desde la vista de agentes

Escriba un mensaje en la entrada en la parte inferior de la vista de agentes y presione Enter para iniciar una nueva sesión en segundo plano. La sesión se nombra automáticamente a partir del mensaje. Puede renombrarla más tarde con Ctrl+R. Pegue una imagen en el mensaje para incluir una captura de pantalla o diagrama con la tarea.

Prefije o mencione partes del mensaje para controlar cómo comienza la sesión:

Escriba / para distribuir un skill. Empaquetar una tarea recurrente como un skill le permite iniciar el mismo flujo de trabajo muchas veces desde la vista de agentes sin reescribir el mensaje. Presione Tab en una entrada vacía para examinar cada subagente distribuible, o para aplicar la sugerencia resaltada cuando se muestren sugerencias.

Cuando el mismo @name coincide tanto con un subagente como con un repositorio hermano, el subagente tiene prioridad. La forma de primera palabra sin @ también se aplica a cualquier nombre de subagente, por lo que un mensaje que comienza con una palabra que coincide con uno de sus nombres de subagente distribuye ese subagente. Use la forma @ cuando desee ser explícito.

Distribuir a un directorio específico

Una nueva sesión se ejecuta en el directorio desde el que abrió la vista de agentes. Para dirigirse a un directorio diferente:

• Abra claude agents en ese directorio.
• Abra claude agents en un directorio padre que contenga varios repositorios y mencione uno con @<repo> en el mensaje para ejecutar la sesión allí.
• Desde el shell, cd al directorio y ejecute claude --bg "<prompt>".

Cuando la vista de agentes se agrupa por directorio, el directorio de la fila resaltada se convierte en el objetivo de distribución, por lo que puede desplazarse a un grupo y distribuir en él sin reescribir la ruta.

Desde dentro de una sesión

Ejecute /background o su alias /bg para desconectar la conversación actual y mantenerla ejecutándose. Pase un mensaje como /bg run the test suite and fix any failures para enviar una instrucción más antes de desconectarse.

Desde el shell

Pase --bg para iniciar una sesión que vaya directamente al segundo plano:

claude --bg "investigate the flaky SettingsChangeDetector test"

Para ejecutar un subagente específico como el agente principal de la sesión, combine --bg con --agent:

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

Después de enviar al segundo plano, Claude imprime el ID corto de la sesión y los comandos para administrarla:

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

Cómo se aíslan las ediciones de archivos

Cada sesión en segundo plano, ya sea iniciada desde la vista de agentes, /bg o claude --bg, comienza en su directorio de trabajo pero se bloquea para no escribir archivos allí. Cuando la sesión necesita editar archivos, Claude la mueve automáticamente a un git worktree aislado bajo .claude/worktrees/, de modo que las sesiones paralelas pueden leer el mismo checkout pero cada una escribe en la suya propia. El bloqueo no se aplica cuando la sesión ya está dentro de un worktree, cuando el directorio de trabajo no es un repositorio git, o a escrituras fuera del directorio de trabajo.

El worktree se elimina cuando elimina la sesión, por lo que fusione o envíe los cambios que desee mantener antes de eliminar. Para encontrar la ruta del worktree de una sesión, eche un vistazo a la sesión o conéctese y verifique su directorio de trabajo.

Para hacer que un subagente siempre se ejecute en su propio worktree independientemente de cómo se inició, establezca isolation: worktree en su frontmatter.

Modo de permiso y configuración

Una sesión distribuida lee su configuración y modo de permiso desde el directorio en el que se ejecuta, igual que si hubiera iniciado claude allí. Distribuir desde la entrada de la vista de agentes no pasa un modo de permiso, por lo que la sesión utiliza el defaultMode de la configuración de ese directorio o el permissionMode del frontmatter del subagente distribuido.

Para establecer el modo desde el shell, pase --permission-mode con claude --bg. El uso de bypassPermissions o auto de esta manera se rechaza hasta que haya aceptado ese modo ejecutando claude con él una vez de forma interactiva, ya que esos modos permiten que una sesión que no está viendo actúe sin aprobación.

Gestionar sesiones desde el shell

Cada sesión en segundo plano tiene un ID corto que puede usar desde el shell. Estos comandos son útiles para scripting o cuando no desea abrir la vista de agentes.

Cómo se alojan las sesiones en segundo plano

Las sesiones en segundo plano se alojan mediante un proceso supervisor por usuario, separado de su terminal y de la vista de agentes. Se inicia automáticamente la primera vez que envía una sesión al segundo plano o abre la vista de agentes, y no lo administra directamente. El supervisor y sus sesiones se autentican con las mismas credenciales que sus sesiones interactivas y no realizan conexiones de red adicionales más allá de la API del modelo.

Cada sesión en segundo plano es su propio proceso de Claude Code, con el supervisor como padre en lugar de su terminal. Una sesión que está funcionando activamente, esperando su entrada o tiene una terminal conectada mantiene su proceso ejecutándose. Una vez que una sesión termina y se queda sin conectar durante aproximadamente una hora, el supervisor detiene su proceso para liberar recursos. La transcripción y el estado permanecen en el disco, y la próxima vez que se conecte, eche un vistazo o responda, el supervisor inicia un proceso nuevo desde donde se quedó. Cuando cada sesión ha terminado y no hay terminal conectada, el supervisor mismo sale e inicia nuevamente la próxima vez que envía una sesión al segundo plano o abre la vista de agentes.

El supervisor observa el binario de Claude Code instalado en el disco y se reinicia en la nueva versión después de que el actualizador automático regular lo reemplace. Esta es una observación de archivo local, no una verificación de red. Las sesiones en segundo plano son procesos desconectados, por lo que siguen ejecutándose durante el reinicio y el nuevo supervisor se reconecta a ellas.

El estado de la sesión se almacena en su directorio de configuración de Claude Code. Si establece CLAUDE_CONFIG_DIR, el supervisor usa ese directorio en lugar de ~/.claude y se ejecuta como una instancia separada con sus propias sesiones.

Para desactivar completamente los agentes en segundo plano y la vista de agentes, establezca la configuración disableAgentView setting en true o establezca la variable de entorno CLAUDE_CODE_DISABLE_AGENT_VIEW. Los administradores pueden aplicar esto a través de configuraciones administradas.

Solución de problemas

La vista de agentes se abre sin sesiones

La vista de agentes está vacía hasta que distribuya su primera sesión. Escriba un mensaje en la entrada en la parte inferior y presione Enter.

Las sesiones se muestran como detenidas después de despertar su máquina

Las sesiones en segundo plano no sobreviven al sueño o apagado. Conéctese, eche un vistazo o responda a cualquier sesión detenida y se reiniciará desde donde se quedó. Para reiniciarlas todas a la vez, ejecute claude respawn --all.

Una sesión es lenta para responder después de conectarse

Una vez que una sesión ha terminado y se ha quedado sin conectar durante aproximadamente una hora, el supervisor detiene su proceso para liberar recursos. Conectarse inicia un proceso nuevo desde donde se quedó, lo que toma un momento. Las sesiones que están funcionando o esperando su entrada nunca se detienen de esta manera.

.claude/worktrees/ se está llenando

Los worktrees se eliminan cuando elimina la sesión que los creó. Si una sesión terminó sin limpiar, enumere las entradas sobrantes con git worktree list en el directorio del proyecto y elimine cada una con git worktree remove <path>. Vea Limpiar worktrees.

Limitaciones

La vista de agentes es una vista previa de investigación. Las limitaciones actuales a tener en cuenta:

• Se aplican límites de velocidad: las sesiones en segundo plano reducen su uso de suscripción igual que las sesiones interactivas, por lo que ejecutar diez agentes en paralelo usa cuota diez veces más rápido que ejecutar uno.
• Las sesiones son locales: las sesiones en segundo plano se ejecutan en su máquina y se detienen si se duerme o se apaga.
• Los worktrees se eliminan con la sesión: fusione o envíe cambios antes de eliminar una sesión que editó archivos en su propio worktree.

Próximos pasos

Ahora que comprende la vista de agentes, explore estas características relacionadas:

• Ejecutar agentes en paralelo: compare la vista de agentes con subagentes, equipos de agentes y worktrees
• Subagentes: defina configuraciones de agentes reutilizables con mensajes personalizados, herramientas y aislamiento
• Equipos de agentes: coordine múltiples sesiones que se envíen mensajes entre sí
• Claude Code en la web: ejecute sesiones en un entorno en la nube administrado en lugar de localmente