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

Projeto IA · Dia 9/100 · Tati Veloso · https://tativeloso.com/dia-9
Publicado em 3 de novembro de 2026 · Funciona em: Claude Code

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.

## 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.

## 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](https://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

> Um mod roda com as suas permissões: pode ler e mudar arquivos e acessar a internet. Teste numa pasta separada e instale só mods de quem você confia.

Todos os episódios: https://tativeloso.com/projeto-ia
