Guardrails para o Claude Code, feitos com as tuas próprias regras.
As regras da tua empresa chegam ao Claude Code antes de cada alteração. O que ele nunca deve fazer fica bloqueado antes de correr.
npx -y @cybedefend/vibedefend@latest installClaude Code está a escrever
billing/refund.ts
export async function refund(req: Request) { const { id, amount } = await req.json(); const invoice = await db.invoices.find({ id, tenant: req.tenant, }); if (amount > 500) await approvals.second(invoice); return payments.refund(invoice, amount); }
Cada consulta fica limitada ao tenant.
rules/data-access.mdReembolsos acima de 500 € precisam de um segundo aprovador.
Aprovada uma vez por Sofia M.Verificado antes do commit: limpo
Pronto em quatro passos.
- Executa um comandoEm qualquer terminal, no macOS, Linux ou Windows. Node 18.17 ou mais recente.
- Escolhe a região e inicia sessãoUE ou EUA. O teu browser abre-se para iniciares sessão, sem chave para colar.
- Seleciona o Claude CodeO instalador encontra os agentes no teu computador e seleciona-os por ti.
- Programa como sempreAbre o Claude Code: o VibeDefend corre ao lado dele.
O que o VibeDefend acrescenta ao Claude Code.
Regras servidas
As tuas regras de negócio e de segurança chegam ao Claude Code antes de cada edição.
Claude Code está a escrever
src/billing/cart-checkout.ts
const total = new Decimal128(cart.sum); const rows = await db.query( "SELECT * FROM carts WHERE id = $1", [id] );
Os montantes usam Decimal128, nunca Number.
Extraída de src/billing.ts:14Qualquer consulta que misture dados do utilizador é parametrizada.
OWASP Top 10Servidas antes da edição
Proteção de segredos
As leituras diretas de segredos são recusadas; o Claude Code recebe a referência gerida.
Claude Code
webhooks.ts
cat .env | grep STRIPEBloqueado: leitura direta de um segredo
Em vez disso
process.env.STRIPE_WEBHOOK_SECRETnpm test -- webhooksOs testes passam
Registado para a equipa
Controlo de ações
Comandos destrutivos, eliminações de esquema e caminhos protegidos são travados antes de correrem.
Claude Code
rm -rf dist/Permitido: saída do build
rm -rf .cache/Permitido: cache
rm -rf ./storage/uploadsBloqueado: caminho protegido, ficheiros dos utilizadores
Registado para a equipa
Descobertas em direto
As descobertas de SAST, SCA, segredos, IaC e CI/CD, em direto na sessão.
Claude Code
SAST
src/db/users.repo.ts:42SQL injection
SCA
package.jsonlodash 4.17.20, CVE-2021-23337
Secrets
config/prod.ymlAWS access key
IaC
infra/main.tfS3 bucket public-read
CI/CD
.github/workflows/deploy.ymlpull_request_target
No contexto do agente, em direto
As tuas perguntas.
O VibeDefend altera a minha configuração do Claude Code?
~/.claude/settings.json, ~/.claude.json. Os teus hooks ficam onde estão: voltar a correr o instalador só substitui as entradas do VibeDefend.O que é que sai da minha máquina?
De que versão do Claude Code preciso?
Tenho de associar cada repositório?
vibedefend link uma vez. O comando escreve .cybedefend/config.json com o ID do projeto.Como é que o desinstalo?
vibedefend uninstall: remove todos os ficheiros que o VibeDefend instalou. Se instalaste o pacote globalmente, corre depois npm uninstall -g @cybedefend/vibedefend.O Claude Code tem guardrails próprios?
Detalhes técnicos para o Claude Code
- Servidor MCP
- Disponível
claude mcp add --scope user - Regras antes de cada alteração
- Disponível
PreToolUseEdit|Write|MultiEdit|BashTambém antes dos comandos shell que escrevem ficheiros: redireções, heredocs, tee, sed -i. Os comandos só de leitura não vão buscar nada. - Ações perigosas bloqueadas
- Disponível
PreToolUse - Regras carregadas no arranque
- Disponível
SessionStart - Revisão no fim da sessão
- Disponível
Stop - Revisão das sessões longas
- Disponível
PreCompact - Lembrete a cada prompt
- Disponível
UserPromptSubmit
O que escreve para o Claude Code
~/.claude/settings.json~/.claude.json
E o runner dos hooks em ~/.cybedefend/. Os teus hooks ficam onde estão: voltar a correr o instalador só substitui as entradas do VibeDefend.
O servidor MCP é adicionado ao nível do utilizador, por isso todos os teus repositórios o veem, e não só aquele a partir do qual instalaste.
Só o Claude Code recebe um lembrete curto a cada prompt: sem ele, uma skill que arranca sozinha podia assumir o controlo antes de as tuas regras chegarem.
Algo não bate certo? O vibedefend status dá um relatório só de leitura, e o vibedefend doctor repara o que conseguir.