/code-review로 로컬에서 리뷰하기

/code-review

​

리뷰 대상 선택

​

리뷰가 읽고 수정하는 항목

• 수정: --fix 없이 실행하면 리뷰 지침은 Claude에 보고서만 요청합니다. --fix를 사용하면 발견 사항을 작업 트리에 적용하도록 추가로 요청합니다. 어느 경우든 모든 수정은 권한 모드를 거칩니다.
• 되감기: 백그라운드 리뷰는 --fix 수정 내용을 세션의 체크포인트 밖에서 적용합니다. 이후 /rewind는 Claude가 대화에서 이미 수정한 파일만 복원합니다. 다른 파일에 대한 리뷰의 수정 내용은 그대로 남으므로 git을 사용해 되돌리세요. 리뷰가 포그라운드에서 실행되면 사용자 자신의 턴 동안 작업 트리를 수정하므로 /rewind가 평소처럼 해당 수정 내용을 복원합니다.
• 지침: 리뷰는 비대화형 -p 실행을 포함하여 CLAUDE.md를 따릅니다. REVIEW.md는 읽지 않습니다. 이 파일은 GitHub 풀 리퀘스트에 대한 관리형 Code Review 서비스를 구성합니다.

​

발견 사항 보고 방식

• /code-review가 리뷰를 분기된 서브에이전트로 실행하는 터미널 세션
• 텍스트 또는 JSON 출력을 사용하는 -p 실행

​

effort 및 인수 조정

• --post: github.com 풀 리퀘스트에 대한 ultra 클라우드 리뷰에서, 실행 대화 상자에 완료된 발견 사항을 PR에 게시하는 옵션을 미리 선택합니다. 풀 리퀘스트에 발견 사항 게시를 참조하세요. Claude Code v2.1.227 이상이 필요합니다.
• --max-findings <n>, --max-findings all 또는 --max-findings default: 리뷰의 일반적인 제한 대신 최대 n개의 발견 사항을 보고하거나, all을 사용하면 모든 발견 사항을 보고합니다. 리뷰가 발견 사항 도구를 통해 보고하는 경우 제한은 32개입니다. 이후 리뷰는 --max-findings default를 전달할 때까지 입력한 값을 재사용하지만, 비대화형 -p 실행에서 전달한 값은 기억되지 않습니다. Claude Code v2.1.288 이상이 필요합니다.

• 수준 입력: /code-review high처럼 입력한 수준은 이후 실행에서 재사용하는 값을 변경합니다
• 비대화형 실행: 비대화형 -p 실행에서 전달한 수준은 기억된 수준을 업데이트하지 않습니다
• ultra: 리뷰는 기억된 수준을 사용하지도 업데이트하지도 않습니다
• 수준을 입력한 적 없음: 리뷰는 세션의 현재 effort를 사용합니다

​

GitLab 병합 요청에 발견 사항 게시

​

effort 수준과 플래그 뒤의 텍스트

• ultra 사용 시: Claude Code는 단일 단어를 기본 브랜치 또는 PR 번호로 읽습니다. 브랜치나 PR을 지정하지 않는 더 긴 텍스트는 리뷰에 첨부되는 메모가 됩니다. /code-review ultra check my auth changes는 현재 브랜치를 리뷰하며, Claude는 발견 사항을 메모와 연관 지어 설명합니다.
• ultra 미사용 시: 남은 모든 내용은 다른 명령 이름으로 시작하더라도 리뷰 대상이 됩니다. /code-review /fix-issue 123은 /fix-issue를 두 번째 스택 스킬로 로드하는 대신 /fix-issue 123을 대상 텍스트로 하여 리뷰합니다. v2.1.218 이전에는 /code-review 뒤에 스택된 명령이 자체 스킬로 확장되었습니다.

​

포그라운드에서 실행

• -p 플래그 또는 Agent SDK를 사용하여 비대화형 모드로 실행합니다. Claude Code는 리뷰를 기다린 후 응답에 발견 사항을 포함합니다. 단, ultra는 클라우드 리뷰를 기다리지 않습니다.
• CLAUDE_CODE_DISABLE_BACKGROUND_TASKS를 1로 설정합니다. 이 설정은 다른 모든 백그라운드 작업 기능도 끕니다
• 이전 리뷰가 아직 진행 중일 때 /code-review를 다시 실행합니다

​

Claude가 리뷰를 시작하도록 하기

• 일반 언어로 요청할 때: Claude에 변경 사항을 리뷰해 달라고 요청하면 Claude가 스킬을 실행할 수 있습니다
• 예약 작업에서: /code-review를 프롬프트로 사용하는 예약 작업이 리뷰를 실행합니다

{
  "skillOverrides": {
    "code-review": "user-invocable-only"
  }
}

​

ultrareview로 확장

• 비교 대상: 현재 브랜치와 저장소의 기본 브랜치를 비교하며, 작업 트리의 커밋되지 않은 변경 사항과 스테이징된 변경 사항도 포함합니다
• 민감한 파일: .env 및 *.tfvars 파일처럼 자격 증명이나 키와 같은 이름을 가진 파일의 커밋되지 않은 변경 사항에 대해서는 Claude Code가 로컬 저장소를 클라우드 세션에 업로드하는 규칙을 따릅니다
• 다른 기준: /code-review ultra develop처럼 브랜치 이름을 전달하여 다른 기준과 비교합니다

​

리뷰 변경 또는 확장

• 명령 대체: code-review라는 이름의 프로젝트 또는 개인 스킬이 번들 스킬 대신 실행되며, /review 별칭은 계속 번들 리뷰를 실행합니다. 같은 이름을 공유하는 스킬 해결을 참조하세요.
• 자체 리뷰어 만들기: 리뷰어 서브에이전트 또는 리뷰 스킬을 작성합니다
• 인접 명령 사용: /simplify는 정리 목적으로만 리뷰하고 수정 사항을 적용하며, /verify는 앱을 실행하여 변경 사항이 작동하는지 확인합니다

​

관련 리소스

• Code Review: 조직의 GitHub 모든 풀 리퀘스트를 리뷰하는 관리형 서비스
• Ultrareview: 더 심층적인 클라우드 리뷰의 설정, 제한 및 비용
• 명령: /code-review, /review, /simplify, /verify에 대한 한 줄 참조
• 스킬: 번들 스킬의 작동 방식과 직접 스킬을 작성하는 방법