Mods de ferramentas personalizadas para Claude Code: dê novas ferramentas ao Claude

Os mods de ferramentas personalizadas para Claude Code dão ao Claude novas ferramentas para chamar durante um turno, como uma busca específica do projeto, uma consulta ao seu issue tracker ou uma calculadora para algo que importa no seu código. A ferramenta é escrita em JavaScript dentro do mod e roda no Claude Code, então não há nenhum processo de servidor separado para iniciar.

Como os mods de ferramentas personalizadas para Claude Code adicionam uma ferramenta?#

O mod chama $.tool.register(...) com um nome e uma descrição que o Claude lê, além da entrada que a ferramenta aceita. Quando o Claude decide usar a ferramenta, a chamada passa pelo evento tool.call como qualquer ferramenta nativa, e o mod a responde retornando { result }. $.tool.list() mostra o que está disponível e $.tool.call() permite que o próprio mod invoque uma ferramenta.

Outros dois eventos importam aqui. tool.describe dispara quando a descrição de uma ferramenta é enviada ao Claude pela primeira vez; o mod pode reescrever o texto ou marcar a ferramenta como adiada, para que ela não ocupe contexto até ser necessária. agent.offer e $.agent.register fazem o mesmo papel para tipos de subagente. A referência da API documenta os métodos $.tool e $.agent.

O que você deve verificar antes de instalar um?#

Um mod de ferramenta mostra Adiciona comandos/ferramentas. O resto dos selos diz o que a ferramenta consegue alcançar. Uma ferramenta que consulta uma API web mostra Rede; uma que busca em arquivos mostra Lê arquivos; uma que roda um linter mostra Executa comandos. Como é o Claude quem decide quando chamar a ferramenta, essas capacidades podem ser usadas em qualquer turno, não só quando você pede, então avalie-as como se o Claude tivesse acesso direto a elas.

Confira também como os erros são reportados. Uma boa ferramenta retorna uma mensagem de erro clara como resultado, em vez de lançar uma exceção, para que o Claude consiga se recuperar.

Qual a diferença entre mods de ferramenta e servidores MCP?#

Os servidores MCP são a forma padrão de dar ferramentas ao Claude e funcionam em muitos clientes. Um mod de ferramenta é mais restrito: só funciona no Claude Code, mas não exige nenhuma etapa de instalação além do plugin, inicia junto com a sessão e pode compartilhar estado com o resto do mod, por exemplo uma linha de status que mostra quantas vezes a ferramenta foi usada.