Notificaciones de Claude Code en tu Mac: cuando termina o te necesita.

El aviso integrado de Claude Code se activa cuando Claude termina una tarea o se detiene para pedir permiso y parece que no estás pendiente del terminal. Que ese aviso aparezca como un banner depende de la app de terminal.

Claude Code tiene un ajuste para esto: preferredNotifChannel. En Claude Code, escribe /config y abre Local notifications. El valor por defecto es auto. Las demás opciones son terminal_bell, iterm2, iterm2_with_bell, kitty, ghostty y notifications_disabled.

La campana del terminal es el sonido breve o destello que emite un terminal cuando un programa reclama tu atención. Para usarla en Terminal.app, Warp o VS Code, también puedes añadir esta línea a un archivo de configuración de Claude Code, como ~/.claude/settings.json, dentro de sus llaves exteriores:

"preferredNotifChannel": "terminal_bell"

• iTerm2: abre Settings > Profiles > Terminal, marca Notification Center Alerts, haz clic en Filter Alerts y activa Send escape sequence-generated alerts.
• Terminal.app: para que la campana se note más, abre Settings > Profiles > Advanced y, en Bell, elige que el icono del Dock muestre un distintivo o dé saltos cuando Terminal esté en segundo plano. Si aceptaste la configuración del terminal que ofrece Claude Code al iniciarse por primera vez, se desactivó la campana audible de Terminal. Marca Audible bell en ese mismo apartado si quieres oírla.
• Cualquier terminal: la propia app de terminal necesita permiso para mostrar notificaciones en Ajustes del Sistema > Notificaciones.

Algunas publicaciones antiguas indican que ejecutes claude config set. Ese comando ya no existe: usa /config o edita el archivo de configuración.

Un hook es un comando de shell que Claude Code ejecuta en un momento determinado. Los hooks se definen en un archivo de configuración. Funcionan en todos los terminales, porque el terminal no interviene en su ejecución.

La propia receta de Anthropic para recibir avisos usa el evento Notification. Ese evento solo te avisa de que Claude ha terminado mediante idle_prompt, unos 60 segundos después, y solo si no has escrito nada desde entonces. Para recibir un aviso en cuanto Claude se detenga, usa Stop.

Un turno que termina con un error de la API, como un límite de solicitudes, activa StopFailure en lugar de Stop. Los hooks de notificación no pueden bloquear nada: solo ejecutan tu comando.

Cada fragmento de abajo va en ~/.claude/settings.json, cuya configuración se aplica a todos tus proyectos. Se ha comprobado que cada uno tiene una sintaxis válida de JSON y shell, y ninguno necesita software adicional.

Un banner en el Mac cuando Claude termina.

En ~/.claude/settings.json

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title \"Claude Code\" sound name \"Glass\"' -e 'end run' \"Finished in ${PWD##*/}\""
          }
        ]
      }
    ]
  }
}

Un banner en el Mac cuando Claude necesita tu permiso.

En ~/.claude/settings.json

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt|elicitation_dialog|elicitation_url_dialog",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title \"Claude Code needs you\" sound name \"Ping\"' -e 'end run' \"Waiting for your OK in ${PWD##*/}\""
          }
        ]
      }
    ]
  }
}

Ambos banners muestran el nombre de la carpeta donde se ejecuta la sesión.

Permite que Editor de Scripts muestre los banners.

En Mac, los banners de osascript proceden de la app integrada Editor de Scripts. Hasta que Editor de Scripts tenga permiso para mostrar notificaciones, el comando falla sin avisar y macOS no te pide permiso.

1. En Terminal, ejecuta esto una vez:

osascript -e 'display notification "test"'

2. Abre Ajustes del Sistema > Notificaciones, busca Editor de Scripts y activa Permitir notificaciones.

Un sonido en lugar de un banner.

En ~/.claude/settings.json

{
  "hooks": {
    "Stop": [
      { "hooks": [ { "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" } ] }
    ],
    "Notification": [
      { "matcher": "permission_prompt", "hooks": [ { "type": "command", "command": "afplay /System/Library/Sounds/Ping.aiff" } ] }
    ]
  }
}

Un aviso de voz.

En ~/.claude/settings.json

{
  "hooks": {
    "Stop": [
      { "hooks": [ { "type": "command", "command": "say \"Claude has finished\"", "async": true } ] }
    ],
    "Notification": [
      { "matcher": "permission_prompt", "hooks": [ { "type": "command", "command": "say \"Claude needs your permission\"", "async": true } ] }
    ]
  }
}

"async": true permite que Claude Code siga trabajando mientras el Mac habla.

Para recibir un banner con un evento y un sonido con el otro, usa el generador de hooks de notificación dos veces: elige un evento y su tipo de aviso cada vez, y después usa el cuadro para combinar configuraciones y añadir ambos resultados a tu archivo. El generador te indica en qué archivo va cada fragmento y todo se ejecuta en tu navegador.

• Marca la carpeta como de confianza. Claude Code no ejecuta ningún hook, ni siquiera los de ~/.claude/settings.json, hasta que aceptas el diálogo de confianza del espacio de trabajo para esa carpeta.
• Comprueba qué se ha cargado. Escribe /hooks en Claude Code. Muestra tus hooks y el archivo del que procede cada uno, pero no permite añadirlos. Claude Code suele detectar tus cambios por sí solo. Si no lo hace, reinicia la sesión.
• Macs de empresa. Una organización puede permitir únicamente sus propios hooks administrados. En ese caso, /hooks muestra «Only hooks from managed settings run here» y los hooks personales no se ejecutan.
• Dos avisos a la vez. Los hooks de todos los niveles de configuración se acumulan. Por tanto, si hay un hook de aviso en un archivo del proyecto y otro distinto en tu archivo de usuario, se activan ambos. Un hook exactamente igual en varios archivos solo se ejecuta una vez. Los hooks también se ejecutan junto con la notificación integrada. Si recibes ambos avisos, cambia Local notifications a notifications_disabled y conserva el hook.
• Demasiados avisos. Stop se activa después de cada turno, no solo cuando termina una tarea completa.
• Si también usas Cowork Island. Mantén cada uno de tus hooks en su propia entrada, como en los fragmentos de arriba, y fuera de ~/.perch/. La app solo considera suyos los comandos que contienen /.perch/ y sustituye las entradas completas. Por eso, un comando colocado dentro de una de sus entradas se eliminaría junto con ella.

• Documentación de Claude Code: configuración del terminal
• Documentación de Claude Code: referencia de hooks
• Documentación de Claude Code: guía de hooks
• Documentación de Claude Code: referencia de ajustes
• Documentación de Claude Code: ajustes
• Historial de cambios de Claude Code
• Manual de uso de Terminal: ajustes avanzados
• Guía de scripts de automatización para Mac: mostrar notificaciones
• Preguntas frecuentes de Cowork Island y guía de instalación

Fuentes consultadas el 18 de octubre de 2026. Esta guía la escribe el creador de Cowork Island. Para señalar una corrección, escribe a support@coworkisland.com o abre una incidencia en GitHub.