Quando desligar os mods e voltar ao Claude Code cru?

Fala aí, beleza? Os mods chegaram no Claude Code e todo mundo já tá montando o setup dos sonhos, com painel novo, comando novo e regra pra tudo 😀

Só que tem uma habilidade que pouca gente comenta: saber DESLIGAR tudo isso e voltar pro Claude Code cru

Recapitulando rapidinho: a Anthropic lançou os mods na versão 2.1.287 do Claude Code

Mods são handlers em TypeScript ou JavaScript que rodam dentro do Claude Code e mudam como ele se comporta e o que ele desenha na tela

E aqui vem o detalhe que importa pra este post: eles ficam ligados por padrão e rodam fora do sandbox, com as mesmas permissões do seu usuário

Ou seja, cada mod instalado é uma camada a mais entre você e o modelo

Na maior parte do tempo isso é ótimo, porém tem três cenários em que essa camada extra atrapalha mais do que ajuda: a tarefa exploratória, o bug que você ainda não entende e a depuração do próprio setup

Bora ver cada um e depois o passo a passo pra desligar? 🙂

Os 3 cenários em que os mods atrapalham mais que ajudam:

Antes dos cenários, vale lembrar o que um mod consegue fazer, segundo a documentação oficial: reescrever um prompt, adicionar interface nova, substituir um recurso nativo ou adicionar funcionalidade nova

Na prática, ele adiciona painéis, comandos e regras sobre chamadas de ferramenta

Guarda isso, porque é exatamente daí que vêm os problemas abaixo

1. Tarefa exploratória: por que desligar os mods?

Explorar é deixar o Claude Code olhar o projeto do jeito dele, sem trilho

Se um mod reescreve o seu prompt ou impõe regras sobre quais ferramentas podem ser chamadas, a exploração já sai enviesada

Você acha que tá vendo como o modelo enxerga o problema, mas tá vendo como o modelo enxerga o problema DEPOIS do filtro do mod

É como pedir a opinião sincera de alguém e entregar o roteiro do que ele deve responder haha

Nesse momento, o que você quer controlar é quanta autonomia o agente tem, e não quais regras de terceiros estão no meio do caminho

2. Bug que você ainda não entende: o mod vira variável extra?

Vira sim

Quando você ainda não sabe a causa de um bug, cada coisa que muda o comportamento do ambiente é uma variável a mais no diagnóstico

Um mod que substitui um recurso nativo ou adiciona regras sobre chamadas de ferramenta entra direto nessa conta

Aí fica difícil separar o que é o problema do seu código, o que é o modelo e o que é o mod

Tirar a camada extra reduz o número de suspeitos, e diagnóstico bom começa assim

3. Depuração do próprio setup: de onde vem o comportamento estranho?

Esse é o clássico: o Claude Code começou a fazer algo esquisito e você não sabe de onde veio

Pode ser um mod, um hook, um servidor MCP, uma regra no CLAUDE.md…

Com tudo ligado, você só vê o resultado final, misturado

A saída é voltar pra uma linha de base limpa e ir religando as peças, e é exatamente pra isso que o safe mode existe (vamos chegar nele já já)

Antes de desligar: o que conferir?

Antes de sair desligando tudo, vale saber o que realmente carregou na sessão

O Claude Code tem comandos pra isso:

• /context: mostra o que está ocupando o contexto da sessão
• /doctor: diagnóstico geral da instalação e da configuração
• /hooks: lista os hooks ativos
• /mcp: mostra os servidores MCP
• /permissions: mostra as regras de allow e deny em vigor

Outra coisa que confunde muita gente: alguns recursos do próprio Claude Code são mods

Eles aparecem na aba Installed do /plugin, mas não dá pra atualizar nem desinstalar esses mods nativos

A documentação mostra como desligar cada um deles, então se o comportamento estranho vier de um mod nativo, o caminho é por lá

E se você usa plano Team ou Enterprise, se liga: existe um mod de segurança nativo chamado sec-default que carrega primeiro, justamente pra que mods instalados pelo usuário não passem por cima das regras de deny

Isso é bom! Só não espere que ele suma junto com os seus mods

Como desligar os mods no Claude Code, do mais amplo ao mais pontual:

Vou do martelo grande pro bisturi, beleza?

A ideia é: começa amplo pra confirmar se o problema é mesmo personalização, e depois vai fechando o cerco

1. Uma sessão inteira crua com o safe mode

Esse é o modo mais rápido de ter o Claude Code cru, sem mexer em nada do seu setup:

claude --safe-mode

Se preferir variável de ambiente, o efeito é o mesmo:

CLAUDE_CODE_SAFE_MODE=1 claude

O safe mode desliga todas as personalizações por uma única sessão, sem mudar a pasta de trabalho nem as suas configurações

Ele não carrega: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos personalizados e agentes personalizados

E mantém funcionando: autenticação, escolha de modelo, ferramentas nativas e permissões

Detalhe importante: como as ferramentas nativas e as permissões continuam valendo, o Claude Code segue editando arquivo normalmente, então se algo sair torto você ainda vai precisar desfazer as alterações do Claude Code do jeito de sempre

O erro comum deste passo: esquecer que o CLAUDE.md também some

Aí o modelo ignora as convenções do projeto e você conclui que ele ficou burro do nada kkk

Não ficou, ele só não leu as instruções que você deixou lá 🙂

2. Só os hooks, numa execução

