Guia de Segurança — Prevenir Operações Destrutivas
Quando Usar
- Ao trabalhar em sistemas de produção
- Quando agentes estão executando de forma autônoma (modo totalmente automático)
- Quando você deseja restringir edições a um diretório específico
- Durante operações sensíveis (migrações, implantações, alterações de dados)
Como Funciona
Três modos de proteção:
Modo 1: Modo Cuidadoso
Intercepta comandos destrutivos antes da execução e avisa:
Padrões monitorados:
- rm -rf (especialmente /, ~, ou raiz do projeto)
- git push --force
- git reset --hard
- git checkout . (descartar todas as alterações)
- DROP TABLE / DROP DATABASE
- docker system prune
- kubectl delete
- chmod 777
- sudo rm
- npm publish (publicações acidentais)
- Qualquer comando com --no-verify
Quando detectado: mostra o que o comando faz, pede confirmação, sugere alternativa mais segura.
Modo 2: Modo Congelamento
Bloqueia edições de arquivos a uma árvore de diretórios específica:
/safety-guard freeze src/components/
Qualquer Escrita/Edição fora de src/components/ é bloqueada com uma explicação. Útil quando você deseja que um agente foque em uma área sem tocar em código não relacionado.
Modo 3: Modo Guarda (Cuidadoso + Congelamento combinados)
Ambas as proteções ativas. Segurança máxima para agentes autônomos.
/safety-guard guard --dir src/api/ --allow-read-all
Agentes podem ler qualquer coisa, mas só escrever em src/api/. Comandos destrutivos são bloqueados em todos os lugares.
Desbloqueio
/safety-guard off
Implementação
Usa hooks PreToolUse para interceptar chamadas de ferramentas Bash, Write, Edit e MultiEdit. Verifica o comando/caminho contra as regras ativas antes de permitir a execução.
Integração
- Ativar por padrão para sessões
codex -a never - Combinar com pontuação de risco de observabilidade no ECC 2.0
- Registra todas as ações bloqueadas em
~/.claude/safety-guard.log