# Como usar mods do Claude Code em TypeScript para personalizar agentes de programação no terminal | Cultura Builder _Source: [https://insights.culturabuilder.com/insights/como-usar-mods-do-claude-code-em-typescript-para-personalizar-agentes-de](https://insights.culturabuilder.com/insights/como-usar-mods-do-claude-code-em-typescript-para-personalizar-agentes-de)_ # Como usar mods do Claude Code em TypeScript para personalizar agentes de programação no terminal Publicado em 6 de outubro de 2026 7 min de leitura Escrito por Equipe Editorial Culturabuilder Neste artigo _Os mods em TypeScript permitem personalizar agentes de programação no terminal e bloquear comandos perigosos antes de executá-los._ ## Pontos principais do artigo - A extensão de comportamentos substitui scripts externos em bash por módulos assíncronos que compartilham o contexto da sessão ativa do agente. - A criação de um mod exige apenas uma pasta oculta com o manifesto do plugin e um script em TypeScript que exporta uma função de registro. - A API expõe gatilhos de ciclo de vida para inspecionar parâmetros de ferramentas, automatizar permissões e registrar métricas em segundo plano. - A introdução de regras imperativas com validação de tipos impede que o modelo edite pastas protegidas ou rode testes quebrados. Interromper o trabalho no meio de uma refatoração para corrigir comandos repetitivos do terminal costuma atrasar entregas que deveriam rodar sozinhas. A chegada das extensões personalizáveis em TypeScript permite ajustar o comportamento operacional do agente sem recorrer a scripts externos em bash. Vemos essa mudança como um avanço direto na autonomia de quem desenvolve software. Mods do Claude Code são módulos em TypeScript executados durante a sessão do agente para interceptar eventos de ciclo de vida, reescrever parâmetros de ferramentas e customizar interfaces no terminal. Com poucos arquivos de configuração, o assistente passa a validar comandos sensíveis antes do envio e a registrar métricas da própria sessão. Em vez de depender apenas de instruções textuais em arquivos de contexto, quem programa consegue agora definir regras imperativas com validação de tipos. Essa abordagem reduz retrabalho ao impedir que o modelo tente rodar testes quebrados ou edite pastas protegidas. O controle sai da camada de sugestão probabilística e entra na camada de código executável. Segundo o [changelog oficial do Claude Code](https://raw.githubusercontent.com/anthropics/claude-code/master/CHANGELOG.md), essa funcionalidade expande o ecossistema de complementos ao integrar os chamados function hooks diretamente na execução do software. O recurso acompanha um assistente embutido chamado You Should Know, ativado pelo comando `/plugin enable cc-plugin-you-should-know@builtin`, que atua em segundo plano alertando sobre detalhes técnicos que poderiam passar despercebidos durante a escrita de código. ## O que muda na arquitetura do assistente com extensões programáveis A migração de scripts estáticos para módulos nativos em TypeScript substitui chamadas isoladas por funções assíncronas que compartilham o contexto da sessão ativa. Antes dessa atualização detalhada no [artigo oficial sobre mods do Claude Code](https://claude.com/blog/claude-code-mods), qualquer intervenção exigia disparar scripts em shell via hooks tradicionais. Esse modelo lia dados de entrada via canal padrão de texto e devolvia respostas simples em formato bruto. A comunicação funcionava, mas apresentava lentidão em comandos complexos e abria margem para falhas de conversão de dados. Com os novos mods, o ambiente carrega módulos que importam tipos estáticos gerados pela própria ferramenta. **O agente consulta definições de interface diretamente na memória**, o que acelera a checagem de argumentos antes de qualquer alteração no repositório. Quando uma função decide bloquear uma ação, o cancelamento ocorre antes de o sistema operacional tocar no disco. ## Como estruturar o primeiro mod dentro de um plugin do Claude Code A criação de uma extensão exige apenas uma pasta organizada com o manifesto do plugin e um módulo TypeScript que exporta uma função de registro. O ponto de partida fica na raiz do seu projeto ou em um diretório global compartilhado. Você precisa criar uma pasta oculta chamada `.claude-plugin` contendo o arquivo `plugin.json`. Esse documento define o identificador do pacote, a versão e o autor da extensão, seguindo o padrão estabelecido no [anúncio do sistema de plugins](https://www.anthropic.com/news/claude-code-plugins) publicado pela Anthropic. Dentro da pasta do projeto, você configura o arquivo `hooks/hooks.json` apontando o caminho do seu código principal, comumente batizado como `register.ts`. O arquivo TypeScript exporta uma função chamada `register` que recebe o método de escuta de eventos e as opções de inicialização. ```typescript export function register(on: (event: string, handler: Function) => void) { on('tool.call', async (event: any) => { if (event.toolName === 'Bash' && event.input.command.includes('rm -rf')) { return { block: true, reason: 'Comando perigoso interceptado pelo mod de protecao' } } }) } ``` Nesse trecho, qualquer tentativa do assistente de apagar arquivos em massa recebe um bloqueio imediato antes de atingir o console. O retorno estruturado avisa o agente sobre o motivo exato da recusa, permitindo que o modelo reformule a estratégia sem travar o diálogo. Para ativar o mod no seu ambiente de trabalho, basta rodar o comando `/plugin install` indicando o caminho local da pasta. Caso queira validar a consistência dos arquivos antes da instalação, o comando `/plugin validate` faz a checagem sintática do manifesto e das declarações de tipos. Se algo estiver fora do padrão exigido pela versão instalada, o terminal exibe o alerta com a linha exata que precisa de correção. Depois de validar a estrutura, você ativa o módulo com `/plugin enable` e acompanha o carregamento durante a inicialização. Em equipes compartilhadas, esse pacote pode ser versionado no repositório do projeto, garantindo que qualquer membro do time trabalhe sob as mesmas regras sem precisar configurar scripts manuais. ## Quais eventos do agente você consegue interceptar na rotina de código A API expõe gatilhos antes e depois de cada ação relevante do modelo durante o desenvolvimento. O ciclo operacional disponibiliza pontos de captura para ferramentas, permissões e elementos visuais da interface. No evento `PreToolUse`, a extensão inspeciona os parâmetros enviados pelo assistente, como o caminho de um arquivo a ser editado ou os argumentos de uma consulta HTTP. Você pode validar o conteúdo, aplicar filtros prévios ou rejeitar a operação caso ela viole convenções do projeto. Já o gatilho `PostToolUse` roda imediatamente após a conclusão da ferramenta. Ele recebe o resultado gerado e permite encadear checagens automáticas. Se o assistente acabou de salvar um arquivo de código, seu mod pode disparar uma rodada silenciosa de testes e devolver os erros encontrados diretamente para o contexto do modelo. O agente recebe o aviso e inicia o ajuste sem você precisar digitar orientações no terminal. Outro ponto proveitoso envolve o evento `PermissionRequest`. **Automatizar a concessão de permissões rotineiras reduz interrupções no desenvolvimento**, mantendo bloqueios estritos apenas para operações sensíveis. É possível aprovar leituras de documentação interna e testes locais de forma imediata, deixando confirmações manuais somente para alterações em arquivos de configuração ou conexões remotas. Conforme detalhado na [documentação de automação com hooks](https://docs.anthropic.com/en/docs/claude-code/hooks-guide), a ferramenta também aceita gatilhos assíncronos. Isso significa que tarefas demoradas, como enviar um alerta para o canal da equipe ou registrar métricas em um banco analítico, rodam sem travar a digitação do usuário. O assistente continua trabalhando enquanto os dados são salvos em segundo plano. Além disso, a biblioteca de eventos oferece suporte para desenhar pequenos componentes na tela do terminal. Você consegue exibir alertas contextuais, barras de progresso customizadas e contadores de tokens consumidos na sessão, mantendo visibilidade sobre o custo computacional de cada tarefa executada. ## Como aplicar mods para elevar a produtividade no trabalho diário com IA Saber como usar IA para produtividade no trabalho exige transformar o assistente de um gerador de palpites em um operador disciplinado que segue as regras do seu repositório. Muitos profissionais perdem tempo corrigindo código mal formatado ou resolvendo conflitos de dependências que poderiam ser evitados no início da sessão. Ao integrar extensões sob medida na sua máquina, você estabelece limites técnicos que impedem o agente de cometer deslizes comuns. Se o projeto exige cobertura de testes em toda nova rota criada, um mod verifica se o arquivo de teste correspondente existe antes de autorizar o commit. Outra aplicação imediata consiste em conectar o agente a fontes corporativas de contexto. Construir soluções eficientes depende de alinhar a ferramenta ao fluxo de valor do projeto. Um mod pode ler documentações de APIs internas ou padrões de arquitetura e injetar trechos relevantes na conversa apenas quando o assistente tentar consumir determinados módulos. A criação de pequenos mods em TypeScript coloca a automação nas mãos de quem realmente constrói. Em vez de esperar que o modelo lembre de não alterar arquivos legados, você define a restrição com poucas linhas de código. Esse equilíbrio entre autonomia do agente e controle rigoroso transforma o terminal em um ambiente previsível para entregar software no dia a dia. ## Referências Referências usadas na apuração do texto. 1. [changelog oficial do Claude Code](https://raw.githubusercontent.com/anthropics/claude-code/master/CHANGELOG.md) ([https://raw.githubusercontent.com/anthropics/claude-code/master/CHANGELOG.md](https://raw.githubusercontent.com/anthropics/claude-code/master/CHANGELOG.md)) 2. [artigo oficial sobre mods do Claude Code](https://claude.com/blog/claude-code-mods) ([https://claude.com/blog/claude-code-mods](https://claude.com/blog/claude-code-mods)) 3. [anúncio do sistema de plugins](https://www.anthropic.com/news/claude-code-plugins) ([https://www.anthropic.com/news/claude-code-plugins](https://www.anthropic.com/news/claude-code-plugins)) 4. [documentação de automação com hooks](https://docs.anthropic.com/en/docs/claude-code/hooks-guide) ([https://docs.anthropic.com/en/docs/claude-code/hooks-guide](https://docs.anthropic.com/en/docs/claude-code/hooks-guide)) Continue lendo ## Conteúdo relacionado [ 19 de set. de 2026 ### Claude Code v2.1 traz 16 mudancas praticas testadas no terminal para quem cria com IA Insight ](/insights/claude-code-v2-1-traz-16-mudancas-praticas-testadas-no-terminal-para) [ 14 de set. de 2026 ### Quando o agente de código instala pacotes sozinho e abre o terminal para ataques de supply chain Insight ](/insights/quando-o-agente-de-codigo-instala-pacotes-sozinho-e-abre-o-terminal) [ 24 de ago. de 2026 ### Como os novos agentes em nuvem do Cursor assumem tarefas no Slack e no GitHub sem você Insight ](/insights/como-os-novos-agentes-em-nuvem-do-cursor-assumem-tarefas-no-slack)