MacPipTu próxima app para Mac está aquí.macpip.com →

Cómo recibir un aviso cuando Claude Code o Codex terminan

Actualizado: 22 de octubre de 2026

Le das una tarea larga a Claude Code o a Codex, te pones con otra cosa y, al volver diez minutos después, ves que se paró a los dos minutos esperando un sí. Un sonido o una notificación cuando el agente termina o necesita tu OK lo soluciona.

Las dos herramientas pueden hacerlo gratis, con lo que traen de serie o con una o dos líneas de configuración. Esta guía explica cada forma, paso a paso.

En resumen

  • Claude Code ya puede avisarte en Ghostty, Kitty e iTerm2 (iTerm2 necesita un ajuste). En otros terminales, añade un hook.
  • Un hook de Claude Code en Stop salta cuando termina; uno en Notification, cuando te necesita. Apunta cualquiera de los dos a afplay para un sonido o a osascript para una notificación.
  • Codex: añade una línea notify a ~/.codex/config.toml, o activa sus notificaciones de terminal integradas.
  • ¿No pasa nada? Reinicia la sesión: los hooks se leen al empezar una sesión.

Cómo te avisan los agentes de que han terminado

Claude Code o Codextermina o te necesita
Hook / notifyejecuta tu comando
Te enterassonido · aviso · campana
Todos los métodos de esta página funcionan igual: el agente ejecuta un comando en el momento justo.

Las dos herramientas pueden ejecutar un comando tuyo en el momento justo. Eso es todo lo que es una notificación: Claude Code lo llama hook y Codex lo llama notify. Lo que haga el comando (sonar, mostrar un aviso, iluminar la pantalla) ocurre cuando el agente se detiene o te pide algo.

Un Mac más agradable mientras tu agente trabaja

Clacky hace que el propio Mac sea más agradable mientras trabajan los agentes: sonidos de clic y de teclado, y una grabadora de pantalla para cuando quieras enseñar lo que construyó el agente. $4.99 una vez para 1 Mac.

Claude Code: la notificación integrada

Cuando Claude Code termina, o espera en una petición de permiso, puede enviar una notificación de escritorio por sí solo. Según la documentación de Anthropic, funciona tal cual en Ghostty y Kitty. En iTerm2, actívalo una vez:

  1. iTerm2 → Settings → Profiles → Terminal.
  2. Marca Notification Center Alerts.
  3. Haz clic en Filter Alerts y activa Send escape sequence-generated alerts.

¿Usas Claude Code dentro de tmux? Añade set -g allow-passthrough on a ~/.tmux.conf, o la notificación nunca llegará a tu terminal. También puedes elegir cómo te avisa Claude Code (por ejemplo, con la campana del terminal) en sus ajustes de /config.

Fuente: documentación de Claude Code: configuración del terminal

Claude Code: un hook que reproduce un sonido

En el Terminal de Apple, en VS Code o en cualquier otro terminal, lo resuelve un hook. Los hooks viven en ~/.claude/settings.json (para todos los proyectos) o en .claude/settings.json (para uno). Importan dos eventos:

  • Stop: Claude ha terminado su respuesta.
  • Notification: Claude te necesita (una petición de permiso, o lleva un rato esperando que escribas).

Esto reproduce un sonido de macOS en los dos casos. Combínalo con tu archivo de ajustes (sin borrar lo que ya tenga):

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

¿Prefieres un aviso en pantalla? Usa este comando en su lugar (el mismo del ejemplo de Anthropic):

osascript -e 'display notification "Claude Code needs your attention" with title "Claude Code"'

Escribe /hooks en Claude Code para ver qué tienes configurado. Los hooks nuevos se aplican a las sesiones que empieces después de guardar. Los sonidos de /System/Library/Sounds/ son de uso libre: Glass, Ping, Pop, Purr, Submarine y más.

Fuentes: referencia de hooks · guía de hooks

Codex: el ajuste notify

La CLI de Codex ejecuta un programa tuyo después de cada turno, configurado con notify en ~/.codex/config.toml. Codex añade una descripción del turno en JSON como último argumento (su type es agent-turn-complete), que un simple comando de sonido puede ignorar:

notify = ["sh", "-c", "afplay /System/Library/Sounds/Glass.aiff"]

notify es una clave de nivel superior: ponla encima de cualquier [section] del archivo. Codex también tiene notificaciones integradas en su interfaz de terminal (notifications dentro de [tui]) que usan la notificación o la campana del propio terminal; que veas un aviso o no depende de tu terminal.

El notify de Codex salta cuando se completa un turno. No tiene un evento aparte de «necesita tu aprobación» como el hook Notification de Claude Code.

Fuente: documentación de Codex: configuración avanzada

Si no pasa nada

  • Reinicia la sesión. Los hooks se leen al empezar una sesión, así que una que ya estaba en marcha no avisará.
  • Comprueba que el archivo es válido. Una coma que falta en settings.json desactiva todos los hooks. Pégalo en cualquier validador de JSON.
  • Prueba el comando por separado. Ejecuta afplay /System/Library/Sounds/Glass.aiff en Terminal. ¿No suena? Revisa la salida de audio y el volumen.
  • ¿No salen los avisos? Revisa Ajustes del Sistema → Notificaciones para tu terminal (o para Editor de Scripts, si usas osascript), y los modos de Concentración.
  • ¿Suenan dos sonidos a la vez? Tienes dos configuraciones (por ejemplo, un hook en ~/.claude/settings.json y otro en el .claude/settings.json del proyecto). Quédate con una.

Preguntas

¿Claude Code tiene un sonido de aviso integrado?

Puede enviar una notificación de escritorio por sí solo en Ghostty, Kitty e iTerm2 (en iTerm2 hay que activar Send escape sequence-generated alerts). Para un sonido en cualquier terminal, añade un hook Stop o Notification que ejecute afplay.

¿Qué diferencia hay entre los hooks Stop y Notification?

Stop se ejecuta cuando Claude termina de responder. Notification se ejecuta cuando Claude te necesita: una petición de permiso, o lleva un rato esperando que escribas. Casi todo el mundo quiere los dos, con sonidos distintos.

¿Puede Codex avisarme cuando necesita aprobación?

El programa notify de Codex se ejecuta cuando se completa un turno (agent-turn-complete). Hoy no tiene un evento aparte para las aprobaciones, así que lo oyes cuando termina el turno.

¿Estos avisos funcionan con Claude Code en la web (claude.ai/code en Chrome)?

Hoy no. Claude Code en la web se ejecuta en la nube de Anthropic, así que sus hooks se ejecutan allí y nunca llegan a tu Mac. Un hook con afplay o osascript solo oye sesiones que se ejecutan en tu Mac: en una terminal o en la pestaña Code de la app de Claude. Para recibir avisos de una sesión web, continúala en tu Mac con claude --teleport en Terminal.

¿No conoces Clacky? Es una app acogedora de la barra de menús del Mac con sonidos de clic y de teclado, grabadora de pantalla, capturas y un pequeño puerto que crece mientras trabajas. Ver todas las herramientas · Escucha los sonidos en tu navegador

Comprobado el 22 de octubre de 2026. ¿Algo ha cambiado o hay algo mal aquí? Escribe a hello@clacky.app.