SpyBara
Go Premium

code-review-local.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 29 additions and 29 deletions.

2026
Thu 15 23:58 Fri 16 22:59 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59 Tue 27 22:59

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

Claude Code 세션에서 /code-review를 실행하여 브랜치 변경 사항의 버그를 찾고, 리뷰 대상을 풀 리퀘스트나 경로로 지정하며, Claude가 수정 사항을 적용하도록 합니다.

/code-review는 작업 중인 세션의 Claude Code 프롬프트에 입력하는 명령입니다. Claude는 브랜치의 변경 사항을 리뷰하고, 정확성 버그를 찾아, 발견한 내용을 대화에 보고합니다. 모델과 effort 수준에 따라 리뷰는 재사용, 단순화, 효율성 정리 항목도 다룹니다.

이 명령은 모든 플랜에서 작동합니다. 리뷰는 사용자 자신의 세션에서 실행되므로, 세션의 나머지 작업과 동일한 방식으로 플랜 사용량 또는 API 청구에 포함됩니다.

[!NOTE]

GitHub에서 저장소의 모든 풀 리퀘스트를 자동으로 리뷰하려면 Owner가 조직에 대해 켜는 관리형 서비스인 Code Review를 참조하세요.

/review는 /code-review의 별칭입니다. v2.1.223 이전에는 /review가 GitHub 풀 리퀘스트에 대해 단일 패스, 읽기 전용 리뷰를 실행하는 별도의 명령이었습니다.

1. /code-review 실행

다음 명령을 실행합니다.

/code-review

대상을 지정하지 않으면 리뷰는 현재 브랜치의 변경 사항을 다룹니다. 대신 풀 리퀘스트, 다른 브랜치, 경로 또는 커밋 범위를 리뷰 대상으로 지정하려면 리뷰 대상 선택을 참조하세요.

플래그를 추가할 수도 있습니다.

  • --fix: 리뷰 후 발견 사항을 작업 트리에 적용하도록 Claude에 추가로 요청합니다. 수정 내용은 권한 모드를 거칩니다.
  • --comment: 발견 사항을 GitHub 풀 리퀘스트에는 인라인 댓글로, GitLab 병합 요청에는 단일 노트로 게시합니다

2. 작업 계속하기

리뷰는 자체 컨텍스트 윈도우를 가진 백그라운드 서브에이전트로 실행되므로 대화를 채우지 않습니다. 리뷰가 완료되면 발견 사항이 대화에 도착합니다.

3. 발견 사항에 대응하기

리뷰에서 발견한 내용을 수정하도록 Claude에 요청합니다. --fix 또는 --comment를 사용하면 Claude가 리뷰의 일부로 발견 사항을 적용하거나 게시하며, 수정 내용에 대한 승인을 요청받을 수 있습니다.

리뷰 대상 선택

현재 브랜치가 아닌 다른 대상을 리뷰하려면 effort 수준과 플래그 뒤에 대상을 입력합니다. Claude는 해당 텍스트를 리뷰 대상으로 받습니다. 대상은 풀 리퀘스트 번호, 브랜치 이름, 파일 경로 또는 Git 리비전 범위일 수 있습니다. 첫 번째 열에서 리뷰하려는 항목을 찾아 두 번째 열에 표시된 내용을 입력하세요.

리뷰 대상 입력
현재 브랜치와 커밋되지 않은 변경 사항 /code-review
최근 15개 커밋 /code-review HEAD~15..HEAD
한 브랜치와 다른 브랜치 비교 /code-review main...my-feature
단일 커밋(abc1234는 커밋 해시) /code-review abc1234^..abc1234
번호로 지정한 풀 리퀘스트 /code-review 1234
파일 또는 디렉터리 경로 /code-review src/auth

대상을 지정하지 않으면 /code-review는 업스트림 브랜치보다 앞선 브랜치의 커밋과 커밋되지 않은 변경 사항을 리뷰합니다. 브랜치에 업스트림이 없으면 Claude는 main 또는 이전 커밋과 비교합니다.

ultra를 사용하면 Claude Code는 effort 수준과 플래그 뒤의 텍스트에서 설명하는 대로 대상을 다르게 해석합니다.

리뷰가 읽고 수정하는 항목

리뷰를 실행하기 전에, 특히 --fix를 사용할 때는 다음 사항을 확인하세요.

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

발견 사항 보고 방식

다음 두 가지 실행에서는 Claude가 발견 사항을 응답의 텍스트로 보고합니다.

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

데스크톱 앱처럼 발견 사항 목록을 요청하는 호스트 애플리케이션에서는 Claude가 대신 ReportFindings 도구를 통해 리뷰의 발견 사항을 보고합니다. 보고서는 발견 사항 목록으로 표시되며, 각 항목에는 파일 위치, 한 문장 요약, 그리고 발견 사항에 카테고리 태그가 있는 경우 correctness 같은 카테고리 태그가 표시됩니다. 호스트 요청은 모든 effort 수준에 적용되며 Claude Code v2.1.218 이상이 필요합니다.

