Background agents y agent view

A veces no quieres ni delegar dentro de una sesión (subagentes) ni montar un equipo coordinado (agent teams). Quieres lanzar varias tareas independientes, mandarlas al background, y mirar de vez en cuando. Para eso está agent view.

Agent view: una pantalla para todo

claude agents

abre agent view (research preview): una sola pantalla donde despachas sesiones, ves el estado de cada una y detectas cuáles necesitan tu input. Cada sesión corre en el background; tú entras solo cuando una se atasca o termina.

Mueve cada sesión despachada a su propio worktree automáticamente cuando necesita editar ficheros — el aislamiento de la lección 1, sin que lo montes tú.

Al abrirla, ocupa todo el terminal: una tabla de sesiones agrupadas por estado y, abajo, un campo para despachar. Verás algo así:

 Claude Code v2.1.140 · opus · ~/proyecto · 1 needs input

 Needs input
   ✻ power-up design       needs input: ¿salto doble o trepar muro?     1m

 Working
   ✽ collision detection   Edit src/physics/CollisionSystem.ts          2m

 Completed
   ✻ title screen          result: menú, opciones y créditos listos     9m

 ▌ describe una tarea para despacharla…

 ↑/↓ moverse · Enter adjuntar/despachar · Space ver · Ctrl+X parar · ? ayuda · Esc salir

Cada fila empieza con un icono cuyo color indica el estado, y los grupos suben lo que te necesita arriba del todo:

• Working (animado) → Claude está ejecutando tools o generando respuesta.
• Needs input (amarillo) → espera una pregunta o un permiso tuyo concretos.
• Idle (atenuado) → sin nada que hacer, listo para tu siguiente prompt.
• Completed (verde) → terminó bien. Failed (rojo) → terminó con error. Stopped (gris) → la paraste con Ctrl+X.

Despachar una tarea: walkthrough

El bucle central de agent view: despachar → vigilar el estado → asomarte y responder → adjuntar para la conversación completa. La sesión sigue corriendo aunque cierres agent view.

1. Abre la pantalla con claude agents. Si nunca has despachado nada, verás un hint de ejemplo en lugar de la tabla.
2. Despacha: escribe en el campo de abajo una tarea (no un saludo —prompts de menos de 4 caracteres se rechazan con Too short) y pulsa Enter. Por ejemplo:

   investiga por qué falla el test SettingsChangeDetector y propón un fix
   

   Arranca una sesión nueva en background y aparece como una fila. Cada Enter lanza una sesión nueva, no un seguimiento de la anterior: así corres varias en paralelo.
3. Vigila el estado: muévete con ↑/↓. La fila se actualiza sola con un resumen de una línea de lo que la sesión hace, necesita o ha producido.
4. Asómate y responde sin entrar del todo: con la fila seleccionada, pulsa Space para abrir el panel de peek (su última salida o la pregunta que te bloquea). Escribe la respuesta y Enter para enviarla sin salir de agent view. Si la pregunta es de opción múltiple, pulsa la tecla del número; para otras, Tab rellena una respuesta sugerida que puedes editar.
5. Adjunta cuando quieras la conversación completa: pulsa Enter o → sobre la fila. Agent view se sustituye por la sesión interactiva entera, igual que si hubieras hecho claude, y Claude te resume lo que pasó mientras no estabas.
6. Vuelve a la tabla: con el prompt vacío, pulsa ← para desacoplar (la sesión sigue corriendo) y volver a agent view. Si un diálogo tiene el foco y ← no responde, Ctrl+Z desacopla al instante.
7. Para o borra una sesión: Ctrl+X la para; Ctrl+X otra vez en menos de dos segundos la borra de la lista (y borra su worktree si lo creó Claude —commitea antes lo que quieras conservar).

Pruébalo. Abre claude agents, despacha una tarea real, y sin esperar despacha una segunda. Verás las dos filas en Working a la vez. Asómate a una con Space; adjunta a la otra con → y vuelve con ←. Eso es el bucle completo.

