Cómo recibir un aviso cuando Claude Code o Codex terminan
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
afplaypara un sonido o aosascriptpara una notificación. - Codex: añade una línea
notifya~/.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
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:
- iTerm2 → Settings → Profiles → Terminal.
- Marca Notification Center Alerts.
- 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.
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.jsondesactiva todos los hooks. Pégalo en cualquier validador de JSON. - Prueba el comando por separado. Ejecuta
afplay /System/Library/Sounds/Glass.aiffen 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.jsony otro en el.claude/settings.jsondel 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.
Más guías
- Mac activo con la tapa cerradaModo clamshell, caffeinate, pmset y apps, y qué hace de verdad cada uno.
- Sonidos de teclado y clic en MacCómo funcionan, el permiso que necesitan, las apps y soluciones.
- Mostrar clics en MacLa opción integrada, los editores y una onda en vivo con sonido.
- Sonido de clic en MacNo hay ajuste integrado: cómo añadirlo y qué permiso necesita.
- Mejores apps de sonidos de teclado17 apps gratis y de pago lado a lado, y cuál te conviene.
- Sonidos de teclado para concentrarteSonidos suaves al teclear para estudiar, escribir y programar, en tus auriculares.
- Sonidos de teclado explicadosQué significan thock, cremoso, clacky y poppy, y cómo suena cada uno.
- Apps acogedoras para MacJuegos idle, sonidos ambientales, mascotas y clics suaves que funcionan mientras trabajas.
- Mejores apps para resaltar el cursorFocos, ondas de clic y sonidos de clic para demos, llamadas y grabaciones.
- Los sonidos de teclado no funcionanMonitorización de entrada, Secure Input, el dispositivo de salida y los ajustes de silencio.
- Teleprompter en MacLee tu guion bajo la cámara y déjalo fuera de la grabación.
- Mostrar clics y grabar su sonidoConsigue la onda y el sonido del clic en cualquier grabación de pantalla del Mac.
- Test de mecanografía con sonidos de tecladoUn test de mecanografía de 30 segundos que puedes oír, en tu navegador.
¿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.