Cmd. /code-review

명령어 원본 선언

/code-review [low|medium|high|xhigh|max|ultra] [--fix] [--comment] [target]

공식 설명 요약

/code-review는 현재 diff를 리뷰해 correctness bug와 함께 재사용(reuse)·단순화(simplification)·효율(efficiency) 정리(cleanup) 항목을 찾아주는 명령입니다. 공식 문서상 번들 스킬(bundled skill) 로 제공됩니다.

• --fix: 리뷰 결과(findings)를 워킹 트리(working tree)에 적용합니다.
• --comment: 리뷰 결과를 GitHub PR의 인라인(inline) 코멘트로 게시합니다.
• ultra: 클라우드 샌드박스에서 다중 에이전트(multi-agent)로 더 깊게 분석하는 ultrareview를 실행합니다.

effort 인자(low|medium|high|xhigh|max)로 검토 강도를 조절하고, 생략하면 현재 세션의 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로 남아 있습니다.

최소 지원 버전

• v2.1.147 이전: 이 명령은 /simplify라는 이름이었고 기본적으로 수정을 적용
• v2.1.151+: 로컬 /code-review가 correctness bug와 reuse/simplification/efficiency 정리를 함께 리포트
• v2.1.154+: /simplify가 cleanup-only 리뷰로 분리되어 /code-review와 역할 구분 확정

(공식 문서의 min-version 주석을 기준으로 한 값입니다.)

사용법

# 현재 세션 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

좋은 사용 예

1. 구현 직후 correctness bug와 정리 항목을 한 번에 점검하고 싶을 때
2. high~max effort로 위험한 변경을 더 넓고 깊게 검토할 때
3. --comment로 PR에 인라인 GitHub 코멘트를 남겨 리뷰 흐름에 녹일 때
4. --fix로 검토 결과를 워킹 트리에 즉시 반영해 수정 왕복을 줄일 때
5. ultra로 전체 코드베이스 맥락을 보는 클라우드 다중 에이전트 리뷰가 필요할 때

비슷한 명령어 추천

활용 사례

• 머지 전 마지막 점검: /diff로 변경을 확인한 뒤 /code-review로 버그·정리 항목을 함께 점검하고, 필요하면 --fix로 적용합니다.
• PR 협업: --comment로 인라인 코멘트를 게시해 팀 리뷰 워크플로에 자연스럽게 끼워 넣습니다.
• 고위험 변경: effort를 high~max로 올려 커버리지를 넓힙니다(불확실한 findings가 포함될 수 있음).
• 대규모/전체 맥락 검토: /code-review ultra로 클라우드 다중 에이전트 리뷰를 돌립니다. ultrareview는 Pro·Max에서 3회 무료, 이후에는 usage credits가 필요합니다.

주의사항

• 버그 탐지에는 /code-review(필요 시 /code-review --fix)를 사용하세요. v2.1.154부터 /simplify는 버그를 찾지 않습니다. 예전에 /simplify로 버그 탐지를 스크립트화했다면 /code-review --fix로 전환하세요.
• 낮은 effort는 적지만 확신도 높은 findings를, high~max는 더 넓은 커버리지(불확실한 항목 포함)를 반환합니다.
• 리뷰 결과는 findings 우선으로 받더라도 실제 merge 전에 diff와 테스트를 직접 확인하세요.
• ultra(ultrareview) 경로는 클라우드 샌드박스에서 실행되며 플랜·usage credits·권한 정책의 영향을 받습니다.

출처

• Commands: https://code.claude.com/docs/en/commands
• Code Review (Review a diff locally): https://code.claude.com/docs/en/code-review