|

Guía para principiantes de Claude Code Agent View: 1 terminal para gestionar N sesiones de IA paralelas

Nota del autor: Descubre la nueva vista de agente (Agent View) de Claude Code en esta vista previa de investigación. Analizamos sus capacidades principales, cómo empezar en 4 pasos, una comparativa con el flujo de trabajo de ventanas múltiples en tmux y lo que debes tener en cuenta sobre la facturación de sesiones en segundo plano.

Si sueles ejecutar varias tareas de Claude Code al mismo tiempo mientras programas, es probable que hayas vivido esta escena: seis pestañas de terminal abiertas, cada una esperando a que la IA escriba código o ejecute pruebas, saltando de una a otra por miedo a perderte ese mensaje de "¿quieres continuar?". Dividir la pantalla con tmux ayuda, pero no resuelve el problema de fondo: no es la gestión de ventanas, es que "no tengo ni idea de qué sesiones están activas y cuáles están esperando mi respuesta".

El 11 de mayo de 2026, Anthropic lanzó la vista previa de investigación de Claude Code Agent View, diseñada precisamente para solucionar este dolor de cabeza. Centraliza todas tus sesiones de Claude Code en un panel de control donde el estado es evidente: quién está trabajando, quién espera una entrada y quién ha terminado. Esta guía para principiantes te explicará de forma sencilla sus capacidades, cómo usarla y en qué se diferencia del flujo de trabajo tradicional con tmux, para que puedas decidir si vale la pena cambiar tu forma de trabajar.

claude-code-agent-view-beginner-guide-es 图示

¿Qué es Claude Code Agent View?

Claude Code Agent View es un panel de control de sesiones integrado en la CLI de Claude Code, que requiere la versión 2.1.139 o superior. Organiza múltiples sesiones de Claude Code en forma de "lista" en una sola pantalla, donde cada fila muestra el estado de la sesión, su actividad reciente y qué está esperando.

No es una herramienta externa, sino parte integral de Claude Code. Ya no necesitas abrir paneles de tmux o pantallas divididas en iTerm2 para tareas paralelas; basta con el comando claude agents para acceder al panel y ver todas tus sesiones en una sola vista. Para los desarrolladores, esto significa que la "gestión de sesiones de IA" tiene por fin una solución oficial.

Cabe añadir que Agent View se encuentra actualmente en fase de vista previa de investigación (Research Preview) y está disponible para suscriptores Pro, Max, Team y Enterprise, así como para usuarios de la API de Claude. Si eres un desarrollador que accede a los modelos de Claude a través de APIYI (apiyi.com), también puedes configurar la variable ANTHROPIC_BASE_URL de Claude Code para que apunte a APIYI, disfrutando así de una red estable y de la ventaja de costes del 0.1x en caché, sin dejar de usar la CLI oficial de Anthropic.

Otra forma de entender Agent View es observar su relación con las "soluciones existentes". Antes, los desarrolladores que querían ejecutar varios Claude Code solían recurrir a tres métodos: abrir múltiples pestañas de terminal, usar divisiones de tmux o escribir scripts de shell para gestionar procesos en segundo plano. Cada uno tenía sus problemas: demasiadas pestañas son difíciles de seguir, tmux tiene una curva de aprendizaje pronunciada y los scripts propios requieren gestionar manualmente los PID, registros y sincronización de estados. Agent View toma el control de estas tres facetas, ofreciendo una experiencia mucho más cercana a un "gestor de tareas de IA".

Las 5 capacidades clave de Claude Code Agent View

Agent View puede parecer solo una lista de interfaz, pero integra capacidades que antes estaban dispersas en múltiples herramientas. La siguiente tabla resume las 5 capacidades principales que debes conocer.

