Edição em Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Modificações do Claude Code: crie um indicador de contexto e confira o acesso

> As modificações do Claude Code podem desenhar elementos na sessão e alterar seu comportamento. Este guia baseado na documentação explica como solicitar um indicador de contexto e examinar seu acesso.

By BIG CHANGE Editorial

Published: 2026-10-02T04:59:25.238Z
Updated: 2026-10-02T04:59:25.238Z
Canonical: https://bigchange.ai/blog/claude-code-mods-context-display-guide

![Illustrated close-up of a computer display with three mod files, a session usage call, and an orange context strip.](https://bigchange.ai/api/media/file/claude-code-mods-context-hero-v2.png)
AI-generated by OpenAI; BIG CHANGE conceptual editorial illustration.

Usuários do Claude Code agora podem alterar a interface e o comportamento do assistente com funções em JavaScript ou TypeScript empacotadas como plug-ins. A Anthropic [lançou as modificações em 1º de outubro](https://claude.com/blog/claude-code-mods), com suporte na CLI e na aba Code do Claude Desktop. Desenvolvedores podem adicionar à conversa um indicador de uso do contexto.

Segundo a Anthropic, as modificações são executadas com as permissões da máquina do usuário e não ficam em uma sandbox. Uma modificação também pode ler dados da sessão ou fazer chamadas a modelos. Examine o código e quem o publicou antes de instalá-la.

Este guia é para desenvolvedores que já usam o Claude Code e querem fazer uma pequena personalização visível. A tarefa é criar um indicador de uso da janela de contexto, examinar o plug-in resultante e decidir se vale a pena mantê-lo. As instruções se baseiam na documentação consultada em 2 de outubro para o Claude Code v2.1.287 e versões 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: as modificações do Claude Code adicionam funções que podem alterar eventos e desenhar elementos na interface do assistente, distribuídas pelo sistema de plug-ins já existente.
- Por que isso importa: desenvolvedores podem integrar à sessão um indicador ou controle de fluxo de trabalho, mas o código recebe acesso à máquina e à conversa.
- O que observar: se as chamadas e o comportamento da modificação correspondem ao objetivo, quais controles organizacionais se aplicam e se houve mudanças na API entre versões do Claude Code.

## Confira a versão, a conta e o espaço de trabalho

Execute `claude --version` em um terminal. A [documentação atual sobre modificações](https://code.claude.com/docs/en/plugins/mods/overview) exige a versão v2.1.287 ou posterior e informa que elas ficam ativadas por padrão. As configurações anteriores de variáveis de ambiente para acesso antecipado não controlam esta versão.

Você precisa ter acesso ao Claude Code e a um espaço de trabalho que tenha marcado como confiável. A [documentação de configuração](https://code.claude.com/docs/en/setup) lista contas Pro, Max, Team, Enterprise e Console, além de provedores de API de terceiros compatíveis. O plano gratuito do chat Claude não inclui o Claude Code. As configurações de uma organização podem impedir o carregamento de modificações criadas pelos usuários.

Use uma sessão interativa de terminal. A CLI e as sessões compatíveis do Desktop exibem as interfaces das modificações. Ganchos também são executados no painel de chat do VS Code e em sessões sem interface, onde os desenhos não aparecem. As sessões do Desktop no WSL não são compatíveis com plug-ins.

## Crie e examine o indicador

O tutorial de 1º de outubro da Anthropic [documenta o Token Weather](https://claude.dev/blog/getting-started-with-claude-code-mods/), um indicador que lê o uso do contexto após cada turno. A porcentagem se baseia no contexto usado na última resposta e na janela de contexto do modelo. É um indicador de uso, não uma medida documentada da qualidade das respostas.

1. Inicie `claude` no espaço de trabalho confiável. Peça que ele crie uma modificação que mostre a porcentagem do contexto, os tokens usados e o tamanho da janela de contexto acima do prompt, atualizando-se após cada turno concluído do agente principal. Solicite a API de uso da sessão documentada e uma implementação apenas visual, sem acesso a arquivos, execução de processos, solicitações de rede nem chamadas a modelos. Esta é nossa especificação mais restrita para o caminho documentado de criação; o pedido, por si só, não impõe essas restrições.
2. Examine os arquivos criados pelo Claude. O [manual de criação](https://code.claude.com/docs/en/plugins/mods/create) instala o plug-in no diretório da sessão, dentro de `~/.claude/dev-mods/`. Inspecione o manifesto, a configuração dos ganchos e o código. O Claude Code perguntará se você quer ativar o recarregamento a quente; se aceitar, as modificações desta sessão e as revisões posteriores serão executadas.
3. Antes de ativá-la, execute `claude plugin validate` e acrescente no terminal o caminho real do diretório do plug-in. Leia os ganchos de evento e as chamadas de API indicados. O comportamento previsto exige a leitura do uso, o estado e a renderização. Investigue também qualquer acesso a arquivos, variáveis de ambiente, processos, rede ou modelos, e examine no código as alterações feitas 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 já examinada, execute `/plugin` e confira a aba Installed para verificar se a modificação aparece. Faça uma solicitação comum e confira se o indicador se atualiza após o turno. O sinal de conclusão é um plug-in carregado com valores de uso visíveis que se atualizam; apenas gerar um arquivo não demonstra que ele funciona.

Estas etapas não garantem que o Claude gere a implementação pretendida na primeira tentativa. A implementação completa do [Token Weather e o exemplo de teste](https://claude.dev/blog/getting-started-with-claude-code-mods/#build-your-first-mod-token-weather) servem de referência para comparar o código gerado. O tutorial diz que uma leitura normal do uso da sessão é gratuita; solicitar um detalhamento pode enviar uma solicitação de contagem de tokens. Pedir ao Claude que escreva ou revise a modificação ainda consome o uso normal do Claude Code.

## Mantenha o código e as permissões em evidência

Uma modificação criada na sessão é temporária. O manual de criação diz que, para mantê-la, copie o diretório para um local próprio e inicie as sessões com `claude --plugin-dir` seguido desse caminho. Cada carregamento grava declarações específicas da versão em `.claude-plugin/types/`; confira-as ao atualizar, pois a API pode mudar.

O [manual de administração](https://code.claude.com/docs/en/plugins/mods/admin) da Anthropic explica uma limitação que as regras de permissão de ferramentas podem ocultar. O mecanismo de segurança integrado é carregado para usuários Team ou Enterprise ou em máquinas com configurações gerenciadas. Na configuração padrão, regras de bloqueio têm prioridade sobre modificações de usuário que aprovam chamadas de ferramentas do Claude. Essas regras não restringem as próprias chamadas de API de arquivos ou processos feitas pela modificação. Administradores podem bloquear modificações instaladas por usuários ou aplicar uma modificação de política às chamadas delas.

A [investigação da Pluto Security de 22 de setembro](https://pluto.security/blog/claude-code-function-hooks-security/) relatou acesso a credenciais, falsificaçã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 essas extensões, e seu relatório é explicitamente anterior à disponibilidade geral. Ele é uma referência útil para examinar o código-fonte de um plug-in e suas dependências baixadas; os achados específicos não demonstram o comportamento da v2.1.287. A documentação atual da Anthropic detalha as permissões da versão lançada.

Desative uma modificação pelos controles do plug-in. `--safe-mode` exclui, em uma sessão, as modificações instaladas e outras personalizações.

## Uso e custos

Os manuais de lançamento e de modificações da Anthropic não especificam uma cobrança separada para as modificações. [A documentação de custos do Claude Code](https://code.claude.com/docs/en/costs) informa que o uso por assinatura consome a franquia do plano, enquanto o uso pelo Console e por provedores em nuvem é cobrado por tokens. Uma modificação que chama um modelo pode consumir essa franquia ou gerar cobrança. Confira `/usage` e a interface de cobrança correspondente à forma como você entrou; uma porcentagem do contexto não é uma fatura nem um limite de gastos.

Registre a versão do Claude Code junto com o plug-in examinado. Aprovar comandos ou adicionar ferramentas auxiliares baixadas exige uma nova revisão, pois isso altera o que o código pode fazer.

## Fontes e leituras complementares

- [Anthropic, Personalize o Claude Code com modificações](https://claude.com/blog/claude-code-mods), 1º de outubro de 2026: anúncio do lançamento, empacotamento de plug-ins e aviso explícito sobre acesso à máquina. A Anthropic desenvolve e comercializa o Claude Code.
- [Visão geral das modificações](https://code.claude.com/docs/en/plugins/mods/overview), consultada em 2 de outubro: versão, ambientes de sessão, permissões do host, validação e controles de desativação.
- [Crie uma modificação](https://code.claude.com/docs/en/plugins/mods/create), consultada em 2 de outubro: criação, aprovação, recarregamento a quente, retenção e declarações de tipos específicas por versão. Descreve o comportamento esperado, não um teste da BIG CHANGE.
- [Primeiros passos com as modificações do Claude Code](https://claude.dev/blog/getting-started-with-claude-code-mods/), Addy Osmani, 1º de outubro: métrica do Token Weather, código e exemplo de teste. O resultado demonstrado é da Anthropic.
- [Gerencie modificações para sua organização](https://code.claude.com/docs/en/plugins/mods/admin), consultada em 2 de outubro: disponibilidade do mecanismo de segurança, escopo das regras de bloqueio e opções de administração. Isso não isola, de modo geral, as modificações de usuário da máquina.
- [Configuração avançada](https://code.claude.com/docs/en/setup) e [Gerencie os custos de forma eficaz](https://code.claude.com/docs/en/costs), consultadas em 2 de outubro: requisitos de conta, cobrança conforme o método de autenticação e acompanhamento de uso. As fontes de lançamento consultadas não especificam um preço separado para as modificações.
- [Pluto Security, Por dentro dos ganchos de função do Claude Code](https://pluto.security/blog/claude-code-function-hooks-security/), 22 de setembro: testes pré-lançamento conduzidos por pesquisadores e suas limitações. A Pluto comercializa produtos de segurança para extensões; não reproduzimos os testes.

## Sources

- [Personalize o Claude Code com modificações](https://claude.com/blog/claude-code-mods) — Anúncio de lançamento da Anthropic: modificações na CLI e no Desktop, empacotamento de plug-ins e permissões da máquina. A empresa comercializa o Claude Code.
- [Visão geral das modificações](https://code.claude.com/docs/en/plugins/mods/overview) — Documentação oficial atualizada: v2.1.287 ou posterior, ambientes, permissões, validação e desativação. São instruções do fornecedor, não um teste nosso.
- [Crie uma modificação](https://code.claude.com/docs/en/plugins/mods/create) — Instruções oficiais para criação, aprovação, recarregamento, retenção e declarações de tipos específicas por versão. O código solicitado ainda precisa ser examinado.
- [Primeiros passos com as modificações do Claude Code](https://claude.dev/blog/getting-started-with-claude-code-mods/) — Tutorial de Addy Osmani, da Anthropic: métrica do Token Weather, implementação completa e exemplo de teste; demonstração feita pelo fornecedor, não pela BIG CHANGE.
- [Gerencie modificações para sua organização](https://code.claude.com/docs/en/plugins/mods/admin) — Disponibilidade oficial do mecanismo de segurança, escopo das regras de bloqueio e controles administrativos. Regras de bloqueio de ferramentas não restringem as chamadas de API de arquivos ou processos da própria modificação.
- [Configuração avançada](https://code.claude.com/docs/en/setup) — Requisitos de conta e acesso: assinaturas pagas, Console ou provedores compatíveis; o plano gratuito do chat não inclui o Claude Code.
- [Gerencie os custos de forma eficaz](https://code.claude.com/docs/en/costs) — Limites dos planos, cobrança por tokens via API ou provedor e acompanhamento de uso. As fontes de lançamento consultadas não especificam cobrança separada para as modificações.
- [Por dentro dos ganchos de função do Claude Code: o problema de confiança por trás das modificações](https://pluto.security/blog/claude-code-function-hooks-security/) — Testes pré-lançamento conduzidos por pesquisadores da Pluto. Não demonstram o comportamento da v2.1.287; a Pluto comercializa produtos de segurança para extensões. A BIG CHANGE não reproduziu os testes.