SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor · Atualizado 2026-10-28

O que o Claude Code grava nos commits

Veja o trailer Co-authored-by e o link claude.ai que o Claude Code grava em commits; o texto varia por release. Aprenda a ler e remover isso antes do push.

O que o Claude Code inclui em um commit

O Claude Code adiciona um trailer Co-authored-by: ao final das mensagens de commit que grava e uma linha de atribuição às descrições de pull request que abre. As sessões executadas na nuvem ou por meio do Remote Control também adicionam um link para a sessão em claude.ai. Tudo isso é texto simples armazenado no histórico do git. Depois que você envia o conteúdo para um repositório público, ele se torna público e permanece lá até que alguém reescreva o histórico.

O texto exato mudou entre as releases, portanto não confie em uma cópia do trailer mostrada em qualquer tutorial, inclusive neste. Leia os seus próprios commits. Os comandos git abaixo são a parte duradoura deste tópico: o tratamento de trailers do git funciona da mesma forma há anos e continuará funcionando assim depois que a próxima release alterar o texto.

O que um trailer do git realmente é

Um trailer é uma linha com o formato Token: value no último bloco da mensagem de um commit. O Git não fornece uma lista fixa de tokens. Signed-off-by:, Reviewed-by:, Fixes: e Co-authored-by: são convenções baseadas no mesmo mecanismo, e um forge, ou seja, o site que aloja o repositório, como GitHub ou GitLab, lê essas linhas para decidir o que mostrar na página de um commit.

O Git aplica regras estritas à posição desse bloco. A documentação de git interpret-trailers diz que o grupo deve ser precedido por uma linha em branco, definida como "uma linha vazia ou composta apenas por espaços em branco". O bloco deve estar no final da mensagem, e a mensagem termina no fim da entrada ou nas últimas linhas que não estejam vazias nem sejam compostas apenas por espaços em branco, antes de uma linha que comece com --- seguida por um espaço ou pelo fim da linha. O grupo também deve conter apenas trailers ou ser um grupo que "contenha pelo menos um trailer gerado pelo Git ou configurado pelo utilizador e seja composto por pelo menos 25% de trailers".

Esta última regra é importante neste caso. Um URL isolado ou uma linha de prosa dentro do bloco final não é um trailer, e um número suficiente de linhas que não sejam trailers impede que o bloco inteiro seja interpretado como trailers. É por isso que um commit pode parecer conter uma linha Co-authored-by:, enquanto todas as ferramentas que leem trailers corretamente não encontram nada.

Como leio os trailers que já estão no meu histórico?

Comece pela mensagem bruta do commit mais recente.

git log -1 --format=%B

%B imprime o assunto e o corpo exatamente como estão armazenados, sem quebra de linhas nem reformatação. Essa saída é a fonte de verdade. Tudo o que uma forge apresenta é uma renderização dessa mensagem.

Agora peça ao git que indique quais dessas linhas ele considera trailers.

git log -1 --format=%B | git interpret-trailers --parse

--parse é uma abreviatura de --only-trailers --only-input --unfold, portanto a saída contém apenas o bloco de trailers. O resultado correto tem uma linha por trailer. Uma saída vazia, quando é possível ver claramente uma linha Co-authored-by:, indica que o bloco não cumpriu as regras de posicionamento acima.

Para procurar em todo o histórico, peça o trailer pela chave.

git log --format='%h %(trailers:key=Co-authored-by,valueonly)'

As versões mais antigas do git não suportam a opção key= em %(trailers). Uma pesquisa no texto da mensagem funciona em todas as versões.

git log -i --grep='^Co-authored-by:' --format='%h %an %s'

--grep corresponde à mensagem do commit e -i torna a correspondência insensível a maiúsculas e minúsculas. Isso é importante porque a capitalização deste trailer não tem sido consistente entre as ferramentas. Antes de fazer um push, limite a consulta ao que ainda não foi enviado.

git log origin/main..HEAD --format=%B

Esses commits ainda estão locais, portanto ainda pode alterá-los facilmente.

O que faz Co-authored-by: pela atribuição no GitHub?

