Antes de começar
- Claude Code atualizado com suporte a Mods
- Git
- Pasta de teste sem segredos
Entenda o acesso de um Mod
Mods executam código JavaScript ou TypeScript dentro do Claude Code e podem reagir a eventos, adicionar comandos e painéis. Eles trabalham com as permissões do processo. Comece por um exemplo que apenas apresenta informações; integrações com arquivos, rede ou outros modelos exigem mais revisão.
Escolha um exemplo oficial
Abra anthropics/claude-code-playground, entre em claude-code/mods e leia o README de token-weather. Confira a versão exigida pela documentação atual e compare com claude --version. Clone o repositório em uma pasta própria e examine o código do exemplo antes de carregá-lo.
Carregue o exemplo só na sessão de teste
No terminal, entre na pasta claude-code/mods do repositório e rode o comando abaixo. O parâmetro aponta para o diretório local do plugin. Se houver erro, confira a versão do cliente e a estrutura da pasta antes de alterar configurações globais.
claude --plugin-dir ./token-weatherPeça uma adaptação limitada
Copie o exemplo para uma pasta sua e descreva uma mudança pequena. Por exemplo: um painel com o nome do projeto e o resultado do último build informado manualmente. Primeiro confira a atualização da interface; adicionar execução de comandos pode ficar para uma segunda versão.
Adapte este exemplo para mostrar um painel “Revisão do projeto”. Exiba três estados: ainda não verificado, passou e falhou. Use a API documentada de Mods. Mostre quais arquivos serão alterados e não faça chamadas externas.Valide estrutura e comportamento
Use a validação de plugins indicada na documentação e rode o Mod numa sessão de teste. Confira carregamento, mensagens de erro e remoção. A validação estrutural não demonstra que o código é seguro: leia chamadas de rede, execução de comandos e acesso a variáveis de ambiente separadamente.
Instale de forma persistente só quando fizer sentido
Mantenha o modo local enquanto ajusta o comportamento. Se decidir distribuir ou instalar como plugin, siga a estrutura oficial e documente dependências e permissões. Guarde um caminho simples para desativar a extensão caso uma atualização do cliente quebre a compatibilidade.
O que você terá ao final
Um Mod pequeno carregado em uma sessão de teste, com comportamento e acessos conhecidos.
Vale conferir
- Não use um Mod desconhecido como garantia de bloqueio de ações arriscadas.
- Guia elaborado a partir da documentação. O fluxo completo não foi executado pela Agentspedia.