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. Cada sesión en segundo plano es una conversación completa de Claude Code que sigue ejecutándose sin una terminal conectada, por lo que puede abrirla, responder y marcharse cuando quiera.

Vista de agentes en una terminal: el encabezado muestra Claude Code v2.1.140, el modelo, el directorio de trabajo y un recuento de resumen. Las sesiones se agrupan bajo Necesita entrada, Trabajando y Completado, con una entrada de distribución en la parte inferior y un pie de página de sugerencias de teclado.

Utilice la vista de agentes cuando tenga varias tareas independientes en las que Claude pueda trabajar sin que usted observe cada paso. Distribuya una corrección de errores, una revisión de solicitud de extracción y una investigación de prueba inestable como tres filas, continúe trabajando en otra ventana y verifique cuando una fila muestre que la necesita o tenga un resultado.

Cuando desee trabajar de forma más directa en la sesión de cualquier agente, conéctese a la fila para entrar en la conversación completa.

Para comparar la vista de agentes con subagentes, equipos de agentes y worktrees, consulte Ejecutar agentes en paralelo.

Inicio rápido

Este tutorial cubre el bucle principal de la vista de agentes: distribuir una tarea, observar cómo se actualiza su fila mientras Claude trabaja, echar un vistazo para verificar y responder, y conectarse para la conversación completa. La sesión que distribuye sigue ejecutándose después de cerrar la vista de agentes, por lo que puede irse y volver a ella.

Abrir la vista de agentes

Desde su shell, ejecute:

claude agents

Si aún no ha aceptado el diálogo de confianza del espacio de trabajo para el directorio, Claude Code lo muestra antes de que se abra la vista de agentes, el mismo diálogo que muestra claude. Acepte para guardar la confianza del espacio de trabajo y continuar. Si rechaza, Claude Code se cierra sin abrir la vista de agentes.

La vista de agentes se abre con una entrada en la parte inferior y una tabla que se completa a medida que comienzan las sesiones. Presione Esc para volver a su shell; si abrió la vista de agentes poniendo una sesión en segundo plano con ←, Esc vuelve a esa conversación en su lugar. Sus sesiones siguen ejecutándose mientras está fuera y reaparecen la próxima vez que abra la vista de agentes.

Distribuir una sesión

Escriba un mensaje describiendo una tarea y presione Enter. Una nueva sesión en segundo plano comienza en esa tarea y aparece como una fila que muestra si está funcionando, esperando su entrada o está hecha. La nueva sesión utiliza el modelo mostrado en el encabezado de la vista de agentes. El modo de permisos en el que comienza depende de cómo abrió la vista de agentes.

Cada mensaje que ingrese aquí inicia su propia sesión nueva. Escribir otro mensaje y presionar Enter lanza una segunda sesión junto a la primera en lugar de enviar una continuación a ella. Puede ejecutar varias en paralelo de esta manera.

Cada sesión utiliza su cuota de suscripción de forma independiente, así que consulte Limitaciones antes de distribuir muchas a la vez.

Echar un vistazo y responder

Seleccione una fila con las teclas de flecha y presione Space para abrir el panel de vista previa. Muestra la salida más reciente de la sesión, o la pregunta en la que está esperando, en lugar de la transcripción completa. Escriba una respuesta y presione Enter para enviarla sin salir de la vista de agentes.

Conectar y desconectar

Presione Enter o → en una fila para conectarse cuando desee la conversación completa. La sesión toma el control de la terminal como una sesión completa e interactiva de Claude Code. Presione ← en un mensaje vacío para desconectarse y volver a la tabla.

Traer una sesión existente

Este paso necesita una sesión en ejecución. Si siguió los pasos anteriores, no tiene una abierta en esta terminal, así que abra una sesión regular de claude en otra terminal y envíele un mensaje primero.

Para mover una sesión que ya tiene abierta a la vista de agentes, ejecute /bg dentro de ella, o presione ← en un mensaje vacío para enviarla al segundo plano y abrir la vista de agentes en un paso. En una sesión nueva sin mensajes aún, /bg le pide que envíe un mensaje primero, mientras que ← funciona de inmediato. La sesión sigue ejecutándose y aparece como una fila junto a las que distribuyó.

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.

Dentro de una sesión regular de claude, la pista ← del pie de página del mensaje cuenta los agentes en segundo plano que están esperando su entrada, como ← 2 agents, y vuelve a ← for agents cuando ninguno necesita entrada. Los conteos superiores a 99 se muestran como 99+. El conteo se actualiza aproximadamente cada diez segundos mientras la terminal está enfocada e inmediatamente cuando el enfoque regresa. Cambia brevemente de color cuando se mueve y cuando un agente se completa, y cuando una sesión en segundo plano se completa mientras ninguno necesita su entrada, muestra brevemente el número completado, como ← 2 done. Ambos destellos se desactivan cuando la configuración prefersReducedMotion está activada, y la pista se oculta en modo de lector de pantalla.

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 su antigüedad, contada desde cuándo se creó la sesión; la antigüedad de una sesión terminada se congela en cuánto tiempo tardó la ejecución.

El nombre está teñido con el color establecido por /color en esa sesión, incluyendo cuando envía una sesión al segundo plano con ← o /background.

De forma predeterminada, la lista muestra cada sesión en segundo plano que ha iniciado, en todos sus proyectos. Una sesión que trabaja en un repositorio y otra en un worktree diferente aparecen aquí, independientemente de qué directorio abrió la vista de agentes. Para limitar la lista a un proyecto, pase --cwd:

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

Esto muestra solo las sesiones iniciadas en ese directorio. Una sesión que se ha movido a un worktree bajo ~/projects/my-app/.claude/worktrees/ sigue contando como perteneciente a ~/projects/my-app.

Las sesiones interactivas que tiene abiertas en otras terminales no aparecen hasta que las envíe al segundo plano. Los subagentes y compañeros de equipo que una sesión genera no se enumeran como filas separadas.

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

Leer el estado de la sesión

Cada fila comienza con un icono cuyo color y animación muestran el estado de la sesión:

Estado	El icono se muestra como	Qué significa
Funcionando	Animado	Claude está ejecutando activamente herramientas o generando una respuesta
Necesita entrada	Amarillo	Claude está esperando algo que solo usted puede proporcionar: una respuesta a una pregunta, una decisión de permiso, u otro mensaje que solo usted puede responder, como un mensaje de sandbox para permitir un host de red o una solicitud de entrada de un servidor MCP. Un comando que necesita una terminal adjunta, como `/install-github-app` o la lista de configuración `/mcp`, mantiene una sesión desatendida aquí también
Inactivo	Atenuado	La sesión no tiene nada que hacer y está lista para su próximo mensaje
Completado	Verde	La tarea se completó exitosamente
Falló	Rojo	La tarea terminó con un error
Detenido	Gris	Detuvo la sesión con `Ctrl+X` o `claude stop`, su proceso fue terminado desde fuera de Claude Code, o terminó mientras el servicio en segundo plano estaba apagado

Por separado, la forma del icono muestra si el proceso subyacente está ejecutándose:

Forma	Qué significa
`✻` o `✽` animado	El proceso de la sesión está activo y responde inmediatamente
`∙`	El proceso ha salido. Aún puede echar un vistazo a la fila, y cuando responda o se adjunte, Claude reinicia desde donde se quedó
`✢`	Una sesión `/loop` durmiendo entre iteraciones. La fila muestra su recuento de ejecución y una cuenta regresiva

La etiqueta #N o !N que puede aparecer en el borde derecho de una fila es un enlace a la solicitud de extracción o solicitud de fusión de la sesión, no parte del icono de estado.

El título de la pestaña de terminal muestra el recuento de entrada pendiente mientras la vista de agentes está abierta: 2 awaiting input · claude agents cuando las sesiones necesitan entrada, o claude agents cuando no lo hacen.

Mientras la vista de agentes está abierta, Claude Code también envía una notificación a través de su canal de notificación de terminal configurado cuando una sesión en segundo plano local comienza a necesitar su entrada, se completa o falla. Las sesiones que se ejecutan según un cronograma, como sesiones /loop, notifican solo cuando necesitan su entrada. Las notificaciones utilizan la misma configuración preferredNotifChannel que el resto de Claude Code y activan el hook Notification con el tipo agent_needs_input o agent_completed.

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.

El estado de la sesión persiste en el disco a través de actualizaciones automáticas y reinicios del supervisor. Las sesiones también se conservan cuando su máquina se duerme. Sus procesos se reanudan al despertar y el supervisor se reconecta a ellos en lugar de tratar la brecha de tiempo como inactividad. El apagado aún detiene las sesiones en ejecución; consulte Las sesiones se muestran como fallidas o detenidas después del apagado para saber cómo recuperarlas.

Una sesión que estaba en medio de una respuesta cuando la máquina se durmió puede volver sin responder. Cuando abre una sesión que ha dejado de responder, el supervisor reinicia su proceso y la sesión continúa la respuesta interrumpida desde donde se quedó.

Resúmenes de filas

El resumen de una línea en cada fila es generado por un modelo de clase Haiku para que la fila pueda 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 texto de la fila se actualiza como máximo una vez cada 15 segundos desde la salida reciente de la sesión sin enviar una solicitud de modelo, y el modelo escribe un resumen nuevo cuando cada turno termina.

Una fila funcionando muestra lo que la sesión dice que está haciendo, y una fila bloqueada muestra la pregunta que está haciendo. Durante un turno largo, el modelo también reescribe el resumen cada pocos minutos para que una fila ocupada no siga mostrando un resumen desactualizado. El texto de resumen llena el ancho restante de la fila; abra el panel de vista previa para leer una oración que el borde de la terminal recorta.

Cuando la lista está agrupada por directorio, el resumen se abre con el estado de la sesión como una palabra coloreada, como Needs input · double jump or wall climb?. En la agrupación de estado predeterminada, el encabezado del grupo ya nombra el estado, por lo que la fila muestra solo el resumen.

El resumen de fin de turno y cada reescritura a mitad de turno son 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. Las actualizaciones de 15 segundos entre reescrituras de modelo reutilizan la salida de la sesión y no envían una solicitud. En un proveedor de terceros o puerta de enlace sin un modelo Haiku configurado, la solicitud utiliza el modelo principal de la sesión en su lugar; establezca ANTHROPIC_DEFAULT_HAIKU_MODEL para elegir uno.

Estado de la solicitud de extracción

Cuando una sesión abre una solicitud de extracción, Claude Code añade una etiqueta en el borde derecho de la fila, vinculada a la solicitud de extracción:

Claude Code escribe la etiqueta como #1234 para una solicitud de extracción y como !1234 para una solicitud de fusión de GitLab.
Claude Code emite el enlace incluso cuando no puede detectar soporte de hipervínculo, por ejemplo sobre SSH o tmux. Establezca FORCE_HYPERLINK=0 para renderizar la etiqueta como texto sin formato.
Después de enviar un seguimiento a la sesión, Claude Code mantiene la etiqueta mientras la fila vuelve al progreso en vivo.

Una sesión que trabaja en una solicitud de extracción existente está vinculada a ella de la misma manera. Claude Code encuentra la solicitud de extracción de manera diferente dependiendo del comando que ejecute Claude:

Cuando Claude edita, comenta, cierra o marca una solicitud de extracción como lista con gh, Claude Code vincula la solicitud de extracción que el resultado del propio comando nombra. Un comando gh cuya salida capturada no nombra ninguna solicitud de extracción no crea un enlace; gh pr merge es el caso común, porque imprime su resultado solo en una terminal interactiva.
Cuando Claude verifica una solicitud de extracción con gh pr checkout o envía a una rama, Claude Code busca la rama con gh pr view y vincula su solicitud de extracción abierta.
La solicitud de extracción no necesita existir aún cuando Claude envía: Claude Code reintenta la búsqueda de rama después de hasta cinco comandos posteriores de git, gh, glab o curl ejecutados en el mismo directorio, por lo que una solicitud de extracción creada después del envío, incluyendo una que Claude crea a través de la API REST de GitHub, se vincula cuando un reintento la encuentra.

Cuando una sesión está vinculada a más de una solicitud de extracción, la etiqueta muestra un recuento en su lugar, como 3 PRs, coloreada por la solicitud de extracción abierta que más necesita atención. Abra el panel de vista previa para verlas todas.

El número de la solicitud de extracción está coloreado por su estado:

Color	Estado de la solicitud de extracción
Amarillo	Esperando verificaciones o revisión, o las verificaciones fallaron
Verde	Las verificaciones pasaron y ninguna revisión está bloqueando
Púrpura	Fusionado
Gris	Borrador o cerrado

Para una tarea que termina en una solicitud de extracción, verifique esta etiqueta para el resultado: revise y fusione la solicitud de extracción cuando su número se vuelva verde.

Echar un vistazo y responder

Presione Space en una fila seleccionada para abrir el panel de vista previa. Se abre con la oración que la fila trunca en el borde de la terminal, y cuál es esa oración depende del estado de la sesión:

Una sesión que está esperando su entrada: la pregunta exacta que está haciendo, encima de la entrada de respuesta
Una sesión terminada: su resultado
Una sesión funcionando: su oración de estado completo

Cualquier solicitud de extracción vinculada a la sesión se enumera a continuación. Para una sesión que está esperando su entrada, una línea como waiting 3m debajo de ellas muestra cuánto tiempo ha estado esperando, y es la única vez que se muestra en el panel. La antigüedad en el borde derecho de la fila es un número diferente: cuenta desde cuándo comenzó la sesión.

La mayoría de las veces el panel de vista previa es suficiente y no 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 hace una pregunta con opciones predefinidas, el panel de vista previa las muestra como una lista numerada y puede presionar una tecla numérica para elegir una. Un mensaje de permiso se muestra como texto que describe lo que la sesión quiere ejecutar, sin opciones numeradas. Escriba una respuesta para responderlo, o adjúntese para responder con el mensaje estándar. 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.

Cuando un hook PermissionRequest o PreToolUse devuelve una salida que Claude Code no puede validar para la llamada que la sesión está pidiendo, la fila muestra el evento del hook y hook output invalid: con el error de validación antes del texto de la solicitud pendiente. Para un hook que falla de otra manera, la fila dice que el hook falló. La sesión sigue esperando la misma solicitud.

Una respuesta que no se puede entregar, porque el servicio en segundo plano es inaccesible o el envío falla, se guarda y se envía a la sesión como su próximo mensaje cuando su proceso se inicia nuevamente, y el mensaje de error dice que la respuesta fue guardada. Una respuesta con prefijo ! no se guarda, porque el texto guardado llegaría a la sesión como un mensaje simple en lugar de ejecutarse como un comando Bash.

Con dictado de voz habilitado, mantenga o toque su tecla de pulsar para hablar mientras la entrada de respuesta está enfocada para dictar una respuesta en lugar de escribirla. Lo mismo funciona en la entrada de distribución en la parte inferior de la vista de agentes.

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

Adjuntarse a una sesión

Presione Enter o → en una fila seleccionada para adjuntarse. La vista de agentes es reemplazada por la sesión interactiva completa. Cuando se adjunta, Claude publica un breve resumen de lo que sucedió mientras estaba fuera.

Mientras está adjunto, la sesión se comporta como cualquier otra sesión de Claude Code: comandos, atajos de teclado y características funcionan todos, con las excepciones a continuación.

Mientras está adjunto, /install-github-app y la lista de configuración /mcp funcionan normalmente, ya que un humano en la terminal puede completar sus diálogos. Cuando nadie está adjunto, estos comandos no pueden abrir sus diálogos, por lo que la sesión aparece bajo Needs input en la vista de agentes con una fila como open this session to manage MCP servers, y la respuesta de transcripción dice lo mismo. Adjúntese y ejecute el comando nuevamente para continuar; la fila de necesidad de entrada se borra cuando se adjunta. /mcp reconnect <server>, /mcp enable y /mcp disable funcionan sin adjuntarse de cualquier manera.

Las sesiones adjuntas siempre se renderizan en modo de pantalla completa, independientemente de su configuración tui, porque una sesión en segundo plano no tiene desplazamiento de terminal para agregar. Desplácese con PgUp, PgDn o la rueda del ratón, y presione Ctrl+O para el modo de transcripción. El desplazamiento nativo de su terminal y el modo de copia de tmux muestran solo la ventana gráfica actual, igual que cuando ejecuta cualquier aplicación de pantalla completa.

Presione ← en un mensaje vacío, o ejecute /exit, para desconectarse y volver a la vista de agentes, ya sea que abrió la sesión desde la vista de agentes o con claude attach <id> desde su shell.

En Windows, si presiona ← dentro de aproximadamente medio segundo de adjuntarse, Claude Code muestra Ambiguous ←, press again to detach, porque en esa ventana la terminal puede reentrega un presión de antes de que se adjuntara. Presione ← nuevamente para desconectarse.

Ctrl+Z también se desconecta pero vuelve a donde comenzó: la vista de agentes si se adjuntó desde allí, o su shell si ejecutó claude attach. Use Ctrl+Z cuando un diálogo tiene el enfoque y no responde a ←.

Ctrl+C mantiene su comportamiento de interrupción estándar mientras está adjunto: cancela una respuesta en ejecución o un comando shell ! en lugar de desconectarse. Presionar Ctrl+C dos veces en un mensaje vacío se desconecta, igual que en cualquier sesión.

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

Cambiar sesiones sin salir de la terminal

En una sesión que se ejecuta en primer plano, una que inició en la terminal en lugar de adjuntarse desde la vista de agentes, presionar ← en un mensaje vacío la envía al segundo plano y abre la vista de agentes con esa fila seleccionada, por lo que puede cambiar de sesión sin salir de la terminal. El mismo presionar único desconecta una sesión adjunta.

Si presiona ← justo después de eliminar el último del texto del mensaje o moverse a través del historial de mensajes, Claude Code le pide que confirme: el primer presión muestra Press ← again to open agents, o Press ← again to go back to agents en una sesión adjunta, y el segundo presión cambia.

Cuando ← envía una sesión en primer plano al segundo plano, la vista de agentes muestra Your conversation moved to the background encima de la lista, con la fila de esa sesión ya seleccionada. Desde allí:

Presione Enter para reabrir la conversación.
Presione Esc para deshacer el cambio y volver a la conversación. Si Esc muestra Still starting — try again in a moment, la sesión en segundo plano aún no está lista, así que presione Esc nuevamente en un momento.
Presione Ctrl+C dos veces para salir a su shell.

Cuando Claude Code no puede reabrir la conversación, sale e imprime un comando claude --resume que la reanuda.

La lista de tareas de Claude se mueve a la sesión en segundo plano con la conversación, por lo que la lista de verificación está intacta cuando vuelve a esa fila.

La fila en la que presionó ← también mantiene un nombre en negrita y sin atenuar después de mover la selección con las teclas de flecha o el ratón, para que pueda saber de qué sesión vino.

Si una herramienta se está ejecutando cuando presiona ←, Claude Code espera hasta aproximadamente diez segundos para que termine antes de enviar al segundo plano, y Claude continúa la respuesta en la sesión en segundo plano. Presione ← nuevamente para enviar al segundo plano inmediatamente en lugar de esperar. Cuando el trabajo en vuelo no puede trasladarse a la sesión en segundo plano, Claude Code muestra primero el diálogo Background this session?, igual que con /background.

El límite de diez segundos no se aplica mientras los subagentes en primer plano que Claude inició en la conversación aún se están ejecutando. Claude Code sigue esperando para que su trabajo se traslade, y muestra un aviso Still backgrounding after the current tool mientras espera. Presione ← nuevamente para enviar al segundo plano sin esperar, lo que reinicia esos subagentes desde el principio. Claude Code no espera a los subagentes que un flujo de trabajo dinámico está ejecutando. Cuando un flujo de trabajo tiene subagentes ejecutándose, Claude Code muestra el diálogo Background this session? en su lugar.

Claude Code no envía la sesión al segundo plano mientras tiene texto sin enviar en la entrada del mensaje, porque el texto permanece en el cuadro de entrada de su terminal y no se movería a la sesión en segundo plano. Si escribe en la entrada mientras Claude Code espera para enviar la sesión al segundo plano, cancela el cambio con Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.

Presionar ← crea la fila de la sesión incluso cuando la conversación no tiene mensajes aún, por lo que → aún vuelve a ella.

Puede desactivar este atajo con la configuración leftArrowOpensAgents en /config.

Organizar la lista

La vista de agentes agrupa sesiones para que las que necesitan entrada estén en la parte superior, con Ready for review y Needs input por encima de Working y Completed. Estos nombres de grupo no se asignan uno a uno a los estados anteriores: una sesión se mueve a Ready for review cuando tiene una solicitud de extracción abierta, y Completed recopila sesiones terminadas, fallidas y detenidas juntas.

Presione Ctrl+S para agrupar por directorio en su lugar. Su elección persiste entre ejecuciones.

Dentro de un grupo:

Presione Ctrl+T para fijar una sesión en la parte superior y mantener su proceso ejecutándose mientras está inactivo
Presione Shift+↑ o Shift+↓ para reordenar sesiones
Presione Ctrl+R para renombrar una sesión
Presione Enter en un encabezado de grupo para contraerlo

Para eliminar una sesión de la lista, 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.

El segundo presión elimina la sesión incluso cuando el intento de detención falla, por ejemplo porque el servicio en segundo plano no responde: la confirmación permanece activa durante otros dos segundos, y la eliminación termina el proceso de la sesión en sí. Presione Esc para descartar la confirmación sin eliminar.

Excepto en los casos mantenidos cubiertos en Qué elimina una sesión, eliminar elimina la sesión de la lista, y un worktree que Claude creó para ella se elimina, se mantiene o se deja en su lugar dependiendo de cómo elimine y qué contenga el worktree. La transcripción de conversación siempre permanece en su máquina local, disponible a través de claude --resume.

Para traer una sesión de vuelta en Claude Code v2.1.212 o posterior, escriba /resume en la entrada de distribución. Se abre un selector con sesiones pasadas del repositorio desde el que abrió la vista de agentes, más recientes primero, incluyendo sesiones que eliminó de la lista; las sesiones que ya tienen una fila no se enumeran. ↑/↓ mueven la selección, Enter reanuda la sesión seleccionada como una sesión en segundo plano para que se reúna con la lista como una fila, y Esc cierra el selector.

El selector se abre solo para un /resume simple. Un /resume dirigido, con alcance o restringido no puede ser servido por el selector, por lo que la vista de agentes muestra la sugerencia attach to a session to run it en su lugar cuando:

/resume nombra un id o un término de búsqueda
la vista está limitada con --cwd
la vista fue iniciada con --safe-mode
la vista fue abierta con una bandera como --permission-mode o --settings

Las sesiones completadas que no caben en la pantalla se pliegan en una fila … N more. Los fallos y las sesiones con una solicitud de extracción abierta siempre permanecen visibles. El grupo Completed llena el espacio vertical restante después de los grupos activos, y en una terminal corta el encabezado se compacta a una línea de resumen única para que las sesiones que están funcionando o necesitan entrada permanezcan visibles.

Filtrar sesiones

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

Filtro	Muestra
`a:<name>`	Sesiones que ejecutan el agente nombrado
`s:<state>`	Sesiones en el estado dado, como `s:working`. También acepta `s:blocked` para todo lo que lo espera a usted
`#<number>` o una URL de PR o MR	La sesión que trabaja en esa solicitud de extracción o solicitud de fusión
Cualquier otra URL	La sesión cuyo primer mensaje contenía esa URL

Atajos de teclado

Presione ? en la vista de agentes para ver cada atajo en contexto. La tabla a continuación los resume.

Atajo	Acción
`↑` / `↓`	Moverse entre filas
`Enter`	Adjuntarse a la sesión seleccionada, o distribuir si hay texto en la entrada
`Space`	Abrir o cerrar el panel de vista previa para la sesión seleccionada
`Shift+Enter`	Insertar una nueva línea en la entrada de distribución, como en el mensaje principal
`Ctrl+Enter`	Distribuir y adjuntarse inmediatamente, en terminales donde la superposición `?` enumera `ctrl+enter to start and open`
`→`	Adjuntarse a la sesión seleccionada
`Alt+1`..`Alt+9`	Adjuntarse a la sesión 1–9 en el directorio de la sesión enfocada
`Tab`	En una entrada vacía, examinar todos los subagentes. De lo contrario, aplicar la sugerencia resaltada
`Ctrl+S`	Cambiar agrupación entre estado y directorio
`Ctrl+T`	Fijar o desfijar la sesión seleccionada
`Ctrl+R`	Renombrar la sesión seleccionada
`Ctrl+G`	Abrir el mensaje de distribución en su `$VISUAL` o `$EDITOR`
`Ctrl+J`	Insertar una nueva línea en la entrada de distribución
`Ctrl+X`	Detener la sesión; presione nuevamente dentro de dos segundos para eliminarla
`Shift+↑` / `Shift+↓`	Reordenar la sesión seleccionada
`Esc`	Cerrar el panel de vista previa, limpiar la entrada o salir. Cuando abrió la vista de agentes enviando su sesión al segundo plano con `←`, el `Esc` final vuelve a esa conversación en lugar de salir. Con modo de editor vim activado, presionar `Esc` en la entrada cambia de modo INSERT a modo NORMAL y mantiene su texto, como en el mensaje principal
`Ctrl+C`	Limpiar la entrada; presione dos veces para salir
`?`	Mostrar todos los atajos

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; renómbrela más tarde con Ctrl+R.

El nombre automático es una etiqueta corta escrita por un modelo de clase Haiku. Un nombre que la sesión obtiene más tarde también aparece en su fila, incluido el título generado que la sesión obtiene cuando acepta un plan en esa sesión.

Pegue una imagen en el mensaje para incluir una captura de pantalla o diagrama con la tarea.

