Validador de Hooks Claude Code
Turner-Levey/claude-code-hooks-settings-checker
Valida settings.json e hooks do Claude Code direto no navegador
Ver no GitHubAgent browser-only que valida a estrutura de arquivos settings.json e configurações de hooks do Claude Code sem necessidade de login ou upload. Detecta erros JSON, problemas de format de matchers, e inconsistências em handlers de command, http, prompt, agent e mcp_tool.
Instalação
npx convez-ai Turner-Levey/claude-code-hooks-settings-checker1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Validar configuração de hooks antes de commitar
- Verificar estrutura de matchers e event arrays
- Identificar problemas de placement de chaves em settings
Veredito

Ferramenta especializada e prática para quem trabalha com Claude Code, reduz debugging ao validar settings localmente. Abordagem privacy-first (tudo no browser) é um diferencial importante para dados de configuração sensíveis.
README
A tradução para o português deste README ainda está na fila.
Claude Code Hooks Settings Checker
Free no-signup browser-only checker for Claude Code settings.json and hooks configuration shape.
Live app: https://claude-code-hooks-settings-checker.vercel.app/
Public listing evidence:
- Tiny Tool Town: https://www.tinytooltown.com/tools/claude-code-hooks-settings-checker/
- No-Login listing: https://nologin.tools/tool/claude-code-hooks-settings-checker-vercel-app/
- No-Login badge: https://nologin.tools/badge/claude-code-hooks-settings-checker-vercel-app/
What It Checks
- JSON parse errors before a settings file is committed.
- Whether hook event arrays live under the
hooksobject. - Common hook handler shape for
command,http,prompt,agent, andmcp_toolentries. - Matcher shape problems, including array matchers where a pipe-separated string is expected.
- Hook events that normally ignore matchers.
- Project/user/settings location hints for keys that belong in a different Claude Code configuration file.
The app does not upload pasted settings. All analysis runs in the browser.
Sources
- Claude Code settings documentation: https://code.claude.com/docs/en/configuration
- Claude Code hooks reference: https://docs.anthropic.com/en/docs/claude-code/hooks
- Claude Code debug and settings notes: https://docs.anthropic.com/en/docs/claude-code/troubleshooting
Development
npm run check
License
MIT