Hooks

Os hooks são scripts automatizados que são executados em resposta a eventos específicos durante as sessões do Claude Code. Permitem automatização, validação, gestão de permissões e fluxos de trabalho personalizados.

Descrição geral

Os hooks são ações automatizadas (comandos shell, webhooks HTTP, prompts LLM, chamadas a ferramentas MCP ou avaliações por subagentes) que são executadas automaticamente quando ocorrem eventos específicos no Claude Code. Recebem dados de entrada em JSON e comunicam os resultados através de códigos de saída e de saída em JSON.

Funcionalidades principais:

• Automatização orientada por eventos
• Entrada/saída baseada em JSON
• Suporte para os tipos de hook command, http, mcp_tool, prompt e agent
• Correspondência de padrões para hooks específicos de ferramentas

Configuração

Os hooks são configurados em ficheiros de definições com uma estrutura específica:

• ~/.claude/settings.json - Definições do utilizador (todos os projetos)
• .claude/settings.json - Definições do projeto (partilháveis, versionadas)
• .claude/settings.local.json - Definições locais do projeto (não versionadas)
• Política gerida - Definições para toda a organização
• Plugin hooks/hooks.json - Hooks no âmbito do plugin
• Frontmatter de skill/agente - Hooks de ciclo de vida do componente

Estrutura de configuração básica

{
  "hooks": {
    "EventName": [
      {
        "matcher": "ToolPattern",
        "hooks": [
          {
            "type": "command",
            "command": "your-command-here",
            "timeout": 60
          }
        ]
      }
    ]
  }
}