Projeto IA · Dia 9/100
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.
Ver os promptsEm 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
/comandoque 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
/diffdo 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.reade$.fs.write: lê e escreve arquivos$.http.fetch: acessa a internet$.process.rune$.process.spawn: abre programas$.env.gete$.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:
- Atualize o Claude Code. No terminal:
claude update. Confira comclaude --version(2.1.287 ou mais nova). - Crie uma pasta de teste (ex.:
teste-mods) com os 3 arquivos abaixo. Fora da pasta do seu trabalho. - Baixe os exemplos da Anthropic:
git clone https://github.com/anthropics/claude-code-playground.git - Confira o que o mod faz:
claude plugin validate ./claude-code-playground/claude-code/mods/replay-theater - 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. - Confira se carregou: digite
/plugin. Embaixo das abas aparece algo como1 mod active · replay-theater. - Faça o pedido (abaixo) e aprove as edições.
- Digite
/replay. Usenpra próxima mudança,ppra anterior ecpra fechar. Ou aperterna 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
Segunda: natação, 40 minutos
Quarta: corrida leve, 30 minutos
Sexta: bike, 1 hora
Sábado: treino longo
Domingo: descanso
Agenda da semana
Segunda, 6h30: natação antes do trabalho
Quarta, 19h: corrida no parque
Sexta, 6h30: bike
Sábado, 7h: treino longo
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
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/diffjá 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
-
Dia 21 · Dica rápida
Códigos do ChatGPT para livros: mapa mental, flashcards e mais
Você anexa um livro ou uma apostila no ChatGPT e escreve um comando curto com barra, tipo /mindmap, pra pedir um resumo visual daquele material. Aqui estão os 5 comandos, como usar cada um e um pedido completo pra quando o comando sozinho não gerar a imagem. ChatGPT -
Dia 20 · Dica rápida
Prompt pra estudar pra prova: o Claude ensina e testa até você acertar
Um prompt pra colar no Claude junto com as suas anotações e PDFs. Ele transforma o material num sistema de estudo: ensina os conceitos importantes, acha os seus pontos fracos, faz um quiz, explica os erros e continua te testando até você responder sem ajuda. Claude · ChatGPT -
Dia 18 · Dica rápida
Texto com cara de IA: os 10 sinais e um prompt pra humanizar
Texto feito por IA tem umas manias que muita gente já reconhece na hora, como o travessão pra todo lado e o "vale ressaltar que". Aqui estão os 10 sinais mais conhecidos, cada um com exemplo, e um prompt de copiar e colar pra IA reescrever o seu texto sem eles, mais perto do jeito que você escreve. ChatGPT · Claude