O que claude-code-harness-kit faz?
Um kit de hooks do Claude Code (aprovação automática somente leitura, guardiões de segredos, guardiões bash opinativos) + repo-radar, uma habilidade de análise de repositório somente leitura. Menos atrito com prompts, sem redução de segurança.
Visão Geral
O claude-code-harness-kit oferece uma coleção de hooks e habilidades que tornam o uso do Claude Code (ou agentes similares como Cursor, Codex) mais fluido e seguro. Em vez de pedir confirmação para cada operação inócua, o kit autoriza automaticamente ações seguras, mantendo a vigilância sobre operações perigosas.
Componentes
- Read-only Auto-approve: Aprova automaticamente comandos de leitura (ex:
ls,cat,git log) sem intervenção do usuário. - Secret Guards: Detecta e bloqueia tentativas de exibir, registrar ou enviar segredos (chaves de API, tokens, senhas) para fora do ambiente.
- Opinionated Bash Guards: Restringe comandos bash potencialmente perigosos (ex:
rm -rf,chmod,curlpara destinos externos) a menos que sejam explicitamente permitidos. - Repo-radar: Uma habilidade somente leitura que analisa o repositório atual, extraindo estrutura, dependências, histórico git e fornece um resumo inteligente para o agente, sem nunca modificar arquivos.
Como Funciona
Os hooks são aplicados no momento em que o Claude Code executa uma ferramenta ou comando. Cada hook verifica:
- Tipo de operação: leitura vs escrita.
- Conteúdo do comando: presença de padrões suspeitos (ex: strings de conexão, comandos destrutivos).
- Contexto: se a operação é para um arquivo dentro do repositório vs externo.
Se a operação for considerada segura (leitura, sem segredos, comando inofensivo), ela é aprovada automaticamente. Caso contrário, o usuário é notificado ou a operação é bloqueada.
Instalação
Clone este repositório no diretório de configuração do Claude Code:
git clone https://github.com/xohzzwn6kcj9/claude-code-harness-kit.git ~/.claude/hooks/
Adicione ao seu arquivo claude.json ou variáveis de ambiente:
{
"hooks": [
"~/.claude/hooks/read-only-auto-approve",
"~/.claude/hooks/secret-guards",
"~/.claude/hooks/bash-guards"
],
"skills": [
"~/.claude/hooks/repo-radar"
]
}
Configuração
| Variável de Ambiente | Descrição | Padrão |
|---|---|---|
HARNESS_READ_ONLY_AUTO_APPROVE | Ativa aprovação automática de leitura | true |
HARNESS_SECRET_GUARDS_ENABLED | Ativa guardiões de segredos | true |
HARNESS_BASH_GUARDS_ENABLED | Ativa guardiões bash | true |
HARNESS_REPO_RADAR_DEPTH | Profundidade da análise do repo-radar | 3 |
Exemplo de Uso
Após ativar, o agente pode executar:
# Aprovado automaticamente (leitura)
cat src/index.js
ls -la
# Bloqueado (segredo detectado)
echo "API_KEY=12345"
# Questionado (comando perigoso)
rm -rf /tmp
Contribuição
Sinta-se à vontade para abrir issues ou pull requests. Todos os hooks são escritos em bash e Python para máxima compatibilidade.
Licença
MIT