Monitor de Claude Code: vigila logs y CI en segundo plano

¿Y si Claude Code vigilara tus logs o tu CI mientras sigues trabajando? 👀 La herramienta Monitor lanza un proceso en segundo plano y le avisa de cada línea. Guía con límites y permisos:

Tarjeta con el título Monitor de Claude Code: vigila logs y CI en segundo plano

La herramienta Monitor de Claude Code ejecuta un comando en segundo plano y le entrega a Claude cada línea de salida a medida que aparece, para que pueda reaccionar a un log, a un cambio de archivos o al estado de un CI sin que tú dejes de trabajar en la misma sesión. El registro oficial de cambios la menciona en la versión 2.1.310, fechada el 23 de octubre de 2026. Aquí tienes cómo funciona, qué límites tiene y qué cuidar en permisos.

Qué cambió y cuándo

En la entrada de la versión 2.1.310 (23 de octubre de 2026), el changelog oficial indica que se añadió la herramienta Monitor y los monitores de plugins en Bedrock, Vertex y Foundry, y también cuando la telemetría o el tráfico no esencial están desactivados. Dicho de otro modo: ese cambio amplía los entornos donde se puede usar.

Ojo con un detalle: al revisar la página de referencia de herramientas, esta todavía enumera esos mismos entornos como no compatibles. Es probable que la documentación vaya por detrás del changelog. Si usas uno de esos proveedores o tienes la telemetría apagada, comprueba tu versión y prueba la herramienta antes de apoyarte en ella.

Qué hace Monitor

Según la documentación, Claude suele escribir un pequeño script, lo lanza en segundo plano y recibe cada línea de salida como un evento. Los usos que menciona la página oficial son:

  • seguir un archivo de log y avisar de errores;
  • consultar un pull request o un trabajo de CI y reportar cambios de estado;
  • vigilar un directorio por cambios de archivos;
  • seguir la salida de cualquier script de larga duración;
  • conectarse a un WebSocket y reportar cada mensaje.

La diferencia con ejecutar un comando normal es que no tienes que esperar a que termine: la sesión sigue disponible mientras el vigilante corre aparte. Si quieres entender antes cómo decide Claude qué puede ejecutar, repasa los permisos y modos de Claude Code.

Requisitos y límites

AspectoQué dice la documentación
PermisoRequiere permiso, igual que Bash: las reglas de Bash se aplican también a Monitor.
ProveedoresLa página de herramientas aún lista Bedrock, Vertex y Foundry como no disponibles (el changelog 2.1.310 dice lo contrario).
TelemetríaLa página de herramientas dice que no está disponible con DISABLE_TELEMETRY o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC (también contradicho por 2.1.310).
WindowsSolo con Git Bash instalado.
DuraciónCada vigilancia tiene un plazo: 5 minutos por defecto, máximo 30, y máximo 10 en ejecuciones no interactivas con -p.

Cuando se cumple el plazo, la vigilancia termina y Claude recibe un aviso para que pueda reiniciarla si hace falta. Para detenerla antes, pídele a Claude que la cancele o cierra la sesión.

Paso a paso: probarla en un proyecto

1. Actualiza Claude Code

Usa una versión igual o posterior a 2.1.310 para tener la herramienta disponible en los entornos que menciona el changelog. La página de herramientas no indica una versión mínima general.

2. Pídele a Claude que vigile algo concreto

No hay un comando especial: se lo pides en lenguaje natural. Este es un ejemplo de petición (es nuestro, no viene de la documentación y no lo ejecutamos):

Vigila el archivo logs/app.log con Monitor y avísame solo cuando aparezca una línea con ERROR.
Si pasan 5 minutos sin errores, dímelo y detén la vigilancia.

3. Aprueba el permiso

Como Monitor sigue las reglas de permisos de Bash, Claude Code te pedirá confirmar el comando la primera vez, salvo que una regla permitida ya lo cubra. Un patrón como Bash(npm run *) se aplica tanto a Bash como a Monitor.

4. Trabaja con normalidad

Mientras el vigilante corre, puedes seguir pidiendo otras cosas. Cuando llegue una línea relevante, Claude la recibe y puede avisarte o actuar según lo que le hayas pedido.

Vigilar un WebSocket

