Diff: o painel diff do Claude Code com as mudanças não commitadas da sua sessão
Um painel /diff para o Claude Code: mudanças não commitadas, arquivo por arquivo com seus hunks, sempre atualizado.
Permissões
- Lê arquivosPode ler arquivos e listar diretórios na sua máquina ($.fs.read / list / stat / exists).
- Executa comandosPode executar programas de shell na sua máquina ($.process.run / spawn). Confira no código-fonte exatamente quais.
- Intercepta chamadas de ferramentasVê cada chamada de ferramenta que o Claude faz (tool.call / tool.check) e pode bloqueá-la ou alterá-la.
- Lê seus promptsPode ver o que você digita e a transcrição da conversa (prompt.* / session.append / session.messages).
- Altera a interfaceDesenha na interface do Claude Code: faixas, painéis, texto de status, notificações (ui.render / $.ui.*).
- Adiciona comandos/ferramentasRegistra novos comandos de barra ou ferramentas que você ou o Claude podem acionar ($.command.register / $.tool.register).
- Armazena dadosGuarda dados entre sessões no armazenamento privado do plugin ($.store.*).
- testado com
- v2.1.310
- último teste
- requer
- Claude Code ≥ 2.1.287
- superfícies
- painel
- código-fonte
- Anthropic (anthropics)
Instale dentro do Claude Code:
git clone https://github.com/anthropics/claude-code
claude --plugin-dir ./claude-code/mods/diffO que este mod faz?
O Diff é um mod que a Anthropic publica no repositório claude-code e que listamos aqui como mod da comunidade. Ele é um painel diff do Claude Code: /diff abre as mudanças não commitadas da sessão ao lado da transcrição, com uma linha por arquivo alterado e os hunks de cada arquivo abaixo; outro /diff o fecha. Cada alternância deixa Diff panel shown ou Diff panel hidden na transcrição.
O painel é atualizado depois que o Claude edita um arquivo ou executa um comando de shell, e, enquanto está aberto, acompanha o HEAD do repositório, de modo que um commit ou checkout feito em outro lugar também aparece. Ele pode comparar a árvore de trabalho com o HEAD do início da sessão (o padrão), com o HEAD puro, ou com o merge-base da branch padrão, e um seletor pode mostrar no lugar as edições de um turno anterior. Arquivos que já tinham mudado antes da sessão, além de lockfiles, arquivos gerados e testes, são listados à parte e recolhidos.
Se o terminal for largo o bastante, a primeira edição bem-sucedida de uma sessão abre o painel sozinha. Sem o layout de tela cheia, o /diff abre, em vez disso, um diálogo em linha: uma lista de arquivos com cinco linhas em torno da selecionada, Enter mostra só os hunks daquele arquivo e Escape volta. O botão [ ask ] de um arquivo o arma, de modo que seus hunks seguem uma vez com o próximo prompt como contexto.
Demonstração
A gravação inicia o Claude Code com o mod carregado no pequeno projeto de demonstração, que tem uma mudança não commitada. Ela digita /diff e o autocompletar mostra “Toggle the diff panel showing uncommitted changes”. Depois do Enter, abre-se acima do prompt um diálogo com borda intitulado Uncommitted changes (git diff HEAD), com 1 file changed +2 abaixo. Ele lista src/index.js com um botão [ ask ] e, abaixo, o hunk com números de linha e as duas linhas adicionadas destacadas em verde. O rodapé diz ↑/↓ to scroll · Esc to back. O clipe fica alguns segundos no diálogo. Ele mostra a forma em linha, porque o terminal da demonstração não usa o layout acoplado.
Instalação
Use qualquer um dos métodos do bloco de instalação; eles instalam direto do repositório do próprio autor. Depois do próximo início de sessão, digite /diff dentro de um repositório git com um arquivo modificado.
$ install diff
Requer Claude Code ≥ 2.1.287
Instala a partir do marketplace do autor: anthropics/claude-code
1.Experimente sem instalar
git clone https://github.com/anthropics/claude-code claude --plugin-dir ./claude-code/mods/diffCarrega o mod só para uma sessão. Nada é adicionado às suas configurações.
Como funciona
O módulo hooks/register.ts registra /diff em session.start, desenha o componente Pane e escuta tool.call de Edit, Write, NotebookEdit, Bash e PowerShell para saber quando atualizar. Cada processo filho do git recebe o diretório git e a árvore de trabalho fixados do repositório, e todo diff começa com os mesmos argumentos fixos, de hooks/git/argv/diff-leading-args.ts:
export const DIFF_LEADING_ARGS = [
'--no-optional-locks',
'-c',
'diff.relative=false',
'-c',
'core.quotePath=false',
'diff',
'--no-ext-diff',
'--no-textconv',
'--ignore-submodules=dirty',
'--submodule=short',
] as constO git roda apenas nos momentos em que o painel embutido o executaria: não no início da sessão, uma vez para encontrar o repositório quando o /diff ou a primeira edição precisa dele, e depois nas leituras após uma edição ou um comando de shell. A saída tem um limite, e a partir de 500 arquivos só os totais são mostrados. Se a sessão já tiver outro comando /diff registrado, o mod se afasta.
Personalize
O mod não tem opções em /config. A base de comparação é escolhida no painel e ctrl+x b passa para a próxima; a escolha é guardada por repositório no armazenamento do próprio plugin. A lista rola com ctrl+up/ctrl+down e opt+up/opt+down. Se você não quer que o painel abra na primeira edição, feche-o uma vez e o mod lembra. Definir CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING também interrompe a abertura automática.
Permissões e segurança
Lemos o manifesto, hooks/hooks.json e hooks/register.ts, e pesquisamos nos cerca de 800 arquivos restantes de hooks/ acessos a rede, processos, gravação de arquivos e ambiente. Não lemos linha por linha o diretório de 3,4 MB, que é em grande parte pequenos módulos TypeScript e testes. Não há package.json, script de instalação, binário nem código minificado ou codificado.
- Altera a interface: o painel ou o diálogo, e os toasts.
- Adiciona um comando:
/diff. - Processos:
$.process.runapenas para subcomandos de git de leitura (rev-parse,status,diff,ls-files,merge-base,show-ref,symbolic-ref), com a localidade fixada em C. - Rede: nenhuma encontrada. Arquivos: lê arquivos e carimbos de data do repositório com
$.fs; só grava em$.store. - Ambiente: lê
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING. - Telemetria: chama
$.telemetry.loge$.telemetry.mark, que são descartados onde falta a telemetria embutida do Claude Code; não encontramos o mod enviando nada por conta própria. - Influência sobre o modelo: o hook
prompt.submitadiciona os hunks de um arquivo armado ao contexto do prompt, somente depois que você aperta o botão ask desse arquivo. - Licença: o
LICENSE.mddiz “all rights reserved”, sem ID SPDX; por isso esta página só linka e não espelha o código.
O claude plugin validate não relatou erros nem avisos, mas deixou recomendações de que o README não tem linha de instalação e falta um ícone, além de notas de que sete hooks não têm .catch. Os testes do autor passaram: 234 aprovados, 0 falhas em 30 arquivos, com o Claude Code 2.1.310.
- Lê arquivos
- Pode ler arquivos e listar diretórios na sua máquina ($.fs.read / list / stat / exists).
- Executa comandos
- Pode executar programas de shell na sua máquina ($.process.run / spawn). Confira no código-fonte exatamente quais.
- Intercepta chamadas de ferramentas
- Vê cada chamada de ferramenta que o Claude faz (tool.call / tool.check) e pode bloqueá-la ou alterá-la.
- Lê seus prompts
- Pode ver o que você digita e a transcrição da conversa (prompt.* / session.append / session.messages).
- Altera a interface
- Desenha na interface do Claude Code: faixas, painéis, texto de status, notificações (ui.render / $.ui.*).
- Adiciona comandos/ferramentas
- Registra novos comandos de barra ou ferramentas que você ou o Claude podem acionar ($.command.register / $.tool.register).
- Armazena dados
- Guarda dados entre sessões no armazenamento privado do plugin ($.store.*).
Compatibilidade e solução de problemas
Verificado com o Claude Code 2.1.310 no macOS (validate, testes e gravação). Se o /diff não mostrar nada:
- Você está dentro de um repositório git; fora de um, o
/diffavisa e não faz mais nada. - Há de fato um arquivo modificado; senão você vê
No changes this session. - Há outro
/diffregistrado: então o mod fica ocioso. - Para a abertura automática, o terminal tem pelo menos 144 colunas com o layout de tela cheia.
- Abaixo de 110 colunas nesse layout aparece uma linha pedindo um terminal mais largo.
Perguntas frequentes
- O Diff envia meu código para algum lugar?
- Não encontramos código de rede. Ele executa na sua máquina apenas comandos de git de leitura (rev-parse, status, diff, ls-files, merge-base, show-ref, symbolic-ref) e desenha o resultado. Só chegam ao modelo os hunks de um arquivo, e somente depois que você aperta o botão ask dele.
- Ele altera meu repositório?
- Não. Todos os comandos de git que encontramos são de leitura e rodam com --no-optional-locks, --no-ext-diff e --no-textconv. O plugin só grava no próprio armazenamento, onde lembra se o painel estava aberto e qual base de comparação você escolheu.
- Por que o /diff às vezes abre sozinho?
- Após a primeira edição bem-sucedida de uma sessão, se o checkpointing de arquivos estiver ativo e o terminal for largo o bastante (144 colunas, ou 110 se você já o manteve aberto antes). Se você o fechou, ele não insiste. Em terminais mais estreitos e no layout em linha, só o /diff o abre.
- O que o botão ask faz?
- Ele arma um arquivo. No seu próximo prompt, o plugin adiciona os hunks desse arquivo como contexto uma vez e o desarma. Se os hunks não couberem no espaço de contexto, são descartados e a linha de status avisa.
- Posso redistribuir ou fazer um fork?
- Pelo que encontramos, não. O LICENSE.md do repositório diz “All rights reserved” e remete aos Commercial Terms of Service da Anthropic, então linkamos o repositório e não espelhamos o código.
# Mods relacionados
DestaqueBranch do Git acima do prompt
Mostra a branch do Git, a contagem de alterações e o status ahead/behind em uma faixa acima do prompt do Claude Code.
- acima do prompt
- Executa comandos
- Intercepta chamadas de ferramentas
- Altera a interface
testado com v2.1.310
cc-pr-tracker
Uma linha por PR do GitHub acima do prompt do Claude Code: merge, revisão, checks obrigatórios e alertas de mudança.
- acima do prompt
- notificação
- Lê arquivos
- Executa comandos
- Intercepta chamadas de ferramentas
- Lê seus prompts
- Altera a interface
- Adiciona comandos/ferramentas
- Armazena dados
testado com v2.1.296
DestaqueBlast Radius
Segura rm -r, force push e migrações de banco de dados no Claude Code e mostra o que mudariam antes de rodarem.
- painel
- acima do prompt
- Executa comandos
- Intercepta chamadas de ferramentas
- Altera a interface
testado com v2.1.291
Mais em Git e GitHub, Ferramentas que você adiciona ao Claude.