VGuard
Docs/Adapters/Claude Code

Claude Code

Runtime enforcement via Claude Code hooks.

Enforcement: Runtime (blocks operations)

Claude Code is the only adapter that provides true runtime enforcement. VGuard generates hook scripts that execute before each tool use and can block operations with exit code 2.

Generated Files

  • .claude/settings.json — hook entries (merged with existing)
  • .vguard/hooks/vguard-pretooluse.js — PreToolUse hook
  • .vguard/hooks/vguard-posttooluse.js — PostToolUse hook
  • .vguard/hooks/vguard-stop.js — Stop hook

How It Works

  1. Claude Code triggers a hook event (e.g., PreToolUse for Edit)
  2. The hook script reads the proposed change from stdin
  3. VGuard evaluates the change against your enabled rules
  4. Pass (exit 0): change proceeds
  5. Block (exit 2): change is rejected with explanation and fix suggestion

Performance

Hook scripts use pre-compiled config (.vguard/cache/resolved-config.json) for fast execution. Target: under 100ms per hook invocation.