Capacidad Comportamiento Problema que resuelve
Registro de sesiones Lista todas las sesiones y estados de Claude Code Demasiadas pestañas de tmux para gestionar
Visualización de estado Trabajando / Esperando entrada / Completado / Fallido / Inactivo / Detenido No saber quién requiere tu atención
Ejecución en segundo plano /bg, claude --bg para separar la sesión del primer plano No ocupar ventanas de terminal innecesariamente
Vista previa rápida Teclas de dirección + Espacio para "Peek" Ver la última salida sin entrar en la sesión
Worktree automático Aislamiento automático en .claude/worktrees/ al escribir archivos Evitar conflictos al modificar archivos en paralelo

🎯 Consejo de uso: Al probar Agent View por primera vez, te sugiero abrir dos sesiones en segundo plano con tareas distintas para observar los cambios de estado antes de escalar a 4-5 tareas paralelas. Al combinarlo con la conexión de modelos Claude de APIYI (apiyi.com), podrás disfrutar de la capacidad de ejecución prolongada de Agent View de forma más estable en China.

El registro de sesiones es la función más intuitiva de Agent View. Antes tenías que recordar mentalmente "la pestaña de arriba es para el frontend, la de abajo para ejecutar pruebas"; ahora, el panel te indica directamente el nombre de la sesión y su actividad reciente. La visualización de estado es su "alma": esa columna de etiquetas te permite saber de un vistazo qué sesiones requieren atención inmediata, evitando que pierdas tiempo "consultando cada ventana". Una vez que te familiarices con los 6 estados comunes (working / waiting / completed / failed / idle / stopped), verás que casi nunca necesitarás adjuntar (attach) una sesión manualmente.

La ejecución en segundo plano es la clave para que Agent View reemplace a tmux. /bg envía la sesión actual al fondo, mientras que claude --bg "<task>" inicia una nueva tarea directamente en modo segundo plano; ambos permiten que Claude Code siga trabajando sin necesidad de una terminal adjunta. Gracias al aislamiento automático de worktree, múltiples sesiones pueden escribir en el mismo repositorio sin sobrescribirse entre sí.

El detalle de la vista previa (Peek) merece una mención especial. Antes, para revisar el progreso de una sesión, tenías que entrar (attach) y esperar a que la pantalla renderizara todo el transcript; pasaban los segundos y podías perderte la pregunta que estaba a punto de aparecer. El panel Peek de Agent View solo muestra "la última salida" o "la pregunta que espera tu respuesta", ofreciendo una experiencia similar a una vista previa de mensajes, lo que aumenta significativamente la eficiencia.

claude-code-agent-view-beginner-guide-es 图示

Cómo activar y usar Claude Code Agent View

La barrera de entrada para Agent View es muy baja; puedes completar el flujo en 4 pasos. Aquí tienes una guía rápida para principiantes.

Paso Comando u operación Acción
1. Actualizar claude --version para verificar y actualizar a ≥ v2.1.139 Cumplir requisitos de Agent View
2. Abrir panel Escribe claude agents en la terminal o presiona flecha izquierda Abrir el registro de sesiones
3. Iniciar en segundo plano claude --bg "Refactorizar directorio utils" Generar una sesión en segundo plano
4. Cambiar y responder Flechas para seleccionar → Espacio para previsualizar → Enter para entrar Ver progreso, responder preguntas, obtener resultados

🎯 Consejo de inicio rápido: Configura la variable ANTHROPIC_BASE_URL de Claude Code a https://api.apiyi.com/v1 y utiliza la clave de modelo Claude proporcionada por APIYI (apiyi.com) para ejecutar Agent View sin problemas en China. El almacenamiento en caché con un coste de 0.1x significa que el coste de ejecutar múltiples sesiones prolongadas será significativamente menor que usar la interfaz oficial directamente.

A continuación, se muestra un escenario de trabajo común. Supongamos que trabajas en un proyecto full-stack y necesitas ejecutar dos tareas independientes: "Diseño de API backend" y "Reescritura de componentes frontend". Puedes organizarlo así:

