[Clacky](https://clacky.app/pt-br/)/Guias

# Como receber um aviso quando o Claude Code ou o Codex terminar

Atualizado em 22 de outubro de 2026

Você começa uma tarefa longa no Claude Code ou no Codex, vai fazer outra coisa e volta dez minutos depois para descobrir que ele parou aos dois minutos, esperando um sim. Um som ou uma notificação quando o agente **termina** ou **precisa do seu OK** resolve isso.

As duas ferramentas fazem isso de graça, de fábrica ou com uma ou duas linhas de configuração. Este guia mostra cada jeito, passo a passo.

A versão curta

-   O **Claude Code** já consegue avisar você no **Ghostty, Kitty e iTerm2** (o iTerm2 precisa de um ajuste). Em outros terminais, adicione um **hook**.
-   Um hook do Claude Code em **Stop** dispara quando ele termina; um em **Notification** dispara quando ele precisa de você. Aponte qualquer um para `afplay` para tocar um som ou para `osascript` para mostrar uma notificação.
-   **Codex**: adicione uma linha `notify` ao `~/.codex/config.toml`, ou ative as notificações de terminal que já vêm nele.
-   Nada acontece? **Reinicie a sessão**: os hooks são lidos quando a sessão começa.

Nesta página

1.  [Como os agentes avisam que terminaram](#como-os-agentes-avisam-que-terminaram)
2.  [Claude Code: a notificação que já vem nele](#claude-code-a-notificac-a-o-que-ja-vem-nele)
3.  [Claude Code: um hook que toca um som](#claude-code-um-hook-que-toca-um-som)
4.  [Codex: o ajuste notify](#codex-o-ajuste-notify)
5.  [Se nada acontecer](#se-nada-acontecer)

## Como os agentes avisam que terminaram

Claude Code ou Codextermina ou precisa de você

Hook / notifyroda seu comando

Você ouvesom · aviso · sino

Todos os métodos desta página funcionam do mesmo jeito: o agente roda um comando na hora certa.

As duas ferramentas conseguem rodar um comando seu na hora certa. Uma notificação é só isso: o Claude Code chama de **hook**, o Codex chama de **notify**. O que o comando fizer (tocar um som, mostrar um aviso, piscar a tela) acontece quando o agente para ou pede uma resposta.

Um Mac mais gostoso enquanto seu agente trabalha

O Clacky deixa o próprio Mac mais gostoso de usar enquanto os agentes trabalham: sons de clique e de teclado, e um gravador de tela para quando você quiser mostrar o que o agente construiu. $4.99 uma vez para 1 Mac.

## Claude Code: a notificação que já vem nele

Quando o Claude Code termina, ou fica esperando uma permissão, ele mesmo pode mandar uma notificação na tela. A documentação da Anthropic diz que isso funciona sem configurar nada no **Ghostty** e no **Kitty**. No **iTerm2**, ative uma vez:

1.  iTerm2 → **Settings** → **Profiles** → **Terminal**.
2.  Marque **Notification Center Alerts**.
3.  Clique em **Filter Alerts** e ative **Send escape sequence-generated alerts**.

Usa o Claude Code dentro do **tmux**? Adicione `set -g allow-passthrough on` ao `~/.tmux.conf`, senão a notificação nunca chega ao seu terminal. Você também pode escolher como o Claude Code avisa você (por exemplo, com o sino do terminal) nos ajustes de `/config`.

Fonte: [documentação do Claude Code: configuração do terminal](https://code.claude.com/docs/en/terminal-config)

## Claude Code: um hook que toca um som

No Terminal da Apple, no VS Code ou em qualquer outro terminal, um hook resolve. Os hooks ficam em `~/.claude/settings.json` (para todos os projetos) ou em `.claude/settings.json` (um projeto só). Dois eventos importam:

-   **Stop**: o Claude terminou a resposta.
-   **Notification**: o Claude precisa de você (um pedido de permissão, ou ele está esperando você responder).

Isto toca um som do macOS nos dois casos. Junte ao seu arquivo de ajustes (mantendo o que já estiver lá):

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

Prefere um aviso na tela? Use este comando no lugar (o mesmo do exemplo da Anthropic):

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

Digite `/hooks` no Claude Code para ver o que está configurado. Hooks novos valem para as sessões que você abrir depois de salvar. Os sons em `/System/Library/Sounds/` são livres para usar: Glass, Ping, Pop, Purr, Submarine e outros.

Fontes: [referência de hooks](https://code.claude.com/docs/en/hooks) · [guia de hooks](https://code.claude.com/docs/en/hooks-guide)

## Codex: o ajuste notify

O Codex CLI roda um programa seu depois de cada turno, definido com `notify` no `~/.codex/config.toml`. O Codex acrescenta uma descrição do turno em JSON como último argumento (o `type` dela é `agent-turn-complete`), que um simples comando de som pode ignorar:

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

`notify` é uma chave de nível superior: coloque acima de qualquer `[section]` do arquivo. O Codex também tem notificações próprias na interface do terminal (`notifications` em `[tui]`), que usam a notificação ou o sino do próprio terminal; se aparece um aviso na tela ou não depende do seu terminal.

O `notify` do Codex dispara quando um turno termina. Ele não tem um evento separado de “precisa da sua aprovação”, como o hook Notification do Claude Code.

Fonte: [documentação do Codex: configuração avançada](https://developers.openai.com/codex/config-advanced)

## Se nada acontecer

-   **Reinicie a sessão.** Os hooks são lidos quando a sessão começa, então uma que já estava rodando não vai avisar.
-   **Confira se o arquivo é válido.** Uma vírgula faltando no `settings.json` trava todos os hooks. Cole ele em qualquer validador de JSON.
-   **Teste o comando sozinho.** Rode `afplay /System/Library/Sounds/Glass.aiff` no Terminal. Sem som? Confira o dispositivo de saída e o volume.
-   **Os avisos não aparecem?** Confira Ajustes do Sistema → **Notificações** para o seu terminal (ou o Editor de Scripts, no caso do `osascript`), e os modos de Foco.
-   **Dois sons ao mesmo tempo?** Você tem duas configurações (por exemplo, um hook em `~/.claude/settings.json` e outro no `.claude/settings.json` do projeto). Fique com uma.

## Perguntas

### O Claude Code tem um som de notificação próprio?

Ele mesmo pode mandar uma notificação na tela no Ghostty, no Kitty e no iTerm2 (no iTerm2, **Send escape sequence-generated alerts** precisa estar ligado). Para ter som em qualquer terminal, adicione um hook **Stop** ou **Notification** que rode `afplay`.

### Qual a diferença entre os hooks Stop e Notification?

**Stop** roda quando o Claude termina de responder. **Notification** roda quando o Claude precisa de você: um pedido de permissão, ou quando ele está esperando sua resposta. A maioria das pessoas quer os dois, com sons diferentes.

### O Codex consegue me avisar quando precisa de aprovação?

O programa `notify` do Codex roda quando um turno termina (`agent-turn-complete`). Hoje não existe um evento separado de aprovação para ele, então você ouve o aviso quando o turno acaba.

### Esses alertas funcionam com o Claude Code na web (claude.ai/code no Chrome)?

Hoje não. O Claude Code na web roda na nuvem da Anthropic, então os hooks dele rodam lá e nunca chegam ao seu Mac. Um hook com `afplay` ou `osascript` só ouve sessões que rodam no seu Mac: num terminal ou na aba Code do app Claude. Para receber alertas de uma sessão web, continue-a no seu Mac com `claude --teleport` no Terminal.

## Mais guias

-   [Mac acordado com a tampa fechadaModo clamshell, caffeinate, pmset e apps, e o que cada um faz de verdade.](https://clacky.app/pt-br/keep-mac-awake-lid-closed/)
-   [Sons de teclado e clique no MacComo funcionam, a permissão que pedem, os apps e as soluções.](https://clacky.app/pt-br/mac-keyboard-sounds/)
-   [Mostrar cliques no MacA opção nativa, os editores e uma onda ao vivo com som.](https://clacky.app/pt-br/show-mouse-clicks-mac/)
-   [Som de clique no MacNão tem ajuste nativo: como adicionar, e a permissão que precisa.](https://clacky.app/pt-br/mac-click-sound/)
-   [Melhores apps de sons de teclado17 apps grátis e pagos lado a lado, e qual combina com você.](https://clacky.app/pt-br/best-keyboard-sound-apps-mac/)
-   [Sons de teclado para focoSons de digitação suaves para estudar, escrever e programar, nos seus fones.](https://clacky.app/pt-br/keyboard-sounds-for-focus/)
-   [Sons de teclado explicadosO que thock, cremoso, clacky e estalado significam, e como cada um soa.](https://clacky.app/pt-br/keyboard-sounds-explained/)
-   [Apps aconchegantes para MacJogos idle, sons ambiente, pets e cliques suaves que rodam enquanto você trabalha.](https://clacky.app/pt-br/cozy-mac-apps/)
-   [Melhores apps para destacar o cursorHolofotes, ondas de clique e sons de clique para demos, chamadas e gravações.](https://clacky.app/pt-br/best-cursor-highlighter-apps-mac/)
-   [Sons de teclado não funcionamMonitoramento de Entrada, Entrada Segura, o dispositivo de saída e ajustes de silêncio.](https://clacky.app/pt-br/keyboard-sounds-not-working-mac/)
-   [Teleprompter no MacLeia o roteiro embaixo da câmera, e deixe ele fora da gravação.](https://clacky.app/pt-br/teleprompter-mac/)
-   [Mostrar cliques e gravar o som delesColoque a onda e o som do clique em qualquer gravação de tela no Mac.](https://clacky.app/record-click-sound/)
-   [Teste de digitação com sons de tecladoUm teste de digitação de 30 segundos que dá para ouvir, direto no navegador.](https://clacky.app/pt-br/typing-test/)

Não conhece o Clacky? É um app aconchegante da barra de menus do Mac com sons de clique e de teclado, gravador de tela, capturas de tela e uma pequena cidade portuária que cresce enquanto você trabalha. [Ver todas as ferramentas](https://clacky.app/pt-br/) · [Ouça os sons no seu navegador](https://clacky.app/pt-br/)

Conferido em 22 de outubro de 2026. Algo mudou ou tem algo errado aqui? Escreva para hello@clacky.app.
