Claude Code mods: o que são e o que as pessoas fazem com eles

Desde 1 de outubro de 2026, o Claude Code, o assistente de programação da Anthropic, aceita mods. A palavra vem dos videojogos, onde um mod acrescenta um mapa ou uma personagem a um jogo feito por outros. Os mods do Claude Code retocam a própria ferramenta, aquilo que ela mostra e uma parte do que ela faz.

Três semanas depois do lançamento, os utilizadores já publicaram milhares deles, do jogo Snake à proteção contra apagamentos. Basta pedir um mod ao Claude em poucas palavras, mas ele tem no computador as mesmas permissões que tu.

O que é um mod?

O Claude Code trabalha por pequenas ações. Lê um ficheiro, executa um comando, espera pela tua resposta, redesenha uma parte do ecrã. Um mod é um pequeno programa que o Claude Code avisa de cada uma destas ações, como um assistente que anunciasse cada gesto antes de o fazer. O mod pode limitar-se a observar, alterar a ação de passagem, ou fazê-la em seu lugar.

O Claude Code já aceitava fichas de instruções, os skills, apresentados no nosso guia dos skills, e definições que disparam quando acontece um evento, os hooks. O anúncio da Anthropic de 1 de outubro de 2026 resume a diferença numa frase: um hook não pode reescrever uma ação, nem desenhar uma interface nova, nem substituir uma função da ferramenta. Um mod consegue fazer as três coisas.

O que um mod pode mostrar

A documentação oficial dos mods descreve os locais onde um mod pode desenhar: um painel ao lado da conversa, uma faixa mesmo por cima da zona onde escreves os teus pedidos, uma linha de estado por baixo, uma pequena notificação no canto superior direito. Também pode retocar o que o próprio Claude Code desenha, por exemplo o indicador que se anima enquanto o Claude trabalha.

O primeiro exemplo do guia da Anthropic conta as ações do Claude e mostra o total ao lado desse indicador, sob a forma de «Thinking · tool calls: 3…». Outros mods mostram a versão do projeto em que estás a trabalhar, ou o espaço que resta na memória de trabalho do Claude, aquilo a que se chama o seu contexto.

O que um mod pode mudar no comportamento

Um mod também pode agir. A Anthropic publica um mod de exemplo, o blast-radius, que retém um comando perigoso, como apagar uma pasta inteira, antes de ele sair. Mostra o que seria apagado e propõe dois botões, continuar ou cancelar. Outros mods enviam certas tarefas para um modelo mais barato, ou substituem as palavras-passe e os endereços de e-mail por etiquetas neutras antes de a IA os ler.

A Anthropic chegou a transformar uma das suas próprias funções num mod. O ecrã /diff, que mostra as alterações feitas a um projeto, passou a ser um mod integrado no Claude Code. Podes desligá-lo ou substituí-lo pela tua própria versão.

O que os utilizadores já inventaram

A 2 de outubro, no dia seguinte ao lançamento, uma lista colaborativa já contabilizava 359 mods, segundo a panorâmica publicada a 3 de outubro pela StashBase. A 20 de outubro, o levantamento independente de karanb192, que passa em revista os repositórios públicos do GitHub, conta 5 898. Alguns exemplos, agrupados por utilização:

• Para passar o tempo enquanto o Claude trabalha: um Snake jogável num painel, uma sala de arcade com nove jogos, um leitor de Shorts do YouTube, ou um exercício de respiração guiada, o Mindful-Claude, o repositório de mods mais seguido que a StashBase encontrou no início de outubro.
• Para a música: um mod mostra a música que está a tocar no Spotify, com a letra sincronizada e os botões de reprodução.
• Para vigiar o consumo: medidores que mostram o que resta do plano, o custo da sessão, ou uma «meteorologia» da memória de trabalho do Claude.
• Para acompanhar o trabalho: um mapa dos ficheiros do projeto que se ilumina quando o Claude lê ou altera um deles, ou um rascunho ao lado da conversa para preparar os pedidos seguintes enquanto o Claude trabalha.
• Para o dia a dia: há até um mod que mostra as horas de oração e o tempo que falta para a seguinte.

