[Claude Code #9] /code-review, low부터 ultra까지

AI가 짠 코드를 그대로 커밋하기 불안할 때가 있습니다. 사람 리뷰어를 부르기 전에 한 번 거를 장치가 필요하죠.

Claude Code의 /code-review가 그 역할을 합니다. 지금 브랜치의 변경분을 검사해 버그와 정리 거리를 찾아 주는 명령어예요.

로컬에서 강도를 조절하는 레벨부터 클라우드 정밀 검사 ultra까지, 이번 편에서 단계별로 정리할게요.

Claude Code 8편에서 다룬 effort 레벨이 리뷰 강도에도 그대로 쓰입니다.

기본 동작은 내 브랜치의 변경분 검사

세션에서 /code-review를 입력하면 리뷰가 시작됩니다.

공식 문서 기준으로 기본 대상은 upstream보다 앞선 브랜치 커밋과 아직 커밋 안 한 변경입니다. 정확성 버그와 재사용·단순화·효율 개선 거리를 보고해요.

다른 대상도 지정할 수 있습니다. 파일 경로, PR 번호, 브랜치 이름, main...my-feature 같은 범위까지요.

리뷰는 기본적으로 백그라운드 서브에이전트가 자기 컨텍스트에서 돌립니다. 내 대화를 차지하지 않고 끝나면 결과만 돌아옵니다.

레벨: 확신이냐 커버리지냐

/code-review high처럼 effort 레벨을 붙이면 리뷰 강도가 바뀝니다.

• low·medium: 가장 확신하는 발견만 보고. 오탐이 적음
• high·xhigh·max: 커버리지를 넓힘. 덜 확실한 발견까지 포함될 수 있음

레벨을 생략하면 마지막에 직접 입력했던 레벨을 재사용합니다. 화면에도 “지난번 입력한 high를 재사용한다”는 안내가 떠요.

찾기만 할지, 고치게 할지

• --fix: 리뷰가 끝나면 발견 사항을 작업 트리에 바로 적용
• --comment: 발견 사항을 PR 인라인 코멘트로 게시

--fix에는 주의점이 하나 있습니다. 백그라운드 리뷰의 수정은 세션 체크포인트 밖에서 일어나서 /rewind로 못 되돌립니다. 마음에 안 들면 git으로 되돌려야 해요.

ultra: 클라우드 멀티에이전트 리뷰

/code-review ultra는 검사 규모가 다릅니다. 클라우드에서 여러 에이전트가 병렬로 파고드는 ultrareview예요.

범위도 달라집니다. 현재 브랜치를 저장소 기본 브랜치와 비교하고, 미커밋 변경까지 포함합니다. /code-review ultra develop처럼 비교 기준 브랜치를 바꿀 수도 있어요.

공식 ultrareview 문서를 보면 claude.ai 계정 인증이 필요합니다. Pro·Max는 3회 무료로 돌려 볼 수 있고, 그 뒤로는 리뷰당 5~25달러 정도가 사용량 크레딧으로 빠져요.

대상이 github.com PR이면 결과를 내 계정 코멘트로 올리는 선택지가 실행 전 다이얼로그에 뜹니다. --post를 붙이면 그 항목이 미리 선택되고, 게시 여부는 그래도 한 번 더 물어봅니다(v2.1.227 이상).

일상 커밋엔 로컬 레벨로 충분하고, 릴리스 전 최종 점검처럼 무게 있는 순간에 ultra를 꺼내는 식의 분업이 자연스럽습니다. ultra를 못 쓰는 환경(Bedrock 등)에서는 이 명령이 조용히 로컬 리뷰로 대체 실행돼요.

형제 명령과의 구분

비슷한 이름이 둘 더 있습니다.

• /simplify: 버그 사냥 없이 정리·단순화만 하고 수정까지 적용하는 청소 전용
• /security-review: 변경분에서 보안 취약점만 집중 검사

버그를 찾고 싶으면 /code-review, 코드를 다듬고 싶으면 /simplify로 나눠 쓰면 됩니다.

리뷰 기준 길들이기

로컬 리뷰는 다른 세션처럼 CLAUDE.md의 프로젝트 룰을 따릅니다. 팀 컨벤션을 CLAUDE.md에 적어 두면 리뷰에도 반영돼요.

참고로 GitHub PR에 자동 리뷰를 붙이는 관리형 Code Review(Team·Enterprise 전용)도 있습니다. 그쪽은 REVIEW.md라는 리뷰 전용 파일로 기준을 조정하는데, 로컬 /code-review는 이 파일을 읽지 않습니다.

정리

커밋 전 습관으로는 /code-review면 충분합니다. 확신 위주로 보려면 low·medium, 넓게 훑으려면 high 이상을 쓰세요.

수정까지 맡기려면 --fix, 릴리스 전 정밀 검사는 ultra로 올립니다.

다음 편에서는 세션 상태를 들여다보는 진단 명령 묶음(/doctor·/context·/usage 등)을 다룹니다.

출처 및 확인 기준

• Claude Code 공식 문서 — Code Review (Anthropic, 2026-08-14 확인)
• Claude Code 공식 문서 — Ultrareview (Anthropic, 2026-08-14 확인)

이어서 읽기

Claude Code 시리즈

• 이전 편: [Claude Code #2] /plan 계획 모드, 수정 전에 설계부터 합의하기
• 이전 편: [Claude Code #1] /init, CLAUDE.md 자동 생성으로 시작하기

관련 주제

• [에이전트 설계 #1] 하네스 엔지니어링이란? 프롬프트 다음에 오는 것