Generador de notificaciones de Claude Code, Codex y Gemini CLI.

Un hook es un comando corto que tu agente de IA ejecuta en un momento concreto, por ejemplo, cuando termina una respuesta. Esta herramienta gratuita genera el hook o el ajuste integrado para configurar tus notificaciones.

Elige tu agente, los momentos que te interesan (cuando termina o necesita tu permiso) y cómo quieres que te avise. Esta página genera el fragmento exacto, indica en qué archivo va y puede combinarlo con una copia de ese archivo. Para Claude Code genera hooks Stop y Notification; para Codex y Gemini CLI, los suyos. Nada de lo que escribas sale de tu navegador.

Última actualización:

Cowork Island

macOS 14 o posterior.
Apple silicon e Intel.
El plan Gratis no requiere una cuenta.

Descarga gratis

Elige tu aviso.

Las opciones siguientes necesitan JavaScript. Sin él, esta página muestra la configuración más habitual: un banner en el Mac cuando Claude Code termina o te necesita.

¿Qué agente?
Avísame cuando
¿Cómo?
Sonidos

Estos son los sonidos de la carpeta de sonidos del sistema de tu Mac.

Tu configuración.

En ~/.claude/settings.json

Añade estas entradas al objeto "hooks" del archivo, junto a las que ya tenga. No sustituyas el archivo: puede contener otros ajustes tuyos y hooks de otras herramientas. Los archivos de configuración exigen JSON estricto, sin comentarios ni comas finales. Para hacerlo más fácil, pega tu archivo actual en el cuadro de combinación de abajo.

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "/usr/bin/osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title (item 2 of argv) subtitle (item 3 of argv) sound name \"Glass\"' -e 'end run' 'Claude Code finished' 'Claude Code' \"${PWD##*/}\""
          }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "permission_prompt|elicitation_dialog|elicitation_url_dialog",
        "hooks": [
          {
            "type": "command",
            "command": "/usr/bin/osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title (item 2 of argv) subtitle (item 3 of argv) sound name \"Funk\"' -e 'end run' 'Claude Code needs you' 'Claude Code' \"${PWD##*/}\""
          }
        ]
      }
    ]
  }
}
  • En Claude Code, los avisos de permisos y las peticiones de información de herramientas conectadas llegan unos 6 segundos después de que aparezca la solicitud. Si escribes, se retrasan. Así funciona el hook Notification de Claude Code. Otras preguntas pueden no activar este hook.
  • El aviso de finalización usa Stop, que se activa cada vez que Claude termina una respuesta, no solo al final de una tarea larga. No se activa cuando interrumpes a Claude.
  • Claude Code no ejecuta los hooks de una carpeta hasta que aceptas su diálogo de confianza en el espacio de trabajo. En un Mac de trabajo, tu organización puede permitir solo sus propios hooks.
  • Si una sesión que ya está abierta no aplica el cambio, reiníciala.

Pruébalo.

Pega esta línea en Terminal y pulsa Retorno. Ejecuta el mismo comando que ejecutará el hook.

/usr/bin/osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title (item 2 of argv) subtitle (item 3 of argv) sound name "Glass"' -e 'end run' 'Claude Code finished' 'Claude Code' "${PWD##*/}"

Permite que Editor de Scripts muestre notificaciones. Estos banners proceden de la app Editor de Scripts de macOS, y macOS no pide permiso antes: hasta que lo permitas, no aparece nada ni se te indica por qué. Ejecuta la línea de prueba una vez. Después, abre Ajustes del Sistema > Notificaciones, busca Editor de Scripts y activa Permitir notificaciones.

Combina las entradas con tu archivo actual.

Pega aquí todo tu archivo actual y esta página le añadirá las entradas nuevas. Las entradas de hooks que ya tenga se conservan tal cual, incluidas las de otras herramientas y las de Cowork Island. Si has elegido un ajuste integrado, su nuevo valor sustituye al anterior y la página te indica cuál ha cambiado. Si combinas la misma opción dos veces, no se duplica nada. Lo que pegues se queda en esta página.

La combinación necesita JavaScript. Sin él, añade las entradas a mano como se explica arriba.

Si también usas Cowork Island.

Cowork Island, la app para Mac del creador de esta herramienta, añade sus propias entradas a los mismos archivos cuando se conecta a Claude Code, Codex o Gemini CLI. Estas entradas conviven con tus hooks existentes. La app considera que una entrada es suya si su comando contiene /.perch/ en cualquier posición, sin distinguir mayúsculas y minúsculas. Elimina y vuelve a añadir entradas completas, no comandos individuales.

  • Cada fragmento de esta página es una entrada independiente y nunca apunta al interior de ~/.perch/, así que reinstalar o desactivar Cowork Island no lo modifica.
  • No pegues ninguno de estos comandos en una entrada de Cowork Island ni guardes tus propios scripts en ~/.perch/: la app los consideraría suyos.
  • No borres a mano las entradas de Cowork Island mientras su integración esté activada: la app vuelve a añadirlas la próxima vez que se inicia.
  • Ambos funcionan a la vez. Claude Code y Codex ejecutan simultáneamente todos los hooks que correspondan, y Gemini CLI espera a que terminen todos.
  • En Claude Code, el aviso de una solicitud de permiso usa el evento Notification, nunca un hook PermissionRequest, así que nunca puede responder a una solicitud por ti.
  • Para Gemini CLI, esta herramienta genera hooks AfterAgent y Notification, nunca hooks BeforeTool.

Qué hace esta página con los datos que introduces.

Todo ocurre en tu navegador. El generador no hace peticiones de red, no guarda nada ni instala cookies: nada de lo que elijas, escribas o pegues sale de esta página. Copiar solo escribe en tu portapapeles cuando haces clic en el botón. El tema de ntfy se crea con el generador de números aleatorios integrado en tu navegador. Como en todas las páginas de este sitio, la visita en sí se contabiliza según lo descrito en la política de privacidad.

La opción sin configuración.

Cowork Island es una app para Mac del creador de esta herramienta. Reúne en un panel bajo el notch tus sesiones de agentes de IA y muestra el estado de cada una, para que veas de un vistazo cuál te necesita. Funciona con o sin notch.

  • Claude Code y las herramientas que la app encuentra en tu Mac se conectan solas. Codex sigue desactivado hasta que lo actives en Ajustes y autorices los hooks de Cowork Island en Codex.
  • Cada sesión muestra su estado y «Te necesita» cuando espera una acción tuya. Por defecto, la isla se despliega sola en ese momento, salvo que el terminal o la app de esa sesión ya esté en primer plano.
  • Cuando una sesión termina, la isla se despliega durante 5 segundos por defecto.
  • En Claude Code, puedes permitir o rechazar una acción, o responder a una pregunta con varias opciones desde la isla. Responder desde ahí es gratis. Con otras herramientas, puede que tengas que responder en su propia app o terminal.
  • Los sonidos están desactivados hasta que los actives. El sonido «Se necesita aprobación» es gratis; el sonido de «Sesión completada» forma parte de Pro. La app no muestra banners propios de macOS.

Gratis muestra una tarjeta de sesión a la vez. Pro muestra todas tus sesiones, y saltar a la ventana, pestaña o panel de una sesión es una función de Pro. Empieza sola una prueba de Pro de 7 días, solo una vez por Mac, y no pide datos de pago. Consulta los planes y la guía de instalación.

Descarga gratis

Fuentes.

Recibe el enlace de descarga para usarlo más tarde.