# Iniciar dos sesiones en segundo plano
claude --bg "Diseñar la API REST del módulo de login, escribir descripción OpenAPI"
claude --bg "Reescribir componente Header, añadir nuevo menú de usuario"

# Abrir Agent View en cualquier momento para ver el progreso
claude agents

Al entrar en Agent View, verás las dos sesiones alineadas. Cuando el estado de una fila cambie a Waiting for input, significa que Claude necesita que confirmes una decisión, como "¿añadir un nuevo campo?". En ese momento, usa las flechas para seleccionar la fila, presiona espacio para previsualizar, revisa la pregunta y presiona Enter para entrar en la sesión y responder.

Si utilizas una clave de Claude de APIYI (apiyi.com), la experiencia es idéntica a la conexión oficial, pero en el entorno de red de China, las sesiones en segundo plano no se interrumpirán por fluctuaciones ocasionales de la red, algo vital para los desarrolladores que buscan flujos de trabajo "desatendidos durante la noche".

El error más común de los principiantes es no distinguir los escenarios de uso de /bg y claude --bg. /bg es un comando que se introduce dentro de una sesión ya abierta y sirve para "enviar la sesión actual al fondo manteniendo su ejecución", ideal si has estado chateando un buen rato y quieres dejar la terminal; mientras que claude --bg "<task>" se lanza directamente desde el shell para iniciar una tarea nueva que no ocupa la terminal desde el principio. Lo primero es como "suspender la conversación actual", lo segundo es como "asignar un nuevo empleado para trabajar de forma independiente".

Comparativa: Claude Code Agent View frente a tmux multiventana

Una forma excelente de entender la "Vista de Agente" (Agent View) es analizar qué es lo que viene a reemplazar. La siguiente tabla compara el flujo tradicional de "tmux multiventana" con el nuevo flujo de "Agent View" en aspectos clave de la experiencia de desarrollo.

Dimensión tmux multiventana Claude Code Agent View
Conciencia de estado Requiere alternar entre ventanas Vista unificada de todas las sesiones
Inicio de sesión en segundo plano Abrir panel + script de demonio Un solo comando: claude --bg "<tarea>"
Esperando entrada Fácil perderse y bloquearse Panel destaca "Waiting for input"
Escritura en archivos Riesgo de sobrescritura Aislamiento automático con worktree
Curva de aprendizaje Requiere dominar atajos Navegación intuitiva (flechas/espacio/enter)
Colaboración compleja Flexible, pero requiere scripts propios Integración nativa con Agent Teams

🎯 Recomendación: Para tareas paralelas en desarrollo individual, la Agent View es más que suficiente. Si necesitas que varios agentes colaboren entre sí (modo equipo), los Agent Teams de Anthropic aún requieren tmux o iTerm2 para la gestión de pantalla dividida. Ambos enfoques no son excluyentes. APIYI (apiyi.com) se conecta a la misma familia de modelos Claude, por lo que es compatible con ambos flujos de trabajo.

Vale la pena profundizar en los detalles del "aislamiento de sesiones". En el modo Agent View, cuando una sesión intenta modificar un archivo, Claude Code lo coloca automáticamente en un árbol de trabajo (worktree) independiente dentro de .claude/worktrees/. Todas las sesiones paralelas comparten la "lectura" del checkout original, pero cada una tiene su propio espacio de "escritura". Al finalizar, tú decides qué cambios fusionar. Este patrón de "lectura compartida, escritura aislada" es la mejor práctica que los desarrolladores avanzados han defendido durante años al construir flujos de trabajo multi-agente manualmente.

Este mecanismo es idéntico a la estrategia de "un git worktree por tarea paralela" que utilizan los desarrolladores experimentados, con la diferencia de que Anthropic lo ha convertido en un comportamiento predeterminado y listo para usar. Para los principiantes, esto significa que puedes ejecutar múltiples tareas de Claude Code en paralelo de forma segura sin necesidad de conocer los detalles técnicos de los worktrees.

