클로드코드 /review: PR을 머지 전에 검토해 놓친 부분 잡기

작성한 코드를 본 프로젝트에 합치기(머지) 직전, "혹시 놓친 게 있지 않을까" 불안하셨다면 /review가 든든한 안전장치가 됩니다. PR(Pull Request, 코드 제출본)을 현재 세션에서 검토해 주는 명령어예요. 머지 전에 한 번 더 눈을 거치는 품질 게이트로 쓰기 좋습니다.

정의 (뭐냐면)

/review는 PR(Pull Request)을 현재 클로드코드 세션 안에서 검토하는 명령어입니다.

PR이란 "이 코드 변경을 본 프로젝트에 합쳐 주세요" 하고 올리는 코드 제출본을 말해요. 보통은 팀원이 직접 읽어보며 문제가 없는지 확인(코드 리뷰)하는데, /review는 그 검토를 클로드코드가 함께 해주는 겁니다. 변경된 코드를 살펴 잠재적 문제나 놓친 부분을 짚어줘서, 합치기 전에 품질을 점검할 수 있어요.

어떻게 쓰나 (난이도별)

기초 — 특정 PR 검토

검토할 PR 번호를 붙여 칩니다.

/review 123

123번 PR의 변경 내용을 클로드코드가 검토합니다. 어떤 부분이 위험할 수 있는지, 빠뜨린 처리가 없는지 등을 짚어줘요.

응용 — 현재 브랜치 자동 감지

번호 없이 그냥 칩니다.

/review

그러면 지금 작업 중인 브랜치(작업 갈래)에 연결된 PR을 자동으로 찾아 검토합니다. 번호를 일일이 확인할 필요가 없어 편리해요.

흔한 함정

• PR 번호로 검토하려면 그 PR이 실제로 올라가 있어야 합니다. 아직 올리지 않았다면 번호로 찾을 수 없어요.
• 자동 감지(/review)는 현재 브랜치에 연결된 PR이 있어야 동작합니다. PR이 없으면 검토할 대상을 못 찾을 수 있어요.
• 검토는 사람의 판단을 돕는 도구입니다. 지적 사항을 그대로 다 따르기보다, 내 맥락에서 맞는지 한 번 더 판단하세요.

실전 사례

팀 협업에서 머지 직전 점검에 자주 쓰입니다. 팀원이 올린 PR을 합치기 전에 /review로 한 번 훑어, 사람 눈이 놓치기 쉬운 부분에 코멘트를 남기는 식이에요. 리뷰 부담을 줄이면서 품질은 챙길 수 있습니다.

이렇게 더 씁니다

내가 올린 PR을 스스로 점검하는 용도로도 좋아요. 머지 요청을 보내기 전에 /review로 먼저 살펴, 검토자에게 넘기기 전에 명백한 문제를 미리 정리해 두면 리뷰가 한결 매끄럽게 진행됩니다.

정리

/review는 PR을 현재 세션에서 검토하는 명령어입니다. 번호를 지정하거나(/review 123), 비워두고 현재 브랜치의 PR을 자동 감지하게 할 수 있어요(/review). 머지 전 품질 게이트로 활용하면 놓친 부분을 잡아내는 데 큰 도움이 됩니다.

FAQ · 자주 묻는 질문

PR 검토는 어떻게 시작하면 되나요?

두 가지 방법이 있습니다. 검토할 PR 번호를 알고 있다면 /review 123처럼 번호를 붙여 치면 되고, 번호 없이 /review만 치면 지금 작업 중인 브랜치에 연결된 PR을 자동으로 찾아 검토해 줘요. 번호를 일일이 확인하기 귀찮다면 자동 감지 쪽이 편합니다.

/review가 문제없다고 하면 그대로 머지해도 되나요?

한 번 더 직접 판단하는 게 좋습니다. 검토는 사람의 판단을 돕는 도구라서, 지적 사항을 그대로 다 따르기보다 내 맥락에서 맞는지 살펴봐야 해요. /review로 명백한 문제를 미리 정리해 두고, 중요한 부분은 사람 눈으로 확인한 뒤 머지하는 흐름이 안전합니다.

/review를 쳤는데 검토할 대상을 못 찾는대요. 왜 그런가요?

PR이 아직 올라가 있지 않아서일 가능성이 큽니다. 번호로 검토하려면 그 PR이 실제로 올라가 있어야 하고, 번호 없이 자동 감지를 쓰려면 현재 브랜치에 연결된 PR이 있어야 동작해요. PR을 먼저 올린 뒤 다시 /review를 실행해 보세요.

기준: Claude Code v2.1.154 (2026.05)