클로드 코드 GitHub Actions 연동: PR·이슈에서 @claude로 작업 맡기기

로컬에서 클로드 코드를 쓰다 보면 "PR 리뷰도 맡기면 좋겠다"는 생각이 듭니다. GitHub Actions와 연동하면 PR이나 이슈 댓글에 @claude라고 적는 것만으로 리뷰, 수정 제안, 질문 답변을 맡길 수 있습니다.

📌 설치 방법과 설정 항목은 바뀔 수 있습니다. 실제 설정은 Claude Code GitHub Actions 공식 문서를 따라 주세요.

무엇을 맡길 수 있나

어떻게 동작하나

댓글에 @claude가 들어가면 저장소에 설정된 워크플로가 GitHub Actions 러너에서 실행되고, 클로드 코드가 저장소를 읽고 작업한 뒤 결과를 댓글이나 커밋으로 남깁니다. 저장소의 CLAUDE.md도 그대로 적용되므로, 팀 규칙을 CLAUDE.md에 잘 정리해 두면 리뷰 품질이 올라갑니다.

설치 흐름

1. 로컬 클로드 코드에서 설치 명령 실행: 공식 문서는 클로드 코드 세션에서 GitHub 앱 설치를 도와주는 명령을 안내합니다. 안내에 따라 GitHub 앱 설치와 워크플로 파일 추가가 진행됩니다.
2. 인증 정보 등록: 저장소의 Settings → Secrets에 API 키(또는 안내된 인증 토큰)를 등록합니다. 키를 워크플로 파일에 직접 쓰면 안 됩니다.
3. 워크플로 파일 확인: .github/workflows/ 아래에 추가된 파일의 트리거와 권한을 확인합니다.
4. 테스트: 테스트용 이슈에 @claude 안녕처럼 간단히 호출해 동작을 확인합니다.

팀에서 쓸 때 정할 것

호출 권한

공개 저장소라면 아무나 댓글로 @claude를 부를 수 있습니다. 외부인이 비용을 쓰게 하거나, 댓글에 악의적인 지시를 넣을 수 있으니 호출 가능한 사용자를 제한하는 설정을 확인하세요.

사람 리뷰 필수

클로드가 만든 변경도 결국 코드입니다. 브랜치 보호 규칙으로 사람의 승인 없이는 병합되지 않게 합니다.

비용 모니터링

GitHub Actions 실행 시간과 클로드 사용량, 두 가지 비용이 듭니다. 처음 한 달은 사용량을 주 단위로 확인해 예상과 맞는지 보세요.

로컬 클로드 코드와 언제 나눠 쓰나

• 로컬: 직접 대화하며 방향을 잡아야 하는 작업, 실행해 보며 고치는 작업
• GitHub Actions: 정해진 리뷰, 작은 이슈 처리, 팀원 누구나 요청할 수 있어야 하는 작업

연동하며 정한 원칙

자동화가 편해질수록 "누가 이 변경에 책임지는가"가 흐려지기 쉽습니다. 저는 @claude가 만든 PR에도 요청한 사람을 리뷰어로 지정하는 규칙을 둡니다. 요청한 사람이 결과를 확인하고 승인하는 흐름을 지키면, 자동화의 속도와 사람의 책임을 함께 가져갈 수 있습니다.

정리하면

• PR·이슈 댓글의 @claude로 리뷰, 구현, 설명, 원인 분석을 맡길 수 있습니다.
• 인증 정보는 Secrets에만 두고, 호출 권한 제한과 브랜치 보호를 함께 설정하세요.
• Actions 실행 시간과 클로드 사용량을 함께 모니터링합니다.

참고 자료

• Claude Code GitHub Actions (공식 문서)
• 클로드 코드로 깃 커밋·PR 정리하기