O GitHub lê o trailer e mostra um segundo autor na página do commit. Só associa esse autor a um perfil quando o endereço de email pertence a uma conta. A documentação do próprio GitHub diz que os commits aparecem no gráfico de contribuições quando são "made with an email address that is connected to your account on GitHub", portanto um endereço que não pertence a ninguém não pode ser associado a um perfil. Para um par de pessoas, esse é o objetivo: o endereço do seu colega está associado à conta dele, e o commit conta para ambos. Quando o endereço não pertence a nenhuma conta, o trailer altera o que a página do commit mostra, mas não altera a lista de contribuidores do repositório.

O próprio Git ignora completamente o trailer. git shortlog -sn e git log --author leem o cabeçalho do autor, que contém o seu nome e o seu email, portanto nenhuma contagem local mostrará o coautor. Aqui, a atribuição é uma funcionalidade da plataforma de hospedagem aplicada sobre uma convenção de texto simples. Essa é a diferença entre o próprio git e a plataforma onde o aloja.

Um trailer identifica um coautor. Um URL de sessão é um ponteiro para uma transcrição. A referência às definições do Claude Code indica que attribution.sessionUrl é a chave que omite "the claude.ai session link from cloud and Remote Control commits", o que também indica de onde vem o link: sessões na Web e sessões iniciadas através do Remote Control. A mesma referência diz que o link é escrito como um trailer Claude-Session nos commits e como um link nas descrições de pull requests, pelo que git log --format='%h %(trailers:key=Claude-Session,valueonly)' lista todos os commits que contêm um.

O link não é uma credencial. A possibilidade de alguém abrir essa sessão depende do acesso à conta, não de o URL permanecer desconhecido. O motivo para o manter fora de um repositório público é mais simples. Trata-se de texto público permanente que identifica um ID de sessão interno e aponta para uma transcrição de trabalho que nunca foi escrita para um público. Num repositório privado, aplica-se o argumento oposto, porque um revisor pode seguir o link e ler como a alteração foi desenvolvida. O local onde essas transcrições são armazenadas e durante quanto tempo permanecem disponíveis é explicado em como o Claude Code armazena as sessões e as retoma.

As definições que controlam a atribuição de commits do Claude Code

Verificado com base na referência de definições do Claude Code em 11 October 2026, estas chaves estão documentadas sob o título "Git and attribution":

  • attribution: "Personalizar a atribuição que o Claude Code adiciona a commits e pull requests"
  • attribution.commit: "Alterar ou ocultar o trailer que o Claude Code adiciona aos commits"
  • attribution.pr: "Alterar ou ocultar a linha de atribuição nas descrições de pull requests"
  • attribution.sessionUrl: "Omitir a ligação da sessão claude.ai dos commits na cloud e do Remote Control"
  • includeGitInstructions: "Remover as instruções incorporadas de commits e PR do contexto do Claude"
  • includeCoAuthoredBy: marcada como obsoleta, com a nota "use attribution to hide or change commit and PR attribution"

Obtenha o valor aceite por cada chave na respetiva entrada da referência de definições, e não num guia. Os nomes das chaves são estáveis. Os valores aceites e as predefinições podem mudar, e um ficheiro de definições com a chave escrita corretamente, mas com o valor escrito incorretamente, falha silenciosamente.

O local onde escreve a definição determina quem a recebe. ~/.claude/settings.json aplica-se a todos os projetos que abrir. Um .claude/settings.json registado na raiz do repositório fica disponível para todos os que o clonarem. .claude/settings.local.json é seu apenas nesse projeto, e o Claude Code adiciona-o aos seus excludes globais do git na primeira vez que escreve o ficheiro, para que este não entre nos seus commits. A precedência aplica primeiro as definições geridas, depois a linha de comandos, depois as definições locais do projeto, depois as definições partilhadas do projeto e, por fim, as definições do utilizador. Por isso, o ficheiro local de um colega tem precedência sobre o ficheiro que registou, portanto trate uma definição registada como uma predefinição, e não como uma garantia.

Depois, verifique a definição, porque aquilo em que acredita não é uma prova. Deixe o Claude Code criar o próximo commit da forma habitual e leia o resultado.

git log -1 --format=%B
git log -1 --format=%B | git interpret-trailers --parse

Se o trailer continuar a ser impresso, a alteração não chegou à sessão. Verifique que ficheiro editou e confirme a ordem de precedência acima antes de concluir que a chave está avariada.

Os controles que não dependem de uma configuração

Uma configuração define o comportamento de uma ferramenta. Uma regra do repositório precisa continuar válida mesmo quando um colaborador usa outra ferramenta ou não usa nenhum agente. O Git fornece um local para essa regra: o hook commit-msg é executado com o caminho do arquivo de mensagem como primeiro argumento e pode editar esse arquivo ou rejeitar o commit imediatamente.

