[Clacky](https://clacky.app/es/)/Guías

# 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.

En esta página

1.  [Cómo te avisan los agentes de que han terminado](#co-mo-te-avisan-los-agentes-de-que-han-terminado)
2.  [Claude Code: la notificación integrada](#claude-code-la-notificacio-n-integrada)
3.  [Claude Code: un hook que reproduce un sonido](#claude-code-un-hook-que-reproduce-un-sonido)
4.  [Codex: el ajuste notify](#codex-el-ajuste-notify)
5.  [Si no pasa nada](#si-no-pasa-nada)

## 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](https://code.claude.com/docs/en/terminal-config)

## 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](https://code.claude.com/docs/en/hooks) · [guía de hooks](https://code.claude.com/docs/en/hooks-guide)

## 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](https://developers.openai.com/codex/config-advanced)

## 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.

## Más guías

-   [Mac activo con la tapa cerradaModo clamshell, caffeinate, pmset y apps, y qué hace de verdad cada uno.](https://clacky.app/es/keep-mac-awake-lid-closed/)
-   [Sonidos de teclado y clic en MacCómo funcionan, el permiso que necesitan, las apps y soluciones.](https://clacky.app/es/mac-keyboard-sounds/)
-   [Mostrar clics en MacLa opción integrada, los editores y una onda en vivo con sonido.](https://clacky.app/es/show-mouse-clicks-mac/)
-   [Sonido de clic en MacNo hay ajuste integrado: cómo añadirlo y qué permiso necesita.](https://clacky.app/es/mac-click-sound/)
-   [Mejores apps de sonidos de teclado17 apps gratis y de pago lado a lado, y cuál te conviene.](https://clacky.app/es/best-keyboard-sound-apps-mac/)
-   [Sonidos de teclado para concentrarteSonidos suaves al teclear para estudiar, escribir y programar, en tus auriculares.](https://clacky.app/es/keyboard-sounds-for-focus/)
-   [Sonidos de teclado explicadosQué significan thock, cremoso, clacky y poppy, y cómo suena cada uno.](https://clacky.app/es/keyboard-sounds-explained/)
-   [Apps acogedoras para MacJuegos idle, sonidos ambientales, mascotas y clics suaves que funcionan mientras trabajas.](https://clacky.app/es/cozy-mac-apps/)
-   [Mejores apps para resaltar el cursorFocos, ondas de clic y sonidos de clic para demos, llamadas y grabaciones.](https://clacky.app/es/best-cursor-highlighter-apps-mac/)
-   [Los sonidos de teclado no funcionanMonitorización de entrada, Secure Input, el dispositivo de salida y los ajustes de silencio.](https://clacky.app/es/keyboard-sounds-not-working-mac/)
-   [Teleprompter en MacLee tu guion bajo la cámara y déjalo fuera de la grabación.](https://clacky.app/es/teleprompter-mac/)
-   [Mostrar clics y grabar su sonidoConsigue la onda y el sonido del clic en cualquier grabación de pantalla del Mac.](https://clacky.app/record-click-sound/)
-   [Test de mecanografía con sonidos de tecladoUn test de mecanografía de 30 segundos que puedes oír, en tu navegador.](https://clacky.app/es/typing-test/)

¿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](https://clacky.app/es/) · [Escucha los sonidos en tu navegador](https://clacky.app/es/)

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