---
published: true
id: hooks
title: Hooks
description: Knowledge captured in João Lopes' learning graph.
tags:
- ai-engineering
- claude-code
- cyberdeck
locale: pt-br
resource: https://joaolopes.dev.br/knowledge/concepts/pt-br/hooks/
created: '2026-04-06'
---

# Hooks
Comandos shell definidos pelo usuário que executam em pontos específicos do lifecycle do Claude Code, fornecendo enforcement determinístico fora do contexto do modelo.

## Definição
Hooks são eventos de lifecycle que disparam antes e depois de tool calls no Claude Code. Diferente de instructions, hooks rodam como código. Eles enforçam comportamento incondicionalmente, fora do contexto do modelo. Hooks são conectados em arquivos de settings e apontam para scripts que rodam de forma síncrona (PreToolUse pode bloquear uma tool call) ou assíncrona. Disparam no nível do processo em toda invocação de tool independente de qual agente ou subagent a disparou, o que os torna um mecanismo confiável de enforcement onde modelagem comportamental não é.

## Fonte
- [Hooks reference - Claude Code Docs](https://docs.anthropic.com/en/docs/claude-code/hooks)
- [Automate workflows with hooks - Claude Code Docs](https://docs.anthropic.com/en/docs/claude-code/hooks-guide)

## Relacionados
- behavioral-modeling
- [CLAUDE.md](/concepts/pt-br/claude-md.md)
- [AI Agent](/concepts/pt-br/ai-agent.md)