CPU & Memory Guard: Claude Code sin dejarte el ordenador lento
Una skill y un plugin para Claude Code. Las tareas pesadas esperan en una cola común a todas las sesiones y se ejecutan con prioridad baja, el navegador automático funciona sin GPU y un hook impide abrir más de dos a la vez. Así puedes seguir trabajando mientras Claude trabaja.
- Funciona en
- Claude Code
- Sistemas
- Windows, macOS y Linux (probada en Windows 11)
- Requisitos
- Python 3 y Node.js 18 o posterior. agent-browser, solo para los límites del navegador
- Privacidad
- Sin red: solo archivos de bloqueo en tu equipo
- Licencia
- MIT, gratis
- Versión
- 1.0.0
Por qué la hicimos
- Revisando el modo oscuro de esta web, Claude Code abrió 100 páginas seguidas en un Chrome sin ventana, cada una con su animación WebGL y sus vídeos: la GPU se quedó al 100 % durante minutos.
- Con dos sesiones de Claude a la vez, cada una lanza su build, sus tests y su navegador, y la CPU y la memoria no dan para todo.
- Las sesiones de navegador que quedan abiertas al terminar siguen ocupando memoria.
- CPU & Memory Guard pone orden: una tarea pesada a la vez, con prioridad baja, y solo las páginas necesarias.
Cómo instalarla
En Claude Code, como plugin (skill y hook)
Escribe este comando en Claude Code:
/plugin install cpu-memory-guard --marketplace agenciaRSE/cpu-memory-guardNavegador sin GPU (si usas agent-browser)
Añade esto al bloque env de ~/.claude/settings.json y abre una sesión nueva de Claude Code:
"AGENT_BROWSER_ARGS": "--disable-gpu,--force-prefers-reduced-motion"En Claude Code, a mano
Copia la carpeta skills/cpu-memory-guard del repositorio en ~/.claude/skills/.
Añade el hook guard.mjs en ~/.claude/settings.json, como explica el README.
Úsala
No tienes que hacer nada: Claude la carga cuando la tarea es pesada o cuando le dices que el ordenador va lento. También puedes usar la cola tú mismo:
python ~/.claude/skills/cpu-memory-guard/scripts/queue.py --name "build" -- npm run buildQué hace
- Cola para toda la máquina:
queue.pyejecuta una tarea pesada a la vez entre todas las sesiones de Claude Code. Si la cola está ocupada, la tarea espera su turno. - Prioridad baja: la tarea corre «por debajo de lo normal» en Windows (nice 10 en macOS y Linux) y sus procesos hijos lo heredan, así que tus programas van primero.
- Navegador ligero: con
AGENT_BROWSER_ARGS, el Chrome de agent-browser no usa la GPU y pide «reducir movimiento», así que las páginas paran sus animaciones y sus vídeos. - Límite de navegadores: el hook impide abrir una tercera sesión de agent-browser y bloquea los bucles que abren muchas páginas fuera de la cola, con un mensaje que dice qué hacer.
- Muestrear antes que barrer: Claude revisa una página por plantilla en lugar de la web entera, reutiliza una sesión de navegador y la cierra al terminar.
- Si dices que va lento, Claude para lo pesado al momento y sigue por la cola o con menos páginas.
Privacidad y seguridad
- Nada sale de tu equipo:
queue.pysolo crea pequeños archivos de bloqueo en%LOCALAPPDATA%\claude-queue(o~/.cache/claude-queue). - El hook lee el comando que Claude va a ejecutar y solo actúa si contiene
agent-browser. Si no puede consultar las sesiones abiertas, no bloquea nada. - Usa solo la librería estándar de Python y Node.js, sin dependencias. El código es abierto: puedes leerlo antes de instalarlo.
Creada y mantenida por AGENCIA RSE, un estudio de WordPress y software a medida de A Coruña. La usamos en todas nuestras sesiones de Claude Code. Ver todas nuestras skills de Claude
Preguntas frecuentes
¿Por qué Claude Code deja el ordenador lento?
Porque no espera: puede lanzar un build, una batería de tests y un navegador sin ventana a la vez, y repetirlo en cada sesión abierta. Con navegadores automáticos que abren muchas páginas con animaciones o vídeos, la GPU y la memoria se agotan enseguida.
¿Limita la memoria que usa Claude Code?
No pone un tope de memoria al propio Claude Code. Evita que se acumulen tareas pesadas a la vez, baja su prioridad y cierra los navegadores que ya no hacen falta, que es lo que suele agotar la memoria.
¿Necesito agent-browser?
No. La cola y las reglas funcionan sin él. El hook y la configuración del navegador solo actúan sobre agent-browser.
¿Y si necesito ver una animación o WebGL?
Abre una sesión aparte sin esos ajustes (con AGENT_BROWSER_ARGS vacío), revisa lo que necesites y ciérrala.
¿Funciona en Mac y Linux?
Sí. En macOS y Linux la prioridad baja es nice 10. La hemos probado en Windows 11.
¿Es gratis?
Sí. Es código abierto con licencia MIT.
¿Necesitas una skill de Claude a medida?
Creamos skills de Claude por encargo con los procesos, plantillas y scripts de tu equipo, para Claude Code, Claude Desktop y claude.ai.
Primera consulta sin coste. Analizamos lo que nos cuentas y te damos una respuesta en 48 h laborables.