Automatizando verificações com Hooks

Desenvolvimento de Software com Claude Code

Dani Zysman

AI Curriculum Manager @ DataCamp

O problema do manual

recraft: half: Uma pessoa desenvolvedora à mesa, cansada, executando o mesmo comando repetidas vezes

  • Hooks disparam quando Claude executa uma ação específica
  • Hooks rodam automaticamente: ótimo para tarefas repetitivas
  • Hooks evitam pular etapas de um processo
Desenvolvimento de Software com Claude Code

O que são Hooks?

  • Ferramentas:
    • Leitura/gravação de arquivos
    • Executar um comando
  • Hooks:

    • Comandos de shell definidos pelo usuário que rodam automaticamente
    • Configurados em .claude/settings.json
    • Pense neles como "se isto, então aquilo" para Claude Code

    Use /hooks para listar o que está ativo

Desenvolvimento de Software com Claude Code

O projeto até agora

music-analytics-api/
  app.py
  routes.py
  test_routes.py    
  CLAUDE.md
  .claude/
    agents/
    skills/
    settings.json    # <- Hook configuration
Desenvolvimento de Software com Claude Code

Tipos de Hooks e fluxo

Diagrama do fluxo de hooks

PreToolUse: dispara antes da ferramenta rodar → Use para inspecionar ou bloquear operações perigosas

PostToolUse: dispara após a conclusão → Use para rodar testes, lint ou registrar resultados

Desenvolvimento de Software com Claude Code

Configurando um Hook

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "cd $CLAUDE_PROJECT_DIR && python -m pytest --tb=short -q"
          }
        ]
      }
    ]
  }
}
Desenvolvimento de Software com Claude Code

Capturando a saída do Hook

def pytest_terminal_summary(terminalreporter, exitstatus, config):
    passed = len(terminalreporter.stats.get('passed', []))
    failed = len(terminalreporter.stats.get('failed', []))

    if failed:
        title = "pytest FAILED"
        message = f"{failed} failed {passed} passed"
    else:
        title = "pytest PASSED"
        message = f"All {passed} tests passed!"

    with open("/tmp/pytest_results.log", "a") as f:
        f.write(f"{title}: {message}\n")
Desenvolvimento de Software com Claude Code

Log de saída do Hook

[23:07:35] pytest FAILED: ❌; 2 failed, 15 passed

[23:07:38] pytest PASSED: ✅ All 17 tests passed!

[23:08:09] pytest PASSED: ✅ All 17 tests passed!

[23:08:12] pytest PASSED: ✅ All 17 tests passed!

Desenvolvimento de Software com Claude Code

Quando usar Hooks

Fluxograma de decisão sobre quando usar hooks

  • Bons candidatos:
    • Testes após edições de arquivos
    • Verificações de lint
    • Bloqueios de segurança
Desenvolvimento de Software com Claude Code

Recap do Capítulo 2

Recurso Acionar Listar Caminho de config
Agents @agent-name /agents .claude/agents/name.md
Skills /skill-name /skills .claude/skills/name/SKILL.md
Hooks (automático) /hooks .claude/settings.json
Desenvolvimento de Software com Claude Code

Vamos praticar!

Desenvolvimento de Software com Claude Code

Preparing Video For Download...