Para ayudarte a decidir si la Agent View encaja en tu flujo de trabajo diario, esta tabla resume los escenarios más y menos recomendados actualmente:

Tipo ¿Recomendado? Razón
Refactorización de código en varios directorios ✅ Muy recomendado Worktree automático + ejecución en segundo plano
Generación automática de docs/tests ✅ Recomendado Un agente por módulo, estado claro
Actualización masiva de dependencias ✅ Recomendado Un agente por repositorio, sin interferencias
Exploración de análisis de datos ⚠️ Según el caso Valor marginal si las tareas son cortas y cambian mucho
Chat/Preguntas en tiempo real ❌ No recomendado Una sola sesión basta, abrir varios agentes es redundante
Colaboración multi-agente ⚠️ Usar Agent Teams Requiere división de pantalla, sigue necesitando tmux/iTerm2

claude-code-agent-view-beginner-guide-es 图示

Preguntas frecuentes sobre Claude Code Agent View

P1: ¿Es de pago Agent View? ¿Cuenta para el límite de suscripción?

Agent View en sí es gratuito, pero cada sesión en segundo plano consume tu límite de suscripción de Claude o tu saldo de API, al igual que una sesión en primer plano. Si ejecutas 10 agentes simultáneamente, el límite se consumirá aproximadamente 10 veces más rápido, por lo que debes realizar una estimación de costos previa; los usuarios del plan Pro deben tener especial cuidado al controlar la cantidad de sesiones concurrentes.

P2: ¿Las sesiones en segundo plano se ejecutan siempre? ¿Continúan después de apagar el equipo?

Las sesiones en segundo plano se ejecutan localmente en tu máquina. Si el equipo entra en modo suspensión, se apaga o cierras el proceso de Claude Code, la sesión se detendrá. No es un agente en la nube; al reactivar el equipo, deberás reanudar la sesión. Para ejecutar tareas largas y "sin supervisión" real, debes asegurarte de que el equipo permanezca activo.

P3: ¿Agent View y Agent Teams son lo mismo?

No. Agent View es un panel de control para "gestionar múltiples sesiones en una sola pantalla", donde cada sesión sigue siendo una tarea independiente. Agent Teams es un mecanismo de múltiples roles para "hacer que varios agentes colaboren entre sí", donde un líder coordina a varios compañeros de equipo para avanzar en una tarea, lo cual aún requiere de tmux o iTerm2 para la división de pantalla. Ambos pueden coexistir sin conflictos: el primero resuelve el problema de la "gestión de multitarea" y el segundo el de la "colaboración entre roles".

P4: ¿Se puede usar Agent View de forma estable desde China?

Agent View es una función de CLI local, pero la invocación del modelo subyacente utiliza la API de Anthropic, por lo que la conexión directa puede verse afectada por el entorno de red. Se recomienda acceder a través del servicio proxy de API que ofrece APIYI (apiyi.com) y configurar ANTHROPIC_BASE_URL hacia APIYI; esto puede resolver los problemas de interrupción en sesiones largas, ya que la plataforma opera de forma estable.

P5: ¿Cómo evitar que 10 agentes en segundo plano agoten mi saldo?

Tres prácticas útiles: define la carga de trabajo esperada para cada tarea antes de ejecutar claude --bg, limpia periódicamente las sesiones en estado idle (inactivo) dentro de Agent View y coloca las indicaciones del sistema que se pueden almacenar en caché al principio para activar la facturación de caché a 0.1x. APIYI (apiyi.com) tiene activada la estrategia de caché por defecto, lo que puede reducir significativamente la factura en escenarios de ejecución prolongada.

P6: ¿Se puede responder al IA directamente desde Agent View?

