Claude Code: Restrija os subagentes Haiku à exploração de código
No Claude Code, é possível forçar os subagentes Haiku a operar em modo somente leitura para explorar o codebase, delegando todas as edições ao agente principal.
Em uma configuração do Claude Code onde o Sonnet atua como modelo principal, o Opus como conselheiro e o Haiku executa subagentes, recomenda-se utilizar os subagentes Haiku exclusivamente para a exploração do codebase.
Você pode forçar os subagentes a um modo de exploração somente leitura, deixando todas as alterações de código sob responsabilidade do agente principal.
Para isso, instale dois hooks:
- Subagents Explore Only — utiliza
SubagentStartpara permitir que os subagentes apenas leiam arquivos, realizem buscas e reportem resultados, sem modificar nada. - Subagent Read Only Guard — utiliza
PreToolUsepara bloquear escritas em arquivos e comandos proibidos. Se um subagente tentar alterar arquivos, o hook bloqueia a ação.
Instale-os com um único comando:
npx claude-code-templates --setting hooks/subagents-explore-only --hook security/subagent-read-only-guard
O agente principal mantém seus direitos de acesso normais, enquanto os subagentes focam exclusivamente na exploração do codebase.
Por que isso importa
AnáliseEssa abordagem reduz o risco de alterações involuntárias no código durante a exploração automatizada e estabelece uma separação mais clara entre operações de pesquisa e escrita.
Debater na comunidade
Compartilhe suas dúvidas e insights com desenvolvedores