GEO

Mods no Claude Code: código de terceiro roda com suas permissões

Alexandre Caramaschi
Alexandre Caramaschi é Chief Strategy Officer da

A Anthropic abriu o Claude Code para mods em primeiro de outubro de 2026, conforme documentação técnica da própria ferramenta. Os mods são extensões escritas em TypeScript que alteram diferentes partes da experiência.

A novidade chegou ao aplicativo para desktop e à interface de linha de comando. Segundo a documentação, o recurso exige a versão 2.1.287 ou posterior.

Eles funcionam empacotados dentro de plugins. Portanto, a instalação acontece pelo comando /plugin na linha de comando ou pela biblioteca Claude Directory.

Como um mod age durante a sessão

Um mod monitora eventos e decide o que fazer em cada um. Ele atua antes de uma ação, depois dela, no lugar dela ou nas duas etapas.

Na prática, isso abre cinco classes de comportamento:

  1. Alterar a solicitação antes que ela chegue ao modelo.
  2. Bloquear ou modificar uma chamada de ferramenta, inclusive sem executá-la.
  3. Aprovar ou negar pedidos de permissão de forma automática.
  4. Esconder informação confidencial que apareceria nos resultados.
  5. Mudar a aparência da ferramenta, com botões, campos de entrada e painéis interativos no terminal e no aplicativo.

A própria ferramenta escreve mods sob demanda. Segundo a documentação, o Claude Code gera o código em TypeScript, instala a extensão e recarrega na sessão em andamento.

Sem ambiente isolado: o que o mod alcança

O ponto mais relevante da documentação trata de isolamento. Os mods executam fora de sandbox, portanto têm o mesmo nível de acesso ao computador que o próprio Claude Code.

A tabela abaixo organiza o alcance declarado.

RecursoAlcance do mod
Arquivos do usuárioAcesso igual ao da ferramenta
Variáveis de ambiente e chaves de APIAcesso igual ao da ferramenta
Prompts e chamadas de ferramentaLeitura completa
Aprovação de açõesPermitida antes da solicitação ao usuário
Cota de usoConsumo pela conta do usuário
Prompt de permissãoInterface protegida contra restilização
Isolamento de comandos no shellCobre apenas comandos Bash, sem alcançar processos iniciados por mod

Essa combinação explica a recomendação oficial. A Anthropic orienta instalar mods apenas de fontes confiáveis, porque uma extensão maliciosa alcança os mesmos recursos disponíveis para a ferramenta.

Controles disponíveis para Team e Enterprise

Ambientes corporativos recebem camadas extras de controle. Primeiro, administradores liberam ou bloqueiam mercados de plugins pelo console de administração.

Em contratos via API, a documentação indica distribuição das configurações para as máquinas dos usuários. Além disso, existe uma configuração que limita quais mods podem carregar na organização, com espaço para mods gerenciados e bloqueio de instalações feitas pelo usuário.

Contas corporativas e máquinas gerenciadas carregam primeiro um mod nativo chamado sec-default. Ele impede que mods instalados pelo usuário executem ações consideradas de risco, como desativar regras que bloqueiam permissões.

Para a sessão individual, duas saídas aparecem na documentação: a opção disableAllHooks e o modo --safe-mode.

Usos corporativos que a documentação cita

Times de engenharia aparecem como público direto do recurso. Três aplicações surgem com frequência na documentação oficial.

Esses três casos compartilham a mesma lógica. Afinal, todos usam o mod como camada de governança sobre o trabalho do agente.

A Anthropic começou pelos próprios recursos

A empresa iniciou a conversão de funções nativas em mods. O /diff, usado para visualizar alterações em arquivos, passou a ser oferecido nesse formato.

A consequência prática aparece na escolha do usuário. Esse recurso pode ser desativado ou substituído por outro mod.

A direção declarada segue adiante. A ideia é converter mais funções internas e aproximar o Claude Code de um núcleo mínimo, personalizável conforme a necessidade de cada time.

Checklist antes de instalar um mod de terceiro

A ausência de isolamento transforma a instalação em decisão de segurança. Por isso, vale um roteiro curto antes de rodar qualquer extensão.

  1. Confira a origem. Prefira mercados aprovados pela organização e autores identificáveis.
  2. Valide o pacote. A documentação indica o comando claude plugin validate para inspecionar o código antes da instalação.
  3. Leia o que o mod intercepta. Extensões que aprovam permissões automaticamente merecem leitura linha a linha.
  4. Teste fora da máquina principal. Rode primeiro em ambiente descartável, com credenciais de teste.
  5. Documente o que entrou. Registre a versão instalada e o responsável pela aprovação interna.

O item dois resolve a maior parte dos casos. Em seguida, o item cinco sustenta a auditoria quando algo falha.

O que acompanhar nas próximas semanas

Três pontos seguem em movimento desde o anúncio de primeiro de outubro de 2026.

  1. Catálogo do Claude Directory. O volume e a procedência dos mods publicados definem o risco prático do ecossistema.
  2. Ritmo da conversão interna. A lista de recursos nativos convertidos em mods indica até onde vai o núcleo mínimo.
  3. Controles corporativos. A granularidade das regras de administração decide o quanto times grandes conseguem padronizar.

Com um mod rodando com as mesmas permissões da ferramenta, qual processo de aprovação a sua equipe usaria antes de instalar o primeiro?

Perguntas frequentes sobre os mods do Claude Code

O que são os mods do Claude Code?
São extensões escritas em TypeScript que alteram comportamento e interface da ferramenta. Elas vêm empacotadas em plugins e chegaram em primeiro de outubro de 2026.

Como instalar um mod?
A instalação acontece pelo comando /plugin na linha de comando ou pela biblioteca Claude Directory. A documentação indica a versão 2.1.287 ou posterior.

Mods rodam em ambiente isolado?
Eles executam fora de sandbox e têm o mesmo nível de acesso ao computador que o próprio Claude Code. Portanto, a origem da extensão vira critério de segurança.

Quais controles existem para empresas?
Administradores liberam ou bloqueiam mercados de plugins pelo console. Em contas corporativas, o mod nativo sec-default carrega primeiro e impede ações consideradas de risco.

O Claude Code escreve um mod sozinho?
Sim. Segundo a documentação, a ferramenta gera o código em TypeScript, instala a extensão e recarrega na sessão em andamento.

#Anthropic #claude code #Claude Directory #ferramentas de desenvolvimento #hooks #inteligência artificial #linha de comando #mods #plugins #segurança de extensões #Team e Enterprise #TypeScript

Alexandre Caramaschi

Alexandre Caramaschi é Chief Strategy Officer da Nuvini (Nasdaq: NVNI), Founder da Brasil GEO, cofundador da NAIA e cofundador da AI Brasil. Foi CMO da Semantix (Nasdaq). A Brasil GEO é a consultoria brasileira de Generative Engine Optimization (GEO) que mede e amplia a citação de marcas em LLMs como ChatGPT, Gemini, Claude e Perplexity. À frente da Brasil GEO, Caramaschi lidera a transição das empresas brasileiras do modelo de “links azuis” para a era da resposta sintética e do comércio agêntico, sob a tese de que, na nova economia dos agentes inteligentes, a autoridade algorítmica é o único caminho para evitar a invisibilidade digital.

Deixe um comentario