O Snake, o leitor de Shorts, a música e as horas de oração vêm todos de um único repositório, o de hamzafer, que reúne vinte e cinco mods. Muitos mods são obra de uma só pessoa e não foram verificados pela Anthropic. O levantamento de 20 de outubro diz de si próprio que é um registo independente, não um catálogo oficial.

Não é preciso saber programar para ter um

A forma mais simples de obter um mod é pedi-lo ao Claude, com as tuas palavras, numa conversa: «faz-me um mod que mostre a música que está a tocar por cima da zona de escrita». O Claude Code inclui uma ficha de instruções que lhe ensina a escrever um mod. Segundo o guia de criação da Anthropic, o Claude escreve os ficheiros, tu aprovas-os um a um, aceitas recarregar os mods da sessão, e o mod ativa-se assim que o Claude acaba de responder.

Esse mod só vive na conversa que o criou. Para o guardares, tens de copiar a pasta dele para outro sítio, ou instalá-lo como uma extensão com o comando /plugin do Claude Code. Precisas do Claude Code 2.1.287 ou mais recente no terminal, e da versão 2.1.286 na aplicação para computador.

Experimentei o mod de exemplo da documentação

Num Mac com o Claude Code 2.1.300, copiei o primeiro mod do guia da Anthropic, o que conta as ações do Claude e acrescenta um comando /tally. O Claude Code sabe ler um mod sem o executar e dizer o que ele faz. O comando seguinte, escrito na pasta onde está o mod, faz essa verificação:

claude plugin validate ./first-mod

A verificação listou os quatro momentos em que este mod intervém (o arranque, cada ação do Claude, o comando /tally e a apresentação do indicador) e as duas únicas coisas que ele pede ao Claude Code, acrescentar um comando e redesenhar o ecrã. Concluiu com «Validation passed». O comando /tally respondeu depois «Claude has made 0 tool calls since this mod loaded», pois ainda não tinha havido nenhuma ação.

Um mod tem as mesmas permissões que tu

A documentação da Anthropic enumera aquilo a que um mod tem acesso depois de instalado. Pode ler e escrever os teus ficheiros, executar programas, ligar-se à Internet, ler as chaves de acesso guardadas nas tuas definições, ver cada um dos teus pedidos, aprovar uma ação por ti e gastar o teu plano ao chamar um modelo. A sandbox do Claude Code, apresentada no nosso artigo sobre as permissões dos agentes de código, isola os comandos que o Claude executa, não os programas que um mod arranca.

Dos 359 mods contabilizados a 2 de outubro, a StashBase contava 111 que veem cada mensagem enviada ao Claude, 75 que comunicam com a Internet e 95 que escrevem ficheiros. Algumas precauções limitam o risco. Instala apenas mods de autores que conheces. Verifica o que um mod faz antes de o instalares, com o comando visto acima, que não o executa. Em caso de dúvida, arranca o Claude Code com a opção –safe-mode, que desliga todos os mods instalados durante uma sessão. Numa empresa, o administrador também pode limitar os mods autorizados.

O que reter

• Um mod é um pequeno programa que muda o que o Claude Code mostra e uma parte do que ele faz. Os mods existem desde 1 de outubro de 2026, a partir do Claude Code 2.1.287.
• Um mod pode acrescentar um painel, uma faixa por cima da zona de escrita, um contador, uma proteção contra apagamentos, e até um jogo.
• O Claude consegue escrever um mod a partir de uma simples descrição, e tu aprovas os ficheiros do mod antes de ele se ativar.
• Os utilizadores publicaram milhares em três semanas, da música que está a tocar ao exercício de respiração.
• Um mod tem no computador as mesmas permissões que tu: instala apenas os de fontes de confiança e verifica-os com claude plugin validate.