Visão geral de mods

​

O que um mod pode fazer

• Desenhar uma interface que você pode usar: um painel ao lado da transcrição ou uma faixa acima do prompt, com abas, botões e campos de texto. Veja Desenhar na interface.
• Redesenhar a própria interface do Claude Code: substituir ou reformatar partes que o Claude Code desenha, como a linha de uma chamada de ferramenta, o spinner ou o diálogo que o Claude faz perguntas. Veja Alterar o que o Claude Code já desenha.
• Intervir em uma chamada de ferramenta ou uma solicitação: por exemplo, manter uma chamada de ferramenta enquanto você faz uma pergunta ao usuário, responder sem executar a ferramenta ou enviar uma solicitação para um modelo diferente. Veja Guardar ou alterar uma chamada de ferramenta e Seguir um turno.
• Executar seu próprio código em um comando: um /command que executa sua função imediatamente, sem nenhum turno do Claude, mesmo enquanto o Claude está trabalhando. Veja Adicionar um comando ou uma ferramenta.
• Compartilhar dados entre hooks: os hooks de um mod compartilham as variáveis em seu arquivo, então o que um hook registra, outro pode mostrar. Por exemplo, um hook pode contar chamadas de ferramenta enquanto outro mostra a contagem ao lado do spinner, ou um pode ler o uso de tokens de cada solicitação enquanto outro o mostra em gráfico em um painel. Veja Reagir a eventos.

​

Obter um mod

• Use um que você já tem: alguns dos próprios recursos do Claude Code são mods, como /diff. Veja Mods integrados ao Claude Code.
• Crie um: descreva o que você quer em uma sessão do Claude Code, e o Claude escreve o mod. Veja Peça ao Claude por um mod. Para aprender como o código de um mod funciona, escreva um você mesmo.
• Instale um: veja Instalar ou atualizar um mod

​

Instalar ou atualizar um mod

• Em uma sessão do Claude Code, execute /plugin install token-chart@your-org.
• No seu shell, execute claude plugin install token-chart@your-org.

​

Decidir se confia em um mod

​

O que um mod pode alcançar

• Agir em sua máquina como você: ler e escrever arquivos em qualquer lugar que sua conta de usuário possa, iniciar programas e fazer solicitações de rede
• Ler seus segredos: variáveis de ambiente e arquivos de configurações, incluindo uma chave de API que você mantém em qualquer um deles
• Ver sua sessão: cada prompt que você envia e cada chamada de ferramenta que o Claude faz
• Alterar sua sessão: reescrever um prompt ou uma chamada de ferramenta, enviar um prompt como se você o tivesse digitado, ou enviar uma mensagem para outra de suas sessões
• Agir sem pedir a você: aprovar uma chamada de ferramenta antes de você ser perguntado
• Gastar seu uso: chamar um modelo em seu plano ou chave de API

​

Listar o que um mod faz antes de instalá-lo

claude plugin validate ./some-mod

​

Ativar ou desativar mods

• Um mod: desabilite ou desinstale seu plugin da aba Installed em /plugin
• Cada mod instalado, para uma sessão: inicie o Claude Code com --safe-mode, que também deixa de fora suas outras personalizações
• Cada mod que você instalou, em cada sessão: defina "disableAllHooks": true em ~/.claude/settings.json. Seus settings hooks e linha de status personalizada também param. O que sua organização gerencia continua funcionando.

​

Ver quais mods uma sessão carregou

​

Como um mod funciona

first-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js

• plugin.json: o manifesto do plugin
• hooks.json: aponta para seu arquivo de código
• register.js: seu código, chamado de módulo hooks. Ele diz ao Claude Code em quais eventos executar suas funções.

// A contagem, compartilhada pelos dois hooks abaixo
let calls = 0

// Claude Code chama isso uma vez quando o mod carrega
export function register(on) {
  // Executado cada vez que Claude está prestes a usar uma ferramenta
  on('tool.call', async ($, e, next) => {
    calls += 1
    // Peça ao Claude Code para desenhar a interface novamente, para que a nova contagem apareça
    $.ui.invalidate('ui.render')
    // Deixe a ferramenta ser executada normalmente
    return next(e)
  })

  // Executado cada vez que Claude Code desenha o spinner
  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    // Mantenha o spinner do Claude Code, com a contagem adicionada após sua palavra
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}

• O hook tool.call é executado cada vez que o Claude está prestes a usar uma ferramenta. Adiciona um a calls, pede ao Claude Code para desenhar a interface novamente e deixa a ferramenta ser executada normalmente.
• O hook ui.render é executado cada vez que o Claude Code desenha o spinner. Mantém o próprio spinner do Claude Code e adiciona a contagem após a palavra.

​

O que um hook pode fazer com um evento

• Observar: notar o que está acontecendo e deixar continuar inalterado, como o hook tool.call no exemplo faz
• Reescrever: alterar o evento antes de continuar, como o hook ui.render faz quando adiciona a contagem ao spinner
• Responder: manipular o evento em si, para que o comportamento usual não seja executado, como recusar um comando

​

Onde os mods são executados

​

Controlar mods para sua organização

​

Comparar mods, settings hooks, skills e servidores MCP

​

Mods integrados ao Claude Code

​

Ler a fonte de mods integrados

• diff: o painel /diff, com botões vinculados a ações de teclado e rolagem que o mod manipula
• agents-md: carrega AGENTS.md como instruções do projeto, com uma opção userConfig
• sec-default: o guarda descrito em Saber o que acontece por padrão, um modelo para um mod que aplica política
• telemetry: adiciona métodos que outros mods podem chamar e envia seus tipos

​

Próximos passos

• Criar um mod: construa um que conte chamadas de ferramenta, mostre a contagem ao lado do spinner e adicione um comando, e aprenda o loop de edição e recarga
• Desenhar na interface: painéis, a faixa acima do prompt, botões, campos de texto e estado
• Reagir a eventos: chamadas de ferramenta, prompts, turnos e a ordem em que mods são executados
• Usar a API de mods: comandos, ferramentas, chamadas de modelo, temporizadores e arquivos
• Testar um mod: testes automatizados que são executados sem uma sessão
• Solucionar problemas de um mod: as razões pelas quais um mod não faz nada e o log de depuração
• Gerenciar mods para sua organização: padrões, configurações gerenciadas, revisão de um mod e mods de política
• Referência de mods: cada evento, método, elemento e limite