AI 코딩 · 2026년 7월 9일 · 약 7분

Claude Code Co-Authored-By 설정법, AI 커밋 저자 표시를 팀 정책에 맞추는 방법

Claude Code가 git commit과 PR에 attribution을 붙이는 기본 동작이 개발자들 사이에서 다시 논쟁이 됐다. 공식 설정 문서를 기준으로 Co-Authored-By를 어떻게 끄거나 바꾸고, 팀에서 어떤 검증 절차를 둘지 정리했다.

• Claude Code Co-Authored-By
• Claude Code 설정
• AI 커밋 메시지
• git attribution
• AI 코딩 워크플로

출처: Anthropic Claude Code Docs

Claude Code가 만든 커밋 메시지 끝에 붙는 Co-Authored-By 표시가 다시 개발자 논쟁으로 떠올랐습니다. 한 개발자가 “Claude는 내가 비용을 내고 쓰는 도구이지 공동 저자가 아니다”라는 취지로 문제를 제기했고, 해당 글은 하루 안에 수십만 조회와 많은 댓글을 모았습니다.

이 이슈를 감정 싸움으로만 보면 놓치는 부분이 있습니다. 실제 팀에서는 커밋 메시지가 감사, 오픈소스 기여, 릴리스 기록, 코드 소유권 정책에 연결됩니다. 핵심은 “AI를 썼다고 숨길까 말까”가 아니라, 우리 팀이 어떤 표현을 공식 기록에 남길지 먼저 정하고 도구 설정으로 일관되게 지키는 것입니다.

핵심 키워드

• Claude Code Co-Authored-By 설정
• Claude Code attribution 끄기
• AI 커밋 메시지 관리
• Claude Code git trailer
• AI 코드 리뷰 정책

공식 문서가 말하는 기본 동작

Anthropic의 Claude Code 설정 문서는 Claude Code가 git commit과 pull request에 attribution을 추가한다고 설명합니다. 커밋에는 기본적으로 Co-Authored-By 같은 git trailer가 쓰이고, PR 설명에는 일반 텍스트 attribution이 붙을 수 있습니다. 문서상으로는 commit과 pr 값을 각각 비우면 해당 attribution을 숨길 수 있습니다.

바로 적용하는 설정 예시

개인 프로젝트에서 Claude Code attribution을 남기지 않으려면 사용자 설정에 아래 값을 넣는 방식이 가장 단순합니다. 팀 저장소라면 개인 설정만 믿지 말고 프로젝트 설정과 리뷰 규칙을 함께 둬야 합니다.

복사해서 확인할 설정

• ~/.claude/settings.json 또는 프로젝트의 .claude/settings.json을 연다.
• attribution.commit 값을 빈 문자열로 두면 커밋 attribution을 숨기는 의도다.
• attribution.pr 값을 빈 문자열로 두면 PR 설명 attribution을 숨기는 의도다.
• 팀에서 AI 사용 공개가 필요하면 빈 문자열 대신 “AI-assisted, human reviewed”처럼 팀이 합의한 문구를 쓴다.
• 설정 후 Claude Code로 테스트 커밋을 만들고 git log -1 --format=%B로 실제 메시지를 확인한다.

초보자가 헷갈리는 지점

Co-Authored-By는 GitHub에서 사람 공동 작업자를 표시할 때도 쓰이는 익숙한 형식입니다. 그래서 일부 개발자는 AI 도구 이름이 같은 자리에 들어가는 것을 불편하게 봅니다. 반대로 AI가 실제로 많은 코드를 만들었다면 표시가 필요하다고 보는 사람도 있습니다. 어느 쪽이든 중요한 것은 커밋 기록이 팀의 책임 구조를 흐리지 않게 만드는 일입니다.

팀에서 정할 질문

• AI가 작성한 코드라도 최종 책임자는 커밋한 사람인가, 리뷰 승인자인가?
• AI 사용 사실을 커밋 메시지에 남길지, PR 체크리스트나 내부 문서에 남길지?
• 외부 오픈소스 프로젝트에 기여할 때는 해당 프로젝트의 규칙을 어떻게 확인할지?
• 도구가 기본 문구를 넣었을 때 리뷰에서 누가 확인하고 수정할지?
• 기존 커밋 기록을 고쳐야 하는 상황과 절대 건드리지 말아야 하는 상황을 어떻게 나눌지?

검증은 설정 파일보다 커밋 결과로 한다

GitHub 이슈에는 attribution 설정이 기대와 다르게 동작했다는 보고도 이어져 있습니다. 모든 환경에서 같은 문제가 재현된다고 단정할 수는 없지만, 설정을 넣었다는 사실만으로 충분하다고 보기는 어렵습니다. 특히 릴리스 브랜치, 고객 납품 repo, 공개 오픈소스 repo에서는 실제 커밋 메시지를 확인해야 합니다.

커밋 전 검증 루틴

• Claude Code가 커밋을 만들게 했다면 바로 git log -1 --format=%B를 실행한다.
• Co-Authored-By, Generated with Claude Code, 원치 않는 세션 링크가 있는지 확인한다.
• 팀 표준 문구가 있다면 정확히 같은 표현인지 확인한다.
• 실수로 들어갔다면 push 전에 git commit --amend로 메시지를 고친다.
• 반복적으로 어긋나면 commit-msg hook이나 PR 체크로 차단한다.

오늘 바로 할 일은 간단합니다. Claude Code를 쓰는 저장소 하나에서 최근 커밋 메시지를 확인하고, 팀이 원하는 AI 사용 표시 방식과 실제 기록이 맞는지 비교해보세요. 맞지 않는다면 모델에게만 부탁하지 말고 settings.json, CONTRIBUTING 문서, 리뷰 체크리스트를 함께 정리하는 편이 안전합니다.