Mods do Claude Code funcionam no Claude Desktop ou só na CLI?

Fala aí, beleza? Se você vive pulando entre o terminal e o app, se liga: os mods funcionam no Claude Desktop sim, mas só na aba Code, e mesmo ali tem exceção 😀

Segundo a documentação oficial, em 1º de outubro de 2026 a Anthropic abriu o Claude Code para mods

E aí bateu a dúvida clássica de quem alterna entre CLI e app: será que vale investir tempo escrevendo ou instalando um mod se ele só roda em um dos lados?

Antes de tudo, o que é um mod?

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

Dá pra escrever o mod você mesmo ou pedir pro próprio Claude Code escrever, o que é bem massa haha

Bora ver onde cada parte funciona?

Compatibilidade dos mods por ambiente: CLI, Desktop, VS Code e nuvem

Segundo a documentação oficial dos mods, o suporte completo existe na CLI do Claude Code e na aba Code do app desktop

Nos outros ambientes o mod funciona pela metade ou nem roda:

Repara que a documentação fala da aba Code do app

Ela não diz nada sobre as outras abas do Desktop, então não conte com mod fora da aba Code

Por que um mod pode funcionar pela metade em alguns ambientes?

Porque um mod tem duas partes bem diferentes, e cada uma depende de uma coisa

Se você já sabe como as skills funcionam por dentro, tira da cabeça a ideia de "instrução pro modelo": o mod é código rodando de verdade dentro do Claude Code

A parte de comportamento (hooks):

É aqui que o mod mexe no fluxo do Claude Code. Ele pode:

• reescrever o prompt antes de ele chegar ao modelo
• bloquear, reescrever ou repetir uma chamada de ferramenta
• aprovar ou negar pedidos de permissão
• ocultar segredos da saída das ferramentas antes que o Claude leia

A parte de interface:

É o que você vê na tela. O mod pode:

• desenhar um painel ao lado da transcrição
• desenhar uma faixa acima do prompt, com abas, botões e campos de texto
• substituir ou reestilizar partes da interface do próprio Claude Code

Onde a UI some, o comportamento continua

Se liga nisso: na extensão do VS Code, no claude -p, no Agent SDK e nas sessões em nuvem, a parte visual não aparece

Mas os hooks seguem ativos

Ou seja, um mod que oculta segredos continua ocultando, mesmo que o painel bonitão dele não esteja lá 🙂

Já no WSL a história é outra: os plugins não ficam disponíveis, então os hooks nem rodam

O que considerar antes de investir tempo em um mod?

A pergunta certa é: onde está o valor do mod que você quer?

Se o valor está na interface:

Painel, faixa com botões, reestilização da UI e por aí vai

Aí ele só entrega a experiência completa na CLI e na aba Code do desktop, fora do WSL

Se teu dia a dia é muiiito VS Code, por exemplo, você vai ficar sem a parte visual

Se o valor está no comportamento:

Regras de permissão, bloqueio de ferramenta, esconder segredo da saída e etc

Esse tipo de mod te acompanha MUITO mais longe: CLI, aba Code do desktop, VS Code, claude -p, Agent SDK e nuvem

Checklist rápido antes de começar:

1. Confere se tu tá no Claude Code v2.1.287 ou superior, que é a versão mínima exigida. O erro comum aqui é achar que o mod quebrou quando na real a versão tá antiga
2. Lembra que os mods já vêm ativados por padrão, não tem chave pra ligar
3. Instala pelo /plugin, já que os mods vêm dentro de plugins, e lembra que no app o mod só roda completo na aba Code
4. Se usa o Desktop com WSL, nem perde tempo nessa sessão: ali os hooks dos mods não rodam

Segurança: mods rodam sem sandbox no terminal e no app

Tome cuidado com essa parte!

Os mods rodam com o mesmo acesso à máquina que o próprio Claude Code e não têm sandbox

Traduzindo: um mod mal-intencionado pode fazer tudo que o Claude Code faz no teu PC, os rm -rf da vida inclusos xD

A orientação oficial é instalar só de fontes confiáveis

Como desligar todos os mods de uma vez?

Se algo estranho acontecer, adiciona a chave disableAllHooks com valor true no arquivo ~/.claude/settings.json:

{
  "disableAllHooks": true
}

Isso desativa todos os mods instalados em todas as sessões

Se o teu arquivo já tem outras configurações, só acrescenta a chave, não apaga o resto 😛

E pra quem administra times?

A documentação traz uma página chamada ‘Manage mods for your organization’, voltada pra gestão de mods em organizações

Se você cuida de um time, vale dar uma lida lá antes de liberar geral

Conclusão: vale usar mods se você alterna entre CLI e Desktop?

Vale sim!

A experiência completa, com comportamento e interface, funciona tanto na CLI quanto na aba Code do Claude Desktop

A única pedra no caminho é o WSL, onde os hooks dos mods não rodam

E se o mod é mais sobre comportamento do que sobre visual, ele ainda te acompanha no VS Code, no claude -p, no Agent SDK e na nuvem

Próximo passo: confere se tá na v2.1.287 ou superior e instala um mod de fonte confiável via /plugin

Ou pede pro próprio Claude Code escrever um pra você, legal né? 😀

até o próximo post!