#!/bin/sh
# .githooks/commit-msg
grep -qi '^co-authored-by: claude' "$1" || exit 0
grep -vi '^co-authored-by: claude' "$1" > "$1.new" && mv "$1.new" "$1"
chmod +x .githooks/commit-msg
git config core.hooksPath .githooks

O primeiro grep encerra cedo quando não há nada a fazer, então um commit comum tem custo mínimo. O segundo grava a mensagem novamente sem a linha correspondente. Faça a correspondência com um token exato, e não com todos os trailers, porque um filtro escrito como "remover o último bloco" também removerá uma linha Signed-off-by: exigida pelo projeto.

.git/hooks não faz parte do repositório, então um hook colocado nesse local nunca chega às outras pessoas. core.hooksPath indica ao git um diretório que pode ser incluído no commit, e cada pessoa ainda precisa executar a linha git config por conta própria. O Git não fará isso por elas, de propósito: um repositório que pudesse instalar seus próprios executáveis durante o clone seria uma forma de executar código na sua máquina.

Para recusar o commit em vez de reescrevê-lo, imprima uma mensagem na saída de erro padrão e exit 1 a partir do hook. Recusar é a escolha honesta em um repositório compartilhado, pois editar silenciosamente a mensagem de commit de alguém oculta a regra em vez de ensiná-la. Essa é uma camada diferente dos hooks do próprio agente, que são executados em uma chamada de ferramenta antes mesmo de o git ser envolvido, e como um hook do Claude Code associa uma ferramenta e a bloqueia aborda esse lado.

Nenhuma dessas opções ajuda com um pull request de um fork, porque o hook fica em uma máquina que você não controla. Uma verificação no CI (integração contínua) é a única camada que vê todos os commits antes da mesclagem.

if git log --format=%B "origin/${BASE_BRANCH:-main}..HEAD" | grep -qi '^co-authored-by: claude'; then
  echo "Attribution trailer found. Rewrite the branch before merging." >&2
  exit 1
fi

Documente a regra além de aplicá-la. Um AGENTS.md ao lado de um CONTRIBUTING.md legível por pessoas informa a mesma coisa ao agente e à pessoa, e a verificação no CI é o que garante seu cumprimento.

Remover o trailer antes de fazer push

Para o commit que acabou de criar:

git log -1 --format=%B | grep -vi '^co-authored-by: claude' | git commit --amend -F -

-F - lê a nova mensagem a partir da entrada padrão. O Git remove as linhas vazias no início e no fim de uma mensagem fornecida dessa forma, por isso a linha vazia deixada pelo trailer removido desaparece automaticamente. Leia o resultado com git log -1 --format=%B antes de continuar.

Para vários commits num branch, execute um rebase interativo sobre o branch que irá integrar e marque cada mensagem que pretende alterar com reword.

git rebase -i origin/main

Cada commit, desde o primeiro alterado, recebe um novo hash, porque o hash de um commit inclui a sua mensagem e o respetivo parent. Isto não tem custo enquanto os commits são locais, mas torna-se dispendioso depois de serem partilhados.

Removendo o trailer depois de fazer push

Em uma branch usada somente por você, reescreva-a como acima e depois faça push sobre ela.

git push --force-with-lease

--force-with-lease recusa o push se o remoto tiver mudado desde o último fetch, portanto não descarta silenciosamente um commit adicionado por outra pessoa. O --force simples não faz essa verificação.

Para um trailer distribuído por um histórico extenso, git filter-repo reescreve todas as mensagens em uma única execução. Execute o clone de dentro da sua cópia de trabalho existente, para que a URL venha do remote que você já tem.

pip install git-filter-repo
git clone "$(git remote get-url origin)" ../project-rewrite
cd ../project-rewrite
git filter-repo --message-callback '
return b"\n".join(l for l in message.split(b"\n") if not l.lower().startswith(b"co-authored-by: claude"))
'

O callback recebe cada mensagem como bytes e retorna a mensagem a ser armazenada. Por isso, cada string nele contém o prefixo b. filter-repo recusa-se a executar em um repositório que não seja um clone novo, a menos que você passe --force. Ao terminar, ele remove o remote origin, para impedir que você faça push da reescrita por acidente. Adicione o remote novamente de forma deliberada, faça force-push e depois diga a todos para clonar novamente, porque todos os hashes que eles têm agora estão incorretos.

