본문으로 건너뛰기

GitLab MR 자동 코드 리뷰 봇

JJJ

2026.02.25

# GitLab MR 자동 코드 리뷰 봇

## 한 줄 요약

> GitLab MR에 `@claude`를 멘션하면 Claude가 코드를 분석해 리뷰 댓글을 자동으로 달아주는 봇

---

## 문제 인식

- 코드 리뷰는 시간이 많이 걸리고 놓치는 이슈가 생김
- 리뷰어마다 관점이 달라 일관성 부족
- 리뷰 대기 시간 동안 개발 흐름이 끊김

---

## 동작 방식

```
개발자가 MR에 "@claude 리뷰" 댓글
        ↓
GitLab Webhook → 봇 서버
        ↓
변경 파일 diff + 주변 코드 컨텍스트 수집
        ↓
Claude API 호출
        ↓
버그 / 보안 / 성능 / 코드품질 리뷰 결과
+ 각 이슈를 해당 라인에 인라인 댓글로 게시
```

---

## 주요 기능

| 기능 | 설명 |
|------|------|
| 자동 코드 리뷰 | 버그·보안·성능·코드품질 항목별 분석 |
| 인라인 댓글 | 이슈 발생 라인에 직접 discussion 게시 |
| 프로젝트 맞춤 기준 | `CLAUDE.md`로 팀별 리뷰 기준 주입 |
| 중복 생략 | 기존 댓글 참조해 이미 지적된 내용 제외 |
| 추가 파일 요청 | Claude가 필요한 파일을 직접 요청 후 재리뷰 |
| 자유 질문 | 리뷰 외 MR 코드 기반 Q&A |
| 스레드 답글 | 리뷰 discussion에 후속 질문 대응 |

---

## 기술적 포인트

1. **컨텍스트 전략** — diff만 보내는 게 아니라 변경 주변 코드까지 3단계로 구성해 리뷰 정확도 향상
2. **CLAUDE.md 활용** — 저장소 내 파일로 팀 컨벤션을 프롬프트에 자동 주입, 프로젝트마다 다른 기준 적용 가능
3. **Claude의 능동적 참여** — 리뷰 전 필요한 파일을 Claude가 직접 요청하는 양방향 구조
4. **기존 리뷰 인식** — 이전 리뷰 내용을 읽고 중복 지적을 스스로 걸러냄

---

## 효과

- 리뷰 대기 시간 단축
- 놓치기 쉬운 보안·엣지케이스 자동 포착
- 리뷰어는 Claude 결과를 검토하는 방식으로 부담 감소
2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

JJJ 프로필 이미지
JJJ2026.02.27

CodeRabbit 은 이제 알았네요! 컨셉을 보니 역할이 비슷해 보여요. 다만 CodeRabbit이 더 잘 만든 부분이 있을 수는 있는데, 보안상 이걸 쓰는 결정을 하기는 어려울 것 같아요.

내일 공유할 자료도 링크해 둡니다.
https://gamma.app/docs/GitLab-MR--dy2l062oey204sv

윤누리 프로필 이미지
윤누리2026.02.25

오오 지피터스에서는 코드레빗이라는 것을 쓰고 있는데 비슷한걸 자체적으로 구축하신 것?! 이라고 생각하면 될까요?

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기