어두운 공간에 길게 이어진 희미한 빛의 사슬 끝에서 작은 표식 하나가 따뜻하게 빛나는 모습

Blog

Claude Code 커밋 표기, 조직이 먼저 정할 기준

이정민

2026년 10월 29일, Claude Code 문서가 설정 키를 한곳에 모은 설정 목록(All settings) 페이지를 게시했습니다. 이 목록의 Git 및 표기(Git and attribution) 묶음에는 attribution이라는 설정이 있습니다. Claude Code가 커밋과 풀 리퀘스트(PR)에 덧붙이는 작성 표기를 바꾸거나 숨기는 설정입니다. 이 주제는 X 사용자 @Voxyz_ai 님의 게시글을 보고 정리하게 되었습니다.

AI 코딩 도구가 만든 변경을 저장소 기록에 어떻게 남길지는 개발자 한 분의 취향으로 끝나지 않습니다. 코드 리뷰와 감사, 외부에 공개하는 저장소의 운영 방침이 모두 이 결정과 이어집니다. 그래서 설정 키 몇 개를 아는 것보다 누가 어떤 기준으로 정할지를 먼저 이야기해 보려고 합니다.

attribution 설정이 하는 일

attribution은 Claude Code가 커밋과 PR에 추가하는 표기를 조직이 직접 정하도록 하는 설정입니다. 문서는 이 설정을 어느 설정 파일에나 둘 수 있다고 안내합니다. 여기서 어느 파일이란 사용자, 프로젝트, 로컬, 관리형 설정 파일 네 가지를 모두 뜻합니다.

기본 표기를 그대로 둘 수도 있고, 문구를 바꾸거나 아예 숨길 수도 있습니다. 하나의 설정 아래에서 커밋, PR, 세션 링크를 각각 다룬다는 점이 눈여겨볼 부분입니다. 항목마다 다른 결정을 내릴 수 있기 때문입니다.

커밋, PR, 세션 링크를 따로 정합니다

attribution 아래에는 세부 키가 세 개 있습니다. attribution.commit은 Claude Code가 커밋에 추가하는 트레일러를 바꾸거나 숨깁니다. 트레일러는 커밋 메시지 끝에 붙는 부가 정보를 말합니다. attribution.pr은 PR 설명에 들어가는 표기 문장을 바꾸거나 숨깁니다.

attribution.sessionUrl은 성격이 조금 다릅니다. 이 키는 클라우드 세션과 원격 제어(Remote Control) 세션에서 만든 커밋에서 claude.ai 세션 링크를 빼 줍니다. 세션 링크는 작업이 이루어진 세션으로 이어지는 주소입니다. 외부에 공개하는 저장소라면 이 링크를 남길지 따로 판단할 필요가 있습니다.

세 키가 나뉘어 있으니 조합도 다양합니다. 커밋 트레일러는 남기고 PR 설명의 표기만 바꿀 수 있습니다. 반대로 PR 표기는 두고 세션 링크만 뺄 수도 있습니다. 조직은 각 항목이 어떤 목적에 필요한지를 기준으로 고르면 됩니다.

예전 설정과 함께 볼 키

이전에는 includeCoAuthoredBy라는 설정으로 표기를 다루었습니다. 문서는 이 설정을 더 이상 권장하지 않는(deprecated) 설정으로 표시했습니다. 표기를 숨기거나 바꾸려면 attribution을 사용하라고 안내합니다.

이미 includeCoAuthoredBy를 사용하는 팀이라면 지금 설정 파일을 점검하는 것이 좋습니다. 예전 키가 남아 있으면 담당자가 바뀌었을 때 어떤 의도로 넣은 설정인지 알기 어렵습니다. 새 키로 옮기면서 커밋과 PR을 각각 어떻게 할지 다시 정하면 기록도 함께 정리됩니다.

같은 묶음에는 이름이 비슷하지만 하는 일이 다른 키도 있습니다. includeGitInstructions는 Claude가 참고하는 맥락에서 기본 커밋 및 PR 작성 지침을 빼는 키입니다. attribution이 결과물에 붙는 표기를 다룬다면, 이 키는 Claude가 커밋과 PR을 만들 때 참고하는 안내 자체를 다룹니다. 사내 커밋 규칙을 따로 운영하는 조직이라면 두 키의 차이를 분명히 알아 두어야 합니다.

