[Claude Code] 커밋과 PR의 Co-Authored-By 표기 숨기기 (attribution 설정)

개요

Claude Code로 작업하다 보면, 커밋 메시지 끝에 자동으로 Co-Authored-By: Claude ... trailer가 붙고 PR 본문 끝에는 🤖 Generated with Claude Code 문구가 붙는 것을 보게 됩니다. 본인 프로젝트나 회사 정책에 따라 이 표기를 숨기고 싶을 때가 있습니다.

이번 포스트에서는 Claude Code의 attribution 설정을 사용해 커밋과 PR의 attribution 표기를 제거하는 방법을 정리합니다.

Claude Code의 설치 방법과 기본 사용법은 Claude Code 기초 지식과 기본 사용법을 참고해 주세요.

왜 attribution 표기를 숨기는가?

Claude Code는 기본적으로 다음 두 가지 attribution을 자동으로 추가합니다.

커밋 메시지: 끝에 Co-Authored-By: Claude <[email protected]> trailer
PR 본문: 끝에 🤖 Generated with [Claude Code](https://claude.com/claude-code) 문구

이 표기를 숨기고 싶은 이유는 다양합니다.

회사 정책상 외부 도구의 attribution을 커밋 이력에 남기지 않으려는 경우
개인 프로젝트에서 커밋 로그를 깔끔하게 유지하고 싶은 경우
GitHub의 contributor 그래프에 Claude가 포함되는 것을 원하지 않는 경우
PR 본문을 더 간결하게 유지하고 싶은 경우

기본 동작 확인

설정을 변경하기 전에 기본 동작을 확인해봅니다. 별도 설정이 없으면 Claude Code가 만드는 커밋은 다음과 같습니다.

feat: 사용자 로그인 기능 추가

이메일과 비밀번호로 로그인할 수 있도록 구현합니다.

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

PR 본문은 다음과 같이 끝납니다.

## Summary

- 사용자 로그인 기능 추가
- 이메일/비밀번호 검증 로직 구현

## Test plan

- [ ] 정상 로그인 테스트
- [ ] 잘못된 비밀번호 입력 테스트

🤖 Generated with [Claude Code](https://claude.com/claude-code)

이번 설정을 적용하면 마지막의 attribution 줄만 제거되고, 그 외의 커밋 메시지/PR 본문은 그대로 유지됩니다.

includeCoAuthoredBy 설정 (deprecated)

예전에는 includeCoAuthoredBy를 false로 설정하여 attribution을 숨겼습니다.

{
  "includeCoAuthoredBy": false
}

하지만 현재 이 설정은 deprecated 상태입니다. Claude Code의 공식 스키마에도 다음과 같이 명시되어 있습니다.

Deprecated: Use attribution instead. Whether to include Claude’s co-authored by attribution in commits and PRs (defaults to true)

새로 설정을 추가하는 경우 attribution 방식을 사용하는 것이 좋습니다. 기존에 includeCoAuthoredBy로 설정해두었다면 attribution 방식으로 변경해 두면 향후 호환성 문제가 발생하지 않습니다.

attribution 설정 (권장)

attribution 설정은 커밋과 PR의 attribution을 각각 독립적으로 제어할 수 있습니다.

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

빈 문자열("")을 지정하면 해당 attribution이 숨겨집니다.

중요한 점은 attribution 부분만 숨겨진다는 것입니다. 커밋 메시지 본문이나 PR 본문 자체가 비어지지는 않습니다. Claude Code가 작성하는 일반적인 커밋 메시지와 PR 본문은 그대로 유지되고, 마지막에 자동으로 붙던 trailer/문구만 제거됩니다.

commit과 pr 각각 제어

commit과 pr을 따로 설정할 수 있으므로 한쪽만 숨기는 것도 가능합니다.

{
  "attribution": {
    "commit": "",
    "pr": "🤖 Generated with [Claude Code](https://claude.com/claude-code)"
  }
}

위 예시는 커밋의 Co-Authored-By trailer만 숨기고, PR 본문에는 기본 attribution을 유지합니다. 반대로 커밋에는 trailer를 남기고 PR에서만 숨기는 것도 가능합니다.

커스텀 텍스트로 변경

attribution을 완전히 숨기는 대신 커스텀 텍스트로 변경할 수도 있습니다.

{
  "attribution": {
    "commit": "Reviewed-by: Team Lead\nGenerated-by: Internal AI Assistant",
    "pr": "---\n_본 PR은 AI 도구의 보조로 작성되었으며, 모든 변경 사항은 사람이 검토했습니다._"
  }
}

회사 정책에 맞춰 attribution 형식을 통일하고 싶을 때 유용합니다.

설정 적용 범위 선택

Claude Code의 설정 파일은 용도에 따라 여러 위치에 존재합니다.

범위	파일 경로	적용 대상
사용자(글로벌)	`~/.claude/settings.json`	모든 프로젝트에 적용
프로젝트	`.claude/settings.json`	해당 프로젝트 내 모든 협업자
로컬	`.claude/settings.local.json`	본인만, 해당 프로젝트에서만

attribution 설정의 권장 위치는 다음과 같습니다.

개인 환경에서 모든 프로젝트에 적용: ~/.claude/settings.json (사용자 글로벌)
팀 전체에 attribution 정책을 적용: .claude/settings.json (프로젝트, Git 커밋)
본인만 적용하고 팀에는 공유하지 않음: .claude/settings.local.json (로컬, gitignore)

본인은 attribution을 숨기고 싶지만 팀원은 기본 설정을 사용하도록 두려면 글로벌 설정(~/.claude/settings.json)에 추가합니다.

설정 확인

설정 파일을 직접 확인하려면 아래 명령어를 사용합니다.

cat ~/.claude/settings.json

또는 jq로 attribution 필드만 확인할 수 있습니다.

jq '.attribution' ~/.claude/settings.json

정상적으로 적용되었다면 다음과 같이 출력됩니다.

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

설정 파일을 수정한 후에는 Claude Code를 재시작할 필요 없이 다음 커밋/PR 생성부터 바로 적용됩니다.

주의사항

attribution 설정과 관련해 알아두어야 할 점이 몇 가지 있습니다.

includeCoAuthoredBy와 attribution을 동시에 설정하지 마세요. 두 설정이 충돌할 수 있으므로 attribution 한 가지만 사용합니다.
attribution은 자동으로 추가되는 부분에만 영향을 미칩니다. Claude Code가 작성하는 커밋 메시지 본문이나 PR 본문 내용 자체는 영향을 받지 않습니다.
이미 생성된 커밋의 trailer는 변경되지 않습니다. 이번 설정 변경은 이후에 새로 생성되는 커밋과 PR에만 적용됩니다.
사내 정책으로 강제하고 싶다면 프로젝트 설정에 포함하고 Git에 커밋해 두면 됩니다. 다만 팀원이 로컬 설정으로 덮어쓸 수 있다는 점은 알아두세요.

완료

이것으로 Claude Code의 attribution 설정으로 커밋과 PR의 Co-Authored-By 표기를 숨기는 방법에 대해 알아보았습니다.

includeCoAuthoredBy는 deprecated 상태이므로, 새로 설정을 추가한다면 attribution을 사용하는 것을 권장합니다. commit과 pr을 독립적으로 제어할 수 있고, 빈 문자열로 숨기거나 커스텀 텍스트로 변경할 수도 있으니 환경에 맞게 설정해 보시기 바랍니다.