Pular para o conteúdo
claudemods

Mods de comandos slash para Claude Code

Mods de comandos slash para Claude Code adicionam comandos como /tally que respondem na hora via código, sem chamar o modelo, ou mudam comandos nativos.

Contador de chamadas de ferramentas em execução no Claude Code

Contador de chamadas de ferramentas

Conta as chamadas de ferramentas do Claude por turno e por sessão, mostra o total junto ao spinner e adiciona /tally.

  • spinner
  • transcrição
  • status
  • Intercepta chamadas de ferramentas
  • Altera a interface
  • Adiciona comandos/ferramentas

testado com v2.1.291

Os mods de comandos slash para Claude Code adicionam comandos que você digita no prompt, como /tally ou /diff, e os respondem em código. Como o handler roda dentro do Claude Code, ele pode responder instantaneamente com dados que o mod já coletou, abrir um painel ou mudar uma configuração, sem nenhuma requisição ao modelo e sem gastar um único token.

Como os mods de comandos slash para Claude Code registram um comando?

O mod chama $.command.register({ name, description }), normalmente no seu hook session.start, e depois trata command.run com um matcher para esse nome: on('command.run', { command: 'tally' }, ...). O handler retorna { text } para imprimir uma resposta, que é renderizada como Markdown na transcrição, ou {} para terminar em silêncio. Os nomes de comando aceitam letras, dígitos, _ e -, com até 64 caracteres.

O mesmo evento command.run também dispara para todos os outros comandos, então um mod pode envolver comandos nativos. command.describe permite que um mod mude a forma como os comandos aparecem na lista de comandos, e $.command.run permite que um mod invoque outro comando. O guia de criação mostra passo a passo um exemplo com /tally.

O que você deve verificar antes de instalar um?

Um mod de comando exibe Adiciona comandos/ferramentas. Esse selo, sozinho, é de baixo risco: o comando só roda quando você o digita. O que importa é o que o comando faz quando é executado, então leia o resto dos selos. Um comando que lê o estado do mod e imprime uma tabela não precisa de mais nada. Um que abre um painel acrescenta Altera a interface. Um que executa git, lê arquivos ou chama um servidor mostra Executa comandos, Lê arquivos ou Rede.

Verifique também conflitos de nome. Dois mods podem tentar registrar o mesmo nome de comando; prefira mods que usam um nome específico e deixam isso claro na própria página.

Quando usar um comando de mod em vez de um prompt?

Use um comando de mod quando a resposta for mecânica: contar, listar, alternar uma configuração, abrir uma visualização. Use um arquivo de comando comum ou uma skill quando você quiser que o Claude pense sobre a resposta. Muitos mods úteis combinam as duas coisas: coletam dados em hooks e apresentam o resultado por meio de um único comando.

Perguntas frequentes

Qual a diferença entre um comando de mod e um arquivo de comando personalizado?
Um arquivo de comando em .claude/commands envia um prompt para o Claude. Um comando de mod executa JavaScript dentro do Claude Code e pode responder na hora com o estado que o mod coletou, sem nenhuma requisição ao modelo.
Um mod pode alterar um comando nativo?
Sim. O hook command.run vê todos os comandos antes de eles rodarem, inclusive os nativos, e pode respondê-los, modificá-los ou repassá-los. Com command.describe, um mod muda a forma como um comando aparece na lista.
Os comandos de mod funcionam com claude -p?
Sim. Os hooks rodam no modo print, então um comando como claude -p "/tally" funciona, embora nada seja desenhado na tela.