Desde então, construímos um produto dedicado para ajudar desenvolvedores a gerenciar permissões de IA de forma melhor, que pretendemos tornar open source. Confira em stoplight.ai.

Claude Code Guardrails

settings.json funciona se:

• Você se sente confortável editando JSON e finalizando sessões do Claude Code toda vez que as políticas mudam
• Sua equipe de segurança se sente confortável em fazer PRs
• Você não precisa saber o que foi bloqueado, quando ou para quem
• Correspondência de padrões básicos como Bash(rm:*) cobre seus casos de uso

Use isto se:

• Mudanças de política precisam ser aplicadas instantaneamente em toda a equipe—sem git pull, sem reinicialização
• Segurança/conformidade precisa de uma trilha de auditoria clara de cada comando bloqueado
• Você precisa de lógica condicional: "permitir rm -rf em node_modules, negar em todos os outros lugares"
• Não-engenheiros precisam editar regras sem tocar em arquivos de configuração

Rulebricks oferece governança instantânea a partir de um único hook.

Claude Code → PreToolUse hook → Rulebricks API → allow / deny / ask

Configuração (5 minutos)

1. Crie suas regras

1. Acesse rulebricks.com e crie uma conta
2. Faça fork de um destes modelos da categoria "AI Agents":
   • Claude – Bash Guardrails — controla comandos de shell
   • Claude – File Access Policy — controla leitura/gravação/edição de arquivos
   • MCP Tool Governance — controla operações do servidor MCP
3. Personalize as regras para sua equipe
4. Publique a regra
5. Copie sua chave de API da aba API

2. Instalação

Encontra automaticamente suas regras

git clone https://github.com/rulebricks/claude-code-guardrails
cd claude-code-guardrails
./install.sh

O Claude detectará suas regras publicadas e conectará os hooks apropriados.

3. Reinicie o Claude Code

Pronto.

O que é verificado

Configuração

Variáveis de ambiente em ~/.claude/settings.json:

{
  "env": {
    "RULEBRICKS_API_KEY": "your-api-key",
    "RULEBRICKS_VERBOSE": "1"
  }
}

Atualizando regras

Edite sua tabela de decisão e publique uma nova versão. As alterações são aplicadas imediatamente— sem reinicialização, sem reimplantação.

Revisando históricos

Revise o histórico de comandos bloqueados na aba Logs. Você pode consultar por ferramenta, decisão de aprovação e mais. Existem outros benefícios significativos nesses dados, como descobrir qual ferramenta está sendo bloqueada com mais frequência.

Privacidade dos dados

Você está livre para editar a guardrail como quiser para ocultar dados sensíveis antes que cheguem à nossa plataforma.

Além disso— embora funcione com nosso ambiente em nuvem, você também pode executar isso em infraestrutura privada, usando seu próprio provedor de logs. Entre em contato se isso for de interesse.

Desinstalar

# Remove hook script
rm ~/.claude/hooks/guardrail.py

# Remove from settings.json (manual)
# Edit ~/.claude/settings.json and delete:
#   - hooks.PreToolUse entry
#   - env.RULEBRICKS_* variables

Ou, use este one-liner para remover o hook e as configurações:

rm ~/.claude/hooks/guardrail.py && python3 -c "
import json
p = '$HOME/.claude/settings.json'.replace('\$HOME', '$HOME')
s = json.load(open(p))
s.get('hooks', {}).pop('PreToolUse', None)
for k in list(s.get('env', {}).keys()):
    if k.startswith('RULEBRICKS_'): s['env'].pop(k)
json.dump(s, open(p, 'w'), indent=2)"