Pular para o conteúdo

Projeto IA · Dia 9/100

  • Dica rápida
  • Claude Code

Claude Code mods: o que são e como ver cada mudança do Claude

Um mod é um pedaço de código que muda o Claude Code por dentro, como um mod de videogame. Aqui você entende o que ele pode fazer, o cuidado antes de instalar e testa o Replay Theater, um exemplo da Anthropic que mostra cada mudança que o Claude fez nos seus arquivos.

Publicado em 7 min de leitura Funciona em: Claude Code

Ver os prompts

Em resumo

  • Um mod é código que roda dentro do Claude Code e muda o que ele mostra e faz: cria painéis, comandos e regras.
  • O Replay Theater, exemplo publicado pela Anthropic, cria o /replay: cada mudança que o Claude fez nos seus arquivos, uma por vez, em vermelho e verde.
  • Mod roda com as suas permissões e não fica isolado: instale só de quem você confia e confira antes com claude plugin validate.

Vídeo

Você vai precisar

  • Claude Code (plano pago do Claude)
  • Versão 2.1.287 ou mais nova no terminal
  • git instalado

O que é um mod, bem simples

Sabe mod de videogame? Alguém escreve um pedaço de código e o jogo ganha uma coisa nova: um mapa, um botão, um jeito diferente de jogar.

No Claude Code é igual. Um mod é um pedaço de código que você encaixa nele. Toda vez que algo acontece (o Claude vai editar um arquivo, você manda um pedido, a tela é desenhada), o Claude Code avisa o mod. E o mod pode só olhar, mudar o que ia acontecer ou fazer no lugar.

O que um mod pode fazer

  • Criar uma tela nova: um painel do lado da conversa ou uma faixa em cima da caixa de texto, com botões.
  • Mudar a tela do próprio Claude Code: o jeito que algumas partes aparecem.
  • Entrar no meio de uma ação: segurar um comando antes de rodar e te perguntar primeiro.
  • Criar comandos seus: um /comando que faz alguma coisa na hora.

Um exemplo da documentação: um mod que conta quantas ferramentas o Claude usou e mostra o número do lado do "Thinking", enquanto ele trabalha.

Mod, skill ou conector?

  • Skill: um texto de instruções que o Claude lê. Serve quando você vive colando as mesmas instruções.
  • Conector (servidor MCP): dá pro Claude acesso a outro sistema, tipo sua agenda ou seu Strava.
  • Mod: código que roda dentro do Claude Code. É o único dos três que consegue desenhar na tela.

Onde funciona

  • No Claude Code: no terminal (versão 2.1.287 ou mais nova), na aba Code do app Claude Desktop (2.1.286 ou mais nova) e na extensão do VS Code.
  • Não funciona no chat do claude.ai nem no ChatGPT.
  • Você talvez já use um: o /diff do Claude Code é um mod que já vem embutido.

Pra ver sua versão: no terminal, claude --version. No app Desktop, digite /status numa sessão da aba Code e olhe a linha Claude Code.

Os 3 mods de exemplo da Anthropic

  • replay-theater: cria o /replay, que passa pelas mudanças que o Claude fez nos seus arquivos na última rodada, uma por vez.
  • token-weather: mostra, em cima da caixa de texto, uma "previsão do tempo" de quanto do espaço da conversa já foi usado.
  • blast-radius: segura um comando arriscado (tipo apagar uma pasta inteira), mostra o que ele mudaria e te dá botões pra seguir ou cancelar.

A Anthropic publica esses exemplos "como estão", sem suporte e sem manutenção. Não são um produto oficial.

O cuidado antes de instalar

Um mod é código que roda com as suas permissões, como se fosse você. Depois que carrega, ele pode:

  • ler e mudar arquivos no seu computador, abrir programas e acessar a internet;
  • ler senhas e chaves guardadas nas suas configurações;
  • ver tudo o que você digita e tudo o que o Claude faz;
  • mudar um pedido seu e, em alguns casos, aprovar uma ação sem te perguntar;
  • gastar o limite do seu plano.

E ele não roda numa área isolada (sandbox). Por isso: instale só de quem você confia. Uma coisa ele não consegue: mudar a janela em que o Claude Code te pede permissão.

