Pular para o conteúdo
claudemods

Mods de git para Claude Code: branches, commits e GitHub

Mods de git para Claude Code mostram seu branch e alterações, barram comandos git arriscados, ajustam textos de commit e PR e exibem o estado do GitHub.

Bloquear comandos perigosos em execução no Claude Code

Bloquear comandos perigosos

Recusa rm -rf /, force-push na main, DROP TABLE, curl | sh e outros comandos Bash destrutivos antes de rodarem.

  • notificação
  • Intercepta chamadas de ferramentas
  • Altera a interface

testado com v2.1.291

Branch do Git acima do prompt em execução no Claude Code

Branch 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.291

Os mods de git para Claude Code mantêm o controle de versão visível e um pouco mais seguro enquanto o Claude edita seu código. Eles mostram o branch atual e quantos arquivos foram alterados, avisam antes de um force-push para main, reescrevem o texto de atribuição dos commits ou exibem o estado de pull requests e de CI vindo do GitHub.

Em quais pontos os mods de git para Claude Code se conectam?

Os mods de exibição leem o repositório com $.process.run(['git', 'status', '--porcelain=v1', '-b'], { cwd }), usando $.session.cwd() para descobrir a pasta, e depois desenham o resultado na faixa AbovePrompt ou na linha de status. Eles atualizam em session.start, em turn.complete e logo depois de um tool.call de Bash cujo comando mencione git, para que um checkout feito pelo Claude apareça na hora. Um timer lento com $.clock.every captura mudanças que você faz em outro terminal.

Os mods de proteção usam o mesmo hook tool.call para recusar comandos como git push --force origin main ou git clean -fdx. Mods que mudam a forma como commits e PRs são assinados tratam attribution.text. Mods que conhecem o GitHub executam gh ou chamam a API do GitHub com $.http.fetch. A referência de mods traz a lista completa de eventos.

O que você deve verificar antes de instalar um?

Espere ver Executa comandos em praticamente todo mod de git. A questão é quais comandos. Um mod de exibição só deve rodar comandos somente leitura, como git status, git rev-parse ou git log, com timeout e sem string de shell. Se um mod mostrar Rede, descubra qual host ele chama e se precisa de um token; um token do GitHub em userConfig deve estar marcado como sensível.

Em um repositório muito grande, git status pode levar um tempo perceptível. Prefira mods que atualizam com base em eventos e deixam você aumentar o intervalo do timer em /config.

Qual a diferença entre mods de git e o uso de git pelo próprio Claude?

O Claude já executa git para você por meio da ferramenta Bash. Os mods de git não substituem isso; eles mostram o resultado sem que você precise perguntar e impõem limites ao que o Claude pode executar. Uma faixa de branch somada a uma proteção contra force-push cobre as duas surpresas mais comuns: fazer commit no branch errado e reescrever um histórico compartilhado.

Perguntas frequentes

Os mods de git para Claude Code precisam do GitHub CLI?
Só se eles conversarem com o GitHub. Um indicador de branch precisa apenas do git. Mods que leem pull requests ou o status de CI geralmente executam o gh por meio de $.process.run ou chamam a API do GitHub com $.http.fetch, e a página deve dizer qual das duas opções é usada.
Um mod de git pode alterar meu repositório?
Só se ele executar comandos que escrevem, como git commit ou git checkout. Leia a seção Como funciona. Um mod que só exibe informações deve rodar comandos somente leitura, como git status.
Por que um mod de git não mostra nada em algumas pastas?
Fora de um repositório git, um mod de git bem-comportado se esconde em vez de imprimir um erro. Inicie o Claude Code dentro do repositório ou entre nele com cd antes de iniciar.