Entiende la versión oficial de las sesiones paralelas
En los videos sobre mods, varias sesiones de Claude trabajaban juntas, con un panel que mostraba quién estaba activo y quién se había bloqueado. Se hacía mediante ingeniería inversa y se rompía con cada actualización.
Hoy, Claude Code lo hace por la vía oficial: claude --bg libera una sesión que trabaja sola, sin bloquear tu terminal. Por debajo, Claude lista estas sesiones con claude agents. El kit envuelve la lectura de esa lista en un script corto, el observar.mjs.
🆕 ¿Eres nuevo aquí? Tres palabras de este módulo
- Sesión — una conversación de Claude Code con memoria propia. Cada vez que abres
claude, se inicia una sesión. - Segundo plan — la sesión se ejecuta sin que tengas una pantalla delante. La dejas correr, vuelves a la terminal y lo revisas después, como cuando dejas la lavadora funcionando.
- id — el código corto, como
d6816239, que identifica la sesión. Usas el id para leer, entrar o detener.
Cómo leer el diagrama: las flechas moradas son los comandos que das. Las cajas azules son las sesiones que trabajan por su cuenta, una al lado de la otra. El observar.mjs solo observa: no detiene ni altera ninguna sesión.
✓ Vía oficial (R4)
- ✓ Comando documentado:
claude --bg - ✓ Cada sesión con su propio nombre, modelo y modo
- ✓ Sigue la misma POLÍTICA del kit
- ✓ Sigue funcionando cuando Claude se actualiza
✗ El «Threads» de los videos
- ✗ Hilo improvisado dentro de la aplicación
- ✗ Desaparece en la próxima actualización
- ✗ Nadie garantiza lo que puede hacer
- ✗ Solo quien lo armó sabe arreglarlo
libera la sesión
el papel de cada una
un solo lugar
cada sesión consume
Marca la carpeta como confiable
Una sesión en segundo plano trabaja sin que tú la estés mirando. Por eso Claude solo acepta iniciarla en una carpeta en la que ya dijiste que confías. Es un paso único por carpeta.
Sin este paso, el --bg responde Workspace not trusted y no hace nada. La receta R4 empieza exactamente aquí.
Abre Claude en la carpeta del kit
En la terminal, dentro de la carpeta, escribe claude. La primera vez que entras en una carpeta nueva aparece un aviso de confianza.
Fíjate en la opción ya seleccionada
El aviso empieza con "No, exit" marcado. Si presionas Enter directamente, Claude se cierra y la carpeta sigue sin ser de confianza.
Cambia a "Yes, I trust this folder"
Cambia la selección a "Yes, I trust this folder" y presiona Enter. Listo: la carpeta queda marcada.
Sal y vuelve a la terminal
Puedes cerrar la sesión. La marca queda guardada y las sesiones en segundo plano ya pueden iniciarse en esta carpeta.
En la terminal, dentro de la carpeta del kit:
claude
En el aviso que aparece:
"No, exit" ← vem selecionado: NÃO aperte Enter aqui "Yes, I trust this folder" ← escolha esta
⚠️ Confía solo en carpetas que conozcas
Confiar en una carpeta permite que Claude lea las instrucciones y los archivos que están allí. Marca la carpeta del kit y tus carpetas de trabajo. Si descargaste una carpeta de un tercero, léela antes (el módulo 4.3 habla de esto).
por carpeta
viene marcado
la elección correcta
el error si lo olvidas
Libera las sesiones en segundo plano
La receta R4 inicia dos sesiones. Un revisor que solo lee y responde una pregunta sobre la POLÍTICA. Y un ejecutor, en un modelo más ligero, que crea un archivo.
Cada línea devuelve el terminal de inmediato. Las dos sesiones siguen trabajando por su cuenta, al mismo tiempo.
En la terminal, dentro de la carpeta del kit (ya marcada como confiable), una línea a la vez:
claude --bg --permission-mode plan --name revisor "Lee runtime/POLITICA.md y responde en una línea cuál es el límite de 'Enviar'." claude --bg --model sonnet --name executor "Crea resumen.md con 3 líneas sobre qué es este kit."
Resultado comprobado en CHANGELOG 0.2.0:
sessão listada como background … done; respondeu "N2" lendo a POLITICA
background. La respuesta correcta del revisor es N2, que es el límite de “Enviar” en la tabla de POLITICA.| Fragmento del comando | Qué hace | Por qué aquí |
|---|---|---|
--bg | libera la sesión en segundo plano | el terminal queda libre de inmediato |
--permission-mode plan | la sesión solo lee y planifica, no modifica nada | el revisor no necesita modificar archivos |
--model sonnet | elige un modelo más ligero | tres líneas de resumen no requieren el nivel máximo |
--name | le da nombre a la sesión | es el nombre que aparece en la tabla de observar |
Qué revisar en la tabla: el modo y el modelo siguen las reglas de ROTEAMENTO.md y de la POLITICA.md que viste en el módulo 3.1. Quien solo lee se ejecuta en modo plano. Quien hace poco se ejecuta en el modelo más pequeño que lo resuelve.
⛔ No unas -p con --bg
O -p (que usaste en R2) responde y termina. El --bg libera y déjalo ejecutándose. Claude rechaza ambos juntos, con el mensaje --bg and --print conflict. Esto se aprendió en la prueba de la versión 0.2.0 del kit.
modo de plan
sonnet, crea un archivo
la respuesta correcta
entra en conflicto con --bg
Supervisa con observar
O runtime/scripts/observar.mjs muestra en una tabla las sesiones en segundo plano de esta carpeta. Solo lee la lista que Claude devuelve en claude agents --json. No detiene ni altera ninguna sesión.
Ejecútalo cuantas veces quieras: no llama a ningún modelo ni consume cuota.
En la terminal, dentro de la carpeta del kit:
node runtime/scripts/observar.mjs
Salida real (05/10/2026, Linux). En la prueba del kit, la sesión se llamaba r4-revisor; con --name revisor, la tuya aparece como revisor:
id tipo nome estado iniciada há d6816239 background r4-revisor done 7 min ver saída: claude logs <id> · entrar: claude attach <id> · parar: claude stop <id>
tipo = background y el nombre que le diste. Para ver las sesiones de todas las carpetas, ejecuta node runtime/scripts/observar.mjs --todas.Cómo leer el diagrama: el buen camino va de izquierda a derecha hasta done. Las líneas rojas discontinuas son las desviaciones: una sesión puede bloquearse mientras espera un permiso (blocked) o fallar (failed). En ambos casos, depende de ti.
💡 Por qué ocurre «blocked»
Cada sesión sigue la POLITICA. Si quien ejecuta necesita algo con límite N2, como un comando que modifica el sistema, se detiene y lo pide. En segundo plano nadie ve la solicitud de inmediato: por eso existe observar.
no para nada
código corto
5 valores
todas las carpetas
Entra, lee y detén una sesión
El propio pie de página de observar recuerda los tres comandos. Todos usan el id de la primera columna de la tabla, por ejemplo d6816239.
Leer siempre es seguro. Iniciar sesión sirve para desbloquear una sesión blocked. Detenerse es la salida cuando consume cuota sin llegar a ninguna parte.
| Comando | Hace | Usa cuando |
|---|---|---|
claude logs <id> | muestra la pantalla de la sesión | ver la respuesta de uno done o el error de uno failed |
claude attach <id> | entra en la sesión para conversar | responder la solicitud de un blocked |
claude stop <id> | para la sesión | sesión que da vueltas en círculo o solicitud incorrecta |
Qué revisar en la tabla: cambia <id> por el código que mostró observar. Sin los signos menor y mayor.
En la terminal, cambiando <id> por el ID del revisor en la tabla de observar:
claude logs <id>
Resultado comprobado en CHANGELOG 0.2.0:
o revisor respondeu "N2" lendo a POLITICA
runtime/POLITICA.md: la línea "Enviar" dice N2.✓ Detente sin miedo cuando
- ✓ El pedido salió mal y quieres rehacerlo
- ✓ La sesión repite el mismo intento
- ✓ Ella continúa
workingmucho más de lo esperado - ✓ Iniciaste demasiadas sesiones a la vez
✗ No hagas
- ✗ Aprobar todo al entrar en un
blockedsin leer la solicitud - ✗ Dejar
failedsin abrir el registro - ✗ Detener una sesión de otro proyecto desde la opción vista
--todas - ✗ Volver a lanzar la misma tarea sin detener la anterior
💡 ¿Prefieres botones?
El kit incluye un mod opcional, el runtime-painel. Dentro de Claude Code, el comando /painel muestra las mismas sesiones con los botones Actualizar e Detener. Solo tu clic para una sesión. Lo configuras en el módulo 4.3.
leer la pantalla
entrar y conversar
detener la sesión
la versión con botones
Combina los resultados sin exceder la cuota
Cada sesión guarda el resultado en un archivo, como el resumo.md del ejecutor. Al final, una sesión "jefe" (o el equipo de R2) lee estos archivos y consolida todo en una sola respuesta.
El cuidado es la cuota: cada sesión consume la de tu suscripción. La propia R4 avisa: empieza por la R2, que se ejecuta en una sola sesión, y abre sesiones paralelas cuando el ahorro de tiempo lo justifique.
Abre claude en la carpeta del kit y pega:
Use o time (planejador, executor, revisor) para ler resumo.md, conferir se ele tem 3 linhas sobre o que é este kit e me dizer APROVADO ou o que falta. Não altere outros arquivos.
APROVADO o con FALTA: y la lista de lo que hay que corregir, que es el formato del revisor en .claude/agents/revisor.md.| Situación | Usa | Por qué |
|---|---|---|
| Clara quiere que se verifiquen los horarios disponibles de la semana | R2, una sesión | tarea corta: el equipo cabe en una conversación |
| Sônia cierra el mes de varios clientes, cada uno con su CSV | R4, una sesión por cliente | partes independientes que van juntas |
| Una sola pregunta sobre la POLÍTICA | una sesión con el modelo más pequeño | el equipo ahí solo consume cuota |
Qué revisar en la tabla: es la regla 2 del ROTEAMENTO.md en la práctica. Usa un equipo de agentes solo cuando el trabajo sea más grande que el costo de armar el equipo.
💡 Dos sesiones, un archivo: ten cuidado
Si dos sesiones editan el mismo archivo, una puede deshacer lo que hizo la otra. Dale a cada sesión su propio archivo de salida. La protección contra colisiones del kit pregunta antes de que ocurra ese daño (módulo 4.3).
Prueba rápida (opcional): ejecutaste claude --bg y recibió Workspace not trusted. ¿Qué hacer?
por sesión
consolida al final
una sola sesión
el guardián pregunta
🎓 Resumen del módulo
Próximo módulo:
3.4 — Agente de larga duración con verificación