Deixe claro o que uma reescrita não pode fazer. Ela altera a sua cópia do repositório. Ela não alcança forks, clones existentes, mirrors, páginas de pull request que já citaram a mensagem nem um índice de pesquisa de código que tenha rastreado o repositório na semana passada. Para um segredo vazado, a correção é fazer a rotação do segredo; a reescrita é apenas uma limpeza. Um trailer de divulgação não é um segredo. Portanto, avalie a reescrita do histórico completo em relação ao custo, que inclui reconstruir todas as pull requests abertas.

O que o revisor espera do outro lado

Os mantenedores não concordam sobre isso, e essa divergência é o verdadeiro motivo para verificar antes de remover qualquer coisa. Alguns projetos querem a divulgação e pedirão que você a restaure, porque um revisor analisa um patch escrito por máquina de outra forma. Outros proíbem a divulgação, muitas vezes por causa da questão de quem é legalmente o autor da alteração. Projetos que usam um DCO (certificado de origem do desenvolvedor) exigem uma linha Signed-off-by:, que é uma declaração sua sobre o direito de enviar o código, e um filtro de mensagens descuidado remove essa linha junto com a atribuição.

Leia CONTRIBUTING.md primeiro. Quando o projeto não disser nada, escolha uma regra para o repositório e registre-a, porque um trailer presente em apenas metade dos commits é pior do que qualquer uma das respostas: ele faz uma única linha do tempo parecer a de dois projetos.

Se você executar o agente em um servidor em vez do seu laptop, a mesma questão reaparece em uma camada inferior. Executar o Claude Code em um VPS com sua própria conta determina quais repositórios ele consegue acessar, e o que um agente de programação envia para fora da máquina abrange o tráfego que nunca aparece em uma mensagem de commit.

FAQ

Um trailer Co-authored-by para Claude conta nas estatísticas de contribuidores do meu repositório?

Não. O GitHub associa um commit a um perfil através de um endereço de email ligado a uma conta GitHub e contabiliza as contribuições com base nisso. Um endereço que não pertença a nenhuma conta não pode ser associado, por isso o trailer altera a página do commit, mas deixa a lista de contribuidores inalterada. O próprio Git nunca lê trailers para este efeito. git shortlog -sn contabiliza o cabeçalho do autor, por isso o coautor nunca aparece nessa lista.

Como encontro todos os commits que já têm o trailer?

git log -i --grep='^Co-authored-by:' --format='%h %an %s' lista-os em todo o histórico, sem distinguir maiúsculas de minúsculas. Numa versão recente do git, git log --format='%h %(trailers:key=Co-authored-by,valueonly)' lê o valor através do próprio parser de trailers do git, em vez de procurar texto bruto. Para ver apenas o que ainda não enviou, adicione um intervalo: git log origin/main..HEAD --format=%B.

Posso remover o trailer dos commits que já enviei?

Sim, reescrevendo o histórico, mas o custo é real. Numa branch que só você utiliza, faça amend ou rebase e depois git push --force-with-lease. Numa branch partilhada, todos os commits desde o primeiro editado recebem um novo hash, por isso todos os clones e todos os pull requests abertos têm de ser reconstruídos. Uma reescrita também nunca chega a forks, mirrors ou a um clone que alguém tenha criado ontem.

Não é uma credencial, e o acesso à sessão é decidido pela conta, não pela dificuldade de adivinhar o URL. O problema é ser texto público permanente que aponta para uma transcrição escrita como notas de trabalho. A documentação de referência das definições do Claude Code identifica attribution.sessionUrl como a chave que omite esse link dos commits cloud e Remote Control, e um hook commit-msg remove-o de tudo o que a definição não abrange.

Devo desativar a atribuição?

Isso depende do repositório, não de uma preferência pessoal. Num projeto público, siga o CONTRIBUTING.md, porque um maintainer que queira essa divulgação irá pedir-lhe para a reativar. Num repositório da empresa, manter o trailer é frequentemente útil, porque informa um reviewer, mesmo um ano mais tarde, sobre o motivo pelo qual uma alteração tem aquele aspeto. Decida uma vez para todo o repositório e aplique a decisão no CI, para manter o histórico consistente.

Este artigo foi útil?

#claude-code#git#commit-messages#attribution#privacy