세션 후반에 Claude가 보고된 발견 사항을 수정하면 이를 다시 보고합니다. 그러면 Claude Code는 업데이트된 발견 사항 목록에서 각 발견 사항을 수정됨, 건너뜀 또는 변경 불필요로 표시합니다.

effort 및 인수 조정

--fix 및 --comment 외에도 이 명령은 다음 플래그를 받습니다.

  • --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 이상이 필요합니다.

effort 수준을 전달하여 범위와 확신도 사이의 균형을 조정합니다. low에서는 리뷰가 가장 확신하는 발견 사항을 보고하므로 오탐이 줄어듭니다. medium부터 max까지는 리뷰의 범위가 넓어집니다.

수준을 입력하지 않으면 리뷰는 이전 세션에서 입력한 것이라도 마지막으로 입력한 low~max 수준을 재사용합니다. Claude Code는 Reusing high effort, the level you typed last time과 같은 알림을 표시합니다. 다음 규칙에 따라 실행에 사용할 수준이 결정됩니다.

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

v2.1.223 이전에는 수준 없이 실행한 /code-review가 항상 세션의 현재 effort를 사용했습니다.

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

GitLab 병합 요청에 --comment를 전달하면 Claude Code는 GitLab의 glab CLI를 통해 발견 사항을 게시합니다. Claude Code v2.1.257 이상이 필요합니다. glab이 설치되어 있지 않으면 Claude는 대신 터미널에 발견 사항을 출력합니다.

병합 요청은 URL 또는 !123 참조 형식으로 전달합니다. Claude Code는 체크아웃의 origin이 gitlab.com에 있을 때만 단순 번호나 브랜치 이름을 병합 요청으로 처리합니다. 자체 관리형 GitLab 인스턴스에서는 URL 또는 !123 형식을 전달하세요.

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

effort 수준과 플래그 뒤에서 Claude Code는 줄의 나머지 부분을 리뷰 대상으로 읽습니다. ultra 인수는 이 해석 방식을 변경합니다.

  • 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를 다시 실행합니다

v2.1.218 이전에는 리뷰가 대화 내부에서 실행되었습니다.

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

Claude는 사용자가 명령을 입력하지 않아도 스스로 /code-review를 시작할 수 있습니다.

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

세션 범위 예약 작업은 클라우드 리뷰를 시작하지 않으므로 ultra 인수 없이 /code-review를 예약하세요.

/code-review를 직접 입력할 수 있도록 유지하면서 Claude와 예약 작업 모두 리뷰를 시작하지 못하게 하려면 ~/.claude/settings.json 같은 설정 파일에 skillOverrides 항목을 추가합니다.

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

v2.1.246 이전에는 Anthropic에서 가져온 기능 플래그가 켜져 있는 경우에만 Claude가 스스로 /code-review를 시작했습니다. 기능 플래그를 가져오지 않는 세션에서는 /code-review가 사용자가 입력한 경우에만 실행되었으며, 예약된 /code-review는 일반 텍스트로 Claude에 전달되었습니다.

ultrareview로 확장

/code-review ultra --fix는 클라우드에서 더 심층적인 ultrareview를 실행한 다음, 발견 사항이 세션에 도착하면 이를 작업 트리에 적용하도록 Claude에 요청합니다.

Ultrareview는 자체 범위를 사용합니다.

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

대상이 github.com 풀 리퀘스트인 경우, Claude가 사용자의 GitHub 계정으로 완료된 발견 사항을 PR에 댓글로 게시하도록 할 수 있습니다. Claude Code v2.1.227 이상이 필요합니다.

[!NOTE]

Ultrareview는 claude.ai 계정을 통한 인증이 필요합니다. Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없으며, Zero Data Retention이 활성화되어 있거나 HIPAA 구성이 적용된 조직에서도 사용할 수 없습니다. 이러한 경우 /code-review ultra는 대신 세션에서 로컬 리뷰를 실행합니다. 고객 관리형 암호화 키(CMEK)를 사용하는 조직은 ultrareview를 실행할 수 없습니다. 변경 사항을 로컬에서 리뷰하려면 /code-review를 실행하세요.

스크립트나 CI 작업에서 클라우드 리뷰를 실행하려면 발견 사항을 기다린 후 stdout에 출력하는 claude ultrareview 하위 명령을 사용하세요.

리뷰 변경 또는 확장

/code-review는 번들 스킬입니다. 지침이 Claude Code에 내장되어 있으므로 디스크에 열거나 편집할 SKILL.md 파일이 없습니다. 모든 리뷰에 프로젝트 규칙을 적용하려면 CLAUDE.md에 규칙을 추가하세요. 더 나아가려면 다음 페이지 중 하나에서 시작하세요.

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

이 명령은 v2.1.147 이전에는 /simplify라는 이름이었으며, 당시에는 기본적으로 수정 사항을 적용했습니다. 버그 찾기를 위해 /simplify를 스크립트로 사용했다면 /code-review --fix로 전환하세요.

관련 리소스

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