Os utilizadores do Claude Code podem agora alterar a interface e o comportamento do assistente através de funções JavaScript ou TypeScript empacotadas como plug-ins. A Anthropic lançou os mods a 1 de outubro, com suporte na CLI e no separador Code do Claude Desktop. Os programadores podem acrescentar à conversa um indicador de utilização da janela de contexto.

Segundo a Anthropic, os mods são executados com as permissões da máquina do utilizador e não estão isolados numa sandbox. Um mod também pode ler dados da sessão ou fazer chamadas a modelos. Examine o código e quem o publicou antes de o instalar.

Este guia destina-se a programadores que já utilizam o Claude Code e pretendem fazer uma pequena personalização visível. O objetivo é criar um indicador da utilização da janela de contexto, examinar o plug-in resultante e decidir se o deve manter. As instruções baseiam-se na documentação consultada a 2 de outubro para o Claude Code v2.1.287 e posteriores. A BIG CHANGE não executou este procedimento nem testou o código gerado de forma independente.

A grande mudança

  • O que mudou: os mods do Claude Code acrescentam funções que podem alterar eventos e desenhar elementos na interface do assistente, através do sistema de plug-ins já existente.
  • Porque é relevante: os programadores podem integrar na sessão um indicador ou um controlo do fluxo de trabalho, mas esse código também recebe acesso à máquina e à conversa.
  • O que acompanhar: se as chamadas e o comportamento reais do mod correspondem ao seu objetivo, que controlos organizacionais se aplicam e se a API muda entre versões do Claude Code.

Verifique a versão, a conta e o espaço de trabalho

Execute claude --version no terminal. A documentação atual sobre mods exige a versão v2.1.287 ou posterior e indica que os mods estão ativados por predefinição. As antigas definições de variáveis de ambiente para acesso antecipado não controlam esta versão.

Precisa de acesso ao Claude Code e de um espaço de trabalho que tenha assinalado como fidedigno. A documentação de definição lista contas Pro, Max, Team, Enterprise e Console, bem como fornecedores de API de terceiros compatíveis. O plano gratuito do chat Claude não inclui Claude Code. As definições da organização podem impedir o carregamento de mods criados pelos utilizadores.

Utilize uma sessão de terminal interativa. A CLI e as sessões suportadas do Claude Desktop apresentam as interfaces dos mods. Os hooks também são executados no painel de chat do VS Code e em sessões sem interface, nas quais os elementos visuais não aparecem. As sessões do Claude Desktop em WSL não suportam plug-ins.

Crie e examine o indicador

Segundo o tutorial da Anthropic, publicado a 1 de outubro, o Token Weather é um indicador que lê a utilização do contexto após cada turno. A percentagem baseia-se no contexto utilizado na última resposta e na janela de contexto do modelo. É um indicador de utilização, não uma medida documentada da qualidade das respostas.

  1. Inicie claude no espaço de trabalho fidedigno. Peça-lhe para criar um mod que apresente a percentagem do contexto, os tokens utilizados e o tamanho da janela de contexto acima do prompt, atualizando-se após cada turno concluído do agente principal. Peça a utilização da API documentada para obter os dados da sessão e uma implementação apenas visual, sem acesso a ficheiros, execução de processos, pedidos de rede ou chamadas a modelos. Esta é uma especificação mais restrita para o percurso de criação documentado; o pedido, por si só, não impõe essas limitações.
  2. Reveja os ficheiros criados pelo Claude. O manual de criação coloca o plug-in no diretório da sessão, dentro de ~/.claude/dev-mods/. Inspecione o manifesto, a configuração dos hooks e o código. O Claude Code perguntará se pretende ativar o recarregamento a quente; ao aceitar, executa os mods desta sessão e as revisões posteriores.
  3. Antes de o ativar, execute claude plugin validate seguido do caminho real do diretório do plug-in no terminal. Leia os hooks de evento e as chamadas à API indicados. O comportamento pretendido requer a leitura da utilização, o estado e a apresentação do indicador. Investigue também qualquer acesso a ficheiros, variáveis de ambiente, processos, rede ou modelos, e examine no código as alterações aos eventos. Uma validação bem-sucedida indica compatibilidade com o carregador, não uma garantia de segurança.
  4. Depois de aprovar uma implementação que tenha revisto, execute /plugin e procure o mod no separador Installed. Faça um pedido normal e confirme que a faixa se atualiza após o turno. A conclusão exige um plug-in carregado com valores de utilização visíveis e atualizados; a simples geração de um ficheiro não demonstra que funciona.