Si el servidor empuja eventos, Claude puede abrir un WebSocket en lugar de lanzar un comando. La documentación describe estas reglas: la entrada ws sustituye a command (no se combinan), la URL debe ser ws:// o wss:// sin credenciales incrustadas, cada mensaje de texto es un evento, los binarios aparecen como un marcador, los mensajes de más de 1 MiB terminan la vigilancia y cerrar el socket también la termina. Abrir un socket pide aprobación cada vez, sin opción de omitirla para ese host, y se deniegan direcciones privadas, locales y de metadatos de nube.

Monitores dentro de un plugin

Los plugins pueden declarar monitores que arrancan solos cuando el plugin está activo, sin que Claude tenga que lanzarlos. Se declaran en plugin.json bajo experimental.monitors, ya sea apuntando a un archivo (por defecto monitors/monitors.json) o con la lista en línea. Este ejemplo viene de la referencia oficial de plugins:

{
  "experimental": {
    "monitors": [
      {
        "name": "deploy-status",
        "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/poll-deploy.sh",
        "description": "Deployment status changes",
        "when": "on-skill-invoke:deploy"
      }
    ]
  }
}
  • name, command y description son obligatorios.
  • when es opcional: "always" (por defecto) arranca al iniciar la sesión; "on-skill-invoke:<skill>" arranca la primera vez que se ejecuta esa skill.
  • Cada entrada es estricta: una clave desconocida es un error y el plugin no carga.
  • Los procesos del monitor no reciben variables como CLAUDE_PLUGIN_ROOT en su entorno, aunque ${CLAUDE_PLUGIN_ROOT} sí se resuelve dentro de command.
  • Los monitores no arrancan con la opción -p.

Para validar el manifiesto, la documentación indica claude plugin validate ./mi-plugin, con --strict para que las advertencias fallen en CI. No ejecutamos este comando. Si te interesa probar plugins con casos reales, mira cómo usar claude plugin eval.

Seguridad y costos

  • Permisos: trata un monitor como cualquier comando de Bash. Revisa qué script va a correr antes de aprobarlo.
  • Modo automático: según la documentación, Claude Code descarta las reglas permitidas que nombran a Monitor, de modo que el clasificador revisa esos comandos como los de Bash.
  • Memoria: en Linux y WSL puedes limitar la memoria de Bash, PowerShell y Monitor con CLAUDE_CODE_TOOL_MEMORY_LIMIT (v2.1.233 o posterior; antes de v2.1.246 Monitor quedaba fuera del límite).
  • Contexto: cada línea que llega ocupa contexto de la conversación. Pide filtros estrictos (por ejemplo, solo ERROR) para no llenarlo de ruido. Esto es una recomendación nuestra, no una cifra de la documentación.

Si lo que buscas es automatizar reacciones fijas sin intervención del modelo, quizá te convenga más un hook de Claude Code.

Qué significa para quien programa

Monitor sirve para tareas que antes obligaban a quedarte mirando una terminal: esperar a que termine un despliegue, vigilar un log mientras reproduces un fallo o enterarte cuando cambia el estado de un CI. Su valor está en que el modelo recibe los eventos y puede proponer el siguiente paso. Su límite es el plazo de unos minutos por vigilancia, así que no sustituye a un sistema de alertas permanente.

Preguntas frecuentes

¿Monitor es lo mismo que un hook?

No. Un hook ejecuta un comando en un evento del ciclo de vida de Claude Code; Monitor mantiene un proceso vivo y le pasa su salida a Claude para que la interprete.

¿Cuánto tiempo puede vigilar?

Por defecto 5 minutos, con un máximo de 30 minutos, y de 10 en ejecuciones no interactivas con -p, según la documentación de herramientas.

¿Funciona en Windows?

Sí, pero solo si tienes Git Bash instalado, según la misma página: «On Windows, the tool is available only when Git Bash is installed.»

Fuentes

Lecturas relacionadas en este sitio: permisos y modos, sandbox de Claude Code y hooks.

Última revisión: 19 de noviembre de 2026. Este artículo fue preparado con ayuda de IA; consulta cómo usamos la IA. Los comandos y ejemplos provienen de la documentación oficial o son ejemplos propios y no se ejecutaron. Partes de la documentación se leyeron de forma resumida, y la página de herramientas y el changelog no coinciden en la disponibilidad por proveedor: verifica en tu instalación.