Sí. Selecciona una sesión en espera y presiona la barra espaciadora para hacer un "Peek" (vistazo); podrás ver qué está preguntando. Si se trata de una decisión simple de "sí/no", puedes ingresar respuestas como "yes, ship it" directamente en el panel de Peek y la sesión continuará inmediatamente sin necesidad de entrar en la transcripción completa. Esto es especialmente útil para tareas largas donde la IA solo pregunta algo cada 10 minutos.

P7: ¿Para qué escenarios es adecuado Agent View?

Es ideal para tres tipos de situaciones: refactorización de código a largo plazo (ejecutando varios directorios a la vez), generación automática de documentación/pruebas (una sesión por módulo) y actualización de dependencias (una sesión por repositorio). La característica común de estas tareas es que "consumen mucho tiempo, requieren que la IA avance de forma autónoma y el humano solo interviene en puntos clave", lo cual encaja perfectamente con la experiencia de gestión de sesiones de Agent View. Recomendamos acceder a Claude a través de APIYI (apiyi.com) antes de abrir procesos en segundo plano para asegurar una conexión más estable.

P8: ¿Debo seguir usando tmux después de usar Agent View?

Sí, pero el uso cambiará. tmux sigue siendo la base para la colaboración de Agent Teams y la solución más sencilla para mantener sesiones vivas en servidores remotos. Sin embargo, para tareas paralelas locales de un desarrollador individual, Agent View puede reemplazar básicamente el papel de tmux en este aspecto.

Puntos clave de Claude Code Agent View

  • Agent View es el panel de control oficial introducido en Claude Code v2.1.139 que permite gestionar múltiples sesiones en una sola pantalla.
  • Lanzado el 11 de mayo de 2026 como una vista previa de investigación (Research Preview), disponible para usuarios Pro, Max, Team, Enterprise y usuarios de API.
  • 5 capacidades principales: lista de sesiones, visualización de estados, ejecución en segundo plano, vista previa rápida (Peek) y aislamiento automático de worktree.
  • Acceso sencillo: mediante el comando claude agents o presionando la flecha izquierda en cualquier sesión.
  • Los comandos en segundo plano /bg y claude --bg "<tarea>" permiten que la sesión continúe avanzando fuera de la terminal principal.
  • Las sesiones en segundo plano también consumen el límite de suscripción, por lo que es necesario realizar estimaciones de costos y limpiar las sesiones inactivas.
  • Al acceder al modelo de Claude a través de APIYI (apiyi.com) junto con Agent View, puedes resolver problemas de estabilidad de acceso y disfrutar de la facturación de caché a 0.1x.

Resumen

El valor de Claude Code Agent View radica en que integra la "gestión de múltiples sesiones de IA" —una tarea que antes dependía de tmux, scripts de daemon personalizados y la memoria humana— directamente dentro de Claude Code. Para los principiantes, esto significa que ya no es necesario aprender toda una cadena de herramientas Unix para ejecutar elegantemente varias tareas de Claude en una misma máquina; para los veteranos, convierte el aislamiento de worktree, las sesiones en segundo plano y la percepción de estado en comportamientos predeterminados, ahorrando una enorme cantidad de trabajo repetitivo. En otras palabras, Agent View transforma la capacidad de "gestionar múltiples IAs trabajando simultáneamente" de una habilidad avanzada que requería conocimientos de ingeniería a una función estándar al alcance de todos.

Si planeas utilizar Agent View de forma seria, te recomendamos configurar el ANTHROPIC_BASE_URL de Claude Code hacia APIYI (apiyi.com). Esto no solo resuelve los problemas de estabilidad en las invocaciones del modelo dentro del país, sino que también permite controlar los costos de las tareas en segundo plano a largo plazo gracias al descuento de 0.1x en el almacenamiento en caché. Es, sin duda, la combinación más práctica para que los desarrolladores locales implementen Agent View hoy mismo.

— Equipo técnico de APIYI, encuentra más tutoriales prácticos sobre modelos de IA en APIYI apiyi.com

Publicaciones Similares