클로드코드 커밋에 남는 Co-Authored-By 흔적 지우기

#들어가며

클로드코드에게 커밋을 시키면 커밋 메시지 끝에 이런 게 붙는다.

Co-Authored-By: Claude <[email protected]>

솔직히 맘에 안 든다.

내가 클로드한테 시킨 건 맞지만, 커밋 히스토리에 매번 이게 찍히는 건 좀 다른 이야기다. 깔끔한 커밋 로그를 유지하고 싶은데 모든 커밋마다 AI가 공동 저자로 태그되어 있으면 보기가 거슬린다.

더 큰 문제가 하나 있다. GitHub에서 Co-Authored-By에 명시된 클로드 계정 프로필을 클릭해 보면 — "Something went wrong" 페이지가 뜬다. 실제로 존재하지 않는 유령 계정이 커밋 히스토리에 공동 저자로 매번 찍히고 있는 셈이다. GitHub 커밋 목록에서 클로드 아바타를 보고 누가 눌러볼 때마다 에러 페이지를 보게 된다. 영 깔끔하지 못하다.

설정 한 줄이면 이 흔적을 제거할 수 있다.

#공식 문서에서 제공하는 설정

클로드코드 공식 문서에 따르면, 이 동작을 제어하는 설정은 두 가지다.

includeCoAuthoredBy는 deprecated 됐고, attribution이 권장된다. 하지만 둘 다 아직 동작한다.

#방법 1: attribution 설정 (권장)

~/.claude/settings.json에 아래 설정을 추가하면 된다.

{
  "attribution": {
    "commit": "",
    "pr": ""
  }
}

• commit: 커밋 메시지에 붙는 트레일러를 제어한다. 기본값은 "🤖 Generated with Claude Code"이고, 빈 문자열("")이면 아무것도 안 붙는다.
• pr: PR 본문에 붙는 문구를 제어한다. 기본값이 이미 빈 문자열이라 PR은 따로 건드릴 필요 없지만, 명시적으로 비워두는 게 깔끔하다.

커스텀 문구를 넣고 싶다면 빈 문자열 대신 원하는 텍스트를 넣으면 된다. 예를 들어 "commit": "Assisted by AI"처럼.

#방법 2: includeCoAuthoredBy 설정 (deprecated)

더 간단하지만 deprecated된 방법이다. ~/.claude/settings.json에 아래 한 줄을 추가하면 된다.

{
  "includeCoAuthoredBy": false
}

attribution 설정이 있으면 includeCoAuthoredBy보다 우선 적용된다. 새로 설정한다면 attribution을 쓰는 게 맞다.

#어디에 넣을까?

이 설정은 글로벌(~/.claude/settings.json)에 넣으면 모든 프로젝트에 적용되고, 프로젝트별(.claude/settings.json)에 넣으면 해당 프로젝트에만 적용된다.

모든 프로젝트에서 제거하고 싶다면 글로벌 설정에 넣는 게 편하다.

#기존 커밋에서 떼어내기

이미 들어간 커밋은 어떻게 할까? git rebase로 수정할 수 있지만, 공유된 브랜치에서는 권장하지 않는다. 히스토리가 꼬이니까.

개인 브랜치에서 최근 커밋 몇 개만 수정하고 싶다면 git rebase -i로 커밋 메시지를 편집하면 된다. 하지만 이미 push된 커밋이라면 force push가 필요하므로 주의하자.

앞으로의 커밋만 깨끗하게 유지하는 게 현실적이다.

#마치며

정리하면 이렇다.

1. ~/.claude/settings.json에 attribution 설정으로 빈 문자열을 넣으면 끝.
2. includeCoAuthoredBy는 deprecated니까 attribution을 쓰자.
3. 이미 들어간 건 무리해서 지우지 말고, 앞으로만 깨끗하게 유지하자.

설정 한 줄이면 커밋 히스토리에서 AI 흔적이 사라진다. GitHub 프로필에서 "Something went wrong" 에러 페이지를 보는 일도 없어진다.