Atajos útiles dentro de agent view: Shift+Enter despacha y adjunta de golpe; Ctrl+T fija (pin) una sesión para que no se pare estando idle; Ctrl+R la renombra; Ctrl+S agrupa por directorio en vez de por estado; ? lista todos los atajos en contexto.

Mandar la sesión actual al background

Si ya estás en una sesión y quieres liberar el terminal mientras sigue trabajando:

/background

(alias: /bg) desacopla la conversación actual y la convierte en un background agent. También puedes darle una instrucción más al desacoplar: /bg ejecuta la suite de tests y arregla lo que falle.

Cómo confirmas que desacopló. No se queda en la conversación: la sesión se mueve a background y aparece como una fila en claude agents. Desde el terminal, el atajo equivalente es pulsar ← con el prompt vacío, que la manda al background y abre agent view con esa fila seleccionada en un solo paso. Si en su lugar ves el mensaje Cannot open agents — N background task(s) running, es que la sesión tiene trabajo en vuelo (un subagente, un comando de fondo): mira qué corre con /tasks y confirma con /bg.

Attach y parar con /tasks

/tasks lista lo que corre en el background de la sesión actual y te deja operarlo sin salir:

• Ver / asomarte: /tasks enumera cada elemento con su estado.
• Attach: entras a uno para ver la conversación completa, igual que adjuntar una fila en agent view.
• Parar: lo detienes desde ahí.

Para terminar la propia sesión desde dentro (no solo desacoplarla), el comando es /stop. Ojo: desacoplar nunca para la sesión — ni ←, ni Ctrl+Z, ni /exit, ni Ctrl+C doble la detienen; solo la dejan corriendo en background.

Los comandos de "¿qué está corriendo?"

Es fácil confundirlos, así que la tabla:

Cómo encaja con lo anterior

Agent view es la pieza de "delego y reviso": ni tú metido en cada conversación (subagentes), ni Claude de lead (agent teams). Y se combina —una sesión que despachas puede a su vez lanzar subagentes, cada uno con su worktree.

El desktop app tiene una vista equivalente de sesiones en paralelo, cada una respaldada por un worktree. Misma idea, otra superficie.

Si falla

• claude agents lista tus subagentes y se cierra en vez de abrir la pantalla → en ese entorno agent view no está disponible (versiones antiguas, o conexión vía Bedrock/Vertex/Foundry). Ejecuta claude update; comprueba la versión con claude --version (necesita v2.1.139 o superior). Si aun así no abre, mira si lo ha desactivado el setting disableAgentView o la variable CLAUDE_CODE_DISABLE_AGENT_VIEW.
• Sesiones en Failed (rojo) tras reiniciar la máquina → apagar el equipo detiene las sesiones de background. Asómate, responde o adjúntate a ellas y reanudan desde donde se quedaron. (Dormir el equipo no las rompe.)
• /background se niega con Cannot open agents — N background task(s) running → la sesión tiene trabajo en vuelo. Revisa con /tasks y confirma el desacople con /bg.
• Una sesión tarda en responder al adjuntarte → tras ~1 hora idle el supervisor para su proceso para liberar recursos; al adjuntarte arranca uno nuevo desde donde estaba. Fíjala con Ctrl+T para que siga viva.

Qué llevas hasta aquí

• claude agents abre agent view: despachar (escribe un prompt + Enter), vigilar el estado por color, asomarte con Space, adjuntar con →/Enter, volver con ←, parar con Ctrl+X.
• /background (alias /bg) desacopla la sesión actual; confirmas que funcionó porque aparece como fila en claude agents. Para terminarla desde dentro, /stop.
• /tasks lista el background de la sesión actual y te deja asomarte, adjuntar o parar cada elemento.
• Ojo a no confundirlos: claude agents (background), /agents (subagentes), /tasks (background de esta sesión), /workflows (dynamic workflows).

En la siguiente lección, el trabajo que ni siquiera necesita tu máquina: routines en la nube.

Fuente oficial: Manage agents with agent view · Run agents in parallel