Claude Code: aviso en el escritorio cuando te necesita

Claude Code trabaja en la terminal (la ventana donde se escriben órdenes). Cuando la tarea es larga, hay dos momentos en los que se queda parado esperándote: cuando necesita tu permiso para hacer algo y cuando ha terminado. Si te has ido a otra pestaña, no te enteras.

Este truco engancha un aviso del sistema a esos momentos. Claude Code tiene un mecanismo llamado hooks (enganches): piezas de configuración que dicen «cuando pase esto, ejecuta tal orden». El que nos interesa se llama Notification y salta cuando Claude pide tu atención.

El aviso es el de tu propio ordenador: un mensaje en el escritorio de Windows, un aviso en macOS o un notify-send en Linux. No hay que instalar nada raro: se usa lo que ya trae tu sistema.

• No quedarte mirando la pantalla. Lanzas la tarea, te vas a lo tuyo y el aviso te llama solo cuando de verdad hacen falta.
• Aprovechar el tiempo. Es lo típico de dejar algo corriendo mientras haces otra cosa.
• No dejarlo a medias sin querer. Si te olvidas de que estaba esperando, la sesión se queda parada y tú crees que sigue trabajando.

Sirve sobre todo si usas Claude Code para tareas que tardan varios minutos: revisar un proyecto, reorganizar ficheros o escribir código largo.

La idea es añadir una orden al fichero de ajustes de Claude Code (settings.json) para que salte un aviso. La documentación oficial trae un ejemplo distinto para cada sistema; elige el tuyo.

• Abre el fichero de ajustes de Claude Code. Está en tu carpeta de usuario, dentro de .claude/settings.json.

• Añade dentro un enganche de tipo Notification con la orden de aviso de tu sistema. Estos son los ejemplos de la documentación oficial:

Linux:

notify-send 'Claude Code' 'Claude Code necesita tu atención'

macOS:

osascript -e 'display notification "Claude Code necesita tu atención" with title "Claude Code"'

Windows (PowerShell): el ejemplo de la documentación usa una ventana de mensaje de PowerShell.

• Guarda el fichero y vuelve a Claude Code.

• Compruébalo. Escribe /hooks dentro de Claude Code: enseña qué enganches tienes puestos y si están bien escritos.

• Pruébalo de verdad. Pídele a Claude algo que necesite tu permiso y déjalo sin contestar. Debe saltarte el aviso.

• Claude Code es de pago. No entra en el plan gratuito de Claude: hace falta un plan Pro o una clave de API. Si no lo usas, este truco no te sirve.
• Hay que editar un fichero de ajustes. Es una línea de texto, pero es un fichero de configuración: si se rompe el formato, Claude Code avisa y no lo lee. Copia el ejemplo tal cual y cambia solo lo que va entre comillas.
• El aviso es de tu ordenador, no del móvil. Salta en el mismo aparato donde está corriendo Claude Code.
• No es un aviso «inteligente». Te dice que Claude necesita atención o que ha terminado, no el detalle de la tarea.

Comprobado el 06/10/2026 en la documentación oficial de Claude Code (code.claude.com/docs/en/hooks-guide, sección «Get notified when Claude needs input»): la sección existe y trae los tres ejemplos por sistema operativo.

1. Me avisa pero el texto sale raro. Puede que hayas cambiado las comillas de más. Deja las comillas tal como aparecen en el ejemplo y cambia solo el texto de dentro.

2. En Linux no salta nada. Puede que tu sistema no tenga notify-send instalado. Prueba a escribir la orden a mano en la terminal; si dice que no existe, instálalo desde el gestor de programas de tu distribución.

3. He roto el fichero y Claude Code se queja. Abre .claude/settings.json y revisa las llaves { } y las comas. Escribe /hooks para ver qué dice. Si no te aclaras, deja el fichero como estaba y empieza de cero.

4. Quiero comprobar que el enganche existe. Escribe /hooks dentro de Claude Code: es la orden oficial para consultarlos y ver los eventos disponibles.