A Anthropic abriu o Claude Code para os mods, pequenas funções em TypeScript que mudam como o agente se comporta e como aparece na tela. A novidade dá muito poder a quem escreve plugins, e a empresa avisa: eles rodam com o mesmo acesso à sua máquina que o próprio Claude Code.
O que são os mods do Claude Code
O Claude Code é a ferramenta de programação da Anthropic que funciona direto no terminal e no aplicativo de desktop. Até agora, quem queria mudar o comportamento dele tinha poucas opções. Isso mudou em 1º de outubro, quando a empresa lançou os mods.
Um mod é uma função em JavaScript ou TypeScript que roda dentro do próprio processo do Claude Code. Ele se conecta a eventos internos e reage a eles. Na prática, é como instalar um pequeno programa que escuta o que o agente está fazendo e decide se deixa passar, se muda ou se assume o comando.
A diferença em relação a um plugin comum é o nível de acesso. Um mod não só adiciona uma funcionalidade ao lado do agente. Ele interfere no funcionamento por dentro.
O que um mod consegue fazer
A lista de possibilidades é ampla. Um mod pode reescrever um comando antes que ele seja enviado, bloquear ações consideradas arriscadas, adicionar elementos novos à interface ou substituir algo que já existe no Claude Code.
Isso inclui pedaços visuais que muita gente nem imagina que dá para mexer. Um mod consegue desenhar painéis e faixas na tela, trocar o visual de partes da interface e até alterar o indicador de carregamento e as caixas de diálogo que aparecem durante o uso.
O caminho para escrever um mod é flexível. Você pode programá-lo por conta própria ou pedir ao próprio Claude Code que escreva a função a partir de uma descrição. Depois, o mod é distribuído dentro de um plugin, o que significa que ele é instalado e compartilhado como qualquer outro plugin da ferramenta.
O aviso de segurança que a Anthropic destaca
A própria Anthropic foi direta no anúncio: os mods rodam com o mesmo acesso à máquina que o Claude Code tem. Eles não ficam isolados em uma caixa de segurança.
Traduzindo: um mod pode fazer tudo o que o Claude Code pode fazer no seu computador. Ler arquivos, executar comandos, acessar pastas. Se o agente tem permissão para uma coisa, o mod também tem.
Por isso a recomendação é instalar mods apenas de fontes confiáveis. O mesmo cuidado que você teria ao rodar um programa desconhecido no computador vale aqui. A comunidade já aponta que a distribuição por plugins torna esse controle mais difícil, porque um plugin pode carregar vários mods de uma vez.
Como começar a usar os mods
O recurso chegou na versão 2.1.287, de 1º de outubro. Para usar, é preciso ter o Claude Code atualizado. Alguns tutoriais da comunidade citam a necessidade de ativar uma variável de ambiente nas primeiras versões em que o recurso apareceu, e a Anthropic vem liberando a função de forma gradual.
A empresa também mantém um repositório no GitHub com exemplos. Cada pasta é um plugin completo, com um arquivo de configuração, um arquivo de hooks que aponta para o módulo e o código em TypeScript. Isso serve de ponto de partida para quem quer escrever o primeiro mod.
O que os mods podem fazer
- Reescrever prompts antes do envio
- Bloquear comandos arriscados
- Adicionar ou trocar elementos da interface
- Assumir chamadas de ferramentas e gerenciar cache
O que você precisa saber antes
- Rodam com o mesmo acesso do Claude Code
- Não são isolados em sandbox
- Vêm dentro de plugins, inclusive de terceiros
- A API pode mudar entre versões
O que isso muda para quem programa com IA
Para quem usa o Claude Code no dia a dia, os mods abrem um caminho para adaptar a ferramenta a um fluxo de trabalho específico. Em vez de lidar com um comportamento fixo, o programador pode moldar o agente para o próprio projeto.
Um exemplo prático é a segurança. Uma equipe pode escrever um mod que barra qualquer comando capaz de apagar arquivos ou mexer em credenciais. O agente deixa de agir por conta própria nesses casos e passa a seguir uma regra definida pela equipe.
Do outro lado, a mesma liberdade vira risco. Um mod mal escrito pode quebrar o agente, e um mod malicioso pode abrir a porta do computador. Como não há isolamento, o usuário é a última barreira.
O que observar de agora em diante
Vale acompanhar três pontos. O primeiro é a estabilidade: a Anthropic avisa que a interface de programação dos mods ainda pode mudar entre versões, então quem já escreveu um mod deve se preparar para ajustes. O segundo é a curadoria: se a empresa criar uma vitrine segura de plugins, o risco cai bastante. O terceiro é o exemplo vindo de dentro: mods internos podem virar atalhos para quem não quer programar do zero.
A ideia de deixar o usuário reescrever o próprio agente é poderosa e, sem cuidado, perigosa. Vale a pena? Para quem programa com IA, a dica é a mesma de sempre: teste em um ambiente separado antes de dar a um plugin o mesmo acesso que você dá ao seu terminal.