El texto pegado más largo que 800 caracteres o más de tres líneas se contrae a un marcador de posición [Pasted text #N] para que la entrada permanezca en una línea; el texto completo se envía cuando distribuye. Para revisar o editar el texto contraído antes de distribuir, pegue el mismo texto nuevamente y el marcador de posición se expande nuevamente en la entrada.

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

Entrada	Efecto
`<agent-name> <prompt>`	Si la primera palabra coincide con un nombre de subagente personalizado, ese subagente se ejecuta como el agente principal de la sesión con la configuración de su frontmatter
`@<agent-name>`	Mencione un subagente personalizado en cualquier lugar del mensaje para ejecutarlo como el agente principal
`@<repo>`	Mencione un repositorio para ejecutar la sesión allí. Consulte Distribuir a un directorio específico para ver qué repositorios se enumeran
`/<command>`	Sugiera skills y commands para distribuir como el mensaje
`! <command>`	Ejecute un comando de shell como un trabajo en segundo plano en lugar de iniciar una sesión de Claude. El trabajo aparece como una fila a la que puede conectarse, observar y desconectarse
`#<number>` o una URL de solicitud de extracción o fusión	Si una sesión ya está trabajando en esa solicitud de extracción o fusión, Claude Code selecciona su fila en lugar de distribuir una nueva sesión

Un pequeño conjunto de comandos se ejecutan en la vista de agentes en sí en lugar de distribuirse:

/exit y /quit cierran la vista de agentes
/logout cierra su sesión
/model establece el modelo de distribución
/login abre el diálogo de inicio de sesión para que pueda iniciar sesión nuevamente sin conectarse a una sesión
Un /resume sin argumentos, o su alias /continue, abre un selector de sesiones pasadas del repositorio para traer una de vuelta como una sesión en segundo plano. Requiere Claude Code v2.1.212 o posterior

Skills, sus propios comandos y built-ins que expanden prompts como /init se envían a una nueva sesión en segundo plano como su primer mensaje. Otros comandos built-in muestran una sugerencia attach to a session to run it en su lugar. Todo lo que escribió permanece en la entrada junto a la sugerencia para que pueda editarlo.

Empaquetar una tarea recurrente como un skill le permite iniciar el mismo flujo de trabajo desde la vista de agentes repetidamente sin reescribir el mensaje.

Cuando el mismo @name coincide tanto con un subagente como con un repositorio hermano, el subagente tiene prioridad. La coincidencia de primera palabra sin @ también se aplica, por lo que un mensaje que comienza con uno de sus nombres de subagente distribuye ese subagente en lugar de tratar la palabra como texto plano. Use la forma @ cuando desee ser explícito, o comience el mensaje con una palabra diferente para evitar la coincidencia.

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, use cualquiera de estos:

Abra claude agents en ese directorio.
Abra claude agents en un directorio padre y mencione un repositorio hijo con @<repo> en el mensaje. Escribir @ enumera estos objetivos:
- Repositorios Git un nivel por debajo del directorio de lanzamiento
- Los git worktrees registrados del repositorio desde el que se lanzó que viven dentro de su árbol de directorios, como los que Claude crea bajo .claude/worktrees/, etiquetados con su rama extraída. Los worktrees agregados fuera del repositorio, como con git worktree add ../feature, no se enumeran
- Cualquier directorio que ya tenga una sesión en la lista
Un directorio cuyo nombre contiene un espacio no se enumera.
Desde el shell, cd al directorio y ejecute claude --bg "<prompt>".

Cuando la vista de agentes se agrupa por directorio, distribuir envía el mensaje al directorio de la fila seleccionada, por lo que puede seleccionar un grupo y distribuir en él sin reescribir la ruta.

Desde dentro de una sesión

Dos comandos mueven el trabajo de la sesión en la que se encuentra al segundo plano: /background envía la conversación actual allí y libera su terminal, y /fork envía una copia mientras continúa trabajando donde está.

Enviar la sesión al segundo plano

Ejecute /background o su alias /bg para mover la conversación actual a una sesión en segundo plano. Pase un mensaje como /bg run the test suite and fix any failures para dar una instrucción más primero. Si Claude está respondiendo cuando ejecuta /bg, la respuesta continúa en la sesión en segundo plano.

Salir de una sesión que aún tiene trabajo en segundo plano en ejecución, como subagentes, comandos de shell en segundo plano, flujos de trabajo o monitores, muestra un diálogo Background work is running en lugar de salir inmediatamente. Elija Move to background and exit para enviar la sesión al segundo plano de la misma manera que /background lo hace y volver a su shell. La opción no se muestra cuando la vista de agentes está desactivada.

Si una sesión en segundo plano en la lista ya tiene el nombre de la conversación, Claude Code numera el nombre de la nueva fila, como my-session (2), y deja el nombre de la fila existente sin cambios. Para renombrar la nueva fila, selecciónela en la vista de agentes y presione Ctrl+R.

Copiar la sesión con /fork

Ejecute /fork para copiar la conversación actual en una nueva sesión en segundo plano mientras la original continúa ejecutándose. La copia comienza con todo en la conversación hasta ese punto; consulte los puntos a continuación para ver dónde se ejecuta la copia. También lleva el modelo, modo de permiso, nivel de esfuerzo y cualquier directorio o concesión de permiso "no preguntar de nuevo" que agregó durante la sesión. La copia aparece como su propia fila en la vista de agentes.

Después de la bifurcación, las dos conversaciones son independientes: nada de lo que hace la copia entra en la conversación original por sí solo, aunque en sesiones donde mensajería entre sesiones está habilitada, Claude en cualquiera de las sesiones puede enviar un mensaje explícitamente a la otra.

Copiar la sesión requiere Claude Code v2.1.212 o posterior; en v2.1.161 a v2.1.211, /fork inicia un subagente bifurcado en su lugar, que ahora es /subtask. Cuando la vista de agentes está desactivada, /fork mantiene el comportamiento de subagente bifurcado y /subtask no está disponible.

Pase un mensaje como /fork open a draft pull request with the work so far y la copia comienza a trabajar en él inmediatamente. Sin un mensaje, la copia espera su primera instrucción: seleccione su fila en claude agents y presione Space para enviar una, o ejecute claude attach <id>. La fila seleccionada muestra space to send it a prompt mientras espera.

La confirmación de /fork es una línea que muestra el estado de la copia, como session running, el nombre de su fila de vista de agentes y su ID de sesión para claude attach. Haga clic en el nombre para cambiar a la copia: esta sesión se mueve al segundo plano, igual que presionar ←, y la vista de agentes abre la sesión de la copia.

Excepto cuando la copia edita en su lugar, Claude Code le indica que cree su propio worktree antes de hacer cambios de código. Fuera de un repositorio git, solo una copia movida fuera de un worktree creado por hook recibe la instrucción; sin un hook WorktreeCreate, la copia edita en su lugar. Una copia movida fuera de su worktree también recibe la instrucción de nunca editar, ejecutar comandos en o entrar en ese worktree, sea cual sea la configuración de aislamiento.

Dónde comienza la copia depende de dónde se ejecuta la sesión actual:

Como cualquier sesión distribuida, la copia se mueve a su propio worktree antes de editar archivos. En ese caso, la confirmación no menciona dónde se ejecuta la copia.
Cuando su sesión se movió a su worktree vinculado después de que comenzó, la copia comienza de nuevo donde estaba la sesión antes del movimiento y, a menos que edite en su lugar, hace sus cambios de código en un worktree propio allí. Cuando su worktree está extraído en una rama, esa instrucción también le dice a una copia cuya tarea se basa en su trabajo que base su nueva rama en la suya, ya que su rama permanece extraída en su worktree. La confirmación termina con runs in the origin tree.
Cuando lanzó la sesión dentro de un worktree vinculado de un repositorio que tiene un árbol de trabajo principal, la copia comienza en ese árbol de trabajo principal, con la misma regla de worktree propio pero sin instrucción de rama. La confirmación termina con runs in the origin tree aquí también.
Una sesión lanzada dentro de un worktree de un diseño de repositorio desnudo no tiene árbol de trabajo principal al que volver, por lo que la copia permanece donde está, y la confirmación termina con edits this checkout. La misma nota aparece cuando el aislamiento de worktree está desactivado en una sesión que no está dentro de un worktree vinculado, porque la copia entonces edita los archivos que tiene abiertos.

Las sesiones iniciadas con banderas de lanzamiento que la copia no heredaría, como un mensaje del sistema reemplazado o una lista de permitidos --tools, no se pueden bifurcar; Claude Code lo dice en lugar de hacer una copia parcial. Una sesión distribuida desde la vista de agentes se bifurca normalmente: la copia se lanza con la misma definición de agente e instrucciones añadidas que la sesión de la que proviene.

Qué se lleva cuando envía al segundo plano

Enviar al segundo plano inicia un nuevo proceso que se reanuda desde la conversación guardada, y el trabajo en vuelo se traslada a él: comandos shell en segundo plano en ejecución, subagentes en segundo plano, flujos de trabajo dinámicos, tareas programadas que creó con /loop, y respuestas automáticas de Claude a comentarios de artefactos se trasladan a la sesión en segundo plano y siguen ejecutándose allí. Un subagente se traslada junto con todo lo que inició, por lo que se traslada solo cuando todo ese trabajo puede trasladarse también. Para detener el trabajo en vuelo en lugar de trasladarlo, establezca la variable de entorno CLAUDE_DISABLE_ADOPT=1; Claude Code luego le pide que confirme antes de enviar al segundo plano.

Cuando un flujo de trabajo dinámico aún tiene subagentes en ejecución, Claude Code pregunta antes de enviar al segundo plano con el diálogo Background this session?, que dice cuántos subagentes se reiniciarían. Elija Stay para dejarlos terminar primero. Si confirma, Claude Code reproduce la ejecución en la sesión en segundo plano: los subagentes que aún se estaban ejecutando comienzan de nuevo desde el principio, por lo que los tokens que usaron hasta ahora se gastan nuevamente. Consulte Reanudar después de una pausa para ver qué subagentes completados devuelven sus resultados guardados y cuáles se ejecutan nuevamente.

Claude Code detiene el trabajo que no puede trasladarse, como un monitor en ejecución, y detiene un subagente en segundo plano que posee un monitor junto con él. Cuando algún trabajo de este tipo se está ejecutando, Claude Code muestra el diálogo Background this session? para que pueda confirmar antes de que se detenga el trabajo.

Una vez en segundo plano, la sesión puede iniciar nuevos subagentes, monitores y comandos en segundo plano, y esos continúan ejecutándose en desconexiones y reconexiones posteriores.

Las banderas de configuración del lanzamiento original se transfieren a la sesión enviada al segundo plano, por lo que sus servidores MCP, configuración y modelo de respaldo permanecen en vigor:

--mcp-config y --strict-mcp-config
--settings
--add-dir
--plugin-dir
--fallback-model
--allow-dangerously-skip-permissions

Los directorios que agregó durante la sesión con /add-dir también se transfieren. Transferir --allow-dangerously-skip-permissions mantiene bypassPermissions accesible en la sesión enviada al segundo plano, pero no otorga nada nuevo: el modo aún requiere la aceptación interactiva única descrita en Modo de permiso, modelo y esfuerzo.

Desde su shell

Pase --bg o su forma larga --background para iniciar una sesión que vaya directamente al segundo plano:

claude --bg "investigate the flaky SettingsChangeDetector test"

El mensaje es el argumento posicional, no un valor -p. Claude Code rechaza --bg combinado con -p o --print antes de que se cree cualquier sesión, porque --print nunca inicia la sesión interactiva a la que claude agents se conecta.

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

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

Si el nombre no coincide con ninguno de sus subagentes, el lanzamiento falla: Claude Code imprime una advertencia no agent named y aún reporta la sesión como enviada al segundo plano, pero la sesión sale inmediatamente con un error --agent '<name>' not found.

Cuando la sesión enviada al segundo plano se reanuda o reinicia más tarde, Claude Code restaura el mensaje del sistema del agente y las restricciones de herramientas. Busca primero el agente en el directorio de la sesión, siempre que haya confiado en ese espacio de trabajo, por lo que un agente con alcance de proyecto aún se carga cuando la sesión se reanuda desde otro directorio. Si el agente ya no existe, la sesión continúa con las herramientas predeterminadas y el mensaje del sistema y su transcripción se abre con una advertencia que nombra al agente.

Pase --name para establecer el nombre de visualización de la sesión en la vista de agentes en lugar del generado automáticamente:

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

Después de enviar al segundo plano, Claude imprime el ID corto de la sesión y los comandos para administrarla. Cuando el servicio que aloja sesiones en segundo plano no está ya en ejecución, --bg puede imprimir primero Starting background service… encima de esta salida. Cuando pasa --name, el nombre aparece después del ID corto:

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

Ejecutar un comando de shell

Para ejecutar un comando de shell como un trabajo en segundo plano en lugar de una sesión de Claude, pase --exec. El siguiente ejemplo ejecuta pytest -x como un trabajo en segundo plano:

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

Desde la vista de agentes, distribuya el mismo tipo de trabajo escribiendo ! como el primer carácter de la entrada de distribución: el ! se muestra como un prefijo, todo lo que viene después es el comando, y Enter inicia el trabajo.

El comando se ejecuta como un trabajo respaldado por PTY y aparece como una fila en la vista de agentes, con la línea de salida más reciente como su estado. Un trabajo de shell ejecuta el comando en lugar de Claude, por lo que no se invoca ningún modelo y la salida no se envía a ninguna sesión.

Para ver la salida, conéctese a la fila, presione Space para echar un vistazo sin conectarse, o ejecute claude logs <id> desde su shell. La salida capturada permanece en la memoria y no se escribe en el disco. La fila y su salida se limpian automáticamente aproximadamente cinco minutos después de que el comando salga, así que léalo antes si necesita el resultado.

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. Antes de editar archivos, Claude mueve la sesión 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. Una vez que la sesión está en su worktree, Claude Code aplica aislamiento de worktree para la sesión y para cualquier subagente que genere.

Claude omite el worktree cuando:

La sesión ya está dentro de un git worktree vinculado, ya sea que Claude lo haya creado bajo .claude/worktrees/ o que lo haya creado con git worktree add en otro lugar
El archivo que Claude está editando está dentro de un git worktree vinculado, como uno que la sesión o su subagente creó con git worktree add
El directorio de trabajo no es un repositorio git y no hay ningún hook WorktreeCreate configurado
La escritura está fuera del directorio de trabajo

Para desactivar el aislamiento de worktree para un repositorio donde los git worktrees no son prácticos, establezca worktree.bgIsolation en "none". Las sesiones en segundo plano editarán su copia de trabajo directamente sin moverse a un worktree primero. Agregue la configuración al archivo .claude/settings.json del proyecto:

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

Fuera de un repositorio git, las sesiones escriben en el directorio de trabajo directamente y no están aisladas entre sí, por lo que evite distribuir sesiones paralelas que editen los mismos archivos. Si utiliza un sistema de control de versiones diferente, configure un hook WorktreeCreate y Claude aísla las ediciones de la misma manera que lo hace para git.

Cuando el hook falla en un directorio que no es un repositorio git, Claude omite el aislamiento para ese directorio y edita el directorio de trabajo en su lugar. Dentro de un repositorio git, Claude Code bloquea las escrituras en el checkout compartido hasta que Claude mueve la sesión a un worktree.

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.

Un subagente que la sesión en segundo plano genera hereda el directorio de trabajo de la sesión, por lo que sus ediciones de archivos se realizan en el worktree de la sesión en lugar de su copia de trabajo. Para darle a un subagente su propio worktree separado en su lugar, establezca isolation: worktree en su frontmatter o pase isolation: "worktree" al generarlo.

Cuando una sesión en segundo plano ha realizado cambios de código en un worktree que Claude ingresó, Claude Code le indica a Claude que preserve el trabajo antes de terminar, por lo que sobrevive si elimina la sesión y su worktree:

Confirmar e insertar: Claude confirma sin preguntar e inserta la rama cuando el repositorio tiene un remoto.
Solicitud de extracción en borrador: Claude abre una cuando la tarea lo requiere, y la etiqueta #N aparece en la fila.
Nunca: insertar a main o master, fuerza-insertar y fusionar.
Sus instrucciones de git tienen prioridad: si la tarea, CLAUDE.md o memoria dice que usted maneja la confirmación o inserción usted mismo, Claude deja git para usted.

Una sesión que edita un checkout que no aisló a sí misma aún pregunta antes de confirmar o cambiar de rama. Esto se aplica cuando el aislamiento se establece en "none", cuando el movimiento del worktree falló, o cuando la sesión comenzó dentro de un worktree que ya existía.

Sea cual sea la tarea, Claude termina el trabajo con un informe que dice qué hizo y dónde está el trabajo: una ruta, una rama, una solicitud de extracción o la respuesta en sí.

Qué elimina la eliminación de una sesión

Elimine una sesión con Ctrl+X dos veces en vista de agentes o con claude rm. Excepto en los casos mantenidos a continuación, la sesión deja la lista. Su transcripción permanece en su máquina a través de claude --resume, y la eliminación sobrevive a los reinicios del supervisor.

Qué sucede con un worktree que Claude creó para la sesión:

La vista de agentes lo elimina, incluidos los cambios sin confirmar, por lo que confirme lo que desee mantener primero.
claude rm lo mantiene, junto con la fila de la sesión, cuando tiene cambios sin confirmar.
Ni la vista de agentes ni claude rm eliminan un worktree con commits que Claude Code no puede confirmar que se guardan en otro lugar, o uno que otra sesión en ejecución está usando o ha bloqueado. Claude Code mantiene el worktree y la sesión, y nombra el directorio mantenido y la razón.

Los commits en un remoto no bloquean la eliminación. Tampoco los commits en la copia local de la rama predeterminada de su remoto origin, siempre que esa rama esté extraída en su checkout principal, el directorio del repositorio en sí en lugar de un worktree.

En la vista de agentes, una eliminación rechazada muestra not deleted con la razón en la fila de la sesión. Inserte los commits, fusionelos en esa rama predeterminada o cierre la otra sesión, luego elimine nuevamente.
Un worktree que git ya no reconoce, por ejemplo después de git worktree prune, no bloquea la eliminación. Claude Code elimina la sesión y deja el directorio en el disco.

Un worktree que creó usted mismo e inició la sesión dentro se deja en su lugar de cualquier forma.

Una sesión cuyo directorio de worktree no pertenece a ningún repositorio git, porque el repositorio fue eliminado o un hook WorktreeCreate creó el directorio en otro lugar, aún se puede eliminar. Mientras los archivos permanezcan en el directorio:

La vista de agentes pide el mismo doble presión Ctrl+X antes de descartarlos. Para un directorio creado por hook, ejecuta su hook WorktreeRemove en su lugar, y sin uno rechaza la eliminación y mantiene la sesión.
claude rm mantiene la sesión y el worktree, y nombra la razón.

Cualquiera de los caminos mantiene un directorio que los registros de otra sesión terminada nombran.

Establecer el modelo

El nombre del modelo mostrado en el encabezado de la vista de agentes es el valor predeterminado de distribución. Las nuevas sesiones que inicia desde la entrada utilizan este modelo, que proviene de la configuración model en su configuración de usuario. Establézcalo seleccionando un modelo en el selector /model, o edite la configuración directamente.

Para anular el valor predeterminado de distribución para toda la sesión de vista de agentes, pase --model al abrir la vista de agentes. Consulte Modo de permiso, modelo y esfuerzo.

Para cambiar el valor predeterminado de distribución desde dentro de la vista de agentes, escriba /model seguido de un nombre de modelo en la entrada de distribución y presione Enter. El encabezado se actualiza para mostrar ese modelo con un marcador (session), y las sesiones que distribuya después lo utilizan. Escriba /model default para borrar la anulación y volver al valor predeterminado de distribución. Esta anulación dura el resto de la ejecución actual de claude agents y no se escribe en su archivo de configuración. El siguiente ejemplo distribuye una sesión en Opus y la siguiente en Sonnet:

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

Cada sesión en segundo plano puede ejecutarse en un modelo diferente. Para anularlo para una sesión:

Desde el shell, pase --model con claude --bg.
Conéctese a una sesión en ejecución y ejecute /model para cambiar: una selección del selector, o un /model <name> escrito, se guarda como su valor predeterminado para nuevas sesiones a menos que presione s en el selector para un cambio solo de sesión. Un cambio solo de sesión persiste si la sesión se reinicia.
Distribuya un subagente cuyo frontmatter establezca un campo model.

Modo de permiso, modelo y esfuerzo

Una sesión en segundo plano toma su configuración, proveedor, modo de permiso, modelo y esfuerzo de dónde y cómo la distribuyó. Las subsecciones a continuación cubren cada fuente y qué persiste cuando el supervisor reinicia la sesión.

Configuración y proveedor

Una sesión en segundo plano lee su configuración desde el directorio en el que se ejecuta, igual que si hubiera iniciado claude allí. Esto incluye valores env en la configuración del proyecto, por lo que una variable ANTHROPIC_MODEL o de proveedor establecida allí se aplica a cada sesión en segundo plano en ese directorio.

Una sesión en segundo plano también se ejecuta con el PATH del shell desde el que la distribuyó, por lo que los comandos que ejecuta encuentran las mismas herramientas que su terminal. También mantiene la selección del proveedor en la nube de ese shell, como CLAUDE_CODE_USE_BEDROCK o CLAUDE_CODE_USE_VERTEX, junto con sus alias ANTHROPIC_DEFAULT_*_MODEL y cualquier anulación CLAUDE_CODE_EXTRA_BODY que haya exportado allí.

Puerta de enlace LLM

Si enruta Claude Code a través de una puerta de enlace LLM, coloque las variables de puerta de enlace en el bloque env de un archivo de configuración en lugar de exportarlas en su shell, y las sesiones en segundo plano las leen con el resto de su configuración. Establecer en un archivo de configuración muestra el bloque y qué archivo de configuración usar para la credencial.

Si exporta una puerta de enlace ANTHROPIC_BASE_URL solo en su shell en su lugar, llega a una sesión en segundo plano, junto con ANTHROPIC_CUSTOM_HEADERS y la credencial que exportó con ella, solo cuando el supervisor fue iniciado desde un shell que exportó la misma puerta de enlace, y solo en estos casos:

Envía su propia sesión al segundo plano con ← o /background
Distribuye una sesión al directorio en el que está
Despierta una sesión detenida en el directorio en el que está adjuntándose o respondiendo a ella

Claude Code reenvía una puerta de enlace frente a un proveedor en la nube. Si el shell desde el que distribuye selecciona el proveedor e exporta su punto final de puerta de enlace con su bandera de omisión de autenticación, Claude Code reenvía el par punto final-y-bandera a la sesión bajo las condiciones que se aplican a ANTHROPIC_BASE_URL, junto con ANTHROPIC_CUSTOM_HEADERS. Por ejemplo, exporte CLAUDE_CODE_USE_VERTEX=1 con ANTHROPIC_VERTEX_BASE_URL y CLAUDE_CODE_SKIP_VERTEX_AUTH=1, y Claude Code reenvía ese punto final y bandera.

Claude Code aplica una puerta de enlace reenviada solo al proceso en ejecución de esa sesión y nunca la escribe en el disco.

Modo de permiso

El modo de permiso depende de cómo inició la sesión:

Enviado al segundo plano con /bg o ←: Claude Code mantiene el modo de permiso en el que estaba la sesión, por lo que uno que cambió a acceptEdits o auto permanece allí después de desconectarse
Distribuido desde una vista de agentes que abrió con ←: la nueva sesión comienza en el modo de permiso de la sesión de la que vino
Distribuido desde claude agents iniciado en un shell, o con claude --bg: la nueva sesión comienza de la manera que lo haría una nueva sesión claude en ese directorio, a menos que la haya distribuido desde una vista de agentes que abrió con valores predeterminados de distribución. Qué modo de permiso comienza una sesión enumera el orden

Valores predeterminados de distribución

Para establecer valores predeterminados para cada sesión que distribuya desde la vista de agentes, pase cualquiera de --permission-mode, --model, --effort o --agent al abrirla:

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

--effort aquí acepta los mismos valores que la bandera --effort de nivel superior, incluido ultracode.

--agent establece el subagente utilizado cuando un mensaje de distribución no nombra uno, ya sea con @name o como la primera palabra. Por defecto es la configuración agent si se establece una, de lo contrario el agente integrado claude que lo captura todo. Nombrar un subagente en la entrada de distribución anula ambos.

claude agents también acepta --dangerously-skip-permissions como abreviatura de --permission-mode bypassPermissions, y --allow-dangerously-skip-permissions para hacer que bypassPermissions esté disponible en el ciclo Shift+Tab de cada sesión distribuida sin comenzar en ese modo. Ambos coinciden con las banderas CLI de nivel superior.

Pase --restricted para iniciar cada sesión que distribuya desde la vista en modo restringido, como si cada una se lanzara con la bandera de nivel superior --restricted. Requiere Claude Code v2.1.248 o posterior.

Los valores predeterminados activos aparecen en el pie de página debajo de la entrada de distribución.

Claude Code rechaza claude --bg --permission-mode bypassPermissions hasta que haya aceptado el descargo de responsabilidad de bypass ejecutando claude --dangerously-skip-permissions una vez de forma interactiva, ya que ese modo permite que una sesión que no está viendo actúe sin aprobación. Pasar --dangerously-skip-permissions o --permission-mode bypassPermissions a claude agents muestra el mismo descargo de responsabilidad cuando no lo ha aceptado antes, y aceptar aplica bypassPermissions a las sesiones que lanza desde la vista. Pasar --allow-dangerously-skip-permissions muestra el mismo descargo de responsabilidad también, y aceptar hace que bypassPermissions esté disponible en el ciclo Shift+Tab de esas sesiones sin iniciarlas en él.

Qué persiste en los reinicios

El modo de permiso, modelo y esfuerzo que eligió para una sesión en segundo plano, junto con las banderas de configuración que lleva, todos persisten cuando el supervisor posteriormente detiene y reinicia su proceso. Una sesión que lanzó con claude --bg --dangerously-skip-permissions o claude --bg --permission-mode bypassPermissions permanece en bypassPermissions después de ese reinicio. Un modelo o esfuerzo que cambió a mitad de sesión con /model o /effort también se mantiene.

Si la sesión tomó su esfuerzo de su configuración en lugar de --effort o /effort, Claude Code lee su configuración nuevamente cada vez que inicia un proceso para la sesión. Entonces, cuando edita el esfuerzo guardado en settings.json, el cambio llega a las sesiones que envía al segundo plano con ← o /bg, y sus reinicios posteriores. El esfuerzo guardado es la clave effortLevel o una entrada modelSettings.

Claude Code también mantiene un nombre que estableció con /rename o Ctrl+R en ese reinicio, por lo que aún puede ejecutar claude --resume <name> para llegar a la sesión.

Configuración, plugins y servidores MCP

La vista de agentes acepta las mismas banderas de configuración que claude para cargar configuración, plugins, servidores MCP y directorios adicionales. La vista de agentes aplica --settings y --plugin-dir a sí misma y pasa cada bandera de configuración a las sesiones que distribuye desde ella, por lo que un plugin o servidor MCP que cargue de esta manera está disponible en esas sesiones.

Bandera	Efecto
`--settings <file-or-json>`	Anule la configuración para la vista de agentes y las sesiones distribuidas
`--add-dir <path>`	Otorgue acceso a archivos a un directorio adicional
`--plugin-dir <path>`	Cargue un plugin desde un directorio local
`--mcp-config <file-or-json>`	Cargue servidores MCP desde un archivo de configuración o cadena JSON
`--strict-mcp-config`	Use solo los servidores MCP de `--mcp-config`, ignorando otra configuración de MCP. Consulte Control exclusivo con managed-mcp.json para ver qué hace la bandera bajo un archivo MCP administrado

Repita --add-dir, --plugin-dir o --mcp-config una vez por valor. claude agents no admite la forma separada por espacios, como --add-dir a b c.

Puede colocar --settings y --plugin-dir antes o después de agents. Mantenga --add-dir y --mcp-config después de agents: si coloca cualquiera de ellos antes de agents, claude agents --json falla con un error unknown option.

El siguiente ejemplo abre la vista de agentes con una anulación de configuración y un directorio adicional:

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

--settings acepta una ruta de archivo o una cadena JSON en línea. Una ruta de archivo debe apuntar a un archivo existente; Claude Code sale con un error Settings file not found si no lo hace.

Gestionar sesiones desde el shell

Cada sesión en segundo plano tiene un ID corto que puede usar desde el shell. El ID se imprime cuando inicia una sesión con claude --bg, y el ID de cada sesión es su nombre de directorio bajo ~/.claude/jobs/. Estos comandos son útiles para scripting o cuando no desea abrir la vista de agentes.

Comando	Propósito
`claude agents`	Abrir la vista de agentes
`claude agents --cwd <path>`	Abrir la vista de agentes limitada a sesiones iniciadas bajo `<path>`
`claude agents --json`	Imprimir sesiones como un array JSON y salir. Consulte Listar sesiones como JSON
`claude attach <id>`	Conectarse a una sesión en esta terminal
`claude logs <id>`	Imprimir la salida reciente de la sesión
`claude stop <id>`	Detener una sesión. También acepta `claude kill`
`claude respawn <id>`	Reiniciar una sesión, en ejecución o detenida, por ejemplo para usar un binario Claude Code actualizado. La sesión reiniciada reanuda su conversación guardada; cuando ninguna está en disco, ejecuta su prompt original nuevamente como una nueva conversación
`claude respawn --all`	Reiniciar cada sesión en ejecución, por ejemplo para mover todas las sesiones a un binario Claude Code actualizado a la vez
`claude rm <id>`	Eliminar una sesión de la lista, junto con un worktree que Claude creó para ella cuando es seguro eliminarlo; consulte Qué elimina la eliminación de una sesión. La transcripción de la conversación permanece en su máquina local y sigue disponible a través de `claude --resume`
`claude daemon status`	Imprimir el estado del supervisor, versión, directorio de socket y número de workers
`claude daemon stop --any`	Detener el proceso supervisor y las sesiones en segundo plano que aloja. Pase `--keep-workers` para dejar las sesiones en segundo plano en ejecución de modo que el siguiente supervisor se reconecte a ellas. El siguiente `claude agents` o `claude --bg` inicia un nuevo supervisor

Listar sesiones como JSON

claude agents --json imprime sesiones activas como un array JSON y sale: cada sesión activa, más sesiones en segundo plano que aún están funcionando o bloqueadas incluso cuando su proceso ha salido. Agregue --all para incluir también sesiones en segundo plano completadas, y --cwd <path> para limitar la lista a sesiones iniciadas bajo ese directorio.

Cada entrada describe una sesión:

Campo	Presente	Descripción
`cwd`, `kind`, `startedAt`	Siempre	El directorio de trabajo, `interactive` o `background`, y la hora de inicio en milisegundos Unix
`id`	Sesiones en segundo plano	ID corto, utilizable con `claude attach`, `claude logs` y `claude stop`
`state`	Sesiones en segundo plano	Uno de `working`, `blocked`, `done`, `failed` o `stopped`
`pid`, `status`	Mientras el proceso está activo	ID del proceso y estado actual
`waitingFor`	Cuando `status` es `waiting`	En qué está bloqueada la sesión: `permission prompt` para una aprobación, `input needed` para una pregunta de Claude o una solicitud de entrada de un servidor MCP, `sandbox request`, `worker request` o `dialog open`
`sessionId`, `name`	Cuando está configurado	`sessionId` es el UUID de sesión completo, utilizable con `claude --resume`. El `name` de una sesión interactiva es su nombre de visualización predeterminado hasta que nombre la sesión o acepte un plan en ella

Cómo se alojan las sesiones en segundo plano

Claude Code trata cada sesión listada en la vista de agentes como una sesión en segundo plano, independientemente de si está actualmente conectado a ella. Por el contrario, una sesión iniciada ejecutando claude directamente está vinculada a esa terminal y finaliza cuando se cierra, a menos que la envíe al segundo plano.

Para verificar qué tipo de sesión está usando, ejecute /status. La fila Session kind muestra background job · attached o background job · unattended en una sesión en segundo plano, dependiendo de si una terminal está conectada, e interactive en cualquier otra sesión.

El proceso supervisor

El supervisor es un servicio en segundo plano que ejecuta sus sesiones en segundo plano para que sigan funcionando después de cerrar la vista de agentes o su terminal. Claude Code lo inicia la primera vez que envía una sesión al segundo plano o abre la vista de agentes, y no necesita administrarlo usted mismo.

Cada sesión es su propio proceso de Claude Code bajo el supervisor, y lo que sucede con ese proceso depende del estado de la sesión:

Funcionando, esperando su entrada o conectado: el proceso sigue ejecutándose. Un subagente, flujo de trabajo o monitor en ejecución cuenta como funcionando.
Finalizado y sin conectar durante aproximadamente una hora: el supervisor detiene el proceso para liberar recursos. La conversación permanece en el disco, y la próxima vez que se conecte o responda, la sesión se reanuda donde se quedó. Fije una sesión con Ctrl+T para mantener su proceso ejecutándose mientras está inactiva.
Salió inesperadamente mientras el supervisor está ejecutándose: el supervisor reinicia el proceso. Finalizar una sesión que envió al segundo plano usted mismo con ← o /background, por ejemplo con kill, la marca como detenida en lugar de reiniciarla. Para sesiones que finalizaron con un apagado, consulte Las sesiones se muestran como fallidas o detenidas después del apagado.
Después de una actualización automática: el supervisor se reinicia en la nueva versión y mueve las sesiones inactivas al segundo plano. Las sesiones que están funcionando, esperando su entrada o conectadas no se interrumpen.

Cuando el proceso de una sesión se detiene o se reinicia, los comandos de shell en segundo plano, los flujos de trabajo dinámicos y los subagentes en segundo plano que Claude inició en ella se transfieren al siguiente proceso; los monitores en ejecución y los comandos de shell que un subagente inició se detienen con el proceso. Eliminar la sesión detiene todo lo que se transfirió. Para detener todo con el proceso en lugar de transferirlo, establezca CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF en 1.

El supervisor y sus sesiones se autentican con las mismas credenciales almacenadas que sus sesiones interactivas. Para saber qué configuraciones y variables de shell llegan a una sesión, incluido PATH, consulte Configuración y proveedor. Para puntos finales de puerta de enlace, consulte Puerta de enlace LLM.

Dónde se almacena el estado

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.

Ruta	Contenidos
`~/.claude/daemon.log`	Registro del supervisor
`~/.claude/daemon/roster.json`	Lista de sesiones en segundo plano en ejecución, utilizada para reconectarse después de un reinicio
`~/.claude/jobs/<id>/state.json`	Estado por sesión mostrado en la vista de agentes
`~/.claude/jobs/<id>/tmp/`	Directorio de trabajo temporal por sesión. Las escrituras aquí no solicitan permiso. Se elimina cuando se elimina la sesión

Cada sesión en segundo plano tiene la variable de entorno CLAUDE_JOB_DIR establecida en su directorio ~/.claude/jobs/<id>, por lo que los comandos de shell que ejecuta la sesión pueden escribir archivos temporales en $CLAUDE_JOB_DIR/tmp sin colisionar con sesiones paralelas.

Para inspeccionar este estado sin leer los archivos directamente, ejecute claude daemon status. Informa si el supervisor es accesible, su ID de proceso y versión, el directorio de socket y cuántas sesiones en segundo plano están activas.

El comando también advierte cuando el supervisor en ejecución está en una versión diferente a la de claude que invocó, lo que sucede después de una actualización en la que el supervisor aún no se ha reiniciado. La advertencia muestra ambas versiones y le indica que ejecute claude daemon stop --any para adoptar la nueva versión. Cuando Claude Code se instala como un servicio del sistema operativo, el comando sugerido es claude daemon stop sin la bandera.

Las sesiones sobreviven a ese desajuste de versión intactas: una versión anterior de Claude Code que actualiza el state.json de una sesión preserva campos que no reconoce y mantiene la sesión listada. La lista de sesiones en roster.json sigue la misma regla, por lo que las sesiones iniciadas por la versión más nueva permanecen accesibles y continúan aceptando entrada después de que el supervisor se reinicia.

Desactivar la vista de agentes

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

`claude agents` enumera subagentes en lugar de abrir la vista de agentes

Si claude agents imprime un recuento seguido de sus subagentes configurados y luego sale, la vista de agentes no está disponible en su entorno. Ejecute claude update para instalar la versión más reciente.

Si la vista de agentes aún no se abre después de actualizar, verifique si ha sido desactivada por una configuración o variable de entorno.

La vista de agentes se abre sin sesiones

Antes de distribuir su primera sesión, la vista de agentes muestra las secciones de encabezado vacías con una descripción debajo de cada una, más una explicación de una línea encima de la entrada, en lugar de la lista de sesiones. Escriba un mensaje en la entrada en la parte inferior y presione Enter para distribuir su primera sesión.

Backgrounding muestra un diálogo `Background this session?`

Si presiona ← para enviar al segundo plano la sesión actual y Claude Code muestra un diálogo Background this session?, la sesión tiene trabajo en vuelo que el backgrounding detendría, reiniciaría o dejaría ejecutándose desatendido, y Claude Code pregunta antes de hacer cualquiera de esos:

Trabajo que no se puede mover: la sesión tiene trabajo que no se puede mover a la sesión en segundo plano, como un monitor en ejecución. El diálogo nombra el trabajo que Claude Code detendría y, por separado, cuenta las tareas que se trasladan.
Un flujo de trabajo con subagentes en ejecución: un flujo de trabajo dinámico aún tiene subagentes en ejecución. El flujo de trabajo en sí se traslada, pero sus subagentes en ejecución se reinician desde el principio, y el diálogo dice cuántos.
Respuestas automáticas de artefactos: Claude está respondiendo a comentarios en un artefacto por su cuenta. Esas respuestas continúan en la sesión en segundo plano, y el diálogo lo dice.

Ejecute /tasks para ver todo lo que se está ejecutando, luego confirme para enviar al segundo plano de todas formas o elija Stay para dejar que el trabajo termine primero. Consulte Qué se traslada cuando envía al segundo plano para saber qué tipos de trabajo se trasladan y cuáles Claude Code detiene.

Mensaje rechazado por ser demasiado corto

La entrada de distribución espera una descripción de tarea, no un abridor conversacional. Un mensaje más corto de cuatro caracteres se rechaza con una sugerencia Too short para que una pulsación de tecla extraviada no inicie una sesión. Describa lo que desea que haga la sesión, como investigate the flaky checkout test.

Las sesiones se muestran como fallidas o detenidas después del apagado

Apagar o reiniciar su máquina detiene las sesiones en segundo plano en ejecución. Una sesión que estaba esperando su entrada permanece bajo Needs input cuando regresa. Para cualquier otra sesión en ejecución, lo que muestra la vista de agentes depende de cuánto tiempo hace que hizo progreso por última vez:

Dentro de 48 horas, la sesión se muestra como fallida. Conéctese, eche un vistazo o responda a ella y se reiniciará desde donde se quedó.
Pasadas 48 horas, como después de que la máquina estuvo apagada durante días, la sesión se muestra como detenida con ended while the background service was off. Presione Enter en la fila y el pie de página muestra Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it. Presione Enter en la misma fila nuevamente para reanudar su conversación guardada. Una respuesta, o claude attach <id>, la reanuda sin ese mensaje de pie de página.

Cuando la limpieza de transcripción ha eliminado la conversación guardada de una sesión detenida, Claude Code se niega a abrir la fila: el mensaje dice que no hay nada que reanudar. claude rm <id> elimina la fila, excepto en los casos mantenidos descritos anteriormente, y claude respawn <id> ejecuta su mensaje original nuevamente. Consulte La conversación guardada de esta sesión ya no está en el disco.

El sueño solo no detiene las sesiones. Las sesiones se conservan durante el sueño y el supervisor se reconecta a ellas al despertar.

Abrir una sesión dice que la conversación ya está abierta

Dos procesos no pueden escribir en la misma transcripción. Cuando la conversación guardada de una sesión detenida ya está abierta en otro proceso Claude Code en vivo, Claude Code se niega a iniciar el proceso de la sesión. Lo que ve depende de lo que mantenga la conversación:

Una terminal donde reanudó la conversación, por ejemplo con claude --resume o /resume: la fila muestra Open in a terminal con una sugerencia para continuarla allí, y abrir la fila muestra Can't open — this session is running in another terminal. Continúe en esa terminal, o salga de ella y abra la fila nuevamente.
Otro proceso Claude Code no interactivo, por ejemplo un proceso de sesión en segundo plano para la misma conversación que aún no ha salido: abrir la fila muestra This conversation is already open in another running Claude session. Use ese proceso, o espere a que salga y abra la fila nuevamente.

Claude Code guarda una respuesta que escribió con el intento rechazado y la envía la próxima vez que se inicia la sesión.

Abrir una sesión dice que no tiene transcripción guardada

Una sesión detenida que fue enviada al segundo plano desde otra conversación y se detuvo antes de que su primera respuesta terminara no tiene nada que reanudar: hasta que esa primera respuesta termine, la conversación aún vive solo en la sesión desde la que fue enviada al segundo plano. claude attach se niega a abrirla con This session has no saved transcript.

En la vista de agentes, abrir esa fila muestra Press enter again to restart this session fresh debajo de la lista. Presione Enter en la misma fila nuevamente para reiniciar la sesión con una conversación vacía, o ejecute claude respawn <id> desde el shell.

La conversación original está intacta; reanúdela con claude --resume o continúe trabajando en ella. Consulte la referencia de errores para obtener detalles.

El host de terminal murió o la sesión dejó de responder

El supervisor ejecuta la terminal de cada sesión en segundo plano en su propio proceso host. Cuando ese proceso muere o deja de responder, Claude Code muestra la razón y ofrece un reinicio; en ambos casos la conversación se guarda y el reinicio la reanuda. La referencia de errores cita los mensajes completos.

Claude Code nunca reinicia una fila que ejecuta un comando shell, desde Enter o desde claude attach, porque eso ejecutaría el comando nuevamente; el mensaje de la fila y claude attach ambos dicen que el comando no se ejecuta nuevamente.

Terminal host murió

En Linux y WSL, el supervisor verifica cada proceso host cada pocos segundos, independientemente de si abre la sesión o no, y marca la sesión como fallida cuando el proceso ha salido pero su conexión al supervisor nunca se cerró.

En la vista de agentes, la fila muestra terminal host process died — press Enter to restart. Presione Enter en ella y Claude Code reinicia la sesión en un proceso host nuevo.
Desde el shell, claude attach <id> reinicia una sesión ya marcada como fallida. De lo contrario, reporta la causa y sale, diciéndole que ejecute claude attach <id> nuevamente.

La sesión no está respondiendo

Cuando el supervisor acepta una apertura pero no llega salida durante aproximadamente diez segundos, Claude Code termina el intento y ofrece un reinicio. Una sesión que simplemente se estancó, por ejemplo durante el sueño de la máquina, no llega a esta oferta: el supervisor la reinicia al abrir por sí solo.

En la vista de agentes, el pie de página muestra Press enter again to restart this session — it isn't responding (its conversation is saved and resumes). Presione Enter en la misma fila nuevamente y Claude Code detiene el proceso que no responde y reinicia la sesión; no detiene nada sin ese segundo press.
Desde el shell, claude attach <id> reporta la causa y sale, diciéndole que ejecute claude stop <id>, luego claude attach <id>.

Una sesión falla antes de iniciarse con una nota `possibly low memory`

Cuando el proceso de una sesión en segundo plano sale antes de terminar de iniciarse y el host tiene poca memoria, el estado de la fila nombra la salida y añade possibly low memory — free some up and retry.

La nota es una hipótesis, no una causa confirmada. Claude Code la añade solo cuando el proceso salió silenciosamente, sin escribir un error y sin ser detenido por una señal, y el host reportó poca memoria en ese momento. Cuando el proceso escribió un error antes de salir, la fila muestra ese error en su lugar.

Libere memoria en la máquina, luego conéctese, eche un vistazo o responda a la fila y el supervisor inicia un proceso nuevo para la sesión. Cuando la memoria se mantiene baja, el supervisor también detiene las sesiones inactivas para liberar recursos por su cuenta, y detiene las sesiones fijadas inactivas también si detener las otras no liberó nada.

La vista de agentes dice que el servicio en segundo plano no respondió

Si conectarse, echar un vistazo o claude logs reporta que el servicio en segundo plano no respondió, el proceso supervisor probablemente se ha estancado. Deténgalo y deje que el siguiente claude agents inicie uno nuevo. Para mantener sus sesiones en segundo plano ejecutándose durante el reinicio, pase --keep-workers:

claude daemon stop --any --keep-workers

El nuevo supervisor se reconecta a las sesiones en ejecución. Sin --keep-workers, el comando también termina las sesiones en segundo plano. La bandera --any confirma que desea detener un supervisor que se inició bajo demanda en lugar de como un servicio instalado, que es el predeterminado.

Un supervisor que se inicia pero no puede aceptar conexiones sale y libera su bloqueo por sí solo, por lo que el siguiente claude agents inicia uno nuevo sin este detención manual. Los pasos anteriores se aplican cuando un supervisor en ejecución se estanca.

Si el comando en su lugar sale diciendo que el proceso registrado no pudo verificarse como el supervisor, verifique el ID de proceso reportado: si es un supervisor que posee, deténgalo usted mismo, luego elimine ~/.claude/daemon.lock para que el siguiente claude agents inicie nuevo.

En Windows, si el supervisor no responde a la solicitud de detención, el comando imprime su ID de proceso. Termine ese proceso con taskkill /PID <pid> para finalizar la recuperación. Las sesiones en segundo plano aún se conservan cuando pasó --keep-workers.

La distribución falla con `Could not resolve authentication method`

Si una distribución en segundo plano falla con Could not resolve authentication method mientras las sesiones interactivas se autentican normalmente, el worker que recibió la distribución no recogió las credenciales. Las sesiones en segundo plano obtienen sus credenciales del supervisor, por lo que este error significa que no había credencial almacenada disponible para el proceso supervisor en sí. Confirme que ha ejecutado /login o ha configurado una clave API, luego detenga el supervisor:

claude daemon stop --any --keep-workers

El siguiente claude agents o claude --bg inicia un supervisor nuevo que lee sus credenciales almacenadas. Si se autentica con una variable de entorno como ANTHROPIC_API_KEY en lugar de /login, ejecute ese comando siguiente desde un shell donde la variable esté configurada.

Consulte la referencia de errores para la lista completa de causas y soluciones.

Las sesiones en segundo plano no pueden leer Desktop, Documents o Downloads en macOS

En macOS, el host de sesión en segundo plano se ejecuta como su propio proceso y solicita acceso a carpetas protegidas por separado desde su terminal. Si una sesión en segundo plano reporta Operation not permitted al leer ~/Desktop, ~/Documents, ~/Downloads u otra ubicación protegida, otorgue acceso en Configuración del Sistema bajo Privacidad y Seguridad > Archivos y Carpetas, o habilite Acceso Total al Disco para la entrada.

Con el instalador nativo, la entrada aparece como Claude Code y la concesión persiste en las actualizaciones. Con otros métodos de instalación como Homebrew o npm, la entrada muestra la ruta del binario y puede necesitar ser otorgada nuevamente después de actualizar.

Las sesiones en segundo plano no pueden alcanzar hosts de red local en macOS

En macOS 15 y posterior, el sistema bloquea un proceso para que no alcance dispositivos en su red local hasta que otorgue permiso de Red Local, por lo que un comando dirigido a una dirección LAN puede fallar con connect: no route to host en una sesión en segundo plano aunque funcione en una terminal en primer plano. El primer comando en una sesión en segundo plano que se conecta a una dirección de red local activa la solicitud de permiso de Red Local de macOS para Claude Code. Otórguelo una vez y esos comandos alcanzarán hosts LAN de la misma manera que lo hacen en una terminal en primer plano.

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ó y cambia a la sesión inmediatamente mientras el proceso se reinicia. Las sesiones que están funcionando, esperando su entrada o fijadas no se detienen de esta manera, así que fije una sesión con Ctrl+T para mantenerla receptiva.

Mientras el proceso se inicia, Claude Code muestra la cola de la transcripción de la sesión formateada de la manera que la sesión en vivo la renderiza, con markdown, bloques de código resaltados y llamadas de herramientas como filas atenuadas, encima de un área de mensaje atenuada con una nota Session is starting. La sesión en vivo la reemplaza tan pronto como esté lista.

`.claude/worktrees/` se está llenando

Eliminar una sesión en la vista de agentes elimina el worktree que Claude creó para ella, pero algunos deletes mantienen el worktree o dejan su directorio en el disco, por lo que los directorios sobrantes pueden acumularse. Los directorios que git ya no reconoce no aparecen en git worktree list, así que elimine esos a mano.

Enumere las entradas sobrantes con git worktree list en el directorio del proyecto y elimine cada una con git worktree remove <path>. Consulte Limpiar worktrees.

Limitaciones

La vista de agentes está en vista previa de investigación con las siguientes limitaciones:

Se aplican límites de velocidad: las sesiones en segundo plano consumen el uso de su suscripción igual que las sesiones interactivas, por lo que ejecutar diez agentes en paralelo usa cuota aproximadamente diez veces más rápido que ejecutar uno.
Las sesiones son locales: las sesiones en segundo plano se ejecutan en su máquina. Se conservan durante el modo de suspensión pero se detienen si la máquina se apaga.
Los worktrees creados por Claude se eliminan con la sesión en la vista de agentes: confirme los cambios antes de eliminar una sesión que editó archivos en su propio worktree. Algunos borrados mantienen el worktree en su lugar.

Para otras formas de ejecutar Claude en paralelo, y para pasar hallazgos entre las sesiones que ejecuta, consulte:

Ejecutar agentes en paralelo: compare la vista de agentes con subagentes, equipos de agentes y worktrees
Mensajería entre sesiones: haga que sus sesiones se pasen hallazgos entre sí
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

Historial de versiones

La vista de agentes ha evolucionado rápidamente durante la vista previa de investigación. Si está en una versión anterior de Claude Code, algunos comportamientos en esta página pueden diferir; en particular, claude agents rechaza banderas que aún no admite con un error unknown option. La tabla a continuación enumera cuándo se agregó cada bandera y comportamiento.

Versión	Cambio
v2.1.251	En una sesión de fondo que no ha entrado en un worktree, Claude y los subagentes que genera pueden editar archivos dentro de un worktree de git vinculado.
v2.1.251	Claude Code reenvía una puerta de enlace de proveedor de nube exportada en el shell desde el que distribuye, como `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL` con su bandera de bypass de autenticación, al worker de la sesión bajo las mismas condiciones que `ANTHROPIC_BASE_URL`. Antes de esta versión, si enviaba al segundo plano o distribuía desde un shell autenticado solo a través de tal puerta de enlace, cada solicitud que la sesión realizaba fallaba, porque el punto final y la bandera se eliminaban de su entorno.
v2.1.251	Cuando una sesión de fondo se inicia mientras otro proceso de Claude Code está actualizando un marketplace de plugins, como una sesión hermana ejecutando la actualización automática del marketplace, Claude Code mantiene los plugins de ese marketplace disponibles. Antes de esta versión, tal sesión podría iniciarse sin ninguna de las skills, agentes, hooks y servidores MCP de ese marketplace y permanecer así durante toda su ejecución.
v2.1.248	`Shift+Enter` en la entrada de distribución inserta una nueva línea, coincidiendo con el prompt principal, y `Ctrl+Enter` distribuye y se adjunta inmediatamente en terminales donde la superposición `?` enumera `ctrl+enter to start and open`. Antes de esta versión, `Shift+Enter` distribuía y se adjuntaba.
v2.1.248	Eliminar una sesión tiene éxito cuando los commits del worktree ya están en la copia local de la rama predeterminada de su remoto `origin` y su checkout principal tiene esa rama verificada; antes de esta versión, la eliminación se rechazaba con `has commits that are not pushed anywhere`.
v2.1.248	Una sesión enviada al segundo plano con `←` o `/background` mantiene el `git worktree lock` en su worktree mientras se ejecuta; antes de esta versión, enviar al segundo plano liberaba el bloqueo, y la limpieza o `git worktree remove` podría eliminar el worktree bajo la sesión en ejecución.
v2.1.248	Una sesión de fondo que no estaba esperando su entrada y se encuentra muerta más de 48 horas después de su última actividad, como después de que la máquina estuvo apagada durante días, se muestra como detenida con `ended while the background service was off`, y `Enter` en ella pregunta antes de reanudar su conversación guardada. Antes de esta versión, tal sesión reaparecía como un fallo nuevo ordenado en la parte superior de la lista, y un único `Enter` traía la conversación de hace semanas al primer plano.
v2.1.248	Abrir una fila detenida cuya conversación reanudó en otra terminal se rechaza con `Can't open — this session is running in another terminal`, y la fila muestra `Open in a terminal` en lugar de mostrarse bajo `Working`. Antes de esta versión, abrir la fila iniciaba un segundo proceso escribiendo en la misma conversación.
v2.1.248	Una sesión de fondo esperando una decisión de permiso mientras un hook `PermissionRequest` o `PreToolUse` imprimía una respuesta inválida nombra el evento del hook y el error de esquema en su fila. Antes de esta versión, la fila mostraba solo la solicitud pendiente.
v2.1.248	En Windows, `claude agents` responde al teclado cuando se lanza en una pestaña de terminal que un programa anterior dejó en win32-input-mode. Antes de esta versión, Claude Code no decodificaba los registros de teclas que tal pestaña envía.
v2.1.247	En Linux y WSL, una sesión cuyo proceso host de terminal murió falla dentro de segundos con la razón. Una apertura que no produce salida termina después de aproximadamente diez segundos con una oferta de reinicio, y `Enter` en la fila reinicia la sesión con su conversación; `claude attach <id>` reporta la causa y sale. Antes de esta versión, abrir tal sesión mostraba `opening… · esc to cancel` indefinidamente y `claude attach <id>` esperaba sin reportar un error.
v2.1.246	En una instalación de npm, cuando el servicio de fondo falla al iniciarse mientras `npm install -g @anthropic-ai/claude-code` está reemplazando el binario, Claude Code espera hasta diez segundos a que la instalación termine y reintenta antes de reportar `EACCES: permission denied`.
v2.1.246	Cuando el proceso del servicio de fondo muere después de imprimir un error, Claude Code reporta el fallo y cita la primera línea de error del servicio.
v2.1.246	Si su máquina se duerme mientras el servicio de fondo se está iniciando, Claude Code reintenta el inicio una vez en lugar de fallar.
v2.1.246	Claude Code espera aproximadamente dos minutos en lugar de 45 segundos para un servicio de fondo recién iniciado que está vivo pero lento para aceptar conexiones.
v2.1.246	El servicio de fondo se inicia desde su directorio de inicio, por lo que en macOS y Linux un directorio de inicio que fue eliminado o movido ya no bloquea el inicio.
v2.1.246	`/fork` copia la conversación completa de una sesión que ella misma se inició como una copia y no ha registrado un nuevo prompt desde: una copia `/fork` a la que se adjuntó, una sesión reajustada después de que `←` o `/background` la movió al segundo plano, o una sesión iniciada con `claude --resume <id> --fork-session`. Antes de esta versión, si ejecutaba `/fork` en tal sesión antes de enviarle un nuevo prompt, Claude Code imprimía la confirmación normal pero iniciaba la copia con una conversación vacía. Mover tal sesión al segundo plano con `←` o `/background` perdía la conversación de la misma manera.
v2.1.246	Cuando abre una sesión que acaba de distribuir mientras su proceso worker aún se está iniciando, como presionando `Enter` en su fila, Claude Code espera al proceso y luego se adjunta. Antes de esta versión, si presionaba `Enter` mientras el proceso aún se estaba iniciando, Claude Code podría detener la sesión con `Session <id> was stopped while the respawn was in flight`.
v2.1.246	Cuando envía al segundo plano una sesión nombrada, Claude Code la enumera una vez, y cuando envía al segundo plano la misma conversación nuevamente, numera el nombre de la nueva fila, como `my-session (2)`, con la fila existente manteniendo su nombre. Antes de esta versión, la terminal en la que presionó `←` podría aparecer en `claude agents --json` como una segunda sesión bajo el mismo nombre, y si enviaba al segundo plano la misma conversación nuevamente, Claude Code agregaba otra fila bajo el nombre idéntico.
v2.1.239	Con modo de editor vim activado, presionar `Esc` en la entrada de la vista de agentes cambia de modo INSERT a NORMAL y mantiene su texto, coincidiendo con el prompt principal; en modo NORMAL con texto aún en la entrada, presionar `Esc` lo borra, y presionar `Esc` en una entrada vacía sale, como describe el atajo `Esc`. Antes de esta versión, `Esc` borraba la entrada.
v2.1.233	Para una sesión vinculada a una solicitud de fusión de GitLab, Claude Code escribe la etiqueta de la fila en la sintaxis de referencia `!1234` de GitLab. También puede pegar la URL de la solicitud de fusión en la entrada de distribución para seleccionar esa sesión. Antes de esta versión, la etiqueta se representaba como `#1234`, y una URL de solicitud de fusión pegada coincidía con una sesión solo cuando su primer prompt contenía la URL.
v2.1.227	Eliminar una sesión mantiene la sesión y su worktree mientras otra sesión de Claude Code en vivo se ejecuta dentro de ese directorio de worktree. La vista de agentes muestra `not deleted` en la fila y la razón en el pie de página, y `claude rm` imprime `kept <id>` con la razón, que nombra el ID de proceso de la otra sesión. Antes de esta versión, eliminar la sesión eliminaba el worktree mientras la otra sesión aún estaba trabajando en él.
v2.1.225	`claude agents` en un directorio que no ha confiado muestra el mismo diálogo de confianza del espacio de trabajo que `claude` muestra al inicio, antes de que se abra la vista de agentes. Aceptar guarda la confianza para ese espacio de trabajo; rechazar sale sin abrir la vista de agentes. Antes de esta versión, `claude agents` se abría sin preguntar, por lo que las sesiones que distribuía desde él se ejecutaban en un directorio en el que nunca le habían pedido que confiara. Con la lista agrupada por directorio, pasar el ratón sobre una fila la resalta sin cambiar el destino de distribución; seleccionar una fila con las teclas de flecha o un clic aún cambia el destino. Antes de esta versión, mover el ratón sobre una sesión en otro proyecto silenciosamente cambiaba el directorio en el que se iniciaba la siguiente sesión distribuida.
v2.1.221	`/status` muestra una fila `Session kind`: `background job · attached` o `background job · unattended` en una sesión de fondo, dependiendo de si una terminal está adjunta, e `interactive` en cualquier otra sesión. Antes de esta versión, `/status` no reportaba el tipo de sesión. `/fork`: Claude Code instruye a la copia para aislar su trabajo del de la sesión original: la copia crea su propio worktree antes de hacer cambios de código, se mantiene fuera del worktree de la sesión original, y basa una nueva rama en la rama de la original cuando su tarea se basa en ese trabajo. Vea la sección vinculada para las condiciones exactas. Antes de esta versión, la copia no recibía instrucción de aislamiento y podría terminar editando el worktree o verificando el checkout en el que la sesión original aún estaba trabajando. Con modo de editor vim activado, presionar `←` justo después de deshacer el prompt de vuelta a vacío con `u` pide la misma confirmación que eliminar el texto o moverse a través del historial de prompts, y cambia solo en el segundo presionar; antes de esta versión el presionar cambiaba inmediatamente.
v2.1.219	Con modo de editor vim activado, presionar `←` en un prompt vacío abre la vista de agentes desde modo NORMAL así como INSERT, y la sugerencia `←` del pie de página se muestra en modo NORMAL; antes de esta versión el gesto y la sugerencia eran solo INSERT, y en modo NORMAL `←` en un prompt vacío no hacía nada. Escribir en la entrada mientras Claude Code espera enviar la sesión al segundo plano cancela el cambio con `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` para que un borrador escrito no se pierda.
v2.1.218	Presionar `←` dentro de dos segundos de una eliminación que vació el prompt, o de moverse a través del historial de prompts, muestra `Press ← again to open agents`, o `Press ← again to go back to agents` en una sesión adjunta, y cambia solo en un segundo presionar al menos un segundo después; antes de esta versión el presionar cambiaba inmediatamente. Un `←` que llega dentro de entrada pegada o escrita por script ya no activa el cambio. Enviar al segundo plano una sesión en primer plano con `←` muestra `Your conversation moved to the background` encima de la lista, y `Esc` en la raíz de la vista de agentes regresa a esa conversación en lugar de salir al shell, con doble `Ctrl+C` permaneciendo como la salida; si la conversación no se puede reabrir, Claude Code sale e imprime un comando `claude --resume` para ella. En Windows, un `←` presionado dentro de aproximadamente medio segundo de adjuntarse muestra `Ambiguous ←, press again to detach` y se desadjunta en el segundo presionar.
v2.1.217	La insignia de solicitud de extracción en la fila de una sesión se representa como un hipervínculo incluso cuando Claude Code no puede detectar soporte de hipervínculo de terminal, por ejemplo sobre SSH o tmux; establezca `FORCE_HYPERLINK=0` para representarla como texto sin formato. Antes de esta versión, la insignia se representaba como texto sin formato cuando el soporte no se detectaba.
v2.1.216	`/fork`: la confirmación es una línea, mostrando el estado de la copia, el nombre de su fila de vista de agentes, y su ID de sesión para `claude attach`, terminando con `runs in the origin tree` o `edits this checkout` solo cuando la copia se ejecuta en el árbol de trabajo principal o edita el checkout que tiene abierto. Hacer clic en el nombre envía esta sesión al segundo plano y abre la vista de agentes en la sesión de la copia. La confirmación ya no reafirma el modo de permiso heredado de la copia; las versiones anteriores imprimían una confirmación de varias líneas sin nombre clickeable. Necesita entrada: `/install-github-app` y la lista de configuración `/mcp`, ejecutadas mientras nadie está adjunto, muestran la sesión bajo `Needs input` con una fila que nombra el comando, y adjuntarse y re-ejecutar el comando continúa; de v2.1.208 a v2.1.215 fueron rechazadas directamente en ese estado. Restauración de `--agent`: reanudar o reiniciar una sesión `--agent` enviada al segundo plano restaura el prompt del sistema del agente y las restricciones de herramientas, buscando el agente en el directorio de la sesión primero, cuando su espacio de trabajo es confiable; una sesión cuyo agente ya no existe continúa con las herramientas predeterminadas y el prompt del sistema y se abre con una advertencia visible, en lugar de revertir silenciosamente al agente predeterminado. `Ctrl+X`: presionarlo dos veces elimina una sesión incluso cuando el intento de detención falla, en lugar de que una detención fallida cancele la eliminación pendiente, y una sesión eliminada cuyo proceso worker había muerto ya no reaparece en el próximo refresco. Eliminación de worktree: una sesión cuyo directorio de worktree no pertenece a ningún repositorio de git puede ser eliminada; antes de esta versión cada intento de eliminar tal sesión fue rechazado. Un directorio que ya se ha ido se borra inmediatamente. El doble presionar de la vista de agentes elimina un directorio que aún tiene archivos, ejecutando su hook `WorktreeRemove` para un directorio creado por hook, a menos que otra sesión también lo nombre. `claude rm` mantiene tal directorio siempre que los archivos permanezcan.
v2.1.214	Una sesión enviada al segundo plano con `←` o `/background` e inactiva sin nada ejecutándose tiene su proceso detenido como cualquier otra sesión inactiva, en lugar de mantener su proceso y el servicio de fondo ejecutándose indefinidamente. Una sesión completada puede ser eliminada con `claude rm` o desde la vista de agentes después de que el servicio de fondo se haya quedado inactivo, y una sesión que entró en un worktree después de ser distribuida desde un directorio que no es un repositorio de git, como una carpeta de espacio de trabajo multi-repo, puede ser eliminada desde la vista de agentes cuando el worktree mismo pertenece a un repositorio de git, porque la limpieza se resuelve desde el worktree en lugar del directorio desde el que se distribuyó la sesión; ambas eliminaciones fueron rechazadas en cada intento antes. Reabrir una sesión detenida restaura su conversación guardada incluso cuando una carpeta en el almacén de transcripción no se puede leer.
v2.1.213	`/install-github-app`, la lista de configuración `/mcp`, y acciones de autenticación MCP funcionan en una sesión de fondo mientras una terminal está adjunta, y se rechazan solo cuando nadie está adjunto, con un mensaje diciéndole que se adjunte y ejecute el comando nuevamente; de v2.1.208 a v2.1.212 fueron rechazadas incluso con una terminal adjunta.
v2.1.212	`/fork` en una sesión interactiva copia la conversación en una nueva sesión de fondo que aparece como su propia fila, nombrada después de la sesión de la que provino o, para un fork solicitado de una sesión sin nombre, después del prompt de fork, mientras la original continúa ejecutándose; el comportamiento anterior de subagente forked de `/fork` se movió a `/subtask`. Con vista de agentes desactivada, `/fork` mantiene el comportamiento de subagente forked. Una fila enfocada que está esperando su primer prompt muestra `space to send it a prompt`. `Ctrl+J` inserta una nueva línea en la entrada de distribución en terminales con reporte de tecla extendida, donde el presionar de tecla fue previamente ignorado, y la superposición `?` enumera el atajo. La sugerencia de pie de página `←` en una sesión interactiva brevemente muestra `N done` cuando una sesión de fondo termina mientras ninguna necesita su entrada. Escribir un `/resume` desnudo en la vista de agentes abre un selector de sesiones pasadas del repositorio desde el que abrió la vista de agentes, incluyendo sesiones eliminadas de la lista, y seleccionar una la reanuda como una sesión de fondo; antes de esta versión `/resume` no estaba disponible en la vista de agentes y las sesiones eliminadas eran alcanzables solo con `claude --resume` o `/resume` desde una sesión interactiva. Los formularios dirigidos, con alcance y restringidos mantienen la sugerencia `attach to a session to run it` que las versiones anteriores mostraban para cada formulario. Las sesiones esperando un prompt de host de red de sandbox, una solicitud de entrada MCP, o un prompt de configuración administrada se muestran como `Needs input` en lugar de `Working`, en la vista de agentes y en `claude agents --json`, y una pregunta de Claude reporta `waitingFor: input needed` en lugar de `permission prompt`. Adjuntarse a una sesión cuyo proceso se ha detenido muestra su transcripción formateada de la manera en que la sesión en vivo la representa, en lugar de como texto sin procesar. Una sesión detenida cuya transcripción está en un lugar inesperado se reanuda desde ella a través de un escaneo de último recurso de sus transcripciones guardadas, y abrir una fila que no tiene transcripción guardada muestra `Press enter again to restart this session fresh`, reiniciándola de nuevo en el segundo presionar; v2.1.211 mostró el rechazo sin forma de reiniciar desde la vista de agentes.
v2.1.211	Despertar una sesión detenida adjuntándose o respondiendo desde el directorio en el que se ejecuta reenvía el `ANTHROPIC_BASE_URL` de puerta de enlace de su shell nuevamente, bajo las mismas condiciones que una distribución nueva, por lo que una sesión autenticada a través de un `ANTHROPIC_AUTH_TOKEN` de puerta de enlace se reanuda en la puerta de enlace en lugar de reportar `Not logged in`. Adjuntarse a una sesión detenida que fue enviada al segundo plano desde otra conversación antes de que su primera respuesta terminara se rechaza con `This session has no saved transcript` en lugar de silenciosamente iniciar una conversación en blanco bajo el mismo ID de sesión; abrir la misma fila desde la vista de agentes mostró el rechazo en el pie de página. Terminar el proceso de una sesión `←` o `/background` desde fuera de Claude Code la marca como detenida en lugar de que el supervisor la reinicie, una detención ya registrada en disco se honra a menos que una respuesta que envió aún esté esperando ser entregada, una sesión reiniciada después de un fallo es informada de que fue reiniciada, y una sesión `←` o `/background` reiniciada no reanuda una respuesta interrumpida más antigua que aproximadamente una hora. Una respuesta de sesión-nombrada que responde o rechaza el prompt en lugar de etiquetarlo, como para un prompt que es principalmente un enlace, se descarta y la fila mantiene un nombre tomado del texto del prompt. Eliminar una sesión cuyo git de worktree ya no reconoce tiene éxito, dejando el directorio de worktree en disco y nombrando su ruta, en lugar de que cada intento sea rechazado. Un rechazo de eliminación muestra la razón en la fila de la sesión, incluyendo el error de git subyacente cuando el worktree no pudo ser eliminado, en lugar de que la fila silenciosamente reaparezca.
v2.1.210	`claude attach` espera mientras el servicio de fondo se está iniciando o reconectando en lugar de fallar con un error `job not found` o `still starting`, reporta una sesión que terminó durante el adjunto como salida, y aplica un cambio de tamaño de terminal hecho durante un adjunto lento cuando el adjunto se completa. La sugerencia de conteo de necesidades de entrada `←` del pie de página del prompt aparece en cada proveedor, incluyendo proveedores de terceros que previamente mostraban la forma `← for agents` simple. Enviar al segundo plano una sesión con `←` lleva la lista de tareas de Claude a la sesión de fondo en lugar de descartarla. La fila en la que presionó `←` mantiene un nombre en negrita, sin atenuar después de que la selección se mueve. `claude agents --effort` acepta `ultracode` en lugar de silenciosamente descartarlo.
v2.1.208	Adjuntarse a una sesión cuyo proceso se ha detenido muestra la última pantalla de su transcripción mientras el proceso se inicia, en lugar de solo una nota `Session is starting`. Una respuesta que no se puede entregar porque el servicio de fondo es inaccesible o el envío falla se guarda y se envía como el siguiente prompt de la sesión cuando su proceso se inicia nuevamente; antes de esta versión, una respuesta perdida mientras el servicio de fondo era inaccesible se descartaba. Un proceso cuyo propio binario fue reemplazado por una actualización aún puede iniciar el supervisor, desde el lanzador `claude` instalado o la versión más nueva en disco, en lugar de fallar hasta que Claude Code se reiniciara. Un supervisor que ejecuta una versión anterior nunca reinicia una sesión inactiva iniciada por una versión más nueva en su propio binario más antiguo. Eliminar una sesión elimina su worktree incluso después de que la sesión movió el worktree a una rama diferente, y mantiene el worktree junto con la fila de sesión cuando el worktree tiene commits que no se han enviado a ningún lugar u otra sesión lo reclama, en lugar de destruir los commits u orfandar el worktree. `/install-github-app` y la lista de configuración `/mcp` y sus acciones de autenticación se rechazan en una sesión de fondo con un mensaje que nombra la alternativa; en v2.1.208 solamente, el selector `/model` fue rechazado de la misma manera y un `/model <name>` escrito cambió solo esa sesión en lugar de también guardar su modelo predeterminado.
v2.1.207	El panel de vista previa se abre con la oración que la fila trunca, como la pregunta exacta para una sesión que lo espera a usted, y muestra cuánto tiempo una sesión bloqueada ha estado esperando como una única línea `waiting 3m` en lugar de prefijar la misma marca de tiempo a la oración de estado y la pregunta. Pegar el mismo texto nuevamente en la entrada de distribución expande el marcador de posición colapsado `[Pasted text #N]` en lugar de agregar uno segundo. Una sesión en segundo plano nombrada al aceptar un plan muestra ese nombre en su fila. Una sesión en segundo plano que se movió a un worktree mantiene su conversación cuando su proceso se reinicia desde la vista de agentes.
v2.1.206	Los resúmenes de filas llenan el ancho restante de la fila y se truncan solo en el borde derecho de la terminal en lugar de en 64 columnas. Después de que el supervisor se reinicia en una nueva versión de Claude Code, reinicia las sesiones en segundo plano inactivas restantes en esa versión en el fondo en lugar de algunas por minuto. Eliminar una sesión con `Ctrl+X` o `claude rm` también la borra de la lista de sesiones del supervisor, por lo que la fila ya no reaparece después de un reinicio del supervisor. Una anulación de cuerpo de solicitud `CLAUDE_CODE_EXTRA_BODY` exportada en el shell de distribución llega a las sesiones de fondo en lugar de ser ignorada.
v2.1.205	La sugerencia `←` del pie de página del prompt en una sesión regular `claude` cuenta los agentes de fondo esperando por usted, como `← 2 agents`. Los resúmenes de filas muestran el informe de una línea propia de la sesión, truncado en 64 columnas, en lugar de una invocación de herramienta sin procesar o un recuento `done/total`; las filas agrupadas por directorio se abren con una palabra de estado coloreada. El panel de vista previa se abre con la oración de estado completa y, para una sesión que espera por usted, su pregunta exacta encima de la entrada de respuesta. Las sesiones que editan, comentan, cierran o marcan una solicitud de extracción como lista con `gh` están vinculadas a ella, no solo las que crean o verifican una solicitud de extracción, un push vincula una solicitud de extracción incluso cuando el nombre de rama local no coincide, y una solicitud de extracción cuya salida del comando de creación excedió el límite en línea también está vinculada. Un turno sin texto legible mantiene el estado anterior de la sesión en lugar de voltearlo de nuevo a `Working`. `claude attach` espera hasta aproximadamente 60 segundos una sesión que se está reiniciando, con una línea de estado que indica por qué, en lugar de fallar.
v2.1.203	Una puerta de enlace `ANTHROPIC_BASE_URL` exportada en el shell de distribución llega a las sesiones distribuidas desde él en ese mismo directorio cuando el supervisor comparte ese entorno de puerta de enlace, en lugar de ser descartada mientras la clave API exportada junto a ella se mantenía. El `PATH` del shell de distribución se aplica al worker de cada sesión. Presionar `←` mientras los subagentes se están ejecutando espera a que terminen en lugar de reiniciarlos después de diez segundos. La lista vacía siempre muestra los encabezados de sección con una descripción bajo cada uno. Escribir `@` en la entrada de distribución también enumera los worktrees de git registrados del repositorio de lanzamiento que viven dentro de su árbol de directorios. Un esfuerzo heredado de la configuración `effortLevel` sigue ediciones posteriores a esa configuración en lugar de ser fijado en la distribución. Abrir una sesión detenida cuya conversación ya está abierta en otra sesión en ejecución se rechaza con un mensaje en lugar de fallar la fila. Un comando que no está disponible en la vista de agentes deja el texto escrito en la entrada. Un hook `WorktreeCreate` que falla fuera de un repositorio de git ya no bloquea la sesión de editar archivos.
v2.1.202	Un nombre establecido con `/rename` o `Ctrl+R` en una sesión en segundo plano persiste cuando el supervisor detiene y reinicia su proceso, en lugar de revertir al nombre con el que se distribuyó la sesión.
v2.1.200	Una versión anterior de Claude Code que reescribe la lista de sesiones en `roster.json` preserva campos escritos por una versión más nueva, coincidiendo con la garantía existente de `state.json`, por lo que las sesiones iniciadas por la versión más nueva continúan aceptando entrada después de que el supervisor se reinicia. Cuando abre una sesión que ha dejado de responder, el supervisor reinicia su proceso y la sesión continúa la respuesta interrumpida desde donde se quedó. La vista de agentes aplica una bandera `--plugin-dir` colocada después de `agents` a su propio subagente y autocompletado de skills en la entrada de distribución así como sesiones distribuidas.
v2.1.199	Una sesión en segundo plano cuyo proceso se cierra antes de terminar de iniciarse en un host con poca memoria muestra `possibly low memory — free some up and retry` en su estado de fila en lugar de solo la razón de salida desnuda. Enviar al segundo plano una sesión con `←` o `/background` lleva su `/color` a la nueva fila.
v2.1.198	La vista de agentes envía una notificación a través de `preferredNotifChannel` cuando una sesión en segundo plano necesita entrada, finaliza o falla, y dispara el hook `Notification` con el tipo `agent_needs_input` o `agent_completed`. `←` y `/exit` dentro de `claude attach <id>` regresan a la vista de agentes en lugar de salir al shell; `Ctrl+Z` regresa al shell. Una sesión en segundo plano que aisló su trabajo en un worktree confirma, envía su propia rama aislada, nunca `main` o `master`, y abre una solicitud de extracción en borrador cuando finaliza en lugar de preguntar primero. `/login` se ejecuta en la vista de agentes y abre el diálogo de inicio de sesión. El diálogo de salida `Background work is running` ofrece `Move to background and exit`. La entrega de salida también cubre subagentes en segundo plano, que se reanudan desde su transcripción en el próximo despertar en lugar de ser reportados como fallidos. `claude --bg` combinado con `-p` o `--print` se rechaza con un error. El host de sesión de fondo solicita permiso de Red Local de macOS en el primer acceso LAN en lugar de fallar con `connect: no route to host`.
v2.1.196	Un único presionar `←` envía al segundo plano una sesión en primer plano; las versiones anteriores requerían dos presiones, con una sugerencia de pie de página y una confirmación. `--dangerously-skip-permissions` pasado a `claude agents` muestra el descargo de responsabilidad de bypass en lugar de ser silenciosamente descartado. Las sesiones interactivas que nunca nombró llevan un nombre predeterminado como `my-app-3f` en listados de sesiones y `claude agents --json`. Los comandos shell en segundo plano y flujos de trabajo dinámicos sobreviven al proceso de la sesión siendo detenido, reiniciado o actualizado, incluso en Windows; establezca `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` para desactivar la entrega. Una transcripción malinterpretada como vacía al reiniciar se renombra con un sufijo `.orphaned-` en lugar de eliminarse.
v2.1.195	El trabajo en vuelo se traslada cuando envía al segundo plano una sesión en Windows también; establezca `CLAUDE_DISABLE_ADOPT=1` para detenerlo en su lugar. El grupo `Completed` llena el espacio vertical restante y el encabezado se compacta en terminales cortas. Una versión anterior de Claude Code ya no descarta campos `state.json` más nuevos de sesiones o oculta esas sesiones de `claude agents`. Conectarse a una sesión detenida cambia inmediatamente en lugar de mostrar una pantalla en blanco durante hasta cinco segundos. Un supervisor que no puede aceptar conexiones sale y libera su bloqueo por sí solo.
v2.1.191	`claude --bg` con un nombre `--agent` que no coincide con ninguno de sus subagentes falla el lanzamiento: la sesión sale inmediatamente con un error `--agent '<name>' not found` en lugar de ejecutarse con el agente predeterminado.
v2.1.174	Las sesiones en segundo plano ya no heredan variables de punto final de puerta de enlace como `ANTHROPIC_BASE_URL` del shell de lanzamiento del supervisor; el supervisor proporciona una instantánea de credencial nueva a workers precalentados, corrigiendo errores espurios de `Could not resolve authentication method`.
v2.1.172	`/model` en la entrada de distribución establece una anulación de modelo de distribución con alcance de sesión.
v2.1.161	Los resúmenes de filas muestran un recuento `done/total` para elementos de trabajo paralelos; el panel de vista previa nombra el elemento de trabajo paralelo que más tiempo lleva ejecutándose.
v2.1.157	`claude agents` acepta `--agent`; las sesiones distribuidas honran la configuración `agent`.
v2.1.145	Dictado de voz compatible en la entrada de respuesta del panel de vista previa y la entrada de distribución.
v2.1.143	Se agregó la configuración `worktree.bgIsolation`; `claude agents` acepta `--allow-dangerously-skip-permissions`.
v2.1.142	`claude agents` acepta `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config` y `--strict-mcp-config`.
v2.1.141	`claude agents` acepta `--cwd` para limitar la lista a un proyecto.
v2.1.139	La vista de agentes se introdujo como una vista previa de investigación.

agent-view.md +389 −183

19Para comparar la vista de agentes con subagentes, equipos de agentes y worktrees, consulte [Ejecutar agentes en paralelo](/docs/es/agents).19Para comparar la vista de agentes con subagentes, equipos de agentes y worktrees, consulte [Ejecutar agentes en paralelo](/docs/es/agents).

20 20

21<Note>21<Note>

22 La vista de agentes es una vista previa de investigación y requiere Claude Code v2.1.139 o posterior. Verifique su versión con `claude --version`. La interfaz y los atajos de teclado pueden cambiar a medida que la función evoluciona.22 La vista de agentes está en vista previa de investigación. La interfaz y los atajos de teclado pueden cambiar a medida que la función evoluciona.

23</Note>23</Note>

24 24

~~25Esta página cubre:~~

~~27* [Inicio rápido](#quick-start): asigne a Claude una tarea para trabajar en segundo plano, verifique su estado e intervenga cuando sea necesario~~

~~28* [Monitorear sesiones con la vista de agentes](#monitor-sessions-with-agent-view), incluidos iconos de estado, vista previa y respuesta, conexión, organización y atajos de teclado~~

~~29* [Distribuir nuevos agentes](#dispatch-new-agents) desde la vista de agentes, desde dentro de una sesión o desde su shell~~

~~30* [Gestionar sesiones desde el shell](#manage-sessions-from-the-shell) con `claude agents`, `claude attach` y comandos relacionados~~

~~31* [Cómo se alojan las sesiones en segundo plano](#how-background-sessions-are-hosted) por el proceso supervisor~~

33<h2 id="quick-start">25<h2 id="quick-start">

34 Inicio rápido26 Inicio rápido

35</h2>27</h2>

44 claude agents36 claude agents

45 ```37 ```

46 38

47 La vista de agentes se abre con una entrada en la parte inferior y una tabla que se completa a medida que comienzan las sesiones. Presione `Esc` en cualquier momento para volver a su shell. Sus sesiones siguen ejecutándose mientras está fuera y reaparecen la próxima vez que abra la vista de agentes.39 Si aún no ha aceptado el [diálogo de confianza del espacio de trabajo](/docs/es/permissions#project-allow-rules-and-workspace-trust) para el directorio, Claude Code lo muestra antes de que se abra la vista de agentes, el mismo diálogo que muestra `claude`. Acepte para guardar la confianza del espacio de trabajo y continuar. Si rechaza, Claude Code se cierra sin abrir la vista de agentes.

41 La vista de agentes se abre con una entrada en la parte inferior y una tabla que se completa a medida que comienzan las sesiones. Presione `Esc` para volver a su shell; si abrió la vista de agentes poniendo una sesión en segundo plano con `←`, `Esc` vuelve a esa conversación en su lugar. Sus sesiones siguen ejecutándose mientras está fuera y reaparecen la próxima vez que abra la vista de agentes.

48 </Step>42 </Step>

49 43

50 <Step title="Distribuir una sesión">44 <Step title="Distribuir una sesión">

51 Escriba un mensaje describiendo una tarea y presione `Enter`. Una nueva sesión en segundo plano comienza en esa tarea y aparece como una fila que muestra si está funcionando, esperando su entrada o está hecha. La nueva sesión utiliza el modelo mostrado en el encabezado de la vista de agentes y el mismo [modo de permisos](#permission-mode-model-and-effort) que obtendría ejecutando `claude` en ese directorio.45 Escriba un mensaje describiendo una tarea y presione `Enter`. Una nueva sesión en segundo plano comienza en esa tarea y aparece como una fila que muestra si está funcionando, esperando su entrada o está hecha. La nueva sesión utiliza el modelo mostrado en el encabezado de la vista de agentes. [El modo de permisos en el que comienza](#permission-mode-model-and-effort) depende de cómo abrió la vista de agentes.

52 46

53 Cada mensaje que ingrese aquí inicia su propia sesión nueva. Escribir otro mensaje y presionar `Enter` lanza una segunda sesión junto a la primera en lugar de enviar una continuación a ella. Puede ejecutar varias en paralelo de esta manera.47 Cada mensaje que ingrese aquí inicia su propia sesión nueva. Escribir otro mensaje y presionar `Enter` lanza una segunda sesión junto a la primera en lugar de enviar una continuación a ella. Puede ejecutar varias en paralelo de esta manera.

54 48

64 </Step>58 </Step>

65 59

66 <Step title="Traer una sesión existente">60 <Step title="Traer una sesión existente">

67 Este paso necesita una sesión en ejecución. Si siguió los pasos anteriores, no tiene una abierta en esta terminal, así que abra una sesión regular de `claude` en otra terminal y envíele un mensaje primero. Para mover una sesión que ya tiene abierta a la vista de agentes, ejecute `/bg` dentro de ella, o presione `←` en un mensaje vacío para enviarla al segundo plano y abrir la vista de agentes en un paso. La sesión sigue ejecutándose y aparece como una fila junto a las que distribuyó.61 Este paso necesita una sesión en ejecución. Si siguió los pasos anteriores, no tiene una abierta en esta terminal, así que abra una sesión regular de `claude` en otra terminal y envíele un mensaje primero.

63 Para mover una sesión que ya tiene abierta a la vista de agentes, ejecute `/bg` dentro de ella, o presione `←` en un mensaje vacío para enviarla al segundo plano y abrir la vista de agentes en un paso. En una sesión nueva sin mensajes aún, `/bg` le pide que envíe un mensaje primero, mientras que `←` funciona de inmediato. La sesión sigue ejecutándose y aparece como una fila junto a las que distribuyó.

68 </Step>64 </Step>

69</Steps>65</Steps>

70 66

71Puede 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.67Puede 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.

72 68

73Dentro de una sesión regular de `claude`, la pista `←` del pie de página del mensaje cuenta los agentes en segundo plano que están esperando su entrada, como `← 2 agents`, y vuelve a `← for agents` cuando ninguno necesita entrada. Los conteos superiores a 99 se muestran como `99+`. El conteo se actualiza aproximadamente cada diez segundos mientras la terminal está enfocada e inmediatamente cuando el enfoque regresa. Cambia brevemente de color cuando se mueve y cuando un agente se completa, a menos que la configuración [`prefersReducedMotion`](/docs/es/settings#available-settings) esté activada, y se oculta en [modo de lector de pantalla](/docs/es/accessibility). En [Amazon Bedrock, Google Cloud's Agent Platform y Microsoft Foundry](/docs/es/third-party-integrations), la pista permanece en su forma simple `← for agents` sin el conteo. Requiere Claude Code v2.1.205 o posterior.69Dentro de una sesión regular de `claude`, la pista `←` del pie de página del mensaje cuenta los agentes en segundo plano que están esperando su entrada, como `← 2 agents`, y vuelve a `← for agents` cuando ninguno necesita entrada. Los conteos superiores a 99 se muestran como `99+`. El conteo se actualiza aproximadamente cada diez segundos mientras la terminal está enfocada e inmediatamente cuando el enfoque regresa. Cambia brevemente de color cuando se mueve y cuando un agente se completa, y cuando una sesión en segundo plano se completa mientras ninguno necesita su entrada, muestra brevemente el número completado, como `← 2 done`. Ambos destellos se desactivan cuando la configuración [`prefersReducedMotion`](/docs/es/settings-reference#prefersreducedmotion) está activada, y la pista se oculta en [modo de lector de pantalla](/docs/es/accessibility).

74 70

75<h2 id="monitor-sessions-with-agent-view">71<h2 id="monitor-sessions-with-agent-view">

76 Monitorear sesiones con la vista de agentes72 Monitorear sesiones con la vista de agentes

78 74

79Ejecute `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 su antigüedad, contada desde cuándo se creó la sesión; la antigüedad de una sesión terminada se congela en cuánto tiempo tardó la ejecución.75Ejecute `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 su antigüedad, contada desde cuándo se creó la sesión; la antigüedad de una sesión terminada se congela en cuánto tiempo tardó la ejecución.

80 76

81El nombre está teñido con el color establecido por [`/color`](/docs/es/commands) en esa sesión. A partir de v2.1.199, el color se mantiene cuando [envía una sesión al segundo plano](#from-inside-a-session) con `←` o `/background`.77El nombre está teñido con el color establecido por [`/color`](/docs/es/commands) en esa sesión, incluyendo cuando [envía una sesión al segundo plano](#from-inside-a-session) con `←` o `/background`.

82 78

83De forma predeterminada, la lista muestra cada sesión en segundo plano que ha iniciado, en todos sus proyectos. Una sesión que trabaja en un repositorio y otra en un worktree diferente aparecen aquí, independientemente de qué directorio abrió la vista de agentes. Para limitar la lista a un proyecto, pase `--cwd`:79De forma predeterminada, la lista muestra cada sesión en segundo plano que ha iniciado, en todos sus proyectos. Una sesión que trabaja en un repositorio y otra en un worktree diferente aparecen aquí, independientemente de qué directorio abrió la vista de agentes. Para limitar la lista a un proyecto, pase `--cwd`:

84 80

117Cada fila comienza con un icono cuyo color y animación muestran el estado de la sesión:113Cada fila comienza con un icono cuyo color y animación muestran el estado de la sesión:

118 114

120| :--------------- | :----------------------- | :---------------------------------------------------------------------------------- |116| :--------------- | :----------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

122| Necesita entrada | Amarillo | Claude está esperando una pregunta específica o una decisión de permiso de su parte |118| Necesita entrada | Amarillo | Claude está esperando algo que solo usted puede proporcionar: una respuesta a una pregunta, una decisión de permiso, u otro mensaje que solo usted puede responder, como un mensaje de [sandbox](/docs/es/sandboxing) para permitir un host de red o una [solicitud de entrada](/docs/es/mcp#respond-to-mcp-elicitation-requests) de un servidor MCP. Un comando que necesita una terminal adjunta, como `/install-github-app` o la lista de configuración `/mcp`, [mantiene una sesión desatendida aquí también](#attach-to-a-session) |

127 123

128Por separado, la forma del icono muestra si el proceso subyacente está ejecutándose:124Por separado, la forma del icono muestra si el proceso subyacente está ejecutándose:

129 125

130| Forma | Qué significa |126| Forma | Qué significa |

131| :---------------- | :------------------------------------------------------------------------------------------------------------------------------------- |127| :---------------- | :------------------------------------------------------------------------------------------------------------------------------------- |

133| `∙` | El proceso ha salido. Aún puede echar un vistazo, responder o conectarse, y Claude reinicia desde donde se quedó |129| `∙` | El proceso ha salido. Aún puede echar un vistazo a la fila, y cuando responda o se adjunte, Claude reinicia desde donde se quedó |

134| `✢` | Una sesión [`/loop`](/docs/es/scheduled-tasks) durmiendo entre iteraciones. La fila muestra su recuento de ejecución y una cuenta regresiva |130| `✢` | Una sesión [`/loop`](/docs/es/scheduled-tasks) durmiendo entre iteraciones. La fila muestra su recuento de ejecución y una cuenta regresiva |

135 131

136La etiqueta `#N` que puede aparecer en el borde derecho de una fila es la [solicitud de extracción que abrió la sesión](#pull-request-status), no parte del icono de estado.132La etiqueta `#N` o `!N` que puede aparecer en el borde derecho de una fila es un enlace a la [solicitud de extracción o solicitud de fusión](#pull-request-status) de la sesión, no parte del icono de estado.

137 133

138El título de la pestaña de terminal muestra el recuento de entrada pendiente mientras la vista de agentes está abierta: `2 awaiting input · claude agents` cuando las sesiones necesitan entrada, o `claude agents` cuando no lo hacen.134El título de la pestaña de terminal muestra el recuento de entrada pendiente mientras la vista de agentes está abierta: `2 awaiting input · claude agents` cuando las sesiones necesitan entrada, o `claude agents` cuando no lo hacen.

139 135

140A partir de v2.1.198, mientras la vista de agentes está abierta, Claude Code también envía una notificación a través de su [canal de notificación de terminal](/docs/es/terminal-config#get-a-terminal-bell-or-notification) configurado cuando una sesión en segundo plano local comienza a necesitar su entrada, se completa o falla. Las sesiones que se ejecutan según un cronograma, como sesiones [`/loop`](/docs/es/scheduled-tasks), notifican solo cuando necesitan su entrada. Las notificaciones utilizan la misma configuración [`preferredNotifChannel`](/docs/es/settings#available-settings) que el resto de Claude Code y activan el hook [`Notification`](/docs/es/hooks#notification) con el tipo `agent_needs_input` o `agent_completed`.136Mientras la vista de agentes está abierta, Claude Code también envía una notificación a través de su [canal de notificación de terminal](/docs/es/terminal-config#get-a-terminal-bell-or-notification) configurado cuando una sesión en segundo plano local comienza a necesitar su entrada, se completa o falla. Las sesiones que se ejecutan según un cronograma, como sesiones [`/loop`](/docs/es/scheduled-tasks), notifican solo cuando necesitan su entrada. Las notificaciones utilizan la misma configuración [`preferredNotifChannel`](/docs/es/settings-reference#preferrednotifchannel) que el resto de Claude Code y activan el hook [`Notification`](/docs/es/hooks#notification) con el tipo `agent_needs_input` o `agent_completed`.

141 137

142Las sesiones en segundo plano no necesitan ninguna terminal abierta para seguir funcionando. Un [proceso supervisor](#the-supervisor-process) 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.138Las sesiones en segundo plano no necesitan ninguna terminal abierta para seguir funcionando. Un [proceso supervisor](#the-supervisor-process) 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.

143 139

144El estado de la sesión persiste en el disco a través de actualizaciones automáticas y reinicios del supervisor. Las sesiones también se conservan cuando su máquina se duerme. Sus procesos se reanudan al despertar y el supervisor se reconecta a ellos en lugar de tratar la brecha de tiempo como inactividad. El apagado aún detiene las sesiones en ejecución; consulte [Las sesiones se muestran como fallidas después del apagado](#sessions-show-as-failed-after-shutdown) para saber cómo recuperarlas.140El estado de la sesión persiste en el disco a través de actualizaciones automáticas y reinicios del supervisor. Las sesiones también se conservan cuando su máquina se duerme. Sus procesos se reanudan al despertar y el supervisor se reconecta a ellos en lugar de tratar la brecha de tiempo como inactividad. El apagado aún detiene las sesiones en ejecución; consulte [Las sesiones se muestran como fallidas o detenidas después del apagado](#sessions-show-as-failed-after-shutdown) para saber cómo recuperarlas.

145 141

146Cuando abre una sesión que ha dejado de responder, el supervisor reinicia su proceso y la sesión continúa la respuesta interrumpida desde donde se quedó. Una sesión puede terminar en ese estado cuando la máquina se duerme mientras está en medio de una respuesta. Requiere Claude Code v2.1.200 o posterior.142Una sesión que estaba en medio de una respuesta cuando la máquina se durmió puede volver sin responder. Cuando abre una sesión que ha dejado de responder, el supervisor reinicia su proceso y la sesión continúa la respuesta interrumpida desde donde se quedó.

147 143

148<h3 id="row-summaries">144<h3 id="row-summaries">

149 Resúmenes de filas145 Resúmenes de filas

151 147

152El resumen de una línea en cada fila es generado por un [modelo de clase Haiku](/docs/es/model-config) para que la fila pueda 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 texto de la fila se actualiza como máximo una vez cada 15 segundos desde la salida reciente de la sesión sin enviar una solicitud de modelo, y el modelo escribe un resumen nuevo cuando cada turno termina.148El resumen de una línea en cada fila es generado por un [modelo de clase Haiku](/docs/es/model-config) para que la fila pueda 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 texto de la fila se actualiza como máximo una vez cada 15 segundos desde la salida reciente de la sesión sin enviar una solicitud de modelo, y el modelo escribe un resumen nuevo cuando cada turno termina.

153 149

154Una fila funcionando muestra lo que la sesión dice que está haciendo, y una fila bloqueada muestra la pregunta que está haciendo. Durante un turno largo, el modelo también reescribe el resumen aproximadamente una vez por minuto, esperando el doble después de cada reescritura hasta cuatro minutos, por lo que una fila ocupada no sigue mostrando un resumen desactualizado. Antes de v2.1.205, una fila funcionando podría mostrar una invocación de herramienta sin procesar en lugar de un informe, y una sesión que ejecuta elementos de trabajo paralelos mostraba un recuento `done/total` como `2/5` antes del texto.150Una fila funcionando muestra lo que la sesión dice que está haciendo, y una fila bloqueada muestra la pregunta que está haciendo. Durante un turno largo, el modelo también reescribe el resumen cada pocos minutos para que una fila ocupada no siga mostrando un resumen desactualizado. El texto de resumen llena el ancho restante de la fila; abra el [panel de vista previa](#peek-and-reply) para leer una oración que el borde de la terminal recorta.

155 151

156El texto de resumen llena el ancho restante de la fila y se trunca solo en el borde derecho de la terminal; abra el [panel de vista previa](#peek-and-reply) para leer una oración que el borde recorta. Antes de v2.1.206, el texto se cortaba en 64 columnas independientemente del ancho de la terminal.152Cuando la lista está [agrupada por directorio](#organize-the-list), el resumen se abre con el estado de la sesión como una palabra coloreada, como `Needs input · double jump or wall climb?`. En la agrupación de estado predeterminada, el encabezado del grupo ya nombra el estado, por lo que la fila muestra solo el resumen.

157 153

158Cuando la lista está [agrupada por directorio](#organize-the-list), el resumen se abre con el estado de la sesión como una palabra coloreada, como `Needs input · double jump or wall climb?`. En la agrupación de estado predeterminada, el encabezado del grupo ya nombra el estado, por lo que la fila muestra solo el resumen. Antes de v2.1.205, las filas agrupadas por directorio no llevaban palabra de estado.154El resumen de fin de turno y cada reescritura a mitad de turno son 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](/docs/es/data-usage) que la sesión misma. Las actualizaciones de 15 segundos entre reescrituras de modelo reutilizan la salida de la sesión y no envían una solicitud. En un proveedor de terceros o puerta de enlace sin un modelo Haiku configurado, la solicitud utiliza el modelo principal de la sesión en su lugar; establezca [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/es/model-config#environment-variables) para elegir uno.

~~159~~

160Un turno cuya salida completa no contiene letras ni dígitos, como una sesión [`/loop`](/docs/es/scheduled-tasks) que imprime un símbolo solitario en una iteración tranquila, mantiene el resumen y estado anterior de la fila. Antes de v2.1.205, ese turno fue reclasificado y podría voltear una sesión que estaba esperando su entrada de vuelta a `Working`.

~~161~~

162El resumen de fin de turno y cada reescritura a mitad de turno son 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](/docs/es/data-usage) que la sesión misma. Las actualizaciones de 15 segundos entre reescrituras de modelo reutilizan la salida de la sesión y no envían una solicitud. En proveedores de terceros como Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry y puertas de enlace personalizadas, la solicitud se revierte al modelo principal de la sesión cuando no hay ningún modelo Haiku configurado. Establezca [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/es/model-config#environment-variables) para elegir el modelo para estos resúmenes en esos proveedores.

163 155

164<h3 id="pull-request-status">156<h3 id="pull-request-status">

165 Estado de la solicitud de extracción157 Estado de la solicitud de extracción

166</h3>158</h3>

167 159

168Cuando una sesión abre una solicitud de extracción, aparece una etiqueta `#1234` en el borde derecho de la fila, vinculada a la solicitud de extracción en terminales que admiten hipervínculos. La etiqueta persiste cuando envía un seguimiento a la sesión, por lo que la solicitud de extracción permanece visible mientras la fila revierte al progreso en vivo. Las sesiones en segundo plano que aislaron sus cambios en un worktree abren estas solicitudes de extracción por sí solas; [Cómo se aíslan los cambios de archivo](#how-file-edits-are-isolated) cubre cuándo sucede eso y qué nunca hace una sesión sin preguntar.160Cuando una sesión [abre una solicitud de extracción](#how-file-edits-are-isolated), Claude Code añade una etiqueta en el borde derecho de la fila, vinculada a la solicitud de extracción:

169 161

170Una sesión que trabaja en una solicitud de extracción existente está vinculada a ella de la misma manera. Editar, comentar, cerrar o marcar una solicitud de extracción como lista con `gh` vincula la solicitud de extracción que el resultado de su propio comando nombra, por lo que un comando `gh` cuya salida capturada no nombra ninguna solicitud de extracción no crea un vínculo; `gh pr merge` es el caso común, porque imprime su resultado solo en una terminal interactiva. Verificar una solicitud de extracción con `gh pr checkout`, o enviar a una rama que tiene una solicitud de extracción abierta, la vincula buscando esa rama con `gh pr view` en su lugar. Antes de v2.1.205, solo las solicitudes de extracción que la sesión creó o verificó fueron vinculadas, y un envío vinculó una solo cuando el nombre de rama local coincidía.162* Claude Code escribe la etiqueta como `#1234` para una solicitud de extracción y como `!1234` para una solicitud de fusión de GitLab.

163* Claude Code emite el enlace incluso cuando no puede detectar soporte de hipervínculo, por ejemplo sobre SSH o tmux. Establezca [`FORCE_HYPERLINK=0`](/docs/es/env-vars) para renderizar la etiqueta como texto sin formato.

164* Después de enviar un seguimiento a la sesión, Claude Code mantiene la etiqueta mientras la fila vuelve al progreso en vivo.

171 165

172Claude Code lee la solicitud de extracción de la salida de comando completa, incluida la parte guardada en un archivo cuando la salida de un comando excede el límite en línea. Antes de v2.1.205, una solicitud de extracción creada en una llamada Bash cuya salida excedía aproximadamente 30,000 caracteres no fue vinculada.166Una sesión que trabaja en una solicitud de extracción existente está vinculada a ella de la misma manera. Claude Code encuentra la solicitud de extracción de manera diferente dependiendo del comando que ejecute Claude:

167

168* Cuando Claude edita, comenta, cierra o marca una solicitud de extracción como lista con `gh`, Claude Code vincula la solicitud de extracción que el resultado del propio comando nombra. Un comando `gh` cuya salida capturada no nombra ninguna solicitud de extracción no crea un enlace; `gh pr merge` es el caso común, porque imprime su resultado solo en una terminal interactiva.

169* Cuando Claude verifica una solicitud de extracción con `gh pr checkout` o envía a una rama, Claude Code busca la rama con `gh pr view` y vincula su solicitud de extracción abierta.

170* La solicitud de extracción no necesita existir aún cuando Claude envía: Claude Code reintenta la búsqueda de rama después de hasta cinco comandos posteriores de `git`, `gh`, `glab` o `curl` ejecutados en el mismo directorio, por lo que una solicitud de extracción creada después del envío, incluyendo una que Claude crea a través de la API REST de GitHub, se vincula cuando un reintento la encuentra.

173 171

174Cuando una sesión está vinculada a más de una solicitud de extracción, la etiqueta muestra un recuento en su lugar, como `3 PRs`, coloreada por la solicitud de extracción abierta que más necesita atención. Abra el [panel de vista previa](#peek-and-reply) para verlas todas.172Cuando una sesión está vinculada a más de una solicitud de extracción, la etiqueta muestra un recuento en su lugar, como `3 PRs`, coloreada por la solicitud de extracción abierta que más necesita atención. Abra el [panel de vista previa](#peek-and-reply) para verlas todas.

175 173

182| Púrpura | Fusionado |180| Púrpura | Fusionado |

183| Gris | Borrador o cerrado |181| Gris | Borrador o cerrado |

184 182

185Para la mayoría de las tareas, esta columna es donde recopila el resultado: revise y fusione la solicitud de extracción cuando su número se vuelva verde.183Para una tarea que termina en una solicitud de extracción, verifique esta etiqueta para el resultado: revise y fusione la solicitud de extracción cuando su número se vuelva verde.

186 184

187<h3 id="peek-and-reply">185<h3 id="peek-and-reply">

188 Echar un vistazo y responder186 Echar un vistazo y responder

198 196

199La mayoría de las veces el panel de vista previa es suficiente y no necesita abrir la transcripción completa.197La mayoría de las veces el panel de vista previa es suficiente y no necesita abrir la transcripción completa.

200 198

201Antes de v2.1.207, cada vista previa se abría con la oración de estado y una marca de tiempo desnuda, y una sesión bloqueada tenía su pregunta apareciendo debajo de ellas con el prefijo de la misma marca de tiempo una segunda vez.199Escriba una respuesta en el panel de vista previa y presione `Enter` para enviarla a esa sesión. Cuando la sesión hace una pregunta con opciones predefinidas, el panel de vista previa las muestra como una lista numerada y puede presionar una tecla numérica para elegir una. Un mensaje de permiso se muestra como texto que describe lo que la sesión quiere ejecutar, sin opciones numeradas. Escriba una respuesta para responderlo, o adjúntese para responder con el mensaje estándar. 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.

202 200

203Escriba 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.201Cuando un hook [`PermissionRequest`](/docs/es/hooks#permissionrequest) o [`PreToolUse`](/docs/es/hooks#pretooluse) devuelve una salida que Claude Code no puede validar para la llamada que la sesión está pidiendo, la fila muestra el evento del hook y `hook output invalid:` con el error de validación antes del texto de la solicitud pendiente. Para un hook que falla de otra manera, la fila dice que el hook falló. La sesión sigue esperando la misma solicitud.

204 202

205Una respuesta que no se puede entregar, porque el servicio en segundo plano es inaccesible o el envío falla, se guarda y se envía a la sesión como su próximo mensaje cuando su proceso se inicia nuevamente, y el mensaje de error dice que la respuesta fue guardada. Una respuesta con prefijo `!` no se guarda, porque el texto guardado llegaría a la sesión como un mensaje simple en lugar de ejecutarse como un comando Bash.203Una respuesta que no se puede entregar, porque el servicio en segundo plano es inaccesible o el envío falla, se guarda y se envía a la sesión como su próximo mensaje cuando su proceso se inicia nuevamente, y el mensaje de error dice que la respuesta fue guardada. Una respuesta con prefijo `!` no se guarda, porque el texto guardado llegaría a la sesión como un mensaje simple en lugar de ejecutarse como un comando Bash.

206 204

207Con [dictado de voz](/docs/es/voice-dictation) habilitado, mantenga o toque su tecla de pulsar para hablar mientras la entrada de respuesta está enfocada para dictar una respuesta en lugar de escribirla. Lo mismo funciona en la entrada de distribución en la parte inferior de la vista de agentes.205Con [dictado de voz](/docs/es/voice-dictation) habilitado, mantenga o toque su tecla de pulsar para hablar mientras la entrada de respuesta está enfocada para dictar una respuesta en lugar de escribirla. Lo mismo funciona en la entrada de distribución en la parte inferior de la vista de agentes.

208 206

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

210 208

211<h3 id="attach-to-a-session">209<h3 id="attach-to-a-session">

212 Conectarse a una sesión210 Adjuntarse a una sesión

213</h3>211</h3>

214 212

215Presione `Enter` o `→` en una fila seleccionada para conectarse. La vista de agentes es reemplazada por la sesión interactiva completa. Cuando se conecta, Claude publica un breve resumen de lo que sucedió mientras estaba fuera.213Presione `Enter` o `→` en una fila seleccionada para adjuntarse. La vista de agentes es reemplazada por la sesión interactiva completa. Cuando se adjunta, Claude publica un breve resumen de lo que sucedió mientras estaba fuera.

214

215Mientras está adjunto, la sesión se comporta como cualquier otra sesión de Claude Code: [comandos](/docs/es/commands), atajos de teclado y características funcionan todos, con las excepciones a continuación.

216 216

217Mientras está conectado, la sesión se comporta como cualquier otra sesión de Claude Code: [comandos](/docs/es/commands), atajos de teclado y características funcionan todos, con las excepciones a continuación.217Mientras está adjunto, `/install-github-app` y la lista de configuración [`/mcp`](/docs/es/mcp) funcionan normalmente, ya que un humano en la terminal puede completar sus diálogos. Cuando nadie está adjunto, estos comandos no pueden abrir sus diálogos, por lo que la sesión aparece bajo `Needs input` en la vista de agentes con una fila como `open this session to manage MCP servers`, y la respuesta de transcripción dice lo mismo. Adjúntese y ejecute el comando nuevamente para continuar; la fila de necesidad de entrada se borra cuando se adjunta. `/mcp reconnect <server>`, `/mcp enable` y `/mcp disable` funcionan sin adjuntarse de cualquier manera.

218 218

219Una sesión en segundo plano rechaza `/install-github-app` y la lista de configuración [`/mcp`](/docs/es/mcp), incluidas sus acciones de autenticación, ya sea que esté conectado o respondiendo desde el panel de vista previa. El mensaje lo dirige a una sesión `claude` regular, y `/mcp reconnect <server>`, `/mcp enable` y `/mcp disable` aún funcionan.219Las sesiones adjuntas siempre se renderizan en [modo de pantalla completa](/docs/es/fullscreen), independientemente de su configuración `tui`, porque una sesión en segundo plano no tiene desplazamiento de terminal para agregar. Desplácese con `PgUp`, `PgDn` o la rueda del ratón, y presione `Ctrl+O` para el modo de transcripción. El desplazamiento nativo de su terminal y el modo de copia de tmux muestran solo la ventana gráfica actual, igual que cuando ejecuta cualquier aplicación de pantalla completa.

220 220

221Las sesiones conectadas siempre se renderizan en [modo de pantalla completa](/docs/es/fullscreen), independientemente de su configuración `tui`, porque una sesión en segundo plano no tiene desplazamiento de terminal para agregar. Desplácese con `PgUp`, `PgDn` o la rueda del ratón, y presione `Ctrl+O` para el modo de transcripción. El desplazamiento nativo de su terminal y el modo de copia de tmux muestran solo la ventana gráfica actual, igual que cuando ejecuta cualquier aplicación de pantalla completa.221Presione `←` en un mensaje vacío, o ejecute `/exit`, para desconectarse y volver a la vista de agentes, ya sea que abrió la sesión desde la vista de agentes o con `claude attach <id>` desde su shell.

222 222

223Presione `←` en un mensaje vacío, o ejecute `/exit`, para desconectarse y volver a la vista de agentes. A partir de v2.1.198, esto funciona de la misma manera si abrió la sesión desde la vista de agentes o con `claude attach <id>` desde su shell.223En Windows, si presiona `←` dentro de aproximadamente medio segundo de adjuntarse, Claude Code muestra `Ambiguous ←, press again to detach`, porque en esa ventana la terminal puede reentrega un presión de antes de que se adjuntara. Presione `←` nuevamente para desconectarse.

224 224

225`Ctrl+Z` también se desconecta pero vuelve a donde comenzó: la vista de agentes si se conectó desde allí, o su shell si ejecutó `claude attach`. Use `Ctrl+Z` cuando un diálogo tiene el enfoque y no responde a `←`.225`Ctrl+Z` también se desconecta pero vuelve a donde comenzó: la vista de agentes si se adjuntó desde allí, o su shell si ejecutó `claude attach`. Use `Ctrl+Z` cuando un diálogo tiene el enfoque y no responde a `←`.

226 226

227`Ctrl+C` mantiene su comportamiento de interrupción estándar mientras está conectado: cancela una respuesta en ejecución o un comando shell `!` en lugar de desconectarse. Presionar `Ctrl+C` dos veces en un mensaje vacío se desconecta, igual que en cualquier sesión.227`Ctrl+C` mantiene su comportamiento de interrupción estándar mientras está adjunto: cancela una respuesta en ejecución o un comando shell `!` en lugar de desconectarse. Presionar `Ctrl+C` dos veces en un mensaje vacío se desconecta, igual que en cualquier sesión.

228 228

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

230 230

231En una sesión que se ejecuta en primer plano, una que inició en la terminal en lugar de conectarse desde la vista de agentes, presionar `←` en un mensaje vacío la envía al segundo plano y abre la vista de agentes con esa fila seleccionada, por lo que puede cambiar de sesión sin salir de la terminal. El mismo presionar único desconecta una sesión conectada.231<h4 id="switch-sessions-without-leaving-the-terminal">

232 Cambiar sesiones sin salir de la terminal

233</h4>

234

235En una sesión que se ejecuta en primer plano, una que inició en la terminal en lugar de adjuntarse desde la vista de agentes, presionar `←` en un mensaje vacío la envía al segundo plano y abre la vista de agentes con esa fila seleccionada, por lo que puede cambiar de sesión sin salir de la terminal. El mismo presionar único desconecta una sesión adjunta.

236

237Si presiona `←` justo después de eliminar el último del texto del mensaje o moverse a través del historial de mensajes, Claude Code le pide que confirme: el primer presión muestra `Press ← again to open agents`, o `Press ← again to go back to agents` en una sesión adjunta, y el segundo presión cambia.

238

239Cuando `←` envía una sesión en primer plano al segundo plano, la vista de agentes muestra `Your conversation moved to the background` encima de la lista, con la fila de esa sesión ya seleccionada. Desde allí:

240

241* Presione `Enter` para reabrir la conversación.

242* Presione `Esc` para deshacer el cambio y volver a la conversación. Si `Esc` muestra `Still starting — try again in a moment`, la sesión en segundo plano aún no está lista, así que presione `Esc` nuevamente en un momento.

243* Presione `Ctrl+C` dos veces para salir a su shell.

244

245Cuando Claude Code no puede reabrir la conversación, sale e imprime un comando `claude --resume` que la reanuda.

246

247[La lista de tareas de Claude](/docs/es/interactive-mode#task-list) se mueve a la sesión en segundo plano con la conversación, por lo que la lista de verificación está intacta cuando vuelve a esa fila.

248

249La fila en la que presionó `←` también mantiene un nombre en negrita y sin atenuar después de mover la selección con las teclas de flecha o el ratón, para que pueda saber de qué sesión vino.

232 250

233Si una herramienta se está ejecutando cuando presiona `←`, Claude Code espera hasta aproximadamente diez segundos para que termine antes de enviar al segundo plano, y la respuesta continúa en la sesión en segundo plano. Presione `←` nuevamente para enviar al segundo plano inmediatamente en lugar de esperar. Cuando el trabajo en vuelo no puede trasladarse a la sesión en segundo plano, aparece primero el diálogo `Background this session?`, igual que con [`/background`](#from-inside-a-session).251Si una herramienta se está ejecutando cuando presiona `←`, Claude Code espera hasta aproximadamente diez segundos para que termine antes de enviar al segundo plano, y Claude continúa la respuesta en la sesión en segundo plano. Presione `←` nuevamente para enviar al segundo plano inmediatamente en lugar de esperar. Cuando el trabajo en vuelo no puede trasladarse a la sesión en segundo plano, Claude Code muestra primero el diálogo `Background this session?`, igual que con [`/background`](#from-inside-a-session).

234 252

235El límite de diez segundos no se aplica mientras [subagentes](/docs/es/sub-agents) están en ejecución. Claude Code sigue esperando para que su trabajo se traslade, y muestra un aviso `Still backgrounding after the current tool` mientras espera; presione `←` nuevamente para enviar al segundo plano sin esperar, lo que reinicia los subagentes desde el principio. Antes de v2.1.203, la espera terminaba después de diez segundos y los subagentes en ejecución se reiniciaban desde el principio sin advertencia.253El límite de diez segundos no se aplica mientras los [subagentes en primer plano](/docs/es/sub-agents#run-subagents-in-foreground-or-background) que Claude inició en la conversación aún se están ejecutando. Claude Code sigue esperando para que su trabajo se traslade, y muestra un aviso `Still backgrounding after the current tool` mientras espera. Presione `←` nuevamente para enviar al segundo plano sin esperar, lo que reinicia esos subagentes desde el principio. Claude Code no espera a los subagentes que un [flujo de trabajo dinámico](/docs/es/workflows) está ejecutando. Cuando un flujo de trabajo tiene subagentes ejecutándose, Claude Code muestra el diálogo `Background this session?` en su lugar.

236 254

237La fila se crea incluso desde una sesión nueva sin historial de conversación, por lo que `→` vuelve a ella. Antes de v2.1.203, la vista de agentes mostraba una sugerencia de incorporación debajo de esa fila cuando era la única.255Claude Code no envía la sesión al segundo plano mientras tiene texto sin enviar en la entrada del mensaje, porque el texto permanece en el cuadro de entrada de su terminal y no se movería a la sesión en segundo plano. Si escribe en la entrada mientras Claude Code espera para enviar la sesión al segundo plano, cancela el cambio con `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.`

256

257Presionar `←` crea la fila de la sesión incluso cuando la conversación no tiene mensajes aún, por lo que `→` aún vuelve a ella.

238 258

239Puede desactivar este atajo con la configuración `leftArrowOpensAgents` en `/config`.259Puede desactivar este atajo con la configuración `leftArrowOpensAgents` en `/config`.

240 260

255 275

256Para eliminar una sesión de la lista, 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.276Para eliminar una sesión de la lista, 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.

257 277

258Eliminar elimina la sesión de la vista de agentes. Si Claude [creó un worktree](#how-file-edits-are-isolated) para la sesión, eliminar elimina ese worktree también, incluidos los cambios sin confirmar en él, por lo que envíe o confirme el trabajo que desea conservar primero. Un worktree que creó usted mismo e inició la sesión dentro se deja en su lugar. La transcripción de conversación permanece en su máquina local y sigue siendo accesible a través de `claude --resume`.278El segundo presión elimina la sesión incluso cuando el intento de detención falla, por ejemplo porque el [servicio en segundo plano no responde](#agent-view-says-the-background-service-did-not-respond): la confirmación permanece activa durante otros dos segundos, y la eliminación termina el proceso de la sesión en sí. Presione `Esc` para descartar la confirmación sin eliminar.

279

280Excepto en los casos mantenidos cubiertos en [Qué elimina una sesión](#what-deleting-a-session-removes), eliminar elimina la sesión de la lista, y un worktree que Claude creó para ella se elimina, se mantiene o se deja en su lugar dependiendo de cómo elimine y qué contenga el worktree. La transcripción de conversación siempre permanece en su máquina local, disponible a través de `claude --resume`.

259 281

260Eliminar nunca elimina un worktree con commits que no se han enviado a ningún lugar, o uno que otra sesión en ejecución reclama o ha bloqueado. Claude Code mantiene el worktree y la sesión, y el pie de página nombra la ruta mantenida y la razón. Envíe los commits, o cierre la otra sesión, luego elimine nuevamente.282Para traer una sesión de vuelta en Claude Code v2.1.212 o posterior, escriba `/resume` en la entrada de distribución. Se abre un selector con sesiones pasadas del repositorio desde el que abrió la vista de agentes, más recientes primero, incluyendo sesiones que eliminó de la lista; las sesiones que ya tienen una fila no se enumeran. `↑`/`↓` mueven la selección, `Enter` reanuda la sesión seleccionada como una sesión en segundo plano para que se reúna con la lista como una fila, y `Esc` cierra el selector.

261 283

262Eliminar también borra la sesión de la [lista de sesiones del supervisor](#the-supervisor-process), ya sea que elimine con `Ctrl+X` o con [`claude rm`](#manage-sessions-from-the-shell) desde el shell, por lo que la eliminación persiste entre reinicios del supervisor. Antes de v2.1.206, eliminar una sesión mientras el supervisor se estaba reiniciando o era inaccesible la dejaba en esa lista, y el siguiente supervisor reinició su proceso y mostró la fila nuevamente.284El selector se abre solo para un `/resume` simple. Un `/resume` dirigido, con alcance o restringido no puede ser servido por el selector, por lo que la vista de agentes muestra la sugerencia `attach to a session to run it` en su lugar cuando:

285

286* `/resume` nombra un id o un término de búsqueda

287* la vista está limitada con `--cwd`

288* la vista fue iniciada con [`--safe-mode`](/docs/es/cli-reference#cli-flags)

289* la vista fue abierta con una bandera como `--permission-mode` o `--settings`

263 290

264Las sesiones completadas que no caben en la pantalla se pliegan en una fila `… N more`. Los fallos y las sesiones con una solicitud de extracción abierta siempre permanecen visibles. El grupo `Completed` llena el espacio vertical restante después de los grupos activos, y en una terminal corta el encabezado se compacta a una línea de resumen única para que las sesiones que están funcionando o necesitan entrada permanezcan visibles.291Las sesiones completadas que no caben en la pantalla se pliegan en una fila `… N more`. Los fallos y las sesiones con una solicitud de extracción abierta siempre permanecen visibles. El grupo `Completed` llena el espacio vertical restante después de los grupos activos, y en una terminal corta el encabezado se compacta a una línea de resumen única para que las sesiones que están funcionando o necesitan entrada permanezcan visibles.

265 292

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

271 298

272| Filtro | Muestra |299| Filtro | Muestra |

273| :-------------------------- | :---------------------------------------------------------------------------------------------------------- |300| :------------------------------- | :---------------------------------------------------------------------------------------------------------- |

275| `s:<state>` | Sesiones en el estado dado, como `s:working`. También acepta `s:blocked` para todo lo que lo espera a usted |302| `s:<state>` | Sesiones en el estado dado, como `s:working`. También acepta `s:blocked` para todo lo que lo espera a usted |

277| Cualquier otra URL | La sesión cuyo primer mensaje contenía esa URL |304| Cualquier otra URL | La sesión cuyo primer mensaje contenía esa URL |

278 305

279<h3 id="keyboard-shortcuts">306<h3 id="keyboard-shortcuts">

283Presione `?` en la vista de agentes para ver cada atajo en contexto. La tabla a continuación los resume.310Presione `?` en la vista de agentes para ver cada atajo en contexto. La tabla a continuación los resume.

284 311

285| Atajo | Acción |312| Atajo | Acción |

286| :-------------------- | :---------------------------------------------------------------------------------------------------- |313| :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

287| `↑` / `↓` | Moverse entre filas |314| `↑` / `↓` | Moverse entre filas |

291| `→` | Conectarse a la sesión seleccionada |318| `Ctrl+Enter` | Distribuir y adjuntarse inmediatamente, en terminales donde la superposición `?` enumera `ctrl+enter to start and open` |

292| `Alt+1`..`Alt+9` | Conectarse a la sesión 1–9 en el directorio de la sesión enfocada |319| `→` | Adjuntarse a la sesión seleccionada |

320| `Alt+1`..`Alt+9` | Adjuntarse a la sesión 1–9 en el directorio de la sesión enfocada |

293| `Tab` | En una entrada vacía, examinar todos los subagentes. De lo contrario, aplicar la sugerencia resaltada |321| `Tab` | En una entrada vacía, examinar todos los subagentes. De lo contrario, aplicar la sugerencia resaltada |

326| `Ctrl+J` | Insertar una nueva línea en la entrada de distribución |

300| `Esc` | Cerrar el panel de vista previa, limpiar la entrada o salir |329| `Esc` | Cerrar el panel de vista previa, limpiar la entrada o salir. Cuando abrió la vista de agentes enviando su sesión al segundo plano con `←`, el `Esc` final vuelve a esa conversación en lugar de salir. Con [modo de editor vim](/docs/es/interactive-mode#vim-editor-mode) activado, presionar `Esc` en la entrada cambia de modo INSERT a modo NORMAL y mantiene su texto, como en el mensaje principal |

302| `?` | Mostrar todos los atajos |331| `?` | Mostrar todos los atajos |

303 332

313 342

314Escriba 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; renómbrela más tarde con `Ctrl+R`.343Escriba 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; renómbrela más tarde con `Ctrl+R`.

315 344

316Un nombre que la sesión obtiene más tarde también aparece en su fila, incluido el nombre que Claude deriva cuando [acepta un plan](/docs/es/permission-modes#review-and-approve-a-plan) en esa sesión. Antes de v2.1.207, una sesión en segundo plano nombrada al aceptar un plan mostraba ese nombre en `/status` pero no en su fila de vista de agentes hasta que la renombraba usted mismo.345El nombre automático es una etiqueta corta escrita por un [modelo de clase Haiku](/docs/es/model-config). Un nombre que la sesión obtiene más tarde también aparece en su fila, incluido el [título generado](/docs/es/sessions#name-your-sessions) que la sesión obtiene cuando [acepta un plan](/docs/es/permission-modes#review-and-approve-a-plan) en esa sesión.

317 346

318Pegue una imagen en el mensaje para incluir una captura de pantalla o diagrama con la tarea.347Pegue una imagen en el mensaje para incluir una captura de pantalla o diagrama con la tarea.

319 348

320El texto pegado más largo que 800 caracteres o más de dos líneas se contrae a un marcador de posición `[Pasted text #N]` para que la entrada permanezca en una línea; el texto completo se envía cuando distribuye. Para revisar o editar el texto contraído antes de distribuir, pegue el mismo texto nuevamente y el marcador de posición se expande nuevamente en la entrada. Un recordatorio `paste again to expand` aparece debajo de la entrada durante unos segundos después del pegado en terminales de al menos 90 columnas de ancho. Antes de v2.1.207, pegar el mismo texto nuevamente agregaba un segundo marcador de posición en lugar de expandir el primero.349El texto pegado más largo que 800 caracteres o más de tres líneas se contrae a un marcador de posición `[Pasted text #N]` para que la entrada permanezca en una línea; el texto completo se envía cuando distribuye. Para revisar o editar el texto contraído antes de distribuir, pegue el mismo texto nuevamente y el marcador de posición se expande nuevamente en la entrada.

321 350

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

323 352

324| Entrada | Efecto |353| Entrada | Efecto |

325| :----------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |354| :-------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

326| `<agent-name> <prompt>` | Si la primera palabra coincide con un nombre de [subagente](/docs/es/sub-agents) personalizado, ese subagente se ejecuta como el agente principal de la sesión con la configuración de su frontmatter |355| `<agent-name> <prompt>` | Si la primera palabra coincide con un nombre de [subagente](/docs/es/sub-agents) personalizado, ese subagente se ejecuta como el agente principal de la sesión con la configuración de su frontmatter |

327| `@<agent-name>` | Mencione un subagente personalizado en cualquier lugar del mensaje para ejecutarlo como el agente principal |356| `@<agent-name>` | Mencione un subagente personalizado en cualquier lugar del mensaje para ejecutarlo como el agente principal |

328| `@<repo>` | Mencione un repositorio para ejecutar la sesión allí. Consulte [Distribuir a un directorio específico](#dispatch-to-a-specific-directory) para ver qué repositorios se enumeran |357| `@<repo>` | Mencione un repositorio para ejecutar la sesión allí. Consulte [Distribuir a un directorio específico](#dispatch-to-a-specific-directory) para ver qué repositorios se enumeran |

330| `! <command>` | Ejecute un comando de shell como un trabajo en segundo plano en lugar de iniciar una sesión de Claude. El trabajo aparece como una fila a la que puede conectarse, observar y desconectarse |359| `! <command>` | Ejecute un comando de shell como un trabajo en segundo plano en lugar de iniciar una sesión de Claude. El trabajo aparece como una fila a la que puede conectarse, observar y desconectarse |

331| `#<number>` o una URL de solicitud de extracción | Si una sesión ya está trabajando en ese PR, selecciónela en lugar de distribuir |360| `#<number>` o una URL de solicitud de extracción o fusión | Si una sesión ya está trabajando en esa solicitud de extracción o fusión, Claude Code selecciona su fila en lugar de distribuir una nueva sesión |

332| `Shift+Enter` | Distribuya e inmediatamente conéctese a la nueva sesión |

333 361

334Un pequeño conjunto de comandos se ejecutan en la vista de agentes en sí en lugar de distribuirse:362Un pequeño conjunto de comandos se ejecutan en la vista de agentes en sí en lugar de distribuirse:

335 363

336* `/exit` y `/quit` cierran la vista de agentes364* `/exit` y `/quit` cierran la vista de agentes

337* `/logout` cierra su sesión365* `/logout` cierra su sesión

338* `/model` establece el [modelo de distribución](#set-the-model)366* `/model` establece el [modelo de distribución](#set-the-model)

339* A partir de v2.1.198, `/login` abre el diálogo de inicio de sesión para que pueda iniciar sesión nuevamente sin conectarse a una sesión367* `/login` abre el diálogo de inicio de sesión para que pueda iniciar sesión nuevamente sin conectarse a una sesión

368* Un `/resume` sin argumentos, o su alias `/continue`, abre un selector de sesiones pasadas del repositorio para [traer una de vuelta](#organize-the-list) como una sesión en segundo plano. Requiere Claude Code v2.1.212 o posterior

340 369

341Skills, sus propios comandos y built-ins que expanden prompts como `/init` se envían a una nueva sesión en segundo plano como su primer mensaje. Otros comandos built-in muestran una sugerencia `attach to a session to run it` en su lugar. Todo lo que escribió permanece en la entrada junto a la sugerencia para que pueda editarlo. Antes de v2.1.203, la sugerencia borraba la entrada y el texto escrito se perdía.370Skills, sus propios comandos y built-ins que expanden prompts como `/init` se envían a una nueva sesión en segundo plano como su primer mensaje. Otros comandos built-in muestran una sugerencia `attach to a session to run it` en su lugar. Todo lo que escribió permanece en la entrada junto a la sugerencia para que pueda editarlo.

342 371

343Empaquetar una tarea recurrente como un [skill](/docs/es/skills) le permite iniciar el mismo flujo de trabajo desde la vista de agentes repetidamente sin reescribir el mensaje.372Empaquetar una tarea recurrente como un [skill](/docs/es/skills) le permite iniciar el mismo flujo de trabajo desde la vista de agentes repetidamente sin reescribir el mensaje.

344 373

357 * Los [git worktrees](/docs/es/worktrees) registrados del repositorio desde el que se lanzó que viven dentro de su árbol de directorios, como los que Claude crea bajo `.claude/worktrees/`, etiquetados con su rama extraída. Los worktrees agregados fuera del repositorio, como con `git worktree add ../feature`, no se enumeran386 * Los [git worktrees](/docs/es/worktrees) registrados del repositorio desde el que se lanzó que viven dentro de su árbol de directorios, como los que Claude crea bajo `.claude/worktrees/`, etiquetados con su rama extraída. Los worktrees agregados fuera del repositorio, como con `git worktree add ../feature`, no se enumeran

358 * Cualquier directorio que ya tenga una sesión en la lista387 * Cualquier directorio que ya tenga una sesión en la lista

359 388

360 Un directorio cuyo nombre contiene un espacio no se enumera. Antes de v2.1.203, los worktrees registrados no se enumeraban, por lo que distribuir en uno significaba ejecutar `claude --bg` desde el directorio de ese worktree.389 Un directorio cuyo nombre contiene un espacio no se enumera.

361* Desde el shell, `cd` al directorio y ejecute `claude --bg "<prompt>"`.390* Desde el shell, `cd` al directorio y ejecute `claude --bg "<prompt>"`.

362 391

363Cuando 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.392Cuando la vista de agentes se agrupa por directorio, distribuir envía el mensaje al directorio de la fila seleccionada, por lo que puede seleccionar un grupo y distribuir en él sin reescribir la ruta.

364 393

365<h3 id="from-inside-a-session">394<h3 id="from-inside-a-session">

366 Desde dentro de una sesión395 Desde dentro de una sesión

367</h3>396</h3>

368 397

398Dos comandos mueven el trabajo de la sesión en la que se encuentra al segundo plano: `/background` envía la conversación actual allí y libera su terminal, y `/fork` envía una copia mientras continúa trabajando donde está.

399

400<h4 id="send-the-session-to-the-background">

401 Enviar la sesión al segundo plano

402</h4>

403

369Ejecute `/background` o su alias `/bg` para mover la conversación actual a una sesión en segundo plano. Pase un mensaje como `/bg run the test suite and fix any failures` para dar una instrucción más primero. Si Claude está respondiendo cuando ejecuta `/bg`, la respuesta continúa en la sesión en segundo plano.404Ejecute `/background` o su alias `/bg` para mover la conversación actual a una sesión en segundo plano. Pase un mensaje como `/bg run the test suite and fix any failures` para dar una instrucción más primero. Si Claude está respondiendo cuando ejecuta `/bg`, la respuesta continúa en la sesión en segundo plano.

370 405

371Salir de una sesión interactiva que aún tiene trabajo en segundo plano en ejecución, como subagentes, comandos de shell en segundo plano, flujos de trabajo o [monitores](/docs/es/tools-reference#monitor-tool), muestra un diálogo `Background work is running` en lugar de salir inmediatamente. A partir de v2.1.198, el diálogo ofrece `Move to background and exit` junto con `Exit anyway` y `Stay`. Elegirlo mueve la sesión al segundo plano de la misma manera que `/background` lo hace, luego lo devuelve a su shell, por lo que el trabajo que puede continuar sigue ejecutándose y la sesión aparece en la vista de agentes. La opción no se muestra cuando la vista de agentes está [desactivada](#turn-off-agent-view).406Salir de una sesión que aún tiene trabajo en segundo plano en ejecución, como subagentes, comandos de shell en segundo plano, flujos de trabajo o [monitores](/docs/es/tools-reference#monitor-tool), muestra un diálogo `Background work is running` en lugar de salir inmediatamente. Elija `Move to background and exit` para enviar la sesión al segundo plano de la misma manera que `/background` lo hace y volver a su shell. La opción no se muestra cuando la vista de agentes está [desactivada](#turn-off-agent-view).

407

408Si una sesión en segundo plano en la lista ya tiene el nombre de la conversación, Claude Code numera el nombre de la nueva fila, como `my-session (2)`, y deja el nombre de la fila existente sin cambios. Para renombrar la nueva fila, selecciónela en la vista de agentes y presione `Ctrl+R`.

409

410<h4 id="copy-the-session-with-/fork">

411 Copiar la sesión con /fork

412</h4>

413

414Ejecute `/fork` para copiar la conversación actual en una nueva sesión en segundo plano mientras la original continúa ejecutándose. La copia comienza con todo en la conversación hasta ese punto; consulte los puntos a continuación para ver dónde se ejecuta la copia. También lleva el modelo, modo de permiso, nivel de esfuerzo y cualquier directorio o concesión de permiso "no preguntar de nuevo" que agregó durante la sesión. La copia aparece como su propia fila en la vista de agentes.

415

416Después de la bifurcación, las dos conversaciones son independientes: nada de lo que hace la copia entra en la conversación original por sí solo, aunque en sesiones donde [mensajería entre sesiones](/docs/es/cross-session-messaging) está habilitada, Claude en cualquiera de las sesiones puede enviar un mensaje explícitamente a la otra.

417

418Copiar la sesión requiere Claude Code v2.1.212 o posterior; en v2.1.161 a v2.1.211, `/fork` inicia un [subagente bifurcado](/docs/es/sub-agents#fork-the-current-conversation) en su lugar, que ahora es `/subtask`. Cuando [la vista de agentes está desactivada](#turn-off-agent-view), `/fork` mantiene el comportamiento de subagente bifurcado y `/subtask` no está disponible.

419

420Pase un mensaje como `/fork open a draft pull request with the work so far` y la copia comienza a trabajar en él inmediatamente. Sin un mensaje, la copia espera su primera instrucción: seleccione su fila en `claude agents` y presione `Space` para enviar una, o ejecute `claude attach <id>`. La fila seleccionada muestra `space to send it a prompt` mientras espera.

421

422La confirmación de `/fork` es una línea que muestra el estado de la copia, como `session running`, el nombre de su fila de vista de agentes y su ID de sesión para `claude attach`. Haga clic en el nombre para cambiar a la copia: esta sesión se mueve al segundo plano, igual que presionar `←`, y la vista de agentes abre la sesión de la copia.

423

424Excepto cuando la copia [edita en su lugar](#how-file-edits-are-isolated), Claude Code le indica que cree su propio worktree antes de hacer cambios de código. Fuera de un repositorio git, solo una copia movida fuera de un worktree creado por hook recibe la instrucción; sin un hook [`WorktreeCreate`](/docs/es/hooks#worktreecreate), la copia edita en su lugar. Una copia movida fuera de su worktree también recibe la instrucción de nunca editar, ejecutar comandos en o entrar en ese worktree, sea cual sea la configuración de aislamiento.

425

426Dónde comienza la copia depende de dónde se ejecuta la sesión actual:

372 427

373Enviar al segundo plano desde una sesión interactiva inicia un proceso nuevo que se reanuda desde la conversación guardada, y el trabajo en vuelo se traslada a él: comandos shell en segundo plano en ejecución, subagentes en segundo plano, flujos de trabajo dinámicos y tareas programadas que creó con [`/loop`](/docs/es/scheduled-tasks) se trasladan a la sesión en segundo plano y siguen ejecutándose allí. Un subagente se traslada junto con todo lo que inició, por lo que se traslada solo cuando todo ese trabajo puede trasladarse también, incluso en Windows. Para detener el trabajo en vuelo en lugar de trasladarlo, establezca la variable de entorno [`CLAUDE_DISABLE_ADOPT=1`](/docs/es/env-vars#variables); Claude Code luego le pide que confirme antes de enviar al segundo plano.428* Como cualquier sesión distribuida, la copia [se mueve a su propio worktree antes de editar archivos](#how-file-edits-are-isolated). En ese caso, la confirmación no menciona dónde se ejecuta la copia.

429* Cuando su sesión se movió a su [worktree](/docs/es/worktrees) vinculado después de que comenzó, la copia comienza de nuevo donde estaba la sesión antes del movimiento y, a menos que [edite en su lugar](#how-file-edits-are-isolated), hace sus cambios de código en un worktree propio allí. Cuando su worktree está extraído en una rama, esa instrucción también le dice a una copia cuya tarea se basa en su trabajo que base su nueva rama en la suya, ya que su rama permanece extraída en su worktree. La confirmación termina con `runs in the origin tree`.

430* Cuando lanzó la sesión dentro de un worktree vinculado de un repositorio que tiene un árbol de trabajo principal, la copia comienza en ese árbol de trabajo principal, con la misma regla de worktree propio pero sin instrucción de rama. La confirmación termina con `runs in the origin tree` aquí también.

431* Una sesión lanzada dentro de un worktree de un diseño de repositorio desnudo no tiene árbol de trabajo principal al que volver, por lo que la copia permanece donde está, y la confirmación termina con `edits this checkout`. La misma nota aparece cuando el aislamiento de worktree está [desactivado](#how-file-edits-are-isolated) en una sesión que no está dentro de un worktree vinculado, porque la copia entonces edita los archivos que tiene abiertos.

374 432

375El trabajo que no puede trasladarse, como un [monitor](/docs/es/tools-reference#monitor-tool) en ejecución, se detiene. Un subagente en segundo plano que posee un monitor se detiene junto con él. Cuando algún trabajo de este tipo se está ejecutando, Claude Code muestra un diálogo `Background this session?` para que pueda confirmar antes de que se detenga.433Las sesiones iniciadas con banderas de lanzamiento que la copia no heredaría, como un mensaje del sistema reemplazado o una lista de permitidos `--tools`, no se pueden bifurcar; Claude Code lo dice en lugar de hacer una copia parcial. Una sesión distribuida desde la vista de agentes se bifurca normalmente: la copia se lanza con la misma [definición de agente](/docs/es/sub-agents) e instrucciones añadidas que la sesión de la que proviene.

434

435<h4 id="what-carries-over-when-you-background">

436 Qué se lleva cuando envía al segundo plano

437</h4>

438

439Enviar al segundo plano inicia un nuevo proceso que se reanuda desde la conversación guardada, y el trabajo en vuelo se traslada a él: comandos shell en segundo plano en ejecución, subagentes en segundo plano, flujos de trabajo dinámicos, tareas programadas que creó con [`/loop`](/docs/es/scheduled-tasks), y [respuestas automáticas de Claude a comentarios de artefactos](/docs/es/artifacts#let-claude-reply-to-comments-on-its-own) se trasladan a la sesión en segundo plano y siguen ejecutándose allí. Un subagente se traslada junto con todo lo que inició, por lo que se traslada solo cuando todo ese trabajo puede trasladarse también. Para detener el trabajo en vuelo en lugar de trasladarlo, establezca la variable de entorno [`CLAUDE_DISABLE_ADOPT=1`](/docs/es/env-vars#variables); Claude Code luego le pide que confirme antes de enviar al segundo plano.

440

441Cuando un [flujo de trabajo dinámico](/docs/es/workflows) aún tiene subagentes en ejecución, Claude Code pregunta antes de enviar al segundo plano con el diálogo `Background this session?`, que dice cuántos subagentes se reiniciarían. Elija `Stay` para dejarlos terminar primero. Si confirma, Claude Code reproduce la ejecución en la sesión en segundo plano: los subagentes que aún se estaban ejecutando comienzan de nuevo desde el principio, por lo que los tokens que usaron hasta ahora se gastan nuevamente. Consulte [Reanudar después de una pausa](/docs/es/workflows#resume-after-a-pause) para ver qué subagentes completados devuelven sus resultados guardados y cuáles se ejecutan nuevamente.

442

443Claude Code detiene el trabajo que no puede trasladarse, como un [monitor](/docs/es/tools-reference#monitor-tool) en ejecución, y detiene un subagente en segundo plano que posee un monitor junto con él. Cuando algún trabajo de este tipo se está ejecutando, Claude Code muestra el diálogo `Background this session?` para que pueda confirmar antes de que se detenga el trabajo.

376 444

377Una vez en segundo plano, la sesión puede iniciar nuevos subagentes, monitores y comandos en segundo plano, y esos continúan ejecutándose en desconexiones y reconexiones posteriores.445Una vez en segundo plano, la sesión puede iniciar nuevos subagentes, monitores y comandos en segundo plano, y esos continúan ejecutándose en desconexiones y reconexiones posteriores.

378 446

385* `--fallback-model`453* `--fallback-model`

386* `--allow-dangerously-skip-permissions`454* `--allow-dangerously-skip-permissions`

387 455

388Los directorios que agregó durante la sesión con [`/add-dir`](/docs/es/permissions#additional-directories-grant-file-access-not-configuration) también se transfieren.456Los directorios que agregó durante la sesión con [`/add-dir`](/docs/es/permissions#additional-directories-grant-file-access-not-configuration) también se transfieren. Transferir `--allow-dangerously-skip-permissions` mantiene `bypassPermissions` accesible en la sesión enviada al segundo plano, pero no otorga nada nuevo: el modo aún requiere la aceptación interactiva única descrita en [Modo de permiso, modelo y esfuerzo](#permission-mode-model-and-effort).

~~389~~

390Transferir `--allow-dangerously-skip-permissions` mantiene `bypassPermissions` accesible en la sesión enviada al segundo plano, pero no otorga nada nuevo. El modo aún requiere la misma aceptación interactiva única descrita en [Modo de permiso, modelo y esfuerzo](#permission-mode-model-and-effort) antes de que cualquier sesión pueda usarlo.

391 457

392<h3 id="from-your-shell">458<h3 id="from-your-shell">

393 Desde su shell459 Desde su shell

399claude --bg "investigate the flaky SettingsChangeDetector test"465claude --bg "investigate the flaky SettingsChangeDetector test"

400```466```

401 467

402El mensaje es el argumento posicional, no un valor `-p`. A partir de v2.1.198, combinar `--bg` con `-p` o `--print` se rechaza con un error antes de que se cree cualquier sesión, porque `--print` nunca inicia la sesión interactiva a la que `claude agents` se conecta.468El mensaje es el argumento posicional, no un valor `-p`. Claude Code rechaza `--bg` combinado con `-p` o `--print` antes de que se cree cualquier sesión, porque `--print` nunca inicia la sesión interactiva a la que `claude agents` se conecta.

403 469

404Para ejecutar un subagente específico como el agente principal de la sesión, combine `--bg` con `--agent`:470Para ejecutar un [subagente](/docs/es/sub-agents) específico que haya definido, como un `code-reviewer`, como el agente principal de la sesión, combine `--bg` con `--agent`:

405 471

406```bash theme={null}472```bash theme={null}

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

408```474```

409 475

476Si el nombre no coincide con ninguno de sus subagentes, el lanzamiento falla: Claude Code imprime una advertencia `no agent named` y aún reporta la sesión como enviada al segundo plano, pero la sesión sale inmediatamente con un error `--agent '<name>' not found`.

477

478Cuando la sesión enviada al segundo plano se reanuda o reinicia más tarde, Claude Code restaura el mensaje del sistema del agente y las restricciones de herramientas. Busca primero el agente en el directorio de la sesión, siempre que haya [confiado en ese espacio de trabajo](/docs/es/permissions#project-allow-rules-and-workspace-trust), por lo que un agente con alcance de proyecto aún se carga cuando la sesión se reanuda desde otro directorio. Si el agente ya no existe, la sesión continúa con las herramientas predeterminadas y el mensaje del sistema y su transcripción se abre con una [advertencia que nombra al agente](/docs/es/errors#session-agent-no-longer-available).

479

410Pase `--name` para establecer el nombre de visualización de la sesión en la vista de agentes en lugar del generado automáticamente:480Pase `--name` para establecer el nombre de visualización de la sesión en la vista de agentes en lugar del generado automáticamente:

411 481

412```bash theme={null}482```bash theme={null}

427 Ejecutar un comando de shell497 Ejecutar un comando de shell

428</h4>498</h4>

429 499

430Para ejecutar un comando de shell como un trabajo en segundo plano en lugar de una sesión de Claude, escriba `!` como el primer carácter de la entrada de distribución de la vista de agentes. El `!` se muestra como un prefijo y todo lo que escriba después de él es el comando. El siguiente ejemplo distribuye `pytest -x` desde el cuadro de entrada de la vista de agentes:500Para ejecutar un comando de shell como un trabajo en segundo plano en lugar de una sesión de Claude, pase `--exec`. El siguiente ejemplo ejecuta `pytest -x` como un trabajo en segundo plano:

~~431~~

432```text theme={null}

433! pytest -x

434```

~~435~~

436Presione `Enter` para iniciar el trabajo. El mismo trabajo también se puede lanzar directamente desde su shell con `--exec`:

437 501

438```bash theme={null}502```bash theme={null}

439claude --bg --exec 'pytest -x'503claude --bg --exec 'pytest -x'

440```504```

441 505

506Desde la vista de agentes, distribuya el mismo tipo de trabajo escribiendo `!` como el primer carácter de la entrada de distribución: el `!` se muestra como un prefijo, todo lo que viene después es el comando, y `Enter` inicia el trabajo.

507

442El comando se ejecuta como un trabajo respaldado por PTY y aparece como una fila en la vista de agentes, con la línea de salida más reciente como su estado. Un trabajo de shell ejecuta el comando en lugar de Claude, por lo que no se invoca ningún modelo y la salida no se envía a ninguna sesión.508El comando se ejecuta como un trabajo respaldado por PTY y aparece como una fila en la vista de agentes, con la línea de salida más reciente como su estado. Un trabajo de shell ejecuta el comando en lugar de Claude, por lo que no se invoca ningún modelo y la salida no se envía a ninguna sesión.

443 509

444Para ver la salida, conéctese a la fila, presione `Space` para echar un vistazo sin conectarse, o ejecute `claude logs <id>` desde su shell. La salida capturada permanece en la memoria y no se escribe en el disco. La fila y su salida se limpian automáticamente aproximadamente cinco minutos después de que el comando salga, así que léalo antes si necesita el resultado.510Para ver la salida, conéctese a la fila, presione `Space` para echar un vistazo sin conectarse, o ejecute `claude logs <id>` desde su shell. La salida capturada permanece en la memoria y no se escribe en el disco. La fila y su salida se limpian automáticamente aproximadamente cinco minutos después de que el comando salga, así que léalo antes si necesita el resultado.

447 Cómo se aíslan las ediciones de archivos513 Cómo se aíslan las ediciones de archivos

448</h3>514</h3>

449 515

450Cada sesión en segundo plano, ya sea iniciada desde la vista de agentes, `/bg` o `claude --bg`, comienza en su directorio de trabajo. Antes de editar archivos, Claude mueve la sesión a un [git worktree](/docs/es/worktrees) aislado bajo `.claude/worktrees/`, de modo que las sesiones paralelas pueden leer el mismo checkout pero cada una escribe en la suya propia.516Cada sesión en segundo plano, ya sea iniciada desde la vista de agentes, `/bg` o `claude --bg`, comienza en su directorio de trabajo. Antes de editar archivos, Claude mueve la sesión a un [git worktree](/docs/es/worktrees) aislado bajo `.claude/worktrees/`, de modo que las sesiones paralelas pueden leer el mismo checkout pero cada una escribe en la suya propia. Una vez que la sesión está en su worktree, Claude Code [aplica aislamiento de worktree](/docs/es/worktrees#how-claude-code-enforces-isolation) para la sesión y para cualquier subagente que genere.

451 517

452Claude omite el worktree cuando:518Claude omite el worktree cuando:

453 519

454* La sesión ya está dentro de un git worktree vinculado, ya sea que Claude lo haya creado bajo `.claude/worktrees/` o que lo haya creado con `git worktree add` en otro lugar520* La sesión ya está dentro de un git worktree vinculado, ya sea que Claude lo haya creado bajo `.claude/worktrees/` o que lo haya creado con `git worktree add` en otro lugar

521* El archivo que Claude está editando está dentro de un git worktree vinculado, como uno que la sesión o su subagente creó con `git worktree add`

455* El directorio de trabajo no es un repositorio git y no hay ningún hook [`WorktreeCreate`](/docs/es/hooks#worktreecreate) configurado522* El directorio de trabajo no es un repositorio git y no hay ningún hook [`WorktreeCreate`](/docs/es/hooks#worktreecreate) configurado

456* La escritura está fuera del directorio de trabajo523* La escritura está fuera del directorio de trabajo

457 524

458Para desactivar el aislamiento de worktree para un repositorio donde los git worktrees no son prácticos, establezca [`worktree.bgIsolation`](/docs/es/settings#worktree-settings) en `"none"`. Las sesiones en segundo plano editarán su copia de trabajo directamente sin moverse a un worktree primero. Agregue la configuración al archivo `.claude/settings.json` del proyecto:525Para desactivar el aislamiento de worktree para un repositorio donde los git worktrees no son prácticos, establezca [`worktree.bgIsolation`](/docs/es/settings-reference#worktree-bgisolation) en `"none"`. Las sesiones en segundo plano editarán su copia de trabajo directamente sin moverse a un worktree primero. Agregue la configuración al archivo `.claude/settings.json` del proyecto:

459 526

460```json theme={null}527```json theme={null}

461{528{

467 534

468Fuera de un repositorio git, las sesiones escriben en el directorio de trabajo directamente y no están aisladas entre sí, por lo que evite distribuir sesiones paralelas que editen los mismos archivos. Si utiliza un sistema de control de versiones diferente, configure un hook [`WorktreeCreate`](/docs/es/worktrees#non-git-version-control) y Claude aísla las ediciones de la misma manera que lo hace para git.535Fuera de un repositorio git, las sesiones escriben en el directorio de trabajo directamente y no están aisladas entre sí, por lo que evite distribuir sesiones paralelas que editen los mismos archivos. Si utiliza un sistema de control de versiones diferente, configure un hook [`WorktreeCreate`](/docs/es/worktrees#non-git-version-control) y Claude aísla las ediciones de la misma manera que lo hace para git.

469 536

470Cuando el hook falla en un directorio que no es un repositorio git, la sesión omite el aislamiento para ese directorio y edita el directorio de trabajo en su lugar. Dentro de un repositorio git, las escrituras permanecen bloqueadas hasta que la sesión se aísle. Antes de v2.1.203, una sesión en segundo plano en ese estado no podía editar ningún archivo: cada escritura se rechazaba hasta que se aislaba, y el hook nunca podía aislar ese directorio.537Cuando el hook falla en un directorio que no es un repositorio git, Claude omite el aislamiento para ese directorio y edita el directorio de trabajo en su lugar. Dentro de un repositorio git, Claude Code bloquea las escrituras en el checkout compartido hasta que Claude mueve la sesión a un worktree.

~~471~~

472Eliminar una sesión elimina o mantiene el worktree que Claude creó para ella, dependiendo de cómo lo elimine y qué contenga el worktree:

~~473~~

474* Eliminar en la vista de agentes con `Ctrl+X` dos veces elimina el worktree, incluidos los cambios sin confirmar, por lo que confirme los cambios que desee mantener primero.

475* Eliminar desde el shell con [`claude rm`](#manage-sessions-from-the-shell) mantiene un worktree que tiene cambios sin confirmar, junto con su fila de sesión.

476* Ninguna ruta elimina un worktree con commits que no se han enviado a ningún lugar: el worktree se [mantiene junto con su sesión](#organize-the-list) y la salida nombra la ruta mantenida y la razón.

477* Un worktree que creó usted mismo e inició la sesión dentro se deja en su lugar de cualquier forma.

478 538

479Para 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.539Para 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.

480 540

481Un [subagente](/docs/es/sub-agents) que la sesión en segundo plano genera hereda el directorio de trabajo de la sesión, por lo que sus ediciones de archivos se realizan en el worktree de la sesión en lugar de su copia de trabajo. Para darle a un subagente su propio worktree separado en su lugar, establezca [`isolation: worktree`](/docs/es/sub-agents#supported-frontmatter-fields) en su frontmatter o pase `isolation: "worktree"` al generarlo.541Un [subagente](/docs/es/sub-agents) que la sesión en segundo plano genera hereda el directorio de trabajo de la sesión, por lo que sus ediciones de archivos se realizan en el worktree de la sesión en lugar de su copia de trabajo. Para darle a un subagente su propio worktree separado en su lugar, establezca [`isolation: worktree`](/docs/es/sub-agents#supported-frontmatter-fields) en su frontmatter o pase `isolation: "worktree"` al generarlo.

482 542

483A partir de v2.1.198, una sesión en segundo plano que aisló sus cambios de código en un worktree también confirma, envía su propia rama y abre una solicitud de extracción en borrador sin detenerse a preguntar. La etiqueta [`#N`](#pull-request-status) aparece en su fila cuando se abre la solicitud de extracción. Nunca envía a `main` o `master`, nunca fuerza-envía o fusiona, y omite la solicitud de extracción cuando le dijo que no abriera una o el repositorio no tiene remoto.543Cuando una sesión en segundo plano ha realizado cambios de código en un worktree que Claude ingresó, Claude Code le indica a Claude que preserve el trabajo antes de terminar, por lo que sobrevive si elimina la sesión y su worktree:

544

545* **Confirmar e insertar**: Claude confirma sin preguntar e inserta la rama cuando el repositorio tiene un remoto.

546* **Solicitud de extracción en borrador**: Claude abre una cuando la tarea lo requiere, y la etiqueta [`#N`](#pull-request-status) aparece en la fila.

547* **Nunca**: insertar a `main` o `master`, fuerza-insertar y fusionar.

548* **Sus instrucciones de git tienen prioridad**: si la tarea, `CLAUDE.md` o [memoria](/docs/es/memory) dice que usted maneja la confirmación o inserción usted mismo, Claude deja git para usted.

484 549

485Una sesión que edita un checkout que no aisló a sí misma aún pregunta antes de confirmar o cambiar de rama. Esto se aplica cuando el aislamiento se establece en `"none"`, cuando el movimiento del worktree falló, o cuando la sesión comenzó dentro de un worktree que ya existía.550Una sesión que edita un checkout que no aisló a sí misma aún pregunta antes de confirmar o cambiar de rama. Esto se aplica cuando el aislamiento se establece en `"none"`, cuando el movimiento del worktree falló, o cuando la sesión comenzó dentro de un worktree que ya existía.

486 551

552Sea cual sea la tarea, Claude termina el trabajo con un informe que dice qué hizo y dónde está el trabajo: una ruta, una rama, una solicitud de extracción o la respuesta en sí.

553

554<h4 id="what-deleting-a-session-removes">

555 Qué elimina la eliminación de una sesión

556</h4>

557

558Elimine una sesión con `Ctrl+X` dos veces en [vista de agentes](#organize-the-list) o con [`claude rm`](#manage-sessions-from-the-shell). Excepto en los casos mantenidos a continuación, la sesión deja la lista. Su transcripción permanece en su máquina a través de `claude --resume`, y la eliminación sobrevive a los reinicios del supervisor.

559

560Qué sucede con un worktree que Claude creó para la sesión:

561

562* La vista de agentes lo elimina, incluidos los cambios sin confirmar, por lo que confirme lo que desee mantener primero.

563* `claude rm` lo mantiene, junto con la fila de la sesión, cuando tiene cambios sin confirmar.

564* Ni la vista de agentes ni `claude rm` eliminan un worktree con commits que Claude Code no puede confirmar que se guardan en otro lugar, o uno que otra sesión en ejecución está usando o ha bloqueado. Claude Code mantiene el worktree y la sesión, y nombra el directorio mantenido y la razón.

565

566 Los commits en un remoto no bloquean la eliminación. Tampoco los commits en la copia local de la rama predeterminada de su remoto `origin`, siempre que esa rama esté extraída en su checkout principal, el directorio del repositorio en sí en lugar de un worktree.

567

568 En la vista de agentes, una eliminación rechazada muestra `not deleted` con la razón en la fila de la sesión. Inserte los commits, fusionelos en esa rama predeterminada o cierre la otra sesión, luego elimine nuevamente.

569* Un worktree que git ya no reconoce, por ejemplo después de `git worktree prune`, no bloquea la eliminación. Claude Code elimina la sesión y deja el directorio en el disco.

570

571Un worktree que creó usted mismo e inició la sesión dentro se deja en su lugar de cualquier forma.

572

573Una sesión cuyo directorio de worktree no pertenece a ningún repositorio git, porque el repositorio fue eliminado o un hook [`WorktreeCreate`](/docs/es/hooks#worktreecreate) creó el directorio en otro lugar, aún se puede eliminar. Mientras los archivos permanezcan en el directorio:

574

575* La vista de agentes pide el mismo doble presión `Ctrl+X` antes de descartarlos. Para un directorio creado por hook, ejecuta su hook [`WorktreeRemove`](/docs/es/hooks#worktreeremove) en su lugar, y sin uno rechaza la eliminación y mantiene la sesión.

576* `claude rm` mantiene la sesión y el worktree, y nombra la razón.

577

578Cualquiera de los caminos mantiene un directorio que los registros de otra sesión terminada nombran.

579

487<h3 id="set-the-model">580<h3 id="set-the-model">

488 Establecer el modelo581 Establecer el modelo

489</h3>582</h3>

490 583

491El nombre del modelo mostrado en el encabezado de la vista de agentes es el valor predeterminado de distribución. Las nuevas sesiones que inicia desde la entrada utilizan este modelo, que proviene de la configuración [`model`](/docs/es/settings#available-settings) en su configuración de usuario. Establézcalo seleccionando un modelo en el selector [`/model`](/docs/es/model-config), o edite la configuración directamente.584El nombre del modelo mostrado en el encabezado de la vista de agentes es el valor predeterminado de distribución. Las nuevas sesiones que inicia desde la entrada utilizan este modelo, que proviene de la configuración [`model`](/docs/es/settings-reference#model) en su configuración de usuario. Establézcalo seleccionando un modelo en el selector [`/model`](/docs/es/model-config), o edite la configuración directamente.

492 585

493Para anularlo para toda la sesión de vista de agentes, pase `--model` al abrir la vista de agentes. Consulte [Modo de permiso, modelo y esfuerzo](#permission-mode-model-and-effort).586Para anular el valor predeterminado de distribución para toda la sesión de vista de agentes, pase `--model` al abrir la vista de agentes. Consulte [Modo de permiso, modelo y esfuerzo](#permission-mode-model-and-effort).

494 587

495Para cambiar el valor predeterminado de distribución desde dentro de la vista de agentes, escriba `/model` seguido de un nombre de modelo en la entrada de distribución y presione `Enter`. El encabezado se actualiza para mostrar ese modelo con un marcador `(session)`, y las sesiones que distribuya después lo utilizan. Escriba `/model default` para borrar la anulación y volver al valor predeterminado de distribución. Esta anulación dura el resto de la ejecución actual de `claude agents` y no se escribe en su archivo de configuración. El siguiente ejemplo distribuye una sesión en Opus y la siguiente en Sonnet:588Para cambiar el valor predeterminado de distribución desde dentro de la vista de agentes, escriba `/model` seguido de un nombre de modelo en la entrada de distribución y presione `Enter`. El encabezado se actualiza para mostrar ese modelo con un marcador `(session)`, y las sesiones que distribuya después lo utilizan. Escriba `/model default` para borrar la anulación y volver al valor predeterminado de distribución. Esta anulación dura el resto de la ejecución actual de `claude agents` y no se escribe en su archivo de configuración. El siguiente ejemplo distribuye una sesión en Opus y la siguiente en Sonnet:

496 589

511 Modo de permiso, modelo y esfuerzo604 Modo de permiso, modelo y esfuerzo

512</h3>605</h3>

513 606

514Una sesión en segundo plano lee su [configuración](/docs/es/settings) desde el directorio en el que se ejecuta, igual que si hubiera iniciado `claude` allí. Esto incluye valores [`env`](/docs/es/settings#available-settings) en la configuración del proyecto, por lo que una variable `ANTHROPIC_MODEL` o de proveedor establecida allí se aplica a las sesiones en segundo plano en ese directorio.607Una sesión en segundo plano toma su configuración, proveedor, modo de permiso, modelo y esfuerzo de dónde y cómo la distribuyó. Las subsecciones a continuación cubren cada fuente y qué persiste cuando el supervisor reinicia la sesión.

608

609<h4 id="settings-and-provider">

610 Configuración y proveedor

611</h4>

612

613Una sesión en segundo plano lee su [configuración](/docs/es/settings) desde el directorio en el que se ejecuta, igual que si hubiera iniciado `claude` allí. Esto incluye valores [`env`](/docs/es/settings-reference#env) en la configuración del proyecto, por lo que una variable `ANTHROPIC_MODEL` o de proveedor establecida allí se aplica a cada sesión en segundo plano en ese directorio.

614

615Una sesión en segundo plano también se ejecuta con el `PATH` del shell desde el que la distribuyó, por lo que los comandos que ejecuta encuentran las mismas herramientas que su terminal. También mantiene la selección del proveedor en la nube de ese shell, como `CLAUDE_CODE_USE_BEDROCK` o `CLAUDE_CODE_USE_VERTEX`, junto con sus alias `ANTHROPIC_DEFAULT_*_MODEL` y cualquier anulación [`CLAUDE_CODE_EXTRA_BODY`](/docs/es/env-vars) que haya exportado allí.

515 616

516La selección del proveedor en la nube, como `CLAUDE_CODE_USE_BEDROCK` o `CLAUDE_CODE_USE_VERTEX`, y los alias `ANTHROPIC_DEFAULT_*_MODEL` siguen el shell que distribuyó la sesión. Si exporta una anulación de cuerpo de solicitud [`CLAUDE_CODE_EXTRA_BODY`](/docs/es/env-vars) en ese shell, llega a la sesión de la misma manera. Antes de v2.1.206, los trabajadores en segundo plano ignoraban un `CLAUDE_CODE_EXTRA_BODY` exportado por shell.617<h4 id="llm-gateway">

618 Puerta de enlace LLM

619</h4>

620

621Si enruta Claude Code a través de una [puerta de enlace LLM](/docs/es/llm-gateway), coloque las variables de puerta de enlace en el bloque `env` de un archivo de configuración en lugar de exportarlas en su shell, y las sesiones en segundo plano las leen con el resto de su configuración. [Establecer en un archivo de configuración](/docs/es/llm-gateway-connect#set-in-a-settings-file) muestra el bloque y qué archivo de configuración usar para la credencial.

622

623Si exporta una puerta de enlace `ANTHROPIC_BASE_URL` solo en su shell en su lugar, llega a una sesión en segundo plano, junto con `ANTHROPIC_CUSTOM_HEADERS` y la credencial que exportó con ella, solo cuando el [supervisor](#the-supervisor-process) fue iniciado desde un shell que exportó la misma puerta de enlace, y solo en estos casos:

624

625* Envía su propia sesión al segundo plano con `←` o `/background`

626* Distribuye una sesión al directorio en el que está

627* Despierta una sesión detenida en el directorio en el que está adjuntándose o respondiendo a ella

517 628

518Si exporta una puerta de enlace `ANTHROPIC_BASE_URL` en el shell de distribución, también llega a la sesión, junto con `ANTHROPIC_CUSTOM_HEADERS`, cuando el supervisor se ejecuta con el mismo entorno de puerta de enlace y la sesión se ejecuta en el directorio desde el que distribuye o es su propia sesión enviada al segundo plano con `←` o `/background`. Ese es el caso normal cuando el primer shell en abrir la vista de agentes o distribuir una sesión en segundo plano es el shell de puerta de enlace. Distribuir a un directorio diferente con `@repo` o `--cwd` no lleva la puerta de enlace del shell; la [configuración](/docs/es/settings) de ese proyecto suministra el punto final. Consulte [el proceso supervisor](#the-supervisor-process) para ver cómo las sesiones en segundo plano obtienen la configuración del proveedor y las credenciales.629Claude Code reenvía una puerta de enlace frente a un proveedor en la nube. Si el shell desde el que distribuye selecciona el proveedor e exporta su punto final de puerta de enlace con su bandera de omisión de autenticación, Claude Code reenvía el par punto final-y-bandera a la sesión bajo las condiciones que se aplican a `ANTHROPIC_BASE_URL`, junto con `ANTHROPIC_CUSTOM_HEADERS`. Por ejemplo, exporte `CLAUDE_CODE_USE_VERTEX=1` con `ANTHROPIC_VERTEX_BASE_URL` y `CLAUDE_CODE_SKIP_VERTEX_AUTH=1`, y Claude Code reenvía ese punto final y bandera.

519 630

520El [modo de permiso](/docs/es/permissions) depende de cómo inició la sesión. Enviar al segundo plano una sesión existente con `/bg` o `←` mantiene el modo de permiso actual, por lo que una sesión que cambió a `acceptEdits` o `auto` permanece en ese modo después de desconectarse. Distribuir desde la entrada de la vista de agentes o ejecutar `claude --bg` desde su shell utiliza el `defaultMode` de la configuración de ese directorio, o el `permissionMode` del [frontmatter del subagente distribuido](/docs/es/sub-agents#supported-frontmatter-fields).631Claude Code aplica una puerta de enlace reenviada solo al proceso en ejecución de esa sesión y nunca la escribe en el disco.

521 632

522El modo de permiso, modelo y esfuerzo con el que inicia una sesión en segundo plano, junto con las [banderas de configuración que lleva](#from-inside-a-session), todos persisten cuando el supervisor posteriormente [detiene y reinicia](#the-supervisor-process) su proceso. Una sesión que lanzó con `claude --bg --dangerously-skip-permissions` o `claude --bg --permission-mode bypassPermissions` permanece en `bypassPermissions` después de ese reinicio en lugar de volver al `defaultMode` del directorio, y un modelo o esfuerzo que cambió a mitad de sesión con `/model` o `/effort` se mantiene.633<h4 id="permission-mode">

634 Modo de permiso

635</h4>

636

637El [modo de permiso](/docs/es/permissions) depende de cómo inició la sesión:

523 638

524Un esfuerzo que la sesión tomó de la configuración [`effortLevel`](/docs/es/settings#available-settings) en lugar de `--effort` o `/effort` no se fija en la distribución: cada proceso iniciado para la sesión lee la configuración nuevamente, por lo que editar `effortLevel` en `settings.json` llega a las sesiones que envía al segundo plano con `←` o `/bg` y sus reinicios posteriores. Antes de v2.1.203, enviar al segundo plano una sesión registraba su esfuerzo derivado de configuración como si hubiera pasado `--effort`, por lo que ediciones posteriores de `effortLevel` nunca lo alcanzaban.639* **Enviado al segundo plano con `/bg` o `←`**: Claude Code mantiene el modo de permiso en el que estaba la sesión, por lo que uno que cambió a `acceptEdits` o `auto` permanece allí después de desconectarse

640* **Distribuido desde una vista de agentes que abrió con `←`**: la nueva sesión comienza en el modo de permiso de la sesión de la que vino

641* **Distribuido desde `claude agents` iniciado en un shell, o con `claude --bg`**: la nueva sesión comienza de la manera que lo haría una nueva sesión `claude` en ese directorio, a menos que la haya distribuido desde una vista de agentes que abrió con [valores predeterminados de distribución](#dispatch-defaults). [Qué modo de permiso comienza una sesión](/docs/es/permission-modes#which-mode-a-session-starts-in) enumera el orden

525 642

526Un nombre que estableció con [`/rename`](/docs/es/commands) o `Ctrl+R` también persiste en ese reinicio, por lo que [`claude --resume <name>`](/docs/es/sessions#name-your-sessions) aún resuelve la sesión. Antes de v2.1.202, el reinicio revertía la sesión al nombre con el que se distribuyó y el nuevo nombre dejaba de resolverse.643<h4 id="dispatch-defaults">

644 Valores predeterminados de distribución

645</h4>

527 646

528Para establecer valores predeterminados para cada sesión que distribuya desde la vista de agentes, pase cualquiera de `--permission-mode`, `--model`, `--effort` o `--agent` al abrirla:647Para establecer valores predeterminados para cada sesión que distribuya desde la vista de agentes, pase cualquiera de `--permission-mode`, `--model`, `--effort` o `--agent` al abrirla:

529 648

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

532```651```

533 652

534`--agent` establece el [subagente](/docs/es/sub-agents) utilizado cuando un mensaje de distribución no nombra uno, ya sea con `@name` o como la primera palabra. Por defecto es la configuración [`agent`](/docs/es/settings#available-settings) si se establece una, de lo contrario el agente integrado `claude` que lo captura todo. Nombrar un subagente en la entrada de distribución anula ambos.653`--effort` aquí acepta los mismos valores que la [bandera `--effort` de nivel superior](/docs/es/cli-reference#cli-flags), incluido `ultracode`.

654

655`--agent` establece el [subagente](/docs/es/sub-agents) utilizado cuando un mensaje de distribución no nombra uno, ya sea con `@name` o como la primera palabra. Por defecto es la configuración [`agent`](/docs/es/settings-reference#agent) si se establece una, de lo contrario el agente integrado `claude` que lo captura todo. Nombrar un subagente en la entrada de distribución anula ambos.

535 656

536`claude agents` también acepta `--dangerously-skip-permissions` como abreviatura de `--permission-mode bypassPermissions`, y `--allow-dangerously-skip-permissions` para hacer que `bypassPermissions` esté disponible en el ciclo `Shift+Tab` de cada sesión distribuida sin comenzar en ese modo. Ambos coinciden con las [banderas CLI de nivel superior](/docs/es/cli-reference).657`claude agents` también acepta `--dangerously-skip-permissions` como abreviatura de `--permission-mode bypassPermissions`, y `--allow-dangerously-skip-permissions` para hacer que `bypassPermissions` esté disponible en el ciclo `Shift+Tab` de cada sesión distribuida sin comenzar en ese modo. Ambos coinciden con las [banderas CLI de nivel superior](/docs/es/cli-reference).

537 658

659Pase `--restricted` para iniciar cada sesión que distribuya desde la vista en [modo restringido](/docs/es/cli-reference#cli-flags), como si cada una se lanzara con la bandera de nivel superior `--restricted`. Requiere Claude Code v2.1.248 o posterior.

660

538Los valores predeterminados activos aparecen en el pie de página debajo de la entrada de distribución.661Los valores predeterminados activos aparecen en el pie de página debajo de la entrada de distribución.

539 662

540Sin estas banderas, la sesión utiliza el `defaultMode` de la configuración de ese directorio o el `permissionMode` del [frontmatter del subagente distribuido](/docs/es/sub-agents#supported-frontmatter-fields), y el modelo mostrado en el encabezado de la vista de agentes.663Claude Code rechaza `claude --bg --permission-mode bypassPermissions` hasta que haya aceptado el descargo de responsabilidad de bypass ejecutando `claude --dangerously-skip-permissions` una vez de forma interactiva, ya que ese modo permite que una sesión que no está viendo actúe sin aprobación. Pasar `--dangerously-skip-permissions` o `--permission-mode bypassPermissions` a `claude agents` muestra el mismo descargo de responsabilidad cuando no lo ha aceptado antes, y aceptar aplica `bypassPermissions` a las sesiones que lanza desde la vista. Pasar `--allow-dangerously-skip-permissions` muestra el mismo descargo de responsabilidad también, y aceptar hace que `bypassPermissions` esté disponible en el ciclo `Shift+Tab` de esas sesiones sin iniciarlas en él.

664

665<h4 id="what-persists-across-restarts">

666 Qué persiste en los reinicios

667</h4>

668

669El modo de permiso, modelo y esfuerzo que eligió para una sesión en segundo plano, junto con las [banderas de configuración que lleva](#what-carries-over-when-you-background), todos persisten cuando el supervisor posteriormente [detiene y reinicia](#the-supervisor-process) su proceso. Una sesión que lanzó con `claude --bg --dangerously-skip-permissions` o `claude --bg --permission-mode bypassPermissions` permanece en `bypassPermissions` después de ese reinicio. Un modelo o esfuerzo que cambió a mitad de sesión con `/model` o `/effort` también se mantiene.

541 670

542El uso de `bypassPermissions` con `claude --bg --permission-mode` se rechaza hasta que haya aceptado el descargo de responsabilidad de bypass ejecutando `claude --dangerously-skip-permissions` una vez de forma interactiva, ya que ese modo permite que una sesión que no está viendo actúe sin aprobación. Pasar `--dangerously-skip-permissions` o `--permission-mode bypassPermissions` a `claude agents` muestra el mismo descargo de responsabilidad cuando no lo ha aceptado antes, y aceptar aplica `bypassPermissions` a las sesiones que lanza desde la vista. Pasar `--allow-dangerously-skip-permissions` muestra el mismo descargo de responsabilidad también, y aceptar hace que `bypassPermissions` esté disponible en el ciclo `Shift+Tab` de esas sesiones sin iniciarlas en él.671Si la sesión tomó su esfuerzo de su configuración en lugar de `--effort` o `/effort`, Claude Code lee su configuración nuevamente cada vez que inicia un proceso para la sesión. Entonces, cuando edita el esfuerzo guardado en `settings.json`, el cambio llega a las sesiones que envía al segundo plano con `←` o `/bg`, y sus reinicios posteriores. El esfuerzo guardado es la clave [`effortLevel`](/docs/es/settings-reference#effortlevel) o una entrada [`modelSettings`](/docs/es/settings-reference#modelsettings).

672

673Claude Code también mantiene un nombre que estableció con [`/rename`](/docs/es/commands) o `Ctrl+R` en ese reinicio, por lo que aún puede ejecutar [`claude --resume <name>`](/docs/es/sessions#name-your-sessions) para llegar a la sesión.

543 674

544<h3 id="settings-plugins-and-mcp-servers">675<h3 id="settings-plugins-and-mcp-servers">

545 Configuración, plugins y servidores MCP676 Configuración, plugins y servidores MCP

546</h3>677</h3>

547 678

548La vista de agentes acepta las mismas banderas de configuración que `claude` para cargar configuración, plugins, servidores MCP y directorios adicionales. Cada bandera se aplica a la vista de agentes en sí y se pasa a cada sesión que distribuya desde ella, por lo que un plugin o servidor MCP que cargue de esta manera está disponible en esas sesiones también.679La vista de agentes acepta las mismas banderas de configuración que `claude` para cargar configuración, plugins, servidores MCP y directorios adicionales. La vista de agentes aplica `--settings` y `--plugin-dir` a sí misma y pasa cada bandera de configuración a las sesiones que distribuye desde ella, por lo que un plugin o servidor MCP que cargue de esta manera está disponible en esas sesiones.

549 680

550| Bandera | Efecto |681| Bandera | Efecto |

551| :----------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------- |682| :----------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

552| [`--settings <file-or-json>`](/docs/es/settings) | Anule la configuración para la vista de agentes y las sesiones distribuidas |683| [`--settings <file-or-json>`](/docs/es/settings) | Anule la configuración para la vista de agentes y las sesiones distribuidas |

553| [`--add-dir <path>`](/docs/es/permissions#additional-directories-grant-file-access-not-configuration) | Otorgue acceso a archivos a un directorio adicional |684| [`--add-dir <path>`](/docs/es/permissions#additional-directories-grant-file-access-not-configuration) | Otorgue acceso a archivos a un directorio adicional |

556| `--strict-mcp-config` | Use solo los servidores MCP de `--mcp-config`, ignorando otra configuración de MCP |687| `--strict-mcp-config` | Use solo los servidores MCP de `--mcp-config`, ignorando otra configuración de MCP. Consulte [Control exclusivo con managed-mcp.json](/docs/es/managed-mcp#exclusive-control-with-managed-mcp-json) para ver qué hace la bandera bajo un archivo MCP administrado |

688

689Repita `--add-dir`, `--plugin-dir` o `--mcp-config` una vez por valor. `claude agents` no admite la forma separada por espacios, como `--add-dir a b c`.

557 690

558Repita `--add-dir`, `--plugin-dir` o `--mcp-config` una vez por valor. La forma separada por espacios, como `--add-dir a b c`, no es compatible con `claude agents`.691Puede colocar `--settings` y `--plugin-dir` antes o después de `agents`. Mantenga `--add-dir` y `--mcp-config` después de `agents`: si coloca cualquiera de ellos antes de `agents`, [`claude agents --json`](#manage-sessions-from-the-shell) falla con un error `unknown option`.

559 692

560El siguiente ejemplo abre la vista de agentes con una anulación de configuración y un directorio adicional:693El siguiente ejemplo abre la vista de agentes con una anulación de configuración y un directorio adicional:

561 694

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

564```697```

565 698

699`--settings` acepta una ruta de archivo o una cadena JSON en línea. Una ruta de archivo debe apuntar a un archivo existente; Claude Code sale con un error `Settings file not found` si no lo hace.

700

566<h2 id="manage-sessions-from-the-shell">701<h2 id="manage-sessions-from-the-shell">

567 Gestionar sesiones desde el shell702 Gestionar sesiones desde el shell

568</h2>703</h2>

570Cada sesión en segundo plano tiene un ID corto que puede usar desde el shell. El ID se imprime cuando inicia una sesión con `claude --bg`, y el ID de cada sesión es su nombre de directorio bajo `~/.claude/jobs/`. Estos comandos son útiles para scripting o cuando no desea abrir la vista de agentes.705Cada sesión en segundo plano tiene un ID corto que puede usar desde el shell. El ID se imprime cuando inicia una sesión con `claude --bg`, y el ID de cada sesión es su nombre de directorio bajo `~/.claude/jobs/`. Estos comandos son útiles para scripting o cuando no desea abrir la vista de agentes.

571 706

572| Comando | Propósito |707| Comando | Propósito |

573| :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |708| :--------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

576| `claude agents --json` | Imprimir sesiones activas como un array JSON y salir: cada sesión activa, más sesiones en segundo plano que aún están funcionando o bloqueadas incluso cuando su proceso ha salido. Agregue `--all` para incluir también sesiones en segundo plano completadas. Cada entrada tiene `cwd`, `kind` y `startedAt`. Las entradas en segundo plano también tienen `id`, utilizable con `claude attach`/`logs`/`stop`, y `state`: uno de `working`, `blocked`, `done`, `failed` o `stopped`. `pid` y `status` están presentes solo mientras el proceso está activo, más `waitingFor` cuando el estado es `waiting`, que indica en qué está bloqueada la sesión, como `permission prompt` o `input needed`; `sessionId` y `name` aparecen cuando están configurados. Una entrada interactiva que nunca nombró lleva un nombre predeterminado construido a partir del nombre del directorio de trabajo más un sufijo de dos caracteres, como `my-app-3f`. Combinar con `--cwd <path>` para filtrar |711| `claude agents --json` | Imprimir sesiones como un array JSON y salir. Consulte [Listar sesiones como JSON](#list-sessions-as-json) |

580| `claude respawn <id>` | Reiniciar una sesión, en ejecución o detenida, con su conversación intacta, por ejemplo para usar un binario Claude Code actualizado |715| `claude respawn <id>` | Reiniciar una sesión, en ejecución o detenida, por ejemplo para usar un binario Claude Code actualizado. La sesión reiniciada reanuda su conversación guardada; cuando ninguna está en disco, ejecuta su prompt original nuevamente como una nueva conversación |

581| `claude respawn --all` | Reiniciar cada sesión en ejecución, por ejemplo para mover todas las sesiones a un binario Claude Code actualizado a la vez |716| `claude respawn --all` | Reiniciar cada sesión en ejecución, por ejemplo para mover todas las sesiones a un binario Claude Code actualizado a la vez |

582| `claude rm <id>` | Eliminar una sesión de la lista. Elimina un worktree que Claude creó para la sesión si no tiene cambios sin confirmar y sin commits que no estén enviados a ningún lugar; de lo contrario la sesión se mantiene también, y el comando imprime la ruta del worktree y la razón para que pueda resolverlo y ejecutar `claude rm` nuevamente. Deja un worktree que creó usted mismo en su lugar. La transcripción de la conversación permanece en su máquina local y sigue disponible a través de `claude --resume` |717| `claude rm <id>` | Eliminar una sesión de la lista, junto con un worktree que Claude creó para ella cuando es seguro eliminarlo; consulte [Qué elimina la eliminación de una sesión](#what-deleting-a-session-removes). La transcripción de la conversación permanece en su máquina local y sigue disponible a través de `claude --resume` |

583| `claude daemon status` | Imprimir el estado del [supervisor](#the-supervisor-process), versión, directorio de socket y número de workers |718| `claude daemon status` | Imprimir el estado del [supervisor](#the-supervisor-process), versión, directorio de socket y número de workers |

584| `claude daemon stop --any` | Detener el proceso supervisor y las sesiones en segundo plano que aloja. Pase `--keep-workers` para dejar las sesiones en segundo plano en ejecución de modo que el siguiente supervisor se reconecte a ellas. El siguiente `claude agents` o `claude --bg` inicia un nuevo supervisor |719| `claude daemon stop --any` | Detener el proceso supervisor y las sesiones en segundo plano que aloja. Pase `--keep-workers` para dejar las sesiones en segundo plano en ejecución de modo que el siguiente supervisor se reconecte a ellas. El siguiente `claude agents` o `claude --bg` inicia un nuevo supervisor |

585 720

586<h2 id="how-background-sessions-are-hosted">721<h3 id="list-sessions-as-json">

587 Cómo se alojan las sesiones en segundo plano722 Listar sesiones como JSON

588</h2>

~~589~~

590Cada sesión listada en la vista de agentes se considera una sesión en segundo plano, independientemente de si está actualmente conectado a ella. Por el contrario, una sesión iniciada ejecutando `claude` directamente está vinculada a esa terminal y finaliza cuando se cierra, a menos que la [envíe al segundo plano](#from-inside-a-session).

~~591~~

592<h3 id="the-supervisor-process">

593 El proceso supervisor

594</h3>723</h3>

595 724

596Las 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.725`claude agents --json` imprime sesiones activas como un array JSON y sale: cada sesión activa, más sesiones en segundo plano que aún están funcionando o bloqueadas incluso cuando su proceso ha salido. Agregue `--all` para incluir también sesiones en segundo plano completadas, y `--cwd <path>` para limitar la lista a sesiones iniciadas bajo ese directorio.

~~597~~

598Cuando una actualización ha reemplazado o eliminado el binario desde el cual se lanzó un proceso de Claude Code en ejecución, ese proceso inicia el supervisor desde otra copia instalada, como el lanzador `claude` instalado o la versión más nueva en el disco.

~~599~~

600El supervisor mantiene un proceso de trabajo precalentado listo para que un envío desde la vista de agentes o `claude --bg` se inicie sin la demora de un lanzamiento en frío. Cuando envía, el supervisor asigna el trabajador precalentado a su sesión, aplica el directorio, la configuración y las credenciales de esa sesión a él, y luego inicia un reemplazo para el próximo envío. Si no hay un trabajador precalentado saludable disponible, el supervisor lanza un proceso nuevo en su lugar.

~~601~~

602El supervisor y sus sesiones se autentican con las mismas credenciales almacenadas que sus sesiones interactivas y no realizan conexiones de red adicionales más allá de la API del modelo. Las variables de selección de proveedor como `CLAUDE_CODE_USE_BEDROCK` y los alias `ANTHROPIC_DEFAULT_*_MODEL` se leen del shell que envió cada sesión y se aplican a su trabajador.

~~603~~

604El `PATH` del shell de envío se aplica al trabajador de la misma manera, por lo que los comandos de shell que ejecuta la sesión encuentran las mismas herramientas que su terminal. Antes de v2.1.203, una sesión en segundo plano mantenía el `PATH` del shell que inició primero el supervisor, por lo que las herramientas agregadas a su `PATH` desde entonces podrían faltar, más a menudo en Windows.

~~605~~

606Una sesión en segundo plano no hereda variables de punto final de puerta de enlace como `ANTHROPIC_BASE_URL` o las variables de URL base equivalentes de Amazon Bedrock, Google Cloud's Agent Platform y Microsoft Foundry del shell que inició el supervisor. Sin una puerta de enlace exportada en el shell desde el que envía, la sesión utiliza sus credenciales almacenadas y cualquier valor `env` en la [configuración](/docs/es/settings) del directorio del proyecto. Para apuntar cada sesión en un proyecto a una [puerta de enlace LLM](/docs/es/llm-gateway), establezca `ANTHROPIC_BASE_URL` en el bloque `env` de `settings.json` de ese proyecto en `.claude/`.

~~607~~

608Si exporta una puerta de enlace `ANTHROPIC_BASE_URL` en el shell desde el que envía, llega al trabajador de esa sesión. `ANTHROPIC_CUSTOM_HEADERS` y la credencial exportada junto a ellos se reenvían con él. Esto sucede cuando el supervisor se inició desde un entorno con la misma puerta de enlace. El supervisor captura su entorno desde el primer shell que abre la vista de agentes o envía una sesión en segundo plano, por lo que comenzar desde el shell de la puerta de enlace le da ese entorno. El reenvío también se aplica solo a las sesiones enviadas al directorio desde el que está enviando, o enviadas al segundo plano desde su propia sesión con `←` o `/background`: enviar a un directorio diferente con `@repo` o `--cwd` no lleva la puerta de enlace del shell, y el bloque `env` de `settings.json` de ese proyecto proporciona el punto final en su lugar. Cuando el entorno del supervisor lleva una puerta de enlace diferente o ninguna, el trabajador mantiene sus credenciales almacenadas contra el punto final predeterminado en lugar de mezclar la credencial de un entorno con el punto final de otro. Antes de v2.1.203, el `ANTHROPIC_BASE_URL` del shell de envío se descartaba mientras que el `ANTHROPIC_API_KEY` exportado junto a él se mantenía, por lo que la clave de la puerta de enlace se enviaba al punto final predeterminado y cada solicitud fallaba con un 401.

~~609~~

610El punto final reenviado se aplica solo a ese proceso activo y nunca se escribe en el disco. Cuando el supervisor detiene una sesión inactiva y luego la reinicia, el proceso reiniciado lee su punto final desde su configuración nuevamente: con un `ANTHROPIC_AUTH_TOKEN` de puerta de enlace vuelve a sus credenciales almacenadas, y con un `ANTHROPIC_API_KEY` emitido por la puerta de enlace puede fallar al autenticarse hasta que la puerta de enlace se establezca en la configuración.

~~611~~

612Cada sesión en segundo plano es su propio proceso de Claude Code, administrado por el supervisor en lugar de estar vinculado a su terminal. Una sesión que está funcionando activamente, esperando su entrada o tiene una terminal conectada mantiene su proceso ejecutándose. Un comando de shell en segundo plano en ejecución, subagente, flujo de trabajo dinámico o monitor cuenta como trabajo activo, por lo que un proceso de larga duración como un servidor de desarrollo mantiene la sesión activa.

~~613~~

614Una vez que una sesión finaliza y permanece sin conectar durante aproximadamente una hora, el supervisor detiene su proceso para liberar recursos. Una sesión que ha [fijado](#organize-the-list) con `Ctrl+T` está exenta y mantiene su proceso ejecutándose mientras está inactiva. La transcripción y el estado permanecen en el disco de cualquier forma, y la próxima vez que se conecte, eche un vistazo o responda a una sesión detenida, el supervisor inicia un proceso nuevo desde donde se quedó. Cuando cada sesión ha finalizado y no hay terminal conectada, el supervisor mismo sale e inicia nuevamente la próxima vez que lo necesite.

~~615~~

616El trabajo en segundo plano que la sesión inició en el nivel superior se entrega cuando su proceso se detiene, se reinicia o se actualiza, incluso en Windows. El siguiente proceso iniciado para esa sesión lo recoge:

617 726

618* Un comando de shell en segundo plano que terminó en el ínterin se reporta como completado con su salida727Cada entrada describe una sesión:

619* Un flujo de trabajo dinámico se reanuda desde donde se quedó

620* Un [subagente en segundo plano](/docs/es/sub-agents#run-subagents-in-foreground-or-background) se reanuda desde su propia transcripción

621 728

622A partir de v2.1.198 la entrega cubre los tres. Antes de v2.1.198 cubría solo comandos de shell y flujos de trabajo, por lo que un subagente en segundo plano se detenía con el proceso y se reportaba como fallido en el próximo despertar.729| Campo | Presente | Descripción |

730| :------------------------- | :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

731| `cwd`, `kind`, `startedAt` | Siempre | El directorio de trabajo, `interactive` o `background`, y la hora de inicio en milisegundos Unix |

732| `id` | Sesiones en segundo plano | ID corto, utilizable con `claude attach`, `claude logs` y `claude stop` |

733| `state` | Sesiones en segundo plano | Uno de `working`, `blocked`, `done`, `failed` o `stopped` |

734| `pid`, `status` | Mientras el proceso está activo | ID del proceso y estado actual |

735| `waitingFor` | Cuando `status` es `waiting` | En qué está bloqueada la sesión: `permission prompt` para una aprobación, `input needed` para una pregunta de Claude o una solicitud de entrada de un servidor MCP, `sandbox request`, `worker request` o `dialog open` |

736| `sessionId`, `name` | Cuando está configurado | `sessionId` es el UUID de sesión completo, utilizable con [`claude --resume`](/docs/es/sessions). El `name` de una sesión interactiva es su [nombre de visualización predeterminado](/docs/es/sessions#name-your-sessions) hasta que nombre la sesión o acepte un plan en ella |

623 737

624El trabajo cuyo estado vive solo dentro del proceso mismo se detiene con él en lugar de ser entregado. Eso son comandos de shell que un subagente inició, que el subagente reanudado puede iniciar nuevamente, y [monitores](/docs/es/tools-reference#monitor-tool) en ejecución, cuya secuencia de eventos no se puede mover a otro proceso.738<h2 id="how-background-sessions-are-hosted">

~~625~~ 739 Cómo se alojan las sesiones en segundo plano

626Eliminar la sesión detiene todo lo que entregó. Para detener todo el trabajo en segundo plano de la sesión con el proceso en lugar de entregarlo, establezca la variable de entorno [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/es/env-vars#variables) en `1`.740</h2>

627 741

628Un proceso reiniciado encuentra la conversación de una sesión que [se movió a un worktree](#how-file-edits-are-isolated) a mitad de la tarea: cuando la transcripción no está donde la sesión comenzó, Claude Code también busca bajo los worktrees registrados del repositorio. Antes de v2.1.207, reabriendo esa sesión desde la vista de agentes después de que su proceso se había detenido podría mostrar una conversación vacía con solo su mensaje original, con la transcripción aún intacta en el disco; abrir la sesión nuevamente en v2.1.207 o posterior la recupera.742Claude Code trata cada sesión listada en la vista de agentes como una sesión en segundo plano, independientemente de si está actualmente conectado a ella. Por el contrario, una sesión iniciada ejecutando `claude` directamente está vinculada a esa terminal y finaliza cuando se cierra, a menos que la [envíe al segundo plano](#from-inside-a-session).

629 743

630Si una sesión reiniciada vuelve mostrando solo su mensaje original porque Claude Code malinterpretó su transcripción como vacía, la transcripción de conversación se renombra con un sufijo `.orphaned-` en lugar de eliminarse, por lo que permanece en su máquina.744Para verificar qué tipo de sesión está usando, ejecute [`/status`](/docs/es/commands). La fila `Session kind` muestra `background job · attached` o `background job · unattended` en una sesión en segundo plano, dependiendo de si una terminal está conectada, e `interactive` en cualquier otra sesión.

631 745

632Una fila vacía dejada por presionar `←` que nunca recibió un mensaje se elimina completamente después de aproximadamente cinco minutos para que la lista se limpie por sí sola. Las sesiones iniciadas con `claude --bg` y las sesiones que esperan un mensaje de configuración como un diálogo de confianza no se eliminan de esta manera.746<h3 id="the-supervisor-process">

747 El proceso supervisor

748</h3>

633 749

634Cuando el host tiene poca memoria, el supervisor detiene primero las sesiones inactivas no fijadas y detiene las fijadas inactivas solo si eso no liberó nada.750El supervisor es un servicio en segundo plano que ejecuta sus sesiones en segundo plano para que sigan funcionando después de cerrar la vista de agentes o su terminal. Claude Code lo inicia la primera vez que envía una sesión al segundo plano o abre la vista de agentes, y no necesita administrarlo usted mismo.

635 751

636El 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](/docs/es/setup#auto-updates) 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. Una sesión fijada inactiva también se reinicia en su lugar en la nueva versión para que recoja la actualización sin que usted se reconecte.752Cada sesión es su propio proceso de Claude Code bajo el supervisor, y lo que sucede con ese proceso depende del estado de la sesión:

637 753

638Una vez que el nuevo supervisor toma el control, también reinicia las sesiones inactivas restantes en la nueva versión, algunas a la vez en segundo plano, después de un breve retraso que permite que las terminales conectadas durante el reinicio se reconecten primero. Una sesión que está funcionando, esperando su entrada o tiene una terminal conectada no se interrumpe; se mueve a la nueva versión la próxima vez que su proceso se reinicia. Antes de v2.1.206, el supervisor movía solo algunas sesiones inactivas por minuto a una nueva versión, por lo que las sesiones podrían seguir ejecutando la antigua durante un tiempo después de una actualización.754* **Funcionando, esperando su entrada o conectado**: el proceso sigue ejecutándose. Un subagente, flujo de trabajo o monitor en ejecución cuenta como funcionando.

755* **Finalizado y sin conectar durante aproximadamente una hora**: el supervisor detiene el proceso para liberar recursos. La conversación permanece en el disco, y la próxima vez que se conecte o responda, la sesión se reanuda donde se quedó. Fije una sesión con `Ctrl+T` para mantener su proceso ejecutándose mientras está inactiva.

756* **Salió inesperadamente mientras el supervisor está ejecutándose**: el supervisor reinicia el proceso. Finalizar una sesión que envió al segundo plano usted mismo con `←` o `/background`, por ejemplo con `kill`, la marca como detenida en lugar de reiniciarla. Para sesiones que finalizaron con un apagado, consulte [Las sesiones se muestran como fallidas o detenidas después del apagado](#sessions-show-as-failed-after-shutdown).

757* **Después de una actualización automática**: el supervisor se reinicia en la nueva versión y mueve las sesiones inactivas al segundo plano. Las sesiones que están funcionando, esperando su entrada o conectadas no se interrumpen.

639 758

640Estos reinicios solo mueven una sesión a una versión más nueva. Un supervisor que ejecuta una versión anterior de Claude Code que la que se inició el proceso de la sesión deja ese proceso solo; la sesión sigue ejecutando la versión más nueva hasta que un supervisor más nuevo toma el control.759Cuando el proceso de una sesión se detiene o se reinicia, los comandos de shell en segundo plano, los flujos de trabajo dinámicos y los subagentes en segundo plano que Claude inició en ella se transfieren al siguiente proceso; los monitores en ejecución y los comandos de shell que un subagente inició se detienen con el proceso. Eliminar la sesión detiene todo lo que se transfirió. Para detener todo con el proceso en lugar de transferirlo, establezca [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/es/env-vars#variables) en `1`.

641 760

642Ejecutar `claude attach` mientras el supervisor está reiniciando una sesión, ya sea para una actualización, un estancamiento o una migración, espera el proceso de reemplazo en lugar de fallar. Una línea de estado como `Agent is updating to the new Claude Code…` nombra lo que está esperando y cuenta los segundos transcurridos, y el comando se conecta tan pronto como la sesión esté lista. Después de aproximadamente 60 segundos deja de esperar e informa un error. Antes de v2.1.205, `claude attach` dejaba de reintentar después de unos pocos segundos e imprimía un error mientras la sesión aún se estaba reiniciando.761El supervisor y sus sesiones se autentican con las mismas credenciales almacenadas que sus sesiones interactivas. Para saber qué configuraciones y variables de shell llegan a una sesión, incluido `PATH`, consulte [Configuración y proveedor](#settings-and-provider). Para puntos finales de puerta de enlace, consulte [Puerta de enlace LLM](#llm-gateway).

643 762

644<h3 id="where-state-is-stored">763<h3 id="where-state-is-stored">

645 Dónde se almacena el estado764 Dónde se almacena el estado

660 779

661El comando también advierte cuando el supervisor en ejecución está en una versión diferente a la de `claude` que invocó, lo que sucede después de una actualización en la que el supervisor aún no se ha reiniciado. La advertencia muestra ambas versiones y le indica que ejecute `claude daemon stop --any` para adoptar la nueva versión. Cuando Claude Code se instala como un servicio del sistema operativo, el comando sugerido es `claude daemon stop` sin la bandera.780El comando también advierte cuando el supervisor en ejecución está en una versión diferente a la de `claude` que invocó, lo que sucede después de una actualización en la que el supervisor aún no se ha reiniciado. La advertencia muestra ambas versiones y le indica que ejecute `claude daemon stop --any` para adoptar la nueva versión. Cuando Claude Code se instala como un servicio del sistema operativo, el comando sugerido es `claude daemon stop` sin la bandera.

662 781

663Las sesiones sobreviven a ese desajuste de versión intactas: una versión anterior de Claude Code que actualiza el `state.json` de una sesión preserva campos que no reconoce y mantiene la sesión listada. La lista de sesiones en `roster.json` sigue la misma regla: una versión anterior que la reescribe preserva campos que una versión más nueva escribió, por lo que las sesiones iniciadas por la versión más nueva permanecen accesibles y continúan aceptando entrada después de que el supervisor se reinicia. Antes de v2.1.200, las versiones anteriores podrían descartar esos campos al reescribir.782Las sesiones sobreviven a ese desajuste de versión intactas: una versión anterior de Claude Code que actualiza el `state.json` de una sesión preserva campos que no reconoce y mantiene la sesión listada. La lista de sesiones en `roster.json` sigue la misma regla, por lo que las sesiones iniciadas por la versión más nueva permanecen accesibles y continúan aceptando entrada después de que el supervisor se reinicia.

~~664~~

665En Windows, `claude daemon status` expone el error de archivo subyacente cuando el archivo de clave de tubería del daemon está bloqueado o no es legible en lugar de informar una falla de conexión genérica.

666 783

667<h3 id="turn-off-agent-view">784<h3 id="turn-off-agent-view">

668 Desactivar la vista de agentes785 Desactivar la vista de agentes

669</h3>786</h3>

670 787

671Para desactivar completamente los agentes en segundo plano y la vista de agentes, establezca la configuración `disableAgentView` [setting](/docs/es/settings) en `true` o establezca la variable de entorno `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Los administradores pueden aplicar esto a través de [configuraciones administradas](/docs/es/permissions#managed-settings).788Para desactivar completamente los agentes en segundo plano y la vista de agentes, establezca la configuración `disableAgentView` [setting](/docs/es/settings) en `true` o establezca la variable de entorno `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Los administradores pueden aplicar esto a través de [configuraciones administradas](/docs/es/managed-settings).

672 789

673<h2 id="troubleshooting">790<h2 id="troubleshooting">

674 Solución de problemas791 Solución de problemas

692 Backgrounding muestra un diálogo `Background this session?`809 Backgrounding muestra un diálogo `Background this session?`

693</h3>810</h3>

694 811

695Si presionar `←` para enviar al segundo plano la sesión actual muestra un diálogo `Background this session?`, la sesión tiene trabajo en vuelo que no puede trasladarse a la sesión en segundo plano, como un [monitor](/docs/es/tools-reference#monitor-tool) en ejecución, y Claude Code no lo detendrá silenciosamente. El diálogo nombra el trabajo que se detendrá y, por separado, cuenta las tareas que se trasladan. Ejecute `/tasks` para ver todo lo que se está ejecutando, luego confirme para enviar al segundo plano de todas formas o elija `Stay` para dejar que el trabajo termine primero. Consulte [Desde dentro de una sesión](#from-inside-a-session) para saber qué tipos de tareas se trasladan y cuáles se detienen.812Si presiona `←` para enviar al segundo plano la sesión actual y Claude Code muestra un diálogo `Background this session?`, la sesión tiene trabajo en vuelo que el backgrounding detendría, reiniciaría o dejaría ejecutándose desatendido, y Claude Code pregunta antes de hacer cualquiera de esos:

813

814* **Trabajo que no se puede mover**: la sesión tiene trabajo que no se puede mover a la sesión en segundo plano, como un [monitor](/docs/es/tools-reference#monitor-tool) en ejecución. El diálogo nombra el trabajo que Claude Code detendría y, por separado, cuenta las tareas que se trasladan.

815* **Un flujo de trabajo con subagentes en ejecución**: un [flujo de trabajo dinámico](/docs/es/workflows) aún tiene subagentes en ejecución. El flujo de trabajo en sí se traslada, pero sus subagentes en ejecución se reinician desde el principio, y el diálogo dice cuántos.

816* **Respuestas automáticas de artefactos**: Claude está [respondiendo a comentarios en un artefacto por su cuenta](/docs/es/artifacts#let-claude-reply-to-comments-on-its-own). Esas respuestas continúan en la sesión en segundo plano, y el diálogo lo dice.

817

818Ejecute `/tasks` para ver todo lo que se está ejecutando, luego confirme para enviar al segundo plano de todas formas o elija `Stay` para dejar que el trabajo termine primero. Consulte [Qué se traslada cuando envía al segundo plano](#what-carries-over-when-you-background) para saber qué tipos de trabajo se trasladan y cuáles Claude Code detiene.

696 819

697<h3 id="prompt-rejected-as-too-short">820<h3 id="prompt-rejected-as-too-short">

698 Mensaje rechazado por ser demasiado corto821 Mensaje rechazado por ser demasiado corto

701La entrada de distribución espera una descripción de tarea, no un abridor conversacional. Un mensaje más corto de cuatro caracteres se rechaza con una sugerencia `Too short` para que una pulsación de tecla extraviada no inicie una sesión. Describa lo que desea que haga la sesión, como `investigate the flaky checkout test`.824La entrada de distribución espera una descripción de tarea, no un abridor conversacional. Un mensaje más corto de cuatro caracteres se rechaza con una sugerencia `Too short` para que una pulsación de tecla extraviada no inicie una sesión. Describa lo que desea que haga la sesión, como `investigate the flaky checkout test`.

702 825

703<h3 id="sessions-show-as-failed-after-shutdown">826<h3 id="sessions-show-as-failed-after-shutdown">

704 Las sesiones se muestran como fallidas después del apagado827 Las sesiones se muestran como fallidas o detenidas después del apagado

705</h3>828</h3>

706 829

707Apagar o reiniciar su máquina detiene las sesiones en segundo plano en ejecución, por lo que se muestran como fallidas cuando abre la vista de agentes la próxima vez. Conéctese, eche un vistazo o responda a cualquiera de ellas y la sesión se reiniciará desde donde se quedó.830Apagar o reiniciar su máquina detiene las sesiones en segundo plano en ejecución. Una sesión que estaba esperando su entrada permanece bajo `Needs input` cuando regresa. Para cualquier otra sesión en ejecución, lo que muestra la vista de agentes depende de cuánto tiempo hace que hizo progreso por última vez:

831

832* Dentro de 48 horas, la sesión se muestra como fallida. Conéctese, eche un vistazo o responda a ella y se reiniciará desde donde se quedó.

833* Pasadas 48 horas, como después de que la máquina estuvo apagada durante días, la sesión se muestra como detenida con `ended while the background service was off`. Presione `Enter` en la fila y el pie de página muestra `Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it.` Presione `Enter` en la misma fila nuevamente para reanudar su conversación guardada. Una respuesta, o `claude attach <id>`, la reanuda sin ese mensaje de pie de página.

834

835Cuando la [limpieza de transcripción](/docs/es/settings-reference#cleanupperioddays) ha eliminado la conversación guardada de una sesión detenida, Claude Code se niega a abrir la fila: el mensaje dice que no hay nada que reanudar. `claude rm <id>` elimina la fila, excepto en los [casos mantenidos](#what-deleting-a-session-removes) descritos anteriormente, y `claude respawn <id>` ejecuta su mensaje original nuevamente. Consulte [La conversación guardada de esta sesión ya no está en el disco](/docs/es/errors#this-sessions-saved-conversation-is-no-longer-on-disk).

708 836

709El sueño solo no causa esto. Las sesiones se conservan durante el sueño y el supervisor se reconecta a ellas al despertar.837El sueño solo no detiene las sesiones. Las sesiones se conservan durante el sueño y el supervisor se reconecta a ellas al despertar.

710 838

711<h3 id="opening-a-session-says-the-conversation-is-already-open">839<h3 id="opening-a-session-says-the-conversation-is-already-open">

712 Abrir una sesión dice que la conversación ya está abierta840 Abrir una sesión dice que la conversación ya está abierta

713</h3>841</h3>

714 842

715Abrir una fila detenida cuya conversación también está siendo mantenida abierta por otro proceso Claude Code interactivo en ejecución, por ejemplo un worker en segundo plano para la misma conversación que aún se está cerrando, muestra `This conversation is already open in another running Claude session` en lugar de iniciar el proceso de la fila, porque dos procesos no pueden escribir en la misma transcripción. Responda en la sesión que ya tiene la conversación abierta, o salga de ella y abra la fila nuevamente. Una respuesta que escribió con el intento rechazado no se pierde; se envía la próxima vez que se inicia la sesión.843Dos procesos no pueden escribir en la misma transcripción. Cuando la conversación guardada de una sesión detenida ya está abierta en otro proceso Claude Code en vivo, Claude Code se niega a iniciar el proceso de la sesión. Lo que ve depende de lo que mantenga la conversación:

844

845* Una terminal donde reanudó la conversación, por ejemplo con `claude --resume` o `/resume`: la fila muestra `Open in a terminal` con una sugerencia para continuarla allí, y abrir la fila muestra `Can't open — this session is running in another terminal`. Continúe en esa terminal, o salga de ella y abra la fila nuevamente.

846* Otro proceso Claude Code no interactivo, por ejemplo un proceso de sesión en segundo plano para la misma conversación que aún no ha salido: abrir la fila muestra `This conversation is already open in another running Claude session`. Use ese proceso, o espere a que salga y abra la fila nuevamente.

847

848Claude Code guarda una respuesta que escribió con el intento rechazado y la envía la próxima vez que se inicia la sesión.

849

850<h3 id="opening-a-session-says-it-has-no-saved-transcript">

851 Abrir una sesión dice que no tiene transcripción guardada

852</h3>

853

854Una sesión detenida que fue [enviada al segundo plano desde otra conversación](#from-inside-a-session) y se detuvo antes de que su primera respuesta terminara no tiene nada que reanudar: hasta que esa primera respuesta termine, la conversación aún vive solo en la sesión desde la que fue enviada al segundo plano. `claude attach` se niega a abrirla con `This session has no saved transcript`.

855

856En la vista de agentes, abrir esa fila muestra `Press enter again to restart this session fresh` debajo de la lista. Presione `Enter` en la misma fila nuevamente para reiniciar la sesión con una conversación vacía, o ejecute `claude respawn <id>` desde el shell.

857

858La conversación original está intacta; reanúdela con `claude --resume` o continúe trabajando en ella. Consulte la [referencia de errores](/docs/es/errors#this-session-has-no-saved-transcript) para obtener detalles.

859

860<h3 id="the-terminal-host-died-or-the-session-stopped-responding">

861 El host de terminal murió o la sesión dejó de responder

862</h3>

863

864El [supervisor](#the-supervisor-process) ejecuta la terminal de cada sesión en segundo plano en su propio proceso host. Cuando ese proceso muere o deja de responder, Claude Code muestra la razón y ofrece un reinicio; en ambos casos la conversación se guarda y el reinicio la reanuda. La [referencia de errores](/docs/es/errors#terminal-host-process-died) cita los mensajes completos.

865

866Claude Code nunca reinicia una fila que ejecuta un [comando shell](#run-a-shell-command), desde `Enter` o desde `claude attach`, porque eso ejecutaría el comando nuevamente; el mensaje de la fila y `claude attach` ambos dicen que el comando no se ejecuta nuevamente.

867

868<h4 id="terminal-host-died">

869 Terminal host murió

870</h4>

871

872En Linux y WSL, el supervisor verifica cada proceso host cada pocos segundos, independientemente de si abre la sesión o no, y marca la sesión como fallida cuando el proceso ha salido pero su conexión al supervisor nunca se cerró.

873

874* En la vista de agentes, la fila muestra `terminal host process died — press Enter to restart`. Presione `Enter` en ella y Claude Code reinicia la sesión en un proceso host nuevo.

875* Desde el shell, `claude attach <id>` reinicia una sesión ya marcada como fallida. De lo contrario, reporta la causa y sale, diciéndole que ejecute `claude attach <id>` nuevamente.

876

877<h4 id="session-isn’t-responding">

878 La sesión no está respondiendo

879</h4>

880

881Cuando el supervisor acepta una apertura pero no llega salida durante aproximadamente diez segundos, Claude Code termina el intento y ofrece un reinicio. Una sesión que simplemente se estancó, por ejemplo durante el sueño de la máquina, no llega a esta oferta: el supervisor la [reinicia al abrir](#read-session-state) por sí solo.

716 882

717Antes de v2.1.203, este estado iniciaba un segundo proceso de todas formas. Ese proceso salía con un error `currently running as a background agent` y la fila se mostraba como fallida.883* En la vista de agentes, el pie de página muestra `Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).` Presione `Enter` en la misma fila nuevamente y Claude Code detiene el proceso que no responde y reinicia la sesión; no detiene nada sin ese segundo press.

884* Desde el shell, `claude attach <id>` reporta la causa y sale, diciéndole que ejecute `claude stop <id>`, luego `claude attach <id>`.

718 885

719<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">886<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">

720 Una sesión falla antes de iniciarse con una nota `possibly low memory`887 Una sesión falla antes de iniciarse con una nota `possibly low memory`

721</h3>888</h3>

722 889

723A partir de v2.1.199, cuando el proceso de una sesión en segundo plano sale antes de terminar de iniciarse y el host tiene poca memoria, el estado de la fila nombra la salida y añade `possibly low memory — free some up and retry`. Las versiones anteriores mostraban solo la razón de salida desnuda para este fallo.890Cuando el proceso de una sesión en segundo plano sale antes de terminar de iniciarse y el host tiene poca memoria, el estado de la fila nombra la salida y añade `possibly low memory — free some up and retry`.

724 891

725La nota es una hipótesis, no una causa confirmada. Claude Code la añade solo cuando el proceso salió silenciosamente, sin escribir un error y sin ser detenido por una señal, y el host reportó poca memoria en ese momento. Cuando el proceso escribió un error antes de salir, la fila muestra ese error en su lugar.892La nota es una hipótesis, no una causa confirmada. Claude Code la añade solo cuando el proceso salió silenciosamente, sin escribir un error y sin ser detenido por una señal, y el host reportó poca memoria en ese momento. Cuando el proceso escribió un error antes de salir, la fila muestra ese error en su lugar.

726 893

727Libere memoria en la máquina, luego conéctese, eche un vistazo o responda a la fila y el supervisor inicia un proceso nuevo para la sesión. Cuando la memoria se mantiene baja, el supervisor también [detiene las sesiones inactivas](#the-supervisor-process) para liberar recursos por su cuenta.894Libere memoria en la máquina, luego conéctese, eche un vistazo o responda a la fila y el supervisor inicia un proceso nuevo para la sesión. Cuando la memoria se mantiene baja, el supervisor también [detiene las sesiones inactivas](#the-supervisor-process) para liberar recursos por su cuenta, y detiene las sesiones fijadas inactivas también si detener las otras no liberó nada.

728 895

729<h3 id="agent-view-says-the-background-service-did-not-respond">896<h3 id="agent-view-says-the-background-service-did-not-respond">

730 La vista de agentes dice que el servicio en segundo plano no respondió897 La vista de agentes dice que el servicio en segundo plano no respondió

740 907

741Un supervisor que se inicia pero no puede aceptar conexiones sale y libera su bloqueo por sí solo, por lo que el siguiente `claude agents` inicia uno nuevo sin este detención manual. Los pasos anteriores se aplican cuando un supervisor en ejecución se estanca.908Un supervisor que se inicia pero no puede aceptar conexiones sale y libera su bloqueo por sí solo, por lo que el siguiente `claude agents` inicia uno nuevo sin este detención manual. Los pasos anteriores se aplican cuando un supervisor en ejecución se estanca.

742 909

910Si el comando en su lugar sale diciendo que el proceso registrado no pudo verificarse como el supervisor, verifique el ID de proceso reportado: si es un supervisor que posee, deténgalo usted mismo, luego elimine `~/.claude/daemon.lock` para que el siguiente `claude agents` inicie nuevo.

911

743En Windows, si el supervisor no responde a la solicitud de detención, el comando imprime su ID de proceso. Termine ese proceso con `taskkill /PID <pid>` para finalizar la recuperación. Las sesiones en segundo plano aún se conservan cuando pasó `--keep-workers`.912En Windows, si el supervisor no responde a la solicitud de detención, el comando imprime su ID de proceso. Termine ese proceso con `taskkill /PID <pid>` para finalizar la recuperación. Las sesiones en segundo plano aún se conservan cuando pasó `--keep-workers`.

744 913

745<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">914<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">

746 La distribución falla con `Could not resolve authentication method`915 La distribución falla con `Could not resolve authentication method`

747</h3>916</h3>

748 917

749Si una distribución en segundo plano falla con `Could not resolve authentication method` mientras las sesiones interactivas se autentican normalmente, el worker que recibió la distribución no recogió las credenciales. El supervisor proporciona una instantánea de credencial nueva cuando asigna un [worker precalentado](#the-supervisor-process), por lo que este error significa que no había credencial almacenada disponible para el proceso supervisor en sí. Confirme que ha ejecutado `/login` o ha configurado una clave API, luego detenga el supervisor:918Si una distribución en segundo plano falla con `Could not resolve authentication method` mientras las sesiones interactivas se autentican normalmente, el worker que recibió la distribución no recogió las credenciales. Las sesiones en segundo plano obtienen sus credenciales del [supervisor](#the-supervisor-process), por lo que este error significa que no había credencial almacenada disponible para el proceso supervisor en sí. Confirme que ha ejecutado `/login` o ha configurado una clave API, luego detenga el supervisor:

750 919

751```bash theme={null}920```bash theme={null}

752claude daemon stop --any --keep-workers921claude daemon stop --any --keep-workers

754 923

755El siguiente `claude agents` o `claude --bg` inicia un supervisor nuevo que lee sus credenciales almacenadas. Si se autentica con una variable de entorno como `ANTHROPIC_API_KEY` en lugar de `/login`, ejecute ese comando siguiente desde un shell donde la variable esté configurada.924El siguiente `claude agents` o `claude --bg` inicia un supervisor nuevo que lee sus credenciales almacenadas. Si se autentica con una variable de entorno como `ANTHROPIC_API_KEY` en lugar de `/login`, ejecute ese comando siguiente desde un shell donde la variable esté configurada.

756 925

757Vea la [referencia de errores](/docs/es/errors#could-not-resolve-authentication-method) para la lista completa de causas y soluciones.926Consulte la [referencia de errores](/docs/es/errors#could-not-resolve-authentication-method) para la lista completa de causas y soluciones.

758 927

759<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">928<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">

760 Las sesiones en segundo plano no pueden leer Desktop, Documents o Downloads en macOS929 Las sesiones en segundo plano no pueden leer Desktop, Documents o Downloads en macOS

768 Las sesiones en segundo plano no pueden alcanzar hosts de red local en macOS937 Las sesiones en segundo plano no pueden alcanzar hosts de red local en macOS

769</h3>938</h3>

770 939

771En macOS 15 y posterior, el sistema bloquea un proceso para que no alcance dispositivos en su red local hasta que otorgue permiso de Red Local. Antes de v2.1.198, el host de sesión en segundo plano nunca solicitó ese permiso, por lo que los comandos dirigidos a una dirección LAN fallaban con `connect: no route to host` aunque el mismo comando funcionaba en una terminal en primer plano. A partir de v2.1.198, el primer comando en una sesión en segundo plano que se conecta a una dirección de red local activa la solicitud de permiso de Red Local de macOS para Claude Code. Otórguelo una vez y esos comandos alcanzarán hosts LAN de la misma manera que lo hacen en una terminal en primer plano.940En macOS 15 y posterior, el sistema bloquea un proceso para que no alcance dispositivos en su red local hasta que otorgue permiso de Red Local, por lo que un comando dirigido a una dirección LAN puede fallar con `connect: no route to host` en una sesión en segundo plano aunque funcione en una terminal en primer plano. El primer comando en una sesión en segundo plano que se conecta a una dirección de red local activa la solicitud de permiso de Red Local de macOS para Claude Code. Otórguelo una vez y esos comandos alcanzarán hosts LAN de la misma manera que lo hacen en una terminal en primer plano.

772 941

773<h3 id="a-session-is-slow-to-respond-after-attaching">942<h3 id="a-session-is-slow-to-respond-after-attaching">

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

776 945

777Una 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ó y cambia a la sesión inmediatamente mientras el proceso se reinicia. Las sesiones que están funcionando, esperando su entrada o [fijadas](#organize-the-list) no se detienen de esta manera, así que fije una sesión con `Ctrl+T` para mantenerla receptiva.946Una 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ó y cambia a la sesión inmediatamente mientras el proceso se reinicia. Las sesiones que están funcionando, esperando su entrada o [fijadas](#organize-the-list) no se detienen de esta manera, así que fije una sesión con `Ctrl+T` para mantenerla receptiva.

778 947

779Mientras el proceso se inicia, se muestra la última pantalla de la transcripción de la sesión con una nota `Session is starting` debajo, y la sesión en vivo la reemplaza tan pronto como esté lista.948Mientras el proceso se inicia, Claude Code muestra la cola de la transcripción de la sesión formateada de la manera que la sesión en vivo la renderiza, con markdown, bloques de código resaltados y llamadas de herramientas como filas atenuadas, encima de un área de mensaje atenuada con una nota `Session is starting`. La sesión en vivo la reemplaza tan pronto como esté lista.

780 949

781<h3 id="claude/worktrees/-is-filling-up">950<h3 id="claude/worktrees/-is-filling-up">

782 `.claude/worktrees/` se está llenando951 `.claude/worktrees/` se está llenando

783</h3>952</h3>

784 953

785Eliminar una sesión en la vista de agentes elimina el worktree que Claude creó para ella, y un worktree que no se puede eliminar de forma segura [mantiene su fila de sesión](#organize-the-list) para que no quede huérfano. `claude rm` mantiene un worktree que tiene cambios sin confirmar, y su fila de sesión, e imprime la ruta mantenida. 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](/docs/es/worktrees#clean-up-worktrees).954Eliminar una sesión en la vista de agentes elimina el worktree que Claude creó para ella, pero [algunos deletes mantienen el worktree o dejan su directorio en el disco](#what-deleting-a-session-removes), por lo que los directorios sobrantes pueden acumularse. Los directorios que git ya no reconoce no aparecen en `git worktree list`, así que elimine esos a mano.

955

956Enumere las entradas sobrantes con `git worktree list` en el directorio del proyecto y elimine cada una con `git worktree remove <path>`. Consulte [Limpiar worktrees](/docs/es/worktrees#clean-up-worktrees).

786 957

787<h2 id="limitations">958<h2 id="limitations">

788 Limitaciones959 Limitaciones

792 963

793* **Se aplican límites de velocidad**: las sesiones en segundo plano consumen el uso de su suscripción igual que las sesiones interactivas, por lo que ejecutar diez agentes en paralelo usa cuota aproximadamente diez veces más rápido que ejecutar uno.964* **Se aplican límites de velocidad**: las sesiones en segundo plano consumen el uso de su suscripción igual que las sesiones interactivas, por lo que ejecutar diez agentes en paralelo usa cuota aproximadamente diez veces más rápido que ejecutar uno.

794* **Las sesiones son locales**: las sesiones en segundo plano se ejecutan en su máquina. Se conservan durante el modo de suspensión pero se detienen si la máquina se apaga.965* **Las sesiones son locales**: las sesiones en segundo plano se ejecutan en su máquina. Se conservan durante el modo de suspensión pero se detienen si la máquina se apaga.

795* **Los worktrees creados por Claude se eliminan con la sesión en la vista de agentes**: confirme los cambios antes de eliminar una sesión que editó archivos en su propio worktree. Un worktree con confirmaciones que no se han enviado a ningún lugar se mantiene junto con la sesión. `claude rm` también mantiene un worktree que tiene cambios sin confirmar junto con su sesión, y un worktree que usted creó se deja en su lugar.966* **Los worktrees creados por Claude se eliminan con la sesión en la vista de agentes**: confirme los cambios antes de eliminar una sesión que editó archivos en su propio worktree. [Algunos borrados mantienen el worktree en su lugar](#what-deleting-a-session-removes).

796 967

797<h2 id="related-resources">968<h2 id="related-resources">

798 Recursos relacionados969 Recursos relacionados

799</h2>970</h2>

800 971

801Para otras formas de ejecutar Claude en paralelo, consulte:972Para otras formas de ejecutar Claude en paralelo, y para pasar hallazgos entre las sesiones que ejecuta, consulte:

802 973

803* [Ejecutar agentes en paralelo](/docs/es/agents): compare la vista de agentes con subagentes, equipos de agentes y worktrees974* [Ejecutar agentes en paralelo](/docs/es/agents): compare la vista de agentes con subagentes, equipos de agentes y worktrees

975* [Mensajería entre sesiones](/docs/es/cross-session-messaging): haga que sus sesiones se pasen hallazgos entre sí

804* [Equipos de agentes](/docs/es/agent-teams): coordine múltiples sesiones que se envíen mensajes entre sí976* [Equipos de agentes](/docs/es/agent-teams): coordine múltiples sesiones que se envíen mensajes entre sí

805* [Claude Code en la web](/docs/es/claude-code-on-the-web): ejecute sesiones en un entorno en la nube administrado en lugar de localmente977* [Claude Code en la web](/docs/es/claude-code-on-the-web): ejecute sesiones en un entorno en la nube administrado en lugar de localmente

806 978

811La vista de agentes ha evolucionado rápidamente durante la vista previa de investigación. Si está en una versión anterior de Claude Code, algunos comportamientos en esta página pueden diferir; en particular, `claude agents` rechaza banderas que aún no admite con un error `unknown option`. La tabla a continuación enumera cuándo se agregó cada bandera y comportamiento.983La vista de agentes ha evolucionado rápidamente durante la vista previa de investigación. Si está en una versión anterior de Claude Code, algunos comportamientos en esta página pueden diferir; en particular, `claude agents` rechaza banderas que aún no admite con un error `unknown option`. La tabla a continuación enumera cuándo se agregó cada bandera y comportamiento.

812 984

814| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |986| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

815| v2.1.208 | Conectarse a una sesión cuyo proceso se ha detenido muestra la última pantalla de su transcripción mientras el proceso se inicia, en lugar de solo una nota `Session is starting`. Una respuesta que no se puede entregar porque el servicio de fondo es inaccesible o el envío falla se guarda y se envía como el siguiente prompt de la sesión cuando su proceso se inicia nuevamente; antes de esta versión, una respuesta perdida mientras el servicio de fondo era inaccesible se descartaba. Un proceso cuyo propio binario fue reemplazado por una actualización aún puede iniciar el supervisor, desde el lanzador `claude` instalado o la versión más nueva en disco, en lugar de fallar hasta que Claude Code se reiniciara. Un supervisor que ejecuta una versión anterior nunca reinicia una sesión inactiva iniciada por una versión más nueva en su propio binario más antiguo. Eliminar una sesión elimina su worktree incluso después de que la sesión movió el worktree a una rama diferente, y mantiene el worktree junto con la fila de sesión cuando el worktree tiene commits que no se han enviado a ningún lugar u otra sesión lo reclama, en lugar de destruir los commits u orfandar el worktree. `/install-github-app` y la lista de configuración `/mcp` y sus acciones de autenticación se rechazan en una sesión de fondo con un mensaje que nombra la alternativa; en v2.1.208 solamente, el selector `/model` fue rechazado de la misma manera y un `/model <name>` escrito cambió solo esa sesión en lugar de también guardar su modelo predeterminado. |987| v2.1.251 | En una sesión de fondo que no ha [entrado en un worktree](#how-file-edits-are-isolated), Claude y los subagentes que genera pueden editar archivos dentro de un worktree de git vinculado. |

988| v2.1.251 | Claude Code reenvía una puerta de enlace de proveedor de nube exportada en el shell desde el que distribuye, como `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL` con su bandera de bypass de autenticación, al [worker de la sesión](#llm-gateway) bajo las mismas condiciones que `ANTHROPIC_BASE_URL`. Antes de esta versión, si enviaba al segundo plano o distribuía desde un shell autenticado solo a través de tal puerta de enlace, cada solicitud que la sesión realizaba fallaba, porque el punto final y la bandera se eliminaban de su entorno. |

989| v2.1.251 | Cuando una sesión de fondo se inicia mientras otro proceso de Claude Code está actualizando un [marketplace de plugins](/docs/es/plugin-marketplaces), como una sesión hermana ejecutando la [actualización automática del marketplace](/docs/es/discover-plugins#configure-auto-updates), Claude Code mantiene los plugins de ese marketplace disponibles. Antes de esta versión, tal sesión podría iniciarse sin ninguna de las skills, agentes, hooks y servidores MCP de ese marketplace y permanecer así durante toda su ejecución. |

990| v2.1.248 | `Shift+Enter` en la [entrada de distribución](#keyboard-shortcuts) inserta una nueva línea, coincidiendo con el prompt principal, y `Ctrl+Enter` distribuye y se adjunta inmediatamente en terminales donde la superposición `?` enumera `ctrl+enter to start and open`. Antes de esta versión, `Shift+Enter` distribuía y se adjuntaba. |

991| v2.1.248 | [Eliminar una sesión](#what-deleting-a-session-removes) tiene éxito cuando los commits del worktree ya están en la copia local de la rama predeterminada de su remoto `origin` y su checkout principal tiene esa rama verificada; antes de esta versión, la eliminación se rechazaba con `has commits that are not pushed anywhere`. |

992| v2.1.248 | Una sesión enviada al segundo plano con `←` o `/background` mantiene el [`git worktree lock`](/docs/es/worktrees#clean-up-subagent-and-background-session-worktrees) en su worktree mientras se ejecuta; antes de esta versión, enviar al segundo plano liberaba el bloqueo, y la limpieza o `git worktree remove` podría eliminar el worktree bajo la sesión en ejecución. |

993| v2.1.248 | Una sesión de fondo que no estaba esperando su entrada y se encuentra muerta más de 48 horas después de su última actividad, como después de que la máquina estuvo apagada durante días, [se muestra como detenida](#sessions-show-as-failed-after-shutdown) con `ended while the background service was off`, y `Enter` en ella pregunta antes de reanudar su conversación guardada. Antes de esta versión, tal sesión reaparecía como un fallo nuevo ordenado en la parte superior de la lista, y un único `Enter` traía la conversación de hace semanas al primer plano. |

994| v2.1.248 | Abrir una fila detenida cuya conversación [reanudó en otra terminal](#opening-a-session-says-the-conversation-is-already-open) se rechaza con `Can't open — this session is running in another terminal`, y la fila muestra `Open in a terminal` en lugar de mostrarse bajo `Working`. Antes de esta versión, abrir la fila iniciaba un segundo proceso escribiendo en la misma conversación. |

995| v2.1.248 | Una sesión de fondo esperando una decisión de permiso mientras un hook `PermissionRequest` o `PreToolUse` imprimía una respuesta inválida [nombra el evento del hook y el error de esquema en su fila](#peek-and-reply). Antes de esta versión, la fila mostraba solo la solicitud pendiente. |

996| v2.1.248 | En Windows, `claude agents` responde al teclado cuando se lanza en una pestaña de terminal que un programa anterior dejó en win32-input-mode. Antes de esta versión, Claude Code no decodificaba los registros de teclas que tal pestaña envía. |

997| v2.1.247 | En Linux y WSL, una sesión [cuyo proceso host de terminal murió](#the-terminal-host-died-or-the-session-stopped-responding) falla dentro de segundos con la razón. Una apertura que no produce salida termina después de aproximadamente diez segundos con una oferta de reinicio, y `Enter` en la fila reinicia la sesión con su conversación; `claude attach <id>` reporta la causa y sale. Antes de esta versión, abrir tal sesión mostraba `opening… · esc to cancel` indefinidamente y `claude attach <id>` esperaba sin reportar un error. |

998| v2.1.246 | En una instalación de npm, cuando el [servicio de fondo](#the-supervisor-process) falla al iniciarse mientras `npm install -g @anthropic-ai/claude-code` está reemplazando el binario, Claude Code espera hasta diez segundos a que la instalación termine y reintenta antes de reportar [`EACCES: permission denied`](/docs/es/errors#eacces-when-starting-a-background-session). |

999| v2.1.246 | Cuando el proceso del [servicio de fondo](#the-supervisor-process) muere después de imprimir un error, Claude Code reporta el fallo y [cita la primera línea de error del servicio](/docs/es/errors#background-service-exited-before-it-became-reachable). |

1000| v2.1.246 | Si su máquina se duerme mientras el [servicio de fondo](#the-supervisor-process) se está iniciando, Claude Code reintenta el inicio una vez en lugar de fallar. |

1001| v2.1.246 | Claude Code espera aproximadamente dos minutos en lugar de 45 segundos para un [servicio de fondo](#the-supervisor-process) recién iniciado que está vivo pero lento para aceptar conexiones. |

1002| v2.1.246 | El [servicio de fondo](#the-supervisor-process) se inicia desde su directorio de inicio, por lo que en macOS y Linux un directorio de inicio que fue eliminado o movido ya no bloquea el inicio. |

1003| v2.1.246 | `/fork` [copia la conversación completa](#copy-the-session-with-%2Ffork) de una sesión que ella misma se inició como una copia y no ha registrado un nuevo prompt desde: una copia `/fork` a la que se adjuntó, una sesión reajustada después de que `←` o `/background` la movió al segundo plano, o una sesión iniciada con `claude --resume <id> --fork-session`. Antes de esta versión, si ejecutaba `/fork` en tal sesión antes de enviarle un nuevo prompt, Claude Code imprimía la confirmación normal pero iniciaba la copia con una conversación vacía. Mover tal sesión al segundo plano con `←` o `/background` perdía la conversación de la misma manera. |

1004| v2.1.246 | Cuando abre una sesión que acaba de distribuir mientras su proceso worker aún se está iniciando, como presionando `Enter` en su fila, Claude Code espera al proceso y luego se adjunta. Antes de esta versión, si presionaba `Enter` mientras el proceso aún se estaba iniciando, Claude Code podría detener la sesión con [`Session <id> was stopped while the respawn was in flight`](/docs/es/errors#session-was-stopped-while-the-respawn-was-in-flight). |

1005| v2.1.246 | Cuando [envía al segundo plano](#from-inside-a-session) una sesión nombrada, Claude Code la enumera una vez, y cuando envía al segundo plano la misma conversación nuevamente, numera el nombre de la nueva fila, como `my-session (2)`, con la fila existente manteniendo su nombre. Antes de esta versión, la terminal en la que presionó `←` podría aparecer en `claude agents --json` como una segunda sesión bajo el mismo nombre, y si enviaba al segundo plano la misma conversación nuevamente, Claude Code agregaba otra fila bajo el nombre idéntico. |

1006| v2.1.239 | Con [modo de editor vim](/docs/es/interactive-mode#vim-editor-mode) activado, presionar `Esc` en la entrada de la vista de agentes cambia de modo INSERT a NORMAL y mantiene su texto, coincidiendo con el prompt principal; en modo NORMAL con texto aún en la entrada, presionar `Esc` lo borra, y presionar `Esc` en una entrada vacía sale, como describe el atajo [`Esc`](#keyboard-shortcuts). Antes de esta versión, `Esc` borraba la entrada. |

1007| v2.1.233 | Para una sesión vinculada a una solicitud de fusión de GitLab, Claude Code escribe la etiqueta de la fila en la sintaxis de referencia `!1234` de GitLab. También puede pegar la URL de la solicitud de fusión en la [entrada de distribución](#filter-sessions) para seleccionar esa sesión. Antes de esta versión, la etiqueta se representaba como `#1234`, y una URL de solicitud de fusión pegada coincidía con una sesión solo cuando su primer prompt contenía la URL. |

1008| v2.1.227 | [Eliminar una sesión](#what-deleting-a-session-removes) mantiene la sesión y su worktree mientras otra sesión de Claude Code en vivo se ejecuta dentro de ese directorio de worktree. La vista de agentes muestra `not deleted` en la fila y la razón en el pie de página, y `claude rm` imprime `kept <id>` con la razón, que nombra el ID de proceso de la otra sesión. Antes de esta versión, eliminar la sesión eliminaba el worktree mientras la otra sesión aún estaba trabajando en él. |

1009| v2.1.225 | `claude agents` en un directorio que no ha confiado muestra el mismo [diálogo de confianza del espacio de trabajo](/docs/es/permissions#project-allow-rules-and-workspace-trust) que `claude` muestra al inicio, antes de que se abra la vista de agentes. Aceptar guarda la confianza para ese espacio de trabajo; rechazar sale sin abrir la vista de agentes. Antes de esta versión, `claude agents` se abría sin preguntar, por lo que las sesiones que distribuía desde él se ejecutaban en un directorio en el que nunca le habían pedido que confiara.<br /><br />Con la lista agrupada por directorio, pasar el ratón sobre una fila la resalta sin cambiar el [destino de distribución](#dispatch-to-a-specific-directory); seleccionar una fila con las teclas de flecha o un clic aún cambia el destino. Antes de esta versión, mover el ratón sobre una sesión en otro proyecto silenciosamente cambiaba el directorio en el que se iniciaba la siguiente sesión distribuida. |

1010| v2.1.221 | `/status` muestra una fila `Session kind`: `background job · attached` o `background job · unattended` en una sesión de fondo, dependiendo de si una terminal está adjunta, e `interactive` en cualquier otra sesión. Antes de esta versión, `/status` no reportaba el tipo de sesión.<br /><br />`/fork`: Claude Code instruye a [la copia](#from-inside-a-session) para aislar su trabajo del de la sesión original: la copia crea su propio worktree antes de hacer cambios de código, se mantiene fuera del worktree de la sesión original, y basa una nueva rama en la rama de la original cuando su tarea se basa en ese trabajo. Vea la sección vinculada para las condiciones exactas. Antes de esta versión, la copia no recibía instrucción de aislamiento y podría terminar editando el worktree o verificando el checkout en el que la sesión original aún estaba trabajando.<br /><br />Con [modo de editor vim](/docs/es/interactive-mode#vim-editor-mode) activado, presionar `←` justo después de deshacer el prompt de vuelta a vacío con `u` pide la misma confirmación que eliminar el texto o moverse a través del historial de prompts, y cambia solo en el segundo presionar; antes de esta versión el presionar cambiaba inmediatamente. |

1011| v2.1.219 | Con [modo de editor vim](/docs/es/interactive-mode#vim-editor-mode) activado, presionar `←` en un prompt vacío abre la vista de agentes desde modo NORMAL así como INSERT, y la sugerencia `←` del pie de página se muestra en modo NORMAL; antes de esta versión el gesto y la sugerencia eran solo INSERT, y en modo NORMAL `←` en un prompt vacío no hacía nada. Escribir en la entrada mientras Claude Code espera enviar la sesión al segundo plano cancela el cambio con `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` para que un borrador escrito no se pierda. |

1012| v2.1.218 | Presionar `←` dentro de dos segundos de una eliminación que vació el prompt, o de moverse a través del historial de prompts, muestra `Press ← again to open agents`, o `Press ← again to go back to agents` en una sesión adjunta, y cambia solo en un segundo presionar al menos un segundo después; antes de esta versión el presionar cambiaba inmediatamente. Un `←` que llega dentro de entrada pegada o escrita por script ya no activa el cambio. Enviar al segundo plano una sesión en primer plano con `←` muestra `Your conversation moved to the background` encima de la lista, y `Esc` en la raíz de la vista de agentes regresa a esa conversación en lugar de salir al shell, con doble `Ctrl+C` permaneciendo como la salida; si la conversación no se puede reabrir, Claude Code sale e imprime un comando `claude --resume` para ella. En Windows, un `←` presionado dentro de aproximadamente medio segundo de adjuntarse muestra `Ambiguous ←, press again to detach` y se desadjunta en el segundo presionar. |

1013| v2.1.217 | La insignia de solicitud de extracción en la fila de una sesión se representa como un hipervínculo incluso cuando Claude Code no puede detectar soporte de hipervínculo de terminal, por ejemplo sobre SSH o tmux; establezca [`FORCE_HYPERLINK=0`](/docs/es/env-vars) para representarla como texto sin formato. Antes de esta versión, la insignia se representaba como texto sin formato cuando el soporte no se detectaba. |

1014| v2.1.216 | `/fork`: la [confirmación](#from-inside-a-session) es una línea, mostrando el estado de la copia, el nombre de su fila de vista de agentes, y su ID de sesión para `claude attach`, terminando con `runs in the origin tree` o `edits this checkout` solo cuando la copia se ejecuta en el árbol de trabajo principal o edita el checkout que tiene abierto. Hacer clic en el nombre envía esta sesión al segundo plano y abre la vista de agentes en la sesión de la copia. La confirmación ya no reafirma el modo de permiso heredado de la copia; las versiones anteriores imprimían una confirmación de varias líneas sin nombre clickeable.<br /><br />Necesita entrada: `/install-github-app` y la lista de configuración `/mcp`, ejecutadas mientras nadie está adjunto, muestran la sesión bajo `Needs input` con una fila que nombra el comando, y adjuntarse y re-ejecutar el comando continúa; de v2.1.208 a v2.1.215 fueron rechazadas directamente en ese estado.<br /><br />Restauración de `--agent`: reanudar o reiniciar una [sesión `--agent` enviada al segundo plano](#from-your-shell) restaura el prompt del sistema del agente y las restricciones de herramientas, buscando el agente en el directorio de la sesión primero, cuando su espacio de trabajo es confiable; una sesión cuyo agente ya no existe continúa con las herramientas predeterminadas y el prompt del sistema y se abre con una advertencia visible, en lugar de revertir silenciosamente al agente predeterminado.<br /><br />`Ctrl+X`: presionarlo dos veces elimina una sesión incluso cuando el intento de detención falla, en lugar de que una detención fallida cancele la eliminación pendiente, y una sesión eliminada cuyo proceso worker había muerto ya no reaparece en el próximo refresco.<br /><br />Eliminación de worktree: una sesión cuyo directorio de worktree no pertenece a ningún repositorio de git puede ser eliminada; antes de esta versión cada intento de eliminar tal sesión fue rechazado. Un directorio que ya se ha ido se borra inmediatamente. El doble presionar de la vista de agentes elimina un directorio que aún tiene archivos, ejecutando su hook `WorktreeRemove` para un directorio creado por hook, a menos que otra sesión también lo nombre. `claude rm` mantiene tal directorio siempre que los archivos permanezcan. |

1015| v2.1.214 | Una sesión enviada al segundo plano con `←` o `/background` e inactiva sin nada ejecutándose tiene su proceso detenido como cualquier otra sesión inactiva, en lugar de mantener su proceso y el servicio de fondo ejecutándose indefinidamente. Una sesión completada puede ser eliminada con `claude rm` o desde la vista de agentes después de que el servicio de fondo se haya quedado inactivo, y una sesión que entró en un worktree después de ser distribuida desde un directorio que no es un repositorio de git, como una carpeta de espacio de trabajo multi-repo, puede ser eliminada desde la vista de agentes cuando el worktree mismo pertenece a un repositorio de git, porque la limpieza se resuelve desde el worktree en lugar del directorio desde el que se distribuyó la sesión; ambas eliminaciones fueron rechazadas en cada intento antes. Reabrir una sesión detenida restaura su conversación guardada incluso cuando una carpeta en el almacén de transcripción no se puede leer. |

1016| v2.1.213 | `/install-github-app`, la lista de configuración [`/mcp`](/docs/es/mcp), y acciones de autenticación MCP funcionan en una sesión de fondo mientras una terminal está adjunta, y se rechazan solo cuando nadie está adjunto, con un mensaje diciéndole que se adjunte y ejecute el comando nuevamente; de v2.1.208 a v2.1.212 fueron rechazadas incluso con una terminal adjunta. |

1017| v2.1.212 | [`/fork` en una sesión interactiva](#from-inside-a-session) copia la conversación en una nueva sesión de fondo que aparece como su propia fila, nombrada después de la sesión de la que provino o, para un fork solicitado de una sesión sin nombre, después del prompt de fork, mientras la original continúa ejecutándose; el comportamiento anterior de subagente forked de `/fork` se movió a `/subtask`. Con [vista de agentes desactivada](#turn-off-agent-view), `/fork` mantiene el comportamiento de subagente forked. Una fila enfocada que está esperando su primer prompt muestra `space to send it a prompt`. `Ctrl+J` inserta una nueva línea en la entrada de distribución en terminales con reporte de tecla extendida, donde el presionar de tecla fue previamente ignorado, y la superposición `?` enumera el atajo. La sugerencia de pie de página `←` en una sesión interactiva brevemente muestra `N done` cuando una sesión de fondo termina mientras ninguna necesita su entrada. Escribir un `/resume` desnudo en la vista de agentes abre un selector de sesiones pasadas del repositorio desde el que abrió la vista de agentes, incluyendo sesiones eliminadas de la lista, y seleccionar una la reanuda como una sesión de fondo; antes de esta versión `/resume` no estaba disponible en la vista de agentes y las sesiones eliminadas eran alcanzables solo con `claude --resume` o `/resume` desde una sesión interactiva. Los formularios dirigidos, con alcance y restringidos mantienen la sugerencia `attach to a session to run it` que las versiones anteriores mostraban para cada formulario. Las sesiones esperando un prompt de host de red de sandbox, una solicitud de entrada MCP, o un prompt de configuración administrada se muestran como `Needs input` en lugar de `Working`, en la vista de agentes y en `claude agents --json`, y una pregunta de Claude reporta `waitingFor: input needed` en lugar de `permission prompt`. Adjuntarse a una sesión cuyo proceso se ha detenido muestra su transcripción formateada de la manera en que la sesión en vivo la representa, en lugar de como texto sin procesar. Una sesión detenida cuya transcripción está en un lugar inesperado se reanuda desde ella a través de un escaneo de último recurso de sus transcripciones guardadas, y abrir una fila que no tiene transcripción guardada muestra `Press enter again to restart this session fresh`, reiniciándola de nuevo en el segundo presionar; v2.1.211 mostró el rechazo sin forma de reiniciar desde la vista de agentes. |

1018| v2.1.211 | Despertar una sesión detenida adjuntándose o respondiendo desde el directorio en el que se ejecuta reenvía el `ANTHROPIC_BASE_URL` de puerta de enlace de su shell nuevamente, bajo las mismas condiciones que una distribución nueva, por lo que una sesión autenticada a través de un `ANTHROPIC_AUTH_TOKEN` de puerta de enlace se reanuda en la puerta de enlace en lugar de reportar `Not logged in`. Adjuntarse a una sesión detenida que fue enviada al segundo plano desde otra conversación antes de que su primera respuesta terminara se rechaza con `This session has no saved transcript` en lugar de silenciosamente iniciar una conversación en blanco bajo el mismo ID de sesión; abrir la misma fila desde la vista de agentes mostró el rechazo en el pie de página. Terminar el proceso de una sesión `←` o `/background` desde fuera de Claude Code la marca como detenida en lugar de que el supervisor la reinicie, una detención ya registrada en disco se honra a menos que una respuesta que envió aún esté esperando ser entregada, una sesión reiniciada después de un fallo es informada de que fue reiniciada, y una sesión `←` o `/background` reiniciada no reanuda una respuesta interrumpida más antigua que aproximadamente una hora. Una respuesta de sesión-nombrada que responde o rechaza el prompt en lugar de etiquetarlo, como para un prompt que es principalmente un enlace, se descarta y la fila mantiene un nombre tomado del texto del prompt. Eliminar una sesión cuyo git de worktree ya no reconoce tiene éxito, dejando el directorio de worktree en disco y nombrando su ruta, en lugar de que cada intento sea rechazado. Un rechazo de eliminación muestra la razón en la fila de la sesión, incluyendo el error de git subyacente cuando el worktree no pudo ser eliminado, en lugar de que la fila silenciosamente reaparezca. |

1019| v2.1.210 | `claude attach` espera mientras el servicio de fondo se está iniciando o reconectando en lugar de fallar con un error `job not found` o `still starting`, reporta una sesión que terminó durante el adjunto como salida, y aplica un cambio de tamaño de terminal hecho durante un adjunto lento cuando el adjunto se completa. La sugerencia de conteo de necesidades de entrada `←` del pie de página del prompt aparece en cada proveedor, incluyendo proveedores de terceros que previamente mostraban la forma `← for agents` simple. Enviar al segundo plano una sesión con `←` lleva la lista de tareas de Claude a la sesión de fondo en lugar de descartarla. La fila en la que presionó `←` mantiene un nombre en negrita, sin atenuar después de que la selección se mueve. `claude agents --effort` acepta `ultracode` en lugar de silenciosamente descartarlo. |

1020| v2.1.208 | Adjuntarse a una sesión cuyo proceso se ha detenido muestra la última pantalla de su transcripción mientras el proceso se inicia, en lugar de solo una nota `Session is starting`. Una respuesta que no se puede entregar porque el servicio de fondo es inaccesible o el envío falla se guarda y se envía como el siguiente prompt de la sesión cuando su proceso se inicia nuevamente; antes de esta versión, una respuesta perdida mientras el servicio de fondo era inaccesible se descartaba. Un proceso cuyo propio binario fue reemplazado por una actualización aún puede iniciar el supervisor, desde el lanzador `claude` instalado o la versión más nueva en disco, en lugar de fallar hasta que Claude Code se reiniciara. Un supervisor que ejecuta una versión anterior nunca reinicia una sesión inactiva iniciada por una versión más nueva en su propio binario más antiguo. Eliminar una sesión elimina su worktree incluso después de que la sesión movió el worktree a una rama diferente, y mantiene el worktree junto con la fila de sesión cuando el worktree tiene commits que no se han enviado a ningún lugar u otra sesión lo reclama, en lugar de destruir los commits u orfandar el worktree. `/install-github-app` y la lista de configuración `/mcp` y sus acciones de autenticación se rechazan en una sesión de fondo con un mensaje que nombra la alternativa; en v2.1.208 solamente, el selector `/model` fue rechazado de la misma manera y un `/model <name>` escrito cambió solo esa sesión en lugar de también guardar su modelo predeterminado. |

816| v2.1.207 | El panel de vista previa se abre con la oración que la fila trunca, como la pregunta exacta para una sesión que lo espera a usted, y muestra cuánto tiempo una sesión bloqueada ha estado esperando como una única línea `waiting 3m` en lugar de prefijar la misma marca de tiempo a la oración de estado y la pregunta. Pegar el mismo texto nuevamente en la entrada de distribución expande el marcador de posición colapsado `[Pasted text #N]` en lugar de agregar uno segundo. Una sesión en segundo plano nombrada al aceptar un plan muestra ese nombre en su fila. Una sesión en segundo plano que se movió a un worktree mantiene su conversación cuando su proceso se reinicia desde la vista de agentes. |1021| v2.1.207 | El panel de vista previa se abre con la oración que la fila trunca, como la pregunta exacta para una sesión que lo espera a usted, y muestra cuánto tiempo una sesión bloqueada ha estado esperando como una única línea `waiting 3m` en lugar de prefijar la misma marca de tiempo a la oración de estado y la pregunta. Pegar el mismo texto nuevamente en la entrada de distribución expande el marcador de posición colapsado `[Pasted text #N]` en lugar de agregar uno segundo. Una sesión en segundo plano nombrada al aceptar un plan muestra ese nombre en su fila. Una sesión en segundo plano que se movió a un worktree mantiene su conversación cuando su proceso se reinicia desde la vista de agentes. |

817| v2.1.206 | Los resúmenes de filas llenan el ancho restante de la fila y se truncan solo en el borde derecho de la terminal en lugar de en 64 columnas. Después de que el supervisor se reinicia en una nueva versión de Claude Code, reinicia las sesiones en segundo plano inactivas restantes en esa versión en el fondo en lugar de algunas por minuto. Eliminar una sesión con `Ctrl+X` o `claude rm` también la borra de la lista de sesiones del supervisor, por lo que la fila ya no reaparece después de un reinicio del supervisor. |1022| v2.1.206 | Los resúmenes de filas llenan el ancho restante de la fila y se truncan solo en el borde derecho de la terminal en lugar de en 64 columnas. Después de que el supervisor se reinicia en una nueva versión de Claude Code, reinicia las sesiones en segundo plano inactivas restantes en esa versión en el fondo en lugar de algunas por minuto. Eliminar una sesión con `Ctrl+X` o `claude rm` también la borra de la lista de sesiones del supervisor, por lo que la fila ya no reaparece después de un reinicio del supervisor. Una anulación de cuerpo de solicitud `CLAUDE_CODE_EXTRA_BODY` exportada en el shell de distribución llega a las sesiones de fondo en lugar de ser ignorada. |

818| v2.1.205 | Los resúmenes de filas muestran el informe de una línea propia de la sesión, truncado en 64 columnas, en lugar de una invocación de herramienta sin procesar o un recuento `done/total`; las filas agrupadas por directorio se abren con una palabra de estado coloreada. El panel de vista previa se abre con la oración de estado completa y, para una sesión que espera por usted, su pregunta exacta encima de la entrada de respuesta. Las sesiones que editan, comentan, cierran o marcan una solicitud de extracción como lista con `gh` están vinculadas a ella, no solo las que crean o verifican una solicitud de extracción, un push vincula una solicitud de extracción incluso cuando el nombre de rama local no coincide, y una solicitud de extracción cuya salida del comando de creación excedió el límite en línea también está vinculada. Un turno sin texto legible mantiene el estado anterior de la sesión en lugar de voltearlo de nuevo a `Working`. `claude attach` espera hasta aproximadamente 60 segundos una sesión que se está reiniciando, con una línea de estado que indica por qué, en lugar de fallar. |1023| v2.1.205 | La sugerencia `←` del pie de página del prompt en una sesión regular `claude` cuenta los agentes de fondo esperando por usted, como `← 2 agents`. Los resúmenes de filas muestran el informe de una línea propia de la sesión, truncado en 64 columnas, en lugar de una invocación de herramienta sin procesar o un recuento `done/total`; las filas agrupadas por directorio se abren con una palabra de estado coloreada. El panel de vista previa se abre con la oración de estado completa y, para una sesión que espera por usted, su pregunta exacta encima de la entrada de respuesta. Las sesiones que editan, comentan, cierran o marcan una solicitud de extracción como lista con `gh` están vinculadas a ella, no solo las que crean o verifican una solicitud de extracción, un push vincula una solicitud de extracción incluso cuando el nombre de rama local no coincide, y una solicitud de extracción cuya salida del comando de creación excedió el límite en línea también está vinculada. Un turno sin texto legible mantiene el estado anterior de la sesión en lugar de voltearlo de nuevo a `Working`. `claude attach` espera hasta aproximadamente 60 segundos una sesión que se está reiniciando, con una línea de estado que indica por qué, en lugar de fallar. |

819| v2.1.203 | Una puerta de enlace `ANTHROPIC_BASE_URL` exportada en el shell de distribución llega a las sesiones distribuidas desde él en ese mismo directorio cuando el supervisor comparte ese entorno de puerta de enlace, en lugar de ser descartada mientras la clave API exportada junto a ella se mantenía. El `PATH` del shell de distribución se aplica al worker de cada sesión. Presionar `←` mientras los subagentes se están ejecutando espera a que terminen en lugar de reiniciarlos después de diez segundos. La lista vacía siempre muestra los encabezados de sección con una descripción bajo cada uno. Escribir `@` en la entrada de distribución también enumera los worktrees de git registrados del repositorio de lanzamiento que viven dentro de su árbol de directorios. Un esfuerzo heredado de la configuración `effortLevel` sigue ediciones posteriores a esa configuración en lugar de ser fijado en la distribución. Abrir una sesión detenida cuya conversación ya está abierta en otra sesión en ejecución se rechaza con un mensaje en lugar de fallar la fila. Un comando que no está disponible en la vista de agentes deja el texto escrito en la entrada. Un hook `WorktreeCreate` que falla fuera de un repositorio de git ya no bloquea la sesión de editar archivos. |1024| v2.1.203 | Una puerta de enlace `ANTHROPIC_BASE_URL` exportada en el shell de distribución llega a las sesiones distribuidas desde él en ese mismo directorio cuando el supervisor comparte ese entorno de puerta de enlace, en lugar de ser descartada mientras la clave API exportada junto a ella se mantenía. El `PATH` del shell de distribución se aplica al worker de cada sesión. Presionar `←` mientras los subagentes se están ejecutando espera a que terminen en lugar de reiniciarlos después de diez segundos. La lista vacía siempre muestra los encabezados de sección con una descripción bajo cada uno. Escribir `@` en la entrada de distribución también enumera los worktrees de git registrados del repositorio de lanzamiento que viven dentro de su árbol de directorios. Un esfuerzo heredado de la configuración `effortLevel` sigue ediciones posteriores a esa configuración en lugar de ser fijado en la distribución. Abrir una sesión detenida cuya conversación ya está abierta en otra sesión en ejecución se rechaza con un mensaje en lugar de fallar la fila. Un comando que no está disponible en la vista de agentes deja el texto escrito en la entrada. Un hook `WorktreeCreate` que falla fuera de un repositorio de git ya no bloquea la sesión de editar archivos. |

820| v2.1.202 | Un nombre establecido con `/rename` o `Ctrl+R` en una sesión en segundo plano persiste cuando el supervisor detiene y reinicia su proceso, en lugar de revertir al nombre con el que se distribuyó la sesión. |1025| v2.1.202 | Un nombre establecido con `/rename` o `Ctrl+R` en una sesión en segundo plano persiste cuando el supervisor detiene y reinicia su proceso, en lugar de revertir al nombre con el que se distribuyó la sesión. |

821| v2.1.200 | Una versión anterior de Claude Code que reescribe la lista de sesiones en `roster.json` preserva campos escritos por una versión más nueva, coincidiendo con la garantía existente de `state.json`, por lo que las sesiones iniciadas por la versión más nueva continúan aceptando entrada después de que el supervisor se reinicia. Cuando abre una sesión que ha dejado de responder, el supervisor reinicia su proceso y la sesión continúa la respuesta interrumpida desde donde se quedó. |1026| v2.1.200 | Una versión anterior de Claude Code que reescribe la lista de sesiones en `roster.json` preserva campos escritos por una versión más nueva, coincidiendo con la garantía existente de `state.json`, por lo que las sesiones iniciadas por la versión más nueva continúan aceptando entrada después de que el supervisor se reinicia. Cuando abre una sesión que ha dejado de responder, el supervisor reinicia su proceso y la sesión continúa la respuesta interrumpida desde donde se quedó. La vista de agentes aplica una bandera `--plugin-dir` colocada después de `agents` a su propio subagente y autocompletado de skills en la entrada de distribución así como sesiones distribuidas. |

822| v2.1.199 | Una sesión en segundo plano cuyo proceso se cierra antes de terminar de iniciarse en un host con poca memoria muestra `possibly low memory — free some up and retry` en su estado de fila en lugar de solo la razón de salida desnuda. Enviar al segundo plano una sesión con `←` o `/background` lleva su `/color` a la nueva fila. |1027| v2.1.199 | Una sesión en segundo plano cuyo proceso se cierra antes de terminar de iniciarse en un host con poca memoria muestra `possibly low memory — free some up and retry` en su estado de fila en lugar de solo la razón de salida desnuda. Enviar al segundo plano una sesión con `←` o `/background` lleva su `/color` a la nueva fila. |

823| v2.1.198 | La vista de agentes envía una notificación a través de `preferredNotifChannel` cuando una sesión en segundo plano necesita entrada, finaliza o falla, y dispara el hook `Notification` con el tipo `agent_needs_input` o `agent_completed`. `←` y `/exit` dentro de `claude attach <id>` regresan a la vista de agentes en lugar de salir al shell; `Ctrl+Z` regresa al shell. Una sesión en segundo plano que aisló su trabajo en un worktree confirma, envía su propia rama aislada, nunca `main` o `master`, y abre una solicitud de extracción en borrador cuando finaliza en lugar de preguntar primero. `/login` se ejecuta en la vista de agentes y abre el diálogo de inicio de sesión. El diálogo de salida `Background work is running` ofrece `Move to background and exit`. La entrega de salida también cubre subagentes en segundo plano, que se reanudan desde su transcripción en el próximo despertar en lugar de ser reportados como fallidos. `claude --bg` combinado con `-p` o `--print` se rechaza con un error. |1028| v2.1.198 | La vista de agentes envía una notificación a través de `preferredNotifChannel` cuando una sesión en segundo plano necesita entrada, finaliza o falla, y dispara el hook `Notification` con el tipo `agent_needs_input` o `agent_completed`. `←` y `/exit` dentro de `claude attach <id>` regresan a la vista de agentes en lugar de salir al shell; `Ctrl+Z` regresa al shell. Una sesión en segundo plano que aisló su trabajo en un worktree confirma, envía su propia rama aislada, nunca `main` o `master`, y abre una solicitud de extracción en borrador cuando finaliza en lugar de preguntar primero. `/login` se ejecuta en la vista de agentes y abre el diálogo de inicio de sesión. El diálogo de salida `Background work is running` ofrece `Move to background and exit`. La entrega de salida también cubre subagentes en segundo plano, que se reanudan desde su transcripción en el próximo despertar en lugar de ser reportados como fallidos. `claude --bg` combinado con `-p` o `--print` se rechaza con un error. El host de sesión de fondo solicita permiso de Red Local de macOS en el primer acceso LAN en lugar de fallar con `connect: no route to host`. |

824| v2.1.196 | Un único presionar `←` envía al segundo plano una sesión en primer plano; las versiones anteriores requerían dos presiones, con una sugerencia de pie de página y una confirmación. `--dangerously-skip-permissions` pasado a `claude agents` muestra el descargo de responsabilidad de bypass en lugar de ser silenciosamente descartado. Las sesiones interactivas que nunca nombró llevan un nombre predeterminado como `my-app-3f` en listados de sesiones y `claude agents --json`. Los comandos shell en segundo plano y flujos de trabajo dinámicos sobreviven al proceso de la sesión siendo detenido, reiniciado o actualizado, incluso en Windows; establezca `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` para desactivar la entrega. Una transcripción malinterpretada como vacía al reiniciar se renombra con un sufijo `.orphaned-` en lugar de eliminarse. |1029| v2.1.196 | Un único presionar `←` envía al segundo plano una sesión en primer plano; las versiones anteriores requerían dos presiones, con una sugerencia de pie de página y una confirmación. `--dangerously-skip-permissions` pasado a `claude agents` muestra el descargo de responsabilidad de bypass en lugar de ser silenciosamente descartado. Las sesiones interactivas que nunca nombró llevan un nombre predeterminado como `my-app-3f` en listados de sesiones y `claude agents --json`. Los comandos shell en segundo plano y flujos de trabajo dinámicos sobreviven al proceso de la sesión siendo detenido, reiniciado o actualizado, incluso en Windows; establezca `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` para desactivar la entrega. Una transcripción malinterpretada como vacía al reiniciar se renombra con un sufijo `.orphaned-` en lugar de eliminarse. |

825| v2.1.195 | El trabajo en vuelo se traslada cuando envía al segundo plano una sesión en Windows también; establezca `CLAUDE_DISABLE_ADOPT=1` para detenerlo en su lugar. El grupo `Completed` llena el espacio vertical restante y el encabezado se compacta en terminales cortas. Una versión anterior de Claude Code ya no descarta campos `state.json` más nuevos de sesiones o oculta esas sesiones de `claude agents`. Conectarse a una sesión detenida cambia inmediatamente en lugar de mostrar una pantalla en blanco durante hasta cinco segundos. Un supervisor que no puede aceptar conexiones sale y libera su bloqueo por sí solo. |1030| v2.1.195 | El trabajo en vuelo se traslada cuando envía al segundo plano una sesión en Windows también; establezca `CLAUDE_DISABLE_ADOPT=1` para detenerlo en su lugar. El grupo `Completed` llena el espacio vertical restante y el encabezado se compacta en terminales cortas. Una versión anterior de Claude Code ya no descarta campos `state.json` más nuevos de sesiones o oculta esas sesiones de `claude agents`. Conectarse a una sesión detenida cambia inmediatamente en lugar de mostrar una pantalla en blanco durante hasta cinco segundos. Un supervisor que no puede aceptar conexiones sale y libera su bloqueo por sí solo. |

1031| v2.1.191 | `claude --bg` con un nombre `--agent` que no coincide con ninguno de sus subagentes falla el lanzamiento: la sesión sale inmediatamente con un error `--agent '<name>' not found` en lugar de ejecutarse con el agente predeterminado. |

826| v2.1.174 | Las sesiones en segundo plano ya no heredan variables de punto final de puerta de enlace como `ANTHROPIC_BASE_URL` del shell de lanzamiento del supervisor; el supervisor proporciona una instantánea de credencial nueva a workers precalentados, corrigiendo errores espurios de `Could not resolve authentication method`. |1032| v2.1.174 | Las sesiones en segundo plano ya no heredan variables de punto final de puerta de enlace como `ANTHROPIC_BASE_URL` del shell de lanzamiento del supervisor; el supervisor proporciona una instantánea de credencial nueva a workers precalentados, corrigiendo errores espurios de `Could not resolve authentication method`. |

827| v2.1.172 | `/model` en la entrada de distribución establece una anulación de modelo de distribución con alcance de sesión. |1033| v2.1.172 | `/model` en la entrada de distribución establece una anulación de modelo de distribución con alcance de sesión. |

828| v2.1.161 | Los resúmenes de filas muestran un recuento `done/total` para elementos de trabajo paralelos; el panel de vista previa nombra el elemento de trabajo paralelo que más tiempo lleva ejecutándose. |1034| v2.1.161 | Los resúmenes de filas muestran un recuento `done/total` para elementos de trabajo paralelos; el panel de vista previa nombra el elemento de trabajo paralelo que más tiempo lleva ejecutándose. |

agent-view.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

Gestionar múltiples agentes con la vista de agentes

Inicio rápido

Abrir la vista de agentes

Distribuir una sesión

Echar un vistazo y responder

Conectar y desconectar

Traer una sesión existente

Monitorear sesiones con la vista de agentes

Leer el estado de la sesión

Resúmenes de filas

Estado de la solicitud de extracción

Echar un vistazo y responder

Adjuntarse a una sesión

Cambiar sesiones sin salir de la terminal

Organizar la lista

Filtrar sesiones

Atajos de teclado

Distribuir nuevos agentes

Desde la vista de agentes

Distribuir a un directorio específico

Desde dentro de una sesión

Enviar la sesión al segundo plano

Copiar la sesión con /fork

Qué se lleva cuando envía al segundo plano

Desde su shell

Ejecutar un comando de shell

Cómo se aíslan las ediciones de archivos

Qué elimina la eliminación de una sesión

Establecer el modelo

Modo de permiso, modelo y esfuerzo

Configuración y proveedor

Puerta de enlace LLM

Modo de permiso

Valores predeterminados de distribución

Qué persiste en los reinicios

Configuración, plugins y servidores MCP

Gestionar sesiones desde el shell

Listar sesiones como JSON

Cómo se alojan las sesiones en segundo plano

El proceso supervisor

Dónde se almacena el estado

Desactivar la vista de agentes

Solución de problemas

`claude agents` enumera subagentes en lugar de abrir la vista de agentes

La vista de agentes se abre sin sesiones

Backgrounding muestra un diálogo `Background this session?`

Mensaje rechazado por ser demasiado corto

Las sesiones se muestran como fallidas o detenidas después del apagado

Abrir una sesión dice que la conversación ya está abierta

Abrir una sesión dice que no tiene transcripción guardada

El host de terminal murió o la sesión dejó de responder

Terminal host murió

La sesión no está respondiendo

Una sesión falla antes de iniciarse con una nota `possibly low memory`

La vista de agentes dice que el servicio en segundo plano no respondió

La distribución falla con `Could not resolve authentication method`

Las sesiones en segundo plano no pueden leer Desktop, Documents o Downloads en macOS

Las sesiones en segundo plano no pueden alcanzar hosts de red local en macOS

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

`.claude/worktrees/` se está llenando

Limitaciones

Recursos relacionados

Historial de versiones