Como receber um aviso quando o Claude Code ou o Codex terminar
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
afplaypara tocar um som ou paraosascriptpara mostrar uma notificação. - Codex: adicione uma linha
notifyao~/.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.
Como os agentes avisam que terminaram
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:
- iTerm2 → Settings → Profiles → Terminal.
- Marque Notification Center Alerts.
- 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
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 · guia de hooks
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.
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.jsontrava todos os hooks. Cole ele em qualquer validador de JSON. - Teste o comando sozinho. Rode
afplay /System/Library/Sounds/Glass.aiffno 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.jsone outro no.claude/settings.jsondo 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.
- Sons de teclado e clique no MacComo funcionam, a permissão que pedem, os apps e as soluções.
- Mostrar cliques no MacA opção nativa, os editores e uma onda ao vivo com som.
- Som de clique no MacNão tem ajuste nativo: como adicionar, e a permissão que precisa.
- Melhores apps de sons de teclado17 apps grátis e pagos lado a lado, e qual combina com você.
- Sons de teclado para focoSons de digitação suaves para estudar, escrever e programar, nos seus fones.
- Sons de teclado explicadosO que thock, cremoso, clacky e estalado significam, e como cada um soa.
- Apps aconchegantes para MacJogos idle, sons ambiente, pets e cliques suaves que rodam enquanto você trabalha.
- Melhores apps para destacar o cursorHolofotes, ondas de clique e sons de clique para demos, chamadas e gravações.
- Sons de teclado não funcionamMonitoramento de Entrada, Entrada Segura, o dispositivo de saída e ajustes de silêncio.
- Teleprompter no MacLeia o roteiro embaixo da câmera, e deixe ele fora da gravação.
- Mostrar cliques e gravar o som delesColoque a onda e o som do clique em qualquer gravação de tela no Mac.
- Teste de digitação com sons de tecladoUm teste de digitação de 30 segundos que dá para ouvir, direto no navegador.
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 · Ouça os sons no seu navegador
Conferido em 22 de outubro de 2026. Algo mudou ou tem algo errado aqui? Escreva para hello@clacky.app.