Estes passos não garantem que o Claude gere a implementação pretendida à primeira tentativa. A implementação completa do Token Weather e o exemplo de teste servem de referência para comparar o que o Claude escrever. O tutorial indica que uma leitura normal da utilização da sessão é gratuita; pedir uma discriminação pode enviar um pedido de contagem de tokens. Pedir ao Claude que escreva ou reveja o mod continua a consumir a utilização normal do Claude Code.

Mantenha o código e as permissões à vista

Um mod criado numa sessão é temporário. O manual de criação recomenda copiá-lo para uma localização própria e iniciar sessões com claude --plugin-dir seguido dessa localização. Cada carregamento grava declarações de tipos específicas da versão em .claude-plugin/types/; verifique-as durante as atualizações, pois a API pode mudar.

O manual de administração da Anthropic explica uma limitação que as regras de permissões das ferramentas podem ocultar. O mecanismo de segurança integrado é carregado para utilizadores Team ou Enterprise ou em máquinas com definições geridas. Na configuração predefinida, as regras de negação têm prioridade sobre mods do utilizador que aprovam chamadas às ferramentas do Claude. Essas regras não restringem as próprias chamadas de API do mod ao sistema de ficheiros ou a processos. Os administradores podem bloquear mods instalados pelos utilizadores ou aplicar aos respetivos pedidos um mod de política.

A investigação da Pluto Security de 22 de setembro relatou acesso a credenciais, dissimulação da interface e alteração remota de código em testes da implementação anterior ao lançamento. A Pluto vende software de segurança para estas extensões, e o relatório refere explicitamente um período anterior à disponibilidade geral. É uma referência útil para examinar o código-fonte de um plug-in e as dependências descarregadas; as conclusões específicas não demonstram o comportamento da v2.1.287. A documentação atual da Anthropic descreve as permissões da versão lançada.

Desative um mod através dos controlos do plug-in. --safe-mode omite os mods instalados e outras personalizações durante uma sessão.

Utilização e custos

Os manuais de lançamento e de mods da Anthropic não especificam uma taxa separada para os mods. A documentação de custos do Claude Code indica que a utilização por subscrição consome os limites incluídos no plano, enquanto a utilização do Console e de fornecedores de cloud é faturada por tokens. Um mod que faça chamadas a modelos pode consumir essa utilização. Verifique /usage e a interface de faturação correspondente ao método de autenticação utilizado; uma percentagem do contexto não é uma fatura nem um limite de despesa.

Registe a versão do Claude Code juntamente com o plug-in revisto. Aprovar comandos ou acrescentar utilitários descarregados exige uma nova revisão, pois altera aquilo que o código pode fazer.

Fontes e leituras adicionais

  • Anthropic, Personalize o Claude Code com mods, 1 de outubro de 2026: anúncio do lançamento, empacotamento de plug-ins e aviso explícito sobre o acesso à máquina. A Anthropic desenvolve e comercializa o Claude Code.
  • Visão geral dos mods, consultada a 2 de outubro: versão, interfaces de sessão, permissões do sistema anfitrião, validação e controlos de desativação.
  • Criar um mod, consultada a 2 de outubro: criação, aprovação, recarregamento a quente, retenção e declarações de tipos específicas da versão. Documenta o comportamento esperado, não um teste da BIG CHANGE.
  • Primeiros passos com os mods do Claude Code, Addy Osmani, 1 de outubro: métrica, código e exemplo de teste do Token Weather. O resultado demonstrado é da Anthropic.
  • Gerir mods na sua organização, consultada a 2 de outubro: disponibilidade do mecanismo de segurança, âmbito das regras de negação e opções administrativas. De um modo geral, não isola os mods do utilizador da máquina.
  • definição avançada e Gerencie os custos de forma eficaz, consultadas a 2 de outubro: requisitos da conta, faturação dependente do método de autenticação e acompanhamento da utilização. As fontes de lançamento consultadas não especificam uma taxa separada para mods.
  • Pluto Security, Por dentro dos ganchos de função do Claude Code, 22 de setembro: testes de segurança pré-lançamento realizados por investigadores e respetivas limitações. A Pluto comercializa produtos de segurança para extensões; não repetimos os testes.