prUrlTemplate도 이 묶음에 들어 있습니다. 이 키는 PR 링크가 github.com 대신 사내 코드 리뷰 도구를 가리키게 합니다. github.com이 아닌 리뷰 도구를 사용하는 조직이라면 표기 설정과 함께 검토할 만합니다.

어느 파일에 둘지가 곧 정책입니다

설정 파일은 위치마다 이름이 다릅니다. 사용자 설정은 ~/.claude/settings.json, 프로젝트 설정은 .claude/settings.json, 로컬 설정은 .claude/settings.local.json입니다. attribution은 이 세 파일과 관리형 설정 파일 가운데 어디에나 둘 수 있습니다.

어디에나 둘 수 있다는 말은 반대로 누구나 정할 수 있다는 뜻이기도 합니다. 개발자마다 사용자 설정에서 표기를 다르게 정하면, 같은 저장소 안에서도 커밋 기록의 모양이 제각각이 됩니다. 리뷰 담당자는 어떤 커밋에 AI 도구가 참여했는지 일관되게 파악하기 어려워집니다.

그래서 파일을 고르기 전에 표기 정책을 개인의 선택으로 둘지, 조직의 규칙으로 둘지를 먼저 정해야 합니다. 팀 단위의 기준이 필요하다면 프로젝트 설정 파일을 검토합니다. 회사 전체에 같은 원칙을 적용해야 한다면 관리형 설정 파일을 함께 살펴보는 것이 좋습니다.

도입 전에 확인할 것

먼저 AI 작성 표기를 남기는 목적을 정합니다. 코드 감사나 품질 분석에서 AI 도구의 참여 여부를 추적하려는 조직이라면 표기를 남기는 쪽이 유리합니다. 고객사에 납품하는 코드처럼 표기 방식이 계약과 이어지는 경우에는 담당 부서와 미리 기준을 맞춰 두어야 합니다.

다음으로 세션 링크를 점검합니다. 클라우드나 원격 제어 세션으로 작업하는 팀이 있다면, 공개 저장소에 claude.ai 세션 링크가 남아도 괜찮은지 판단해야 합니다. 필요하다면 attribution.sessionUrl로 링크를 뺄 수 있습니다.

기존 설정도 정리합니다. includeCoAuthoredBy가 남아 있는 저장소와 개인 설정을 찾아 attribution으로 옮깁니다. includeGitInstructions로 기본 지침을 뺀다면, 그 자리를 채울 사내 커밋 규칙이 준비되어 있는지 함께 확인합니다.

마지막으로 교육이 필요합니다. 개발자가 사용자, 프로젝트, 로컬, 관리형 설정 파일의 차이를 알아야 조직의 기준이 실제로 지켜집니다. 설정 파일의 위치와 각 키의 역할을 온보딩 자료에 넣어 두면, 새로 합류한 분도 같은 기준으로 작업할 수 있습니다.

자주 묻는 질문

Claude Code가 커밋에 붙이는 표기를 없앨 수 있나요?
네, 없앨 수 있습니다. attribution.commit 키로 커밋에 붙는 트레일러를 바꾸거나 숨길 수 있습니다.
예전에 사용하던 includeCoAuthoredBy 설정은 계속 사용해도 되나요?
문서는 이 설정을 더 이상 권장하지 않는 설정으로 표시했습니다. 표기를 바꾸거나 숨기려면 attribution 설정으로 옮기는 것이 좋습니다.
팀 전체에 같은 표기 기준을 적용하려면 어디에 설정해야 하나요?
attribution은 사용자, 프로젝트, 로컬, 관리형 설정 파일 어디에나 둘 수 있습니다. 팀 공통 기준이라면 프로젝트 파일인 .claude/settings.json이나 관리형 설정 파일을 먼저 검토합니다.
클라우드 세션에서 만든 커밋의 세션 링크도 뺄 수 있나요?
뺄 수 있습니다. attribution.sessionUrl 키를 사용하면 클라우드와 원격 제어 세션에서 만든 커밋에서 claude.ai 세션 링크가 빠집니다.

다른 글

AI 도입 성과를 높이는 1분

참여자의 역할, 규모에 맞추어 과정을 구성합니다.
신청 후에는 담당자가 1영업일 내로 연락드릴게요.

1분 내로 문의하기