Claude Code envía una notificación cuando finaliza una tarea o se detiene ante una solicitud de permiso mientras usted parece estar ausente. Puede mostrarla como notificación de escritorio, como señal sonora en la terminal o mediante cualquier acción que pueda ejecutar un hook de Notificación. La opción que necesita depende de su terminal y de cuántas sesiones ejecute simultáneamente.
1. Notificaciones de escritorio
En Ghostty, Kitty e iTerm2, las notificaciones de Claude Code aparecen como notificaciones de escritorio sin necesidad de configuración adicional.
En iTerm2, si no se muestran, abra Settings > Profiles > Terminal, active Notification Center Alerts y, en Filter Alerts, permita las alertas generadas por secuencias de escape. Compruebe también que la aplicación de terminal tenga permisos de notificación en los ajustes de su sistema.
Estas notificaciones también le llegarán desde una sesión remota a través de SSH.
En la aplicación de escritorio de Claude, la pestaña Code envía su propia notificación de escritorio cuando una sesión completa una tarea mientras usted no la está visualizando. Una sesión iniciada desde Dispatch en su teléfono envía una notificación push allí cuando finaliza o necesita su aprobación.
Si su terminal implementa el protocolo de estado de programas OSC 7501, Claude Code 2.1.295 o posterior también informa si cada sesión interactiva está trabajando, esperando por usted o terminada, sin necesidad de activar nada. La documentación de su terminal indicará si admite el protocolo y dónde muestra dicho estado.
2. El aviso sonoro de la terminal
Otras terminales, como Apple Terminal, Warp o la terminal integrada de VS Code, no reciben la notificación de escritorio. En su lugar, puede solicitar una señal sonora. Añada esto a ~/.claude/settings.json:
{
"preferredNotifChannel": "terminal_bell"
}Si utiliza tmux, añada set -g allow-passthrough on a ~/.tmux.conf para que la notificación se transmita a la terminal externa.
Si sus sesiones se ejecutan dentro del Subsistema de Windows para Linux, consulte Claude Code WSL notifications: get alerts on Windows para ver la configuración de la señal sonora en Windows Terminal y los hooks de PowerShell.
3. Un hook de Notificación
Un hook ejecuta su propio comando cuando Claude requiere su atención: un sonido, una alerta en el escritorio o un mensaje en su teléfono. Se ejecuta en paralelo a la notificación integrada. En Mac, esto reproduce un sonido:
{
"hooks": {
"Notification": [
{
"hooks": [
{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }
]
}
]
}
}El evento Notification incluye tipos por los que puede filtrar, incluidos permission_prompt e idle_prompt, lo que permite tratar la solicitud de aprobación de forma distinta a la espera de su próximo mensaje. Un hook Stop independiente se ejecuta cuando Claude termina de responder. Ninguno de estos tipos cubre las preguntas de opción múltiple de Claude. Consulte Know when Claude Code asks you a question or wants a plan approved para ver el hook que lo gestiona.
Si ejecuta sesiones en segundo plano, la vista de agentes (claude agents, vista previa de investigación) también le notifica mientras permanece abierta cuando una de ellas necesita información, finaliza o falla. Activa el hook Notification con el tipo agent_needs_input o agent_completed, de modo que un script pueda reaccionar a ellos también. Consulte Vista de agentes en Claude Code: ejecutar y supervisar sesiones en segundo plano para aprender a iniciar sesiones en segundo plano y responder a ellas.
Para ver cómo encaja Notification junto con PreToolUse, PostToolUse, Stop y los demás eventos de hooks, lea Claude Code hooks: events, matchers, settings and handlers.
Cuál utilizar
| You run | Use |
|---|---|
| Una sesión, Ghostty, Kitty o iTerm2 | Notificaciones de escritorio integradas |
| Una sesión, otra terminal | terminal_bell |
| Desea un sonido o una acción personalizada | Un hook de Notificación |
| Varias sesiones a la vez | Una pantalla que muestre qué sesión está esperando |
Cuando las notificaciones no son suficientes
Una notificación indica que una sesión requiere su atención. Con cuatro sesiones abiertas, todavía tiene que buscar cuál es, y una vez que descarta el aviso, desaparece.
Para una comparación más amplia de tmux, hooks, la vista de agentes, los paneles del IDE y los pads de estado, consulte How to monitor multiple Claude Code sessions.
Orbtile muestra cada sesión como su propia casilla en un iPhone, un teléfono Android o en el Logitech MX Creative Keypad. Una sesión en espera se ilumina con el color de alerta de su agente y pasa al primer plano, la casilla muestra lo que está solicitando y usted puede responder a las solicitudes compatibles desde el teclado: pulse Denegar o mantenga presionado Permitir durante 0,6 segundos. Utiliza los hooks de Claude Code a través de su propio complemento, por lo que sus notificaciones continúan funcionando como antes.
Si también ejecuta Kimi Code, consulte Kimi Code notifications: hooks, NotifyUser and TUI settings para ver cómo funcionan sus hooks y actualizaciones de progreso.
FAQ
Why don't I get notifications in the VS Code terminal?
No recibe la notificación de escritorio de Claude Code. Establezca preferredNotifChannel en terminal_bell o añada un hook de Notificación.
Can I get notified only for permission prompts?
Sí. Asigne al hook Notification el filtro permission_prompt.
Does Orbtile change my Claude Code settings?
Instala su complemento a través de la propia línea de comandos de Claude Code. Si eso falla, edita ~/.claude/settings.json guardando previamente una copia con fecha. Al eliminar el complemento en los ajustes de Orbtile, se da de baja del sistema.