Gestionar varias sesiones de Claude Code en paralelo

Para ejecutar varias sesiones de Claude Code, abre un agente independiente en cada panel de Paneflow y asígnale una tarea delimitada. Usa worktrees de Git separados cuando ambas sesiones vayan a modificar el mismo repositorio. Paneflow mantiene visibles los terminales, el contexto y la actividad; tú decides qué puede cambiar cada sesión y cuándo está listo su resultado.

Esta guía describe la gestión de sesiones en Paneflow 0.17.4. Instala y autentica Claude Code por separado en el shell que vayas a utilizar. Paneflow es software libre bajo GPL-3.0-or-later; el acceso y el uso de Claude Code siguen sujetos a su proveedor.

La barra lateral mantiene visibles las tareas, ramas y estados de los proyectos junto al terminal activo de Claude Code.

¿Sesiones independientes o subagentes?

Las sesiones independientes encajan con tareas que quieres dirigir personalmente: una conversación para un error y otra para la documentación, cada una con su terminal y, cuando haga falta, su checkout. Lees y respondes a cada sesión por separado.

Los subagentes de Claude Code realizan trabajo delegado dentro de una sesión, usan su propio contexto y devuelven resultados a la conversación principal. Elige ese modelo cuando una conversación principal deba coordinar una investigación delimitada. Abrir dos paneles de Paneflow no establece esa delegación ni comparte sus historiales automáticamente.

Para combinar herramientas, consulta la guía de Claude Code y Codex en paralelo. Los pasos siguientes se centran en varias instancias de Claude Code.

Una tarea revisable para cada sesión

Empieza con dos contribuciones independientes a un proyecto existente: actualizar docs/setup.md en una sesión y añadir pruebas de casos límite para un analizador ya implementado en la otra. Si las pruebas dependen de una reescritura del analizador aún en curso, termina primero esa reescritura.

Antes de empezar, concreta cuatro puntos por tarea:

• El resultado esperado y los archivos que la sesión puede modificar.
• Los archivos asignados a otra tarea, que debe dejar intactos.
• El comportamiento o la interfaz existente en los que puede apoyarse.
• La comprobación que demostrará el resultado y las decisiones que requieren tu intervención.

Mantén las instrucciones del proyecto disponibles en cada checkout. Una sesión nueva no hereda el plan sin guardar, las decisiones ni la conversación de otra.

Archivos compartidos o un worktree separado

Un segundo panel abre otro terminal; no aísla los archivos. Para cambios independientes en el mismo repositorio, crea una rama con Worktree activado en New branch y abre Claude Code allí. Repite el proceso para la otra tarea desde la base elegida. La referencia de worktrees explica su creación, reutilización y eliminación.

Los worktrees son opcionales. Una investigación de solo lectura puede usar un checkout existente si aceptas que los archivos cambien mientras los lee. Dos sesiones que escriben en archivos compartidos necesitan coordinación explícita; otro nombre de rama en el mismo checkout no crea una segunda copia de esos archivos.

Comprueba el directorio, la rama y los cambios existentes en cada panel antes de asignar trabajo:

git rev-parse --show-toplevel
git branch --show-current
git status --short

Las dependencias, puertos de servidores, bases de datos y límites del proveedor requieren atención por separado. Un worktree separa archivos de trabajo, no el acceso a la red ni los servicios activos.

Encontrar la sesión que necesita atención

Abre Settings > Agents y comprueba la integración de Claude Code. Install hooks activa los informes del ciclo de vida; la referencia de supervisión describe la configuración y el comportamiento sin hooks. Paneflow utiliza la integración disponible para mostrar actividad y solicitudes de intervención.

Cuando una sesión necesite atención, abre su terminal y lee la solicitud antes de aprobarla. Cuando termine un turno, inspecciona lo que produjo. El estado de finalización indica un evento del agente, no la aceptación de la implementación ni la superación de las pruebas. Si el estado parece incorrecto, lee la salida del terminal antes de iniciar una tarea duplicada.

Limita el número de sesiones a lo que puedas revisar. Más procesos activos solo ayudan si el trabajo avanza de forma independiente y puedes integrar los resultados.

Revisar cambios y recuperar el contexto

Guarda los búferes del editor e inspecciona Changes en el checkout de la tarea. Compara cambios preparados, no preparados y archivos sin seguimiento con su HEAD. Los commits de la rama requieren una revisión aparte. Comprueba la validación de la tarea, integra las contribuciones revisadas con tu flujo habitual de Git y verifica el árbol combinado. Los worktrees separados también pueden producir conflictos de fusión.

Para cerrar la ventana y conservar los terminales activos, elige Keep sessions running. Al volver a abrir, se reconectan mientras el host y la máquina sigan activos; la guía de persistencia explica los límites del apagado y la suspensión. Si el proceso terminó, Sessions puede cargar una conversación guardada de Claude Code para el directorio activo. Restart solo inicia un shell nuevo.

¿Puede Paneflow gestionar varias sesiones de Claude Code?

Sí. Paneflow ejecuta terminales independientes de Claude Code, organiza su contexto por proyecto y muestra su actividad mediante la integración disponible. No combina sus contextos de modelo ni elimina la necesidad de revisar el trabajo.

¿Cada sesión necesita un worktree de Git?

No. Usa un worktree cuando una tarea necesite sus propios archivos y su rama. Las sesiones que solo leen un checkout compartido pueden usarlo directamente, aunque pueden ver cambios de otra sesión.

¿Más sesiones permiten evitar los límites de Claude Code?

No. Paneflow no cambia los límites de cuenta, concurrencia o uso del proveedor. Reduce el paralelismo cuando las tareas compitan por la misma cuota, recursos de la máquina o resultados aún incompletos.