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

Cómo te avisan los agentes de que han terminado

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.

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

Agent Alerts de Clacky: lo mismo, sin configurar nada

Si prefieres no editar JSON ni TOML, Clacky (una app de la barra de menús del Mac) tiene Agent Alerts (avisos de agentes). Usa los mismos hooks de arriba, así que nada vigila tu pantalla ni lee tu terminal:

1. Abre el panel de Clacky → Agent Alerts.
2. Junto a Claude Code o Codex, haz clic en Set Up…. Clacky te enseña las líneas exactas que va a añadir; haz clic en Add Hooks. Guarda una copia de seguridad de tu archivo justo al lado (settings.json.clacky-backup).
3. Haz clic en Send a Test Alert para oír los dos sonidos.

Lo que consigues:

• Un sonido distinto para listo (un acorde que sube) y para te necesito (dos toques y una pregunta), con cinco voces para elegir por agente.
• Un suave brillo opcional en el borde de la pantalla durante más o menos un segundo. Deja pasar los clics y nunca aparece en las grabaciones.
• Quiet when it’s in front (en silencio mientras el terminal del agente es la app activa) y Quiet during calls (en silencio mientras el micro está en uso), los dos activados por defecto.
• Un punto por sesión en la barra de menús: trabajando, esperando o listo. Haz clic en uno para traer su terminal al frente.
• Keep Awake → Until My Agent Is Done (mantener activo hasta que el agente termine), para que una tarea larga no se pare porque tu Mac se fue a reposo.

Claude Code funciona en cualquier terminal y en la pestaña Code de la app de Claude. Codex funciona con la CLI y recibe el sonido de listo (Codex no envía ningún evento de «te necesito»). Si tu configuración de Codex ya tiene una línea notify, Clacky no la toca y te lo dice, en vez de sustituirla. Remove… quita solo las líneas de Clacky.

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, tu propio hook y el de Clacky). Quédate con una.