Cmd. /code-review
현재 diff의 correctness bug를 찾고 모델·effort에 따라 정리 항목도 검토하는 코드 리뷰 명령
핵심 요약
- diff·PR·branch·path 코드 리뷰 (skill)
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
diff·PR·branch·path 코드 리뷰 (skill)
/code-review [low|medium|high|xhigh|max|ultra] [--fix] [--comment] [pr#|branch|path]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 번들 스킬 |
| 상태 | 현재 공식 표 |
| 별칭 | /review |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/code-review high# 마지막으로 명시한 review effort를 재사용해 현재 diff 리뷰
/code-review# 강도를 높여 위험한 변경을 집중 검토
/code-review high# 리뷰 결과를 워킹 트리에 바로 적용
/code-review --fix# 결과를 GitHub PR 인라인 코멘트로 게시
/code-review --comment# 클라우드 다중 에이전트 리뷰 후 결과를 워킹 트리에 적용
/code-review ultra --fix# 특정 경로 또는 PR만 대상으로 리뷰
/code-review high src/auth선택 시점
- 구현 직후 correctness bug와 정리 항목을 한 번에 점검하고 싶을 때
high~maxeffort로 위험한 변경을 더 넓고 깊게 검토할 때--comment로 PR에 인라인 GitHub 코멘트를 남겨 리뷰 흐름에 녹일 때--fix로 검토 결과를 워킹 트리에 즉시 반영해 수정 왕복을 줄일 때ultra로 전체 코드베이스 맥락을 보는 클라우드 다중 에이전트 리뷰가 필요할 때
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/code-review | correctness bug 탐지, 모델·effort에 따라 cleanup 포함 | 버그 탐지 + 정리 |
/simplify | v2.1.154부터 cleanup-only, 버그는 찾지 않음 (번들 스킬) | 코드 정리만 |
/security-review | 보안 취약점 중심 | injection, auth, data exposure 확인 |
/review | /code-review의 별칭, 같은 인자·옵션 지원 | 동일한 리뷰 흐름 사용 |
/ultrareview | /code-review ultra의 alias, 클라우드 다중 에이전트 | 깊은 클라우드 리뷰 |
실행 결과와 유지 범위
현재 diff 또는 지정한 대상을 검토합니다. --fix는 수정 적용, --comment는 댓글 게시를 요청하므로 결과 범위가 달라집니다.
/code-review는 현재 diff의 correctness bug를 찾습니다. cleanup 검토가 함께 수행되는지는 모델과 effort 레벨에 따라 다릅니다. 공식 문서상 번들 스킬(bundled skill) 로 제공됩니다.
--fix: 리뷰 결과(findings)를 워킹 트리(working tree)에 적용합니다.--comment: 리뷰 결과를 GitHub PR의 인라인(inline) 코멘트로 게시합니다.ultra: 클라우드 샌드박스에서 다중 에이전트(multi-agent)로 더 깊게 분석하는 ultrareview를 실행합니다.
effort 인자(low|medium|high|xhigh|max)로 검토 강도를 조절하고, 생략하면 마지막으로 직접 지정한 low~max를 재사용합니다. 세부 fallback은 공식 Code Review 문서의 effort 선택 규칙을 확인하세요. target 자리에는 경로(path)나 PR 참조를 넘겨 현재 diff 대신 특정 대상만 리뷰합니다.
이 명령은 과거 /simplify라는 이름이었습니다. v2.1.147 이전에는 /simplify로 불리며 기본적으로 수정을 적용했습니다. v2.1.154부터 /simplify는 버그를 찾지 않고 정리(cleanup)만 적용하는 별도의 cleanup-only 리뷰로 분리됐습니다. 버그를 탐지하려면 /code-review(또는 /code-review --fix)를 쓰세요.
깊은 클라우드 리뷰의 권장 호출은 /code-review ultra이며, 기존 /ultrareview는 alias로 남아 있습니다.
리뷰 실행
별도 tuned 설정이 없는 모델의 /code-review는 많은 review subagent 대신 간결한 inline prompt를 사용합니다(v2.1.274). claude -p 등 확인을 받을 수 없는 실행은 base branch·shared history가 없을 때 전체 저장소 리뷰를 거절합니다. 사용자가 직접 실행한 claude ultrareview는 전체 저장소 fallback 동의로 취급하지만, Claude가 도구로 대신 실행한 경우에는 거절합니다. 첫 커밋 리뷰는 대화형 확인이 필요합니다(v2.1.277).
주의사항
- 버그 탐지에는
/code-review(필요 시/code-review --fix)를 사용하세요. v2.1.154부터/simplify는 버그를 찾지 않습니다. 예전에/simplify로 버그 탐지를 스크립트화했다면/code-review --fix로 전환하세요. - 낮은 effort는 적지만 확신도 높은 findings를,
high~max는 더 넓은 커버리지(불확실한 항목 포함)를 반환합니다. - 리뷰 결과는 findings 우선으로 받더라도 실제 merge 전에 diff와 테스트를 직접 확인하세요.
- 자동으로 실행될 것을 기대하지 말고 구현 완료 시 명시적으로
/code-review를 호출하세요. 실행 중에도 메인 대화는 계속 사용할 수 있습니다. ultra(ultrareview) 경로는 클라우드 샌드박스에서 실행되며 플랜·usage credits·권한 정책의 영향을 받습니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록