Como conferir um mod antes de usar. No terminal, claude plugin validate [pasta do mod] lista o que ele faz, sem rodar nada. Olhe a linha calls::

  • $.fs.read e $.fs.write: lê e escreve arquivos
  • $.http.fetch: acessa a internet
  • $.process.run e $.process.spawn: abre programas
  • $.env.get e $.settings.read: lê configurações, onde podem estar senhas e chaves
  • $.model.complete: usa o seu plano pra chamar a IA

O Replay Theater, conferido em 30/10/2026, só lê arquivos (pra mostrar o "antes" de cada mudança) e desenha o painel. Não acessa a internet e não abre programas.

Como desligar. Testou com --plugin-dir, como no passo a passo abaixo? Fechou a sessão, acabou: nada fica instalado. Um mod instalado você desativa em /plugin, na aba Installed. E claude --safe-mode abre uma sessão com todos os mods instalados desligados.

Passo a passo

Pra testar o Replay Theater, numa pasta de teste:

  1. Atualize o Claude Code. No terminal: claude update. Confira com claude --version (2.1.287 ou mais nova).
  2. Crie uma pasta de teste (ex.: teste-mods) com os 3 arquivos abaixo. Fora da pasta do seu trabalho.
  3. Baixe os exemplos da Anthropic:
    git clone https://github.com/anthropics/claude-code-playground.git
  4. Confira o que o mod faz:
    claude plugin validate ./claude-code-playground/claude-code/mods/replay-theater
  5. Abra o Claude Code na pasta de teste, com o mod ligado só nesta sessão:
    claude --plugin-dir [caminho até]/claude-code-playground/claude-code/mods/replay-theater
    Se ele perguntar se você confia na pasta, responda que sim: o mod só carrega depois.
  6. Confira se carregou: digite /plugin. Embaixo das abas aparece algo como 1 mod active · replay-theater.
  7. Faça o pedido (abaixo) e aprove as edições.
  8. Digite /replay. Use n pra próxima mudança, p pra anterior e c pra fechar. Ou aperte r na faixa "▶ Replay" que aparece em cima da caixa de texto.

Os arquivos de teste

Crie os 3 arquivos de texto dentro da pasta de teste, com estes nomes e textos. São inventados: nada seu.

treino-da-semana.txt
Treino da semana

Segunda: natação, 40 minutos
Quarta: corrida leve, 30 minutos
Sexta: bike, 1 hora
Sábado: treino longo
Domingo: descanso
agenda.txt
Agenda da semana

Segunda, 6h30: natação antes do trabalho
Quarta, 19h: corrida no parque
Sexta, 6h30: bike
Sábado, 7h: treino longo
lembretes.txt
Lembretes

Domingo à noite: separar óculos e touca pra natação de segunda
Terça: comprar gel pro treino longo
Quinta: lavar a roupa de bike

Os prompts

Pra pedir uma mudança em vários arquivos (o teste)
Mudei a natação de segunda pra terça. Atualize os 3 arquivos desta pasta pra bater com isso.

Dúvidas

Preciso saber programar?
Pra usar um mod pronto, não: são comandos de copiar e colar. Pra criar um, a documentação diz que você pode descrever o que quer numa sessão do Claude Code e o Claude escreve o mod. Aí vale o mesmo cuidado: confira antes de usar.
Não funcionou. E agora?
Confira a versão (2.1.287 ou mais nova) e se o mod aparece em /plugin. Se ainda não funcionar, o /diff já vem no Claude Code (é um mod embutido) e também mostra as mudanças que o Claude fez.
Funciona no app Desktop?
Mods funcionam na aba Code do app Desktop (versão 2.1.286 ou mais nova). O Replay Theater foi testado pela Anthropic no terminal; o README dele não fala do app.
Uma edição que eu recusei aparece no replay?
Aparece. O mod anota cada edição na hora em que o Claude tenta fazer, então uma edição recusada ou que deu erro também aparece.
O replay fica salvo?
Não. Ele fica disponível até a próxima rodada que mexer em arquivos e some quando você fecha o Claude Code.

Documentação oficial (inglês): https://code.claude.com/docs/en/plugins/mods/overview
O exemplo (inglês): https://github.com/anthropics/claude-code-playground/tree/main/claude-code/mods/replay-theater

Veja também