Em 01/10/2026 a Anthropic lançou os mods do Claude Code. Um mod é um programa pequeno, escrito em TypeScript ou JavaScript, que você liga no Claude Code para mudar o jeito como ele funciona por dentro. Funciona tanto no terminal quanto no aplicativo de desktop.
A ideia central é o momento certo. Cada mod fica esperando um acontecimento interno, por exemplo o Claude estar prestes a rodar um comando, e entra em ação nessa hora. Ali ele pode deixar seguir, mudar o que vai acontecer ou impedir.
Este guia mostra o que um mod consegue fazer, um exemplo prático de proteção, onde estão os exemplos oficiais, como pedir ao próprio Claude para escrever um e o cuidado que vale antes de instalar mod de outra pessoa.
O que um mod consegue fazer
Pelas fontes do lançamento, um mod pode:
- Reescrever o seu pedido antes de ele chegar ao modelo, por exemplo acrescentando uma regra que você sempre esquece de pedir.
- Bloquear ou repetir uma chamada de ferramenta, como um comando no terminal ou uma edição de arquivo.
- Decidir permissões do seu jeito, em vez de responder à mesma pergunta de "pode rodar?" toda hora.
- Esconder segredos na saída, como uma senha ou chave de API que ia aparecer na tela.
- Trocar elementos da interface, como desenhar um painel novo.
Exemplos citados no lançamento: previsão de uso da janela de contexto (a memória de curto prazo da conversa), bloqueio de comando destrutivo do Git, repetição automática de edição de arquivo que falhou, permissões personalizadas e filtro de saída.
O exemplo do vídeo: proteger o seu trabalho no Git
Alguns comandos do Git apagam trabalho que ainda não foi salvo, sem pedir confirmação. O caso clássico é git reset --hard, que descarta tudo o que você mudou desde o último commit. Uma IA que roda esse comando por engano leva junto horas de trabalho.
Um mod resolve isso esperando o momento "logo antes de um comando rodar". Se o comando for um dos destrutivos, o mod bloqueia e devolve uma mensagem explicando por quê. O Claude lê a recusa e procura outro caminho.
Onde estão os exemplos oficiais
A equipe da Anthropic publicou exemplos na pasta claude-code/mods/ do repositório anthropics/claude-code-playground:
O próprio README avisa que aquilo não é produto oficial e que os exemplos podem quebrar. Leia como ponto de partida, não como peça pronta para produção.
Requisito de versão
Os mods precisam do Claude Code 2.1.287 ou mais novo e vêm ligados por padrão. Para conferir a sua versão, rode no terminal:
claude --version
Se estiver abaixo disso, atualize o Claude Code antes de testar.
Não precisa saber programar
O mod é código, mas você não precisa escrever o código. Dá para pedir ao próprio Claude, descrevendo o comportamento em português:
Escreva um mod do Claude Code que bloqueie os comandos git reset --hard, git clean -fd e git push --force, e mostre uma mensagem explicando que esses comandos apagam trabalho.
Peça também que ele explique, em linguagem simples, o que cada parte do código faz. Assim você sabe o que está ligando, mesmo sem programar.
O cuidado: mod de outra pessoa tem acesso a tudo
Um mod roda dentro do Claude Code, com o mesmo acesso que ele tem: seus arquivos, seus comandos, o que aparece na tela. Um mod mal-intencionado poderia copiar uma chave de API ou mudar o seu pedido sem você perceber.
Antes de instalar mod que você não escreveu:
- Veja de onde vem. Repositório da Anthropic ou de alguém com histórico público é diferente de arquivo solto num grupo.
- Peça ao Claude para revisar o código e listar tudo o que o mod lê, envia ou altera.
- Desconfie de mod que acessa a internet sem motivo claro para isso.
- Prefira mod pequeno. Quanto menos código, mais fácil de entender o que ele faz.
Na dúvida, peça ao Claude para escrever a sua própria versão. É a forma mais segura de ter o mesmo comportamento.