Se você quer manter o resto do setup e tirar os hooks da jogada só naquela execução, sem gravar nada em arquivo:

claude --settings '{"disableAllHooks": true}'

Esse --settings tem precedência sobre as settings de projeto e as locais, então mesmo que o projeto ligue hooks, nessa execução eles ficam de fora

É útil quando você não quer mexer no arquivo de configuração só pra fazer um teste rápido

Guarda o nome dessa chave, porque ela volta no próximo passo

3. Todos os mods, em todas as sessões

Agora sim o desligamento permanente, e se liga: a chave é a MESMA do passo anterior

A diferença é onde ela mora: lá ela vinha pelo --settings e valia só pra uma execução, aqui ela fica gravada no seu arquivo de settings e vale pra todas as sessões

No arquivo ~/.claude/settings.json, adicione:

{
  "disableAllHooks": true
}

Gravada no ~/.claude/settings.json, a documentação de mods diz que essa chave desliga todos os mods instalados em todas as sessões, e junto param os hooks das settings e a status line personalizada

Ou seja, não são dois efeitos diferentes: o passo 2 é um uso pontual da chave, focado em hooks, e este aqui é o uso permanente, com o alcance completo que a documentação de mods descreve

Fora das managed settings, essa chave desliga hooks de usuário, projeto, local e plugin

O erro comum deste passo: achar que isso desliga TUDO, inclusive o que a organização gerencia

Não desliga!

Continuam rodando os hooks gerenciados, os hooks do Agent SDK e os plugins forçados em enabledPlugins gerenciado

Então se você tá numa empresa e algo persiste mesmo com essa chave, provavelmente é configuração gerenciada, e aí o papo é com quem administra

4. Um mod específico

Quando você já sabe (ou desconfia) qual mod tá atrapalhando, não precisa derrubar o resto

Mods vêm dentro de plugins, então o caminho é o mesmo de sempre:

/plugin

Na aba Installed, desative ou desinstale o plugin daquele mod

Depois, aplique a mudança sem reiniciar a sessão:

/reload-plugins

O /reload-plugins aplica plugins instalados, atualizados, ativados, desativados ou editados desde o início da sessão, então não precisa fechar e abrir o Claude Code de novo

O erro comum deste passo: desativar o plugin e continuar na mesma sessão achando que já valeu, sem rodar o /reload-plugins

5. Um servidor MCP específico

As vezes o vilão nem é mod, é um servidor MCP

Pra desligar só ele, liste o servidor em disabledMcpServers nas settings:

{
  "disabledMcpServers": ["nome-do-servidor"]
}

Com isso o Claude Code simplesmente não conecta nele

Resumindo os cinco caminhos numa tabela:

Como achar o mod culpado depois do safe mode?

Aqui é onde o safe mode mostra pra que veio

Sintoma: o Claude Code tá com um comportamento estranho, e quando você roda claude --safe-mode o problema some

Causa: se some no safe mode, a causa está em alguma das personalizações que ele desliga (mod, plugin, hook, MCP, CLAUDE.md, skill, comando ou agente personalizado)

Solução: religar as personalizações uma de cada vez até o problema voltar

A que trouxe o problema de volta é a culpada, simples assim

Pra acelerar esse processo:

• Use o /reload-plugins a cada plugin que você religa, assim não precisa reiniciar a sessão toda hora
• Inicie o Claude Code com log de debug pra ver o que tá acontecendo por baixo

claude --debug

Ou, se quiser o log salvo num arquivo:

claude --debug-file <caminho>

O log tem uma linha pra cada módulo carregado ou recusado e uma linha pra cada hook que falha, no formato hook skipped: seguido do motivo

Os motivos podem ser erro, tempo esgotado ou resultado no formato errado

E se você já tá no meio de uma sessão, o /debug liga o log de debug ali mesmo

Como prevenir: antes de culpar o modelo, confere /hooks, /mcp e /context pra saber o que tá rodando de verdade

E instale mods de forma incremental, um de cada vez, observando o comportamento antes de colocar o próximo

Instalar dez mods de uma vez e depois tentar descobrir qual quebrou é pedir pra passar a tarde caçando fantasma…

Pra quem quiser ir mais fundo, a página de depuração de configuração da documentação oficial é a referência desses comandos

Desligar também é saber usar:

O argumento todo do post cabe numa frase: o Claude Code cru é a sua linha de base

Pra explorar um projeto, pra entender um bug novo e pra descobrir por que o seu setup tá doido, você quer o mínimo de camadas entre você e o modelo

Os mods voltam quando você sabe o que quer deles, e aí sim eles brilham, com painel, comando e regra fazendo exatamente o que você pediu

Recapitulando os caminhos:

• claude --safe-mode pra uma sessão inteira sem personalizações
• claude --settings '{"disableAllHooks": true}' pra tirar os hooks de uma execução
• A mesma chave "disableAllHooks": true, agora gravada no ~/.claude/settings.json, pra desligar os mods instalados (e os hooks das settings) em todas as sessões
• Aba Installed do /plugin + /reload-plugins pra um mod específico
• disabledMcpServers pra um servidor MCP específico

Próximo passo: na sua próxima tarefa exploratória, roda uma sessão com claude --safe-mode e compara com o seu setup de sempre

A diferença (ou a falta dela) já te conta muito sobre o quanto os seus mods estão ajudando 😀

Até o próximo post!