Horário de silêncio e Não perturbe para notificações do Claude Code

01O que "silêncio" deve significar no Claude Code

Antes de configurar qualquer coisa, decida o que deve acontecer com uma solicitação que chega durante o horário de silêncio. Existem três tipos de alerta:

• O Claude terminou. Pode esperar sem problema. Você lê quando for olhar.
• O Claude precisa de uma permissão. O Claude Code fica parado no prompt até alguém responder. Se nada chegar até você, a sessão fica esperando até você voltar.
• O Claude fez uma pergunta. Igual à permissão: a sessão fica esperando.

Ou seja, o horário de silêncio troca progresso por sono. Se você começa uma tarefa longa antes de dormir, talvez queira silenciar os alertas de "terminou", mas ainda ver uma solicitação pendente de manhã. Se você quer que o Claude continue trabalhando a noite toda sem perguntar, isso é uma decisão de modo de permissão, não de notificação.

02Horário de silêncio em um hook feito por você

O Claude Code roda o comando do seu hook toda vez que o evento dispara. Para adicionar um horário de silêncio, verifique a hora no início do script e saia antes. Isso funciona para qualquer hook que envie uma notificação no desktop, um push pelo ntfy ou uma mensagem de chat.

No Mac e no Linux, salve isto como ~/.claude/hooks/notify.sh e torne o arquivo executável com chmod +x:

#!/bin/sh
# Quiet between 22:00 and 08:00, local time
hour=$(date +%H)
if [ "$hour" -ge 22 ] || [ "$hour" -lt 8 ]; then
  exit 0
fi

# Your real notification command goes here, for example:
notify-send "Claude Code" "Claude has finished"

No Mac, troque a última linha por um comando osascript; o guia de macOS tem um exemplo. Depois, aponte o hook para o script em ~/.claude/settings.json:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          { "type": "command", "command": "~/.claude/hooks/notify.sh" }
        ]
      }
    ]
  }
}

O importante é sair com código 0. Qualquer outro código mostra um erro de hook na transcrição, e o código 2 em um hook Stop manda o Claude continuar trabalhando, o que não é o que você quer aqui.

No Windows, faça a mesma verificação no PowerShell com (Get-Date).Hour. O guia de Windows mostra um hook completo em PowerShell.

Pausando os hooks por completo

Para uma sessão silenciosa avulsa, inicie o Claude Code com todos os hooks desligados:

claude --settings '{"disableAllHooks": true}'

Isso vale só para essa sessão. Definir "disableAllHooks": true em um arquivo de configuração desliga os hooks até você remover a opção. Atenção: isso desliga todos os hooks, inclusive os que formatam código ou bloqueiam comandos, então use com cuidado.

Os alertas nativos do Claude Code

As notificações de terminal nativas do Claude Code são controladas por preferredNotifChannel. Definir como "notifications_disabled" desativa esses alertas. Isso não interrompe seus hooks, que continuam rodando. O guia do terminal bell explica os outros valores.

03Foco e Não Perturbe no celular

Se seus alertas vão para o celular, os modos silenciosos do próprio aparelho são a camada mais simples, e funcionam independentemente da ferramenta que envia o alerta.

• iPhone: o Foco (Ajustes, depois Foco) silencia notificações em horários programados. Você pode escolher quais apps ainda podem passar. Se quiser receber alertas do Claude Code à noite, adicione o app à lista de permitidos; se quiser silêncio, deixe-o de fora e os alertas ficam aguardando na Central de Notificações.
• Android: o Não Perturbe (em Configurações, em Notificações ou Som, dependendo do aparelho) funciona do mesmo jeito, com horários e exceções por app. As configurações de notificação de cada app também permitem desativar som ou vibração só para aquele app.

A vantagem da camada do celular é que nada se perde: os alertas continuam chegando e ficam esperando por você. A desvantagem é que ela vale para tudo no celular, então você configura uma vez para a noite inteira, não só para o Claude Code.

04Silêncio no computador

No computador, o Foco no Mac, o Não perturbe no Windows e a opção de não perturbe na maioria dos desktops Linux silenciam as notificações de desktop vindas dos hooks. Isso é útil ao compartilhar a tela, quando a última coisa que você quer é um banner mostrando o nome de um projeto ou um comando.

05Horário de silêncio com o Claude Code Notifier

O Claude Code Notifier é uma ferramenta independente, não feita pela Anthropic. Sua ferramenta de linha de comando, ccn, roda como hooks do Claude Code no Mac, Windows e Linux e envia alertas para um iPhone ou Android pareado. Ela já vem com configurações de silêncio, então você não precisa editar nenhum script:

ccn config set quiet_hours 22:00-08:00

Durante o horário de silêncio, o ccn não envia nada para o celular e nada fica esperando por ele: o Claude Code pergunta no terminal normalmente, e a solicitação estará lá quando você voltar. As notificações de desktop no computador também ficam suspensas nesse período. ccn config set quiet_hours off desativa o agendamento.

Outras configurações que ajudam:

Por exemplo, ccn config set notify_on_done off mantém só os alertas que bloqueiam o Claude. A maioria dessas configurações também pode ser alterada por computador pelo app do celular, o que é prático quando você tem um notebook do trabalho e um desktop em casa com horários diferentes. Rode ccn config show para ver o que está valendo e ccn sync para puxar as alterações feitas no celular.

Se você quer o contrário, uma noite tranquila em que o Claude continue trabalhando, o fluxo para se afastar do computador explica como deixar uma sessão rodando e respondê-la pelo celular quando você quiser.

06Perguntas frequentes