[Claude Code 입문 E38] 커밋 생성 자동화: 절차·스마트 메시지·Conventional Commits·HEREDOC·Co-Authored-By

원저자：새로운 시작 (neosarchizo)

원본 소스：https://www.youtube.com/embed/srE5CtDbDQI

이 채널의 번역 음성 트랙 상당수는 HeyGen으로 제작됩니다. AI 영상 번역, 더빙, 다국어 콘텐츠 제작에 관심이 있다면 HeyGen을 여기서 사용해 보세요: https://bit.ly/4o4bn9P 이 링크를 통해 가입하시면 채널에 도움이 됩니다 — 감사합니다! 섹션 8(Git 통합 워크플로우)의 두 번째 차시입니다. 37차시가 변경을 읽고(status·diff·log) 안전하게 다루는 토대였다면, 38차시는 그 위에서 처음으로 쓰는 작업 — 커밋 생성입니다. 먼저 오해 하나를 걷어냅니다: 내장 /commit 슬래시 명령은 없습니다. 커밋은 자연어로 부르고, Claude는 그걸 Bash 도구로 절차로 실행합니다. 그 절차, 스마트 메시지, Conventional Commits, HEREDOC, 그리고 Co-Authored-By 트레일러까지 다룹니다. 📌 다루는 내용 - /commit 슬래시 명령은 없다 — "변경사항 커밋해줘" 같은 자연어로 부르면 Claude가 Bash로 커밋 절차를 돈다. 베스트 프랙티스의 Explore→Plan→Implement→Commit 마지막 스텝도 "설명적인 메시지로 커밋하고 PR을 열어줘" 같은 자연어다 - 커밋은 명령이 아니라 절차다 — git status(무엇이)→git diff(어떻게)→git log(기존 스타일)→메시지→git add→git commit→git status(확인). 앞 셋은 읽기 전용 git이라 자동·병렬로 돌고, "스마트"의 절반은 git log로 저장소 컨벤션에 맞추는 데 있다. 그리고 좋은 메시지는 "무엇"이 아니라 "왜" — diff가 이미 무엇을 보여준다 - Conventional Commits 형식 — 타입[스코프]: 설명 + 본문 + 푸터. feat→MINOR·fix→PATCH·BREAKING CHANGE(! 또는 푸터)→MAJOR로 SemVer와 맞물려 changelog·릴리스 자동화가 파싱한다. 단 Claude는 당신 저장소의 컨벤션을 따르므로, 강제하려면 CLAUDE.md에 적는다(21차시) - 본문 있는 멀티라인은 HEREDOC으로 — 작은따옴표로 감싼 'EOF' 구분자가 셸의 $·백틱 해석을 막아 메시지를 글자 그대로 보존한다. 멀티라인·특수문자·정확한 포맷을 한 번에 해결하는 관용구 - Co-Authored-By: Claude 트레일러로 정직하게 표시 — GitHub이 공동 작성자로 인식하고(활성 모델명이 들어갈 수 있다), git config는 건드리지 않은 채 작성자는 사람·기여는 트레일러로. 끄거나 바꾸려면 attribution 설정(구 includeCoAuthoredBy, 기본 true)으로 commit·pr을 각각 비우거나 바꾼다 - 37차시 안전 원칙은 커밋에 그대로 — 요청해야만 커밋, 기본 브랜치면 먼저 브랜치, 훅 스킵(--no-verify) 금지, --amend보다 새 커밋, 민감 파일 제외. allow Bash(git commit *) + deny Bash(git push *)로 못 박는다 📌 환경 정보 - Claude Code 최신 버전 - 커밋 호출: 자연어("변경사항 커밋해줘") · 내장 /commit 없음 · Git 내장은 /diff·/code-review·/security-review·/install-github-app - 커밋 절차: git status → git diff (+ --staged) → git log → 메시지 작성 → git add(관련 파일만) → git commit → git status - 멀티라인: HEREDOC 관용구 · 작은따옴표로 감싼 'EOF' 구분자가 셸의 $·백틱 해석을 막아 메시지를 글자 그대로 보존 - Conventional Commits: 타입[스코프]: 설명 + 본문 + 푸터 · feat→MINOR · fix→PATCH · BREAKING CHANGE(! 또는 푸터)→MAJOR - 기여 표시: 커밋 = Co-Authored-By: Claude (noreply@anthropic.com) 트레일러 · PR = 🤖 Generated with Claude Code 푸터(39차시) - attribution 설정(v2.0.62 도입, 구 includeCoAuthoredBy 기본 true): commit·pr을 ""로 끄거나 문구 변경 - 권한 규칙: allow Bash(git commit *) · deny Bash(git push *) · 헤드리스 --allowedTools "Edit,Bash(git commit *)" - 안전: 커밋·푸시 명시 요청 · 기본 브랜치 보호 · --no-verify 금지 · --amend 신중(authorship 확인) · .env·*.key 제외 📌 챕터 0:00 들어가며 — 에이전트 시대엔 커밋이 더 중요해진다 0:41 /commit 같은 건 없다 — 커밋은 자연어로 부른다 1:29 커밋은 명령이 아니라 절차다 — status→diff→log→메시지→add→commit→status 2:37 좋은 커밋 메시지 — "무엇"이 아니라 "왜" 4:06 Conventional Commits 형식 — 타입[스코프]: 설명과 SemVer 6:31 본문과 HEREDOC — 멀티라인을 안전하게 7:26 Co-Authored-By — git config 안 건드리고 기여만 정직하게 8:18 attribution 설정으로 끄거나 바꾸기 (구 includeCoAuthoredBy) 9:09 37차시 안전 원칙 — 요청해야 커밋·먼저 브랜치·allow commit·deny push 10:20 흔한 함정 정리 📌 참고 링크 - 블로그: https://neosarchizo.github.io/posts/claude-code-38-commit-generation - 베스트 프랙티스 — Explore→Plan→Implement→Commit 워크플로우, "설명적인 메시지로 커밋하고 PR을 열어줘", CLAUDE.md repository etiquette: https://code.claude.com/docs/en/best-practices - 일반 워크플로우 — 변경 요약·PR 생성 프롬프트 레시피, gh pr create 세션 링크: https://code.claude.com/docs/en/common-workflows - 설정 — attribution(커밋·PR 기여 표시 커스터마이즈)과 deprecated includeCoAuthoredBy(기본 true): https://code.claude.com/docs/en/settings - Conventional Commits v1.0.0 — 타입[스코프]: 설명 구조, feat/fix와 SemVer, BREAKING CHANGE: https://www.conventionalcommits.org/en/v1.0.0/ - 명령 레퍼런스 — 내장 명령 목록(/diff·/code-review 등, /commit은 없음): https://code.claude.com/docs/en/commands #ClaudeCode #Git #커밋자동화