Code Review

다중 에이전트 분석을 통해 전체 코드베이스를 검토하여 논리 오류, 보안 취약점 및 회귀를 감지하는 자동화된 PR 검토를 설정합니다

Code Review는 GitHub 풀 요청을 분석하고 문제를 발견한 코드 라인에 인라인 댓글로 결과를 게시합니다. 전문화된 에이전트 집합이 전체 코드베이스의 맥락에서 코드 변경 사항을 검토하여 논리 오류, 보안 취약점, 손상된 엣지 케이스 및 미묘한 회귀를 찾습니다.

결과는 심각도별로 태그가 지정되며 PR을 승인하거나 차단하지 않으므로 기존 검토 워크플로우는 그대로 유지됩니다. 리포지토리에 CLAUDE.md 또는 REVIEW.md 파일을 추가하여 Claude가 플래그하는 항목을 조정할 수 있습니다.

관리되는 서비스 대신 자신의 CI 인프라에서 Claude를 실행하려면 GitHub Actions 또는 GitLab CI/CD를 참조하십시오. 자체 호스팅 GitHub 인스턴스의 리포지토리의 경우 GitHub Enterprise Server를 참조하십시오.

이 페이지에서 다루는 내용:

• 검토 작동 방식
• 설정
• @claude review 및 @claude review always를 사용한 수동 검토 트리거
• CLAUDE.md 및 REVIEW.md를 사용한 검토 사용자 정의
• 가격
• 실패한 실행 및 누락된 댓글 문제 해결
• 로컬에서 diff 검토 - /code-review 명령 사용

검토 작동 방식

관리자가 조직에 대해 Code Review를 활성화하면 리포지토리의 구성된 동작에 따라 PR이 열릴 때, 모든 푸시 시 또는 수동으로 요청할 때 검토가 트리거됩니다. PR에서 @claude review를 댓글로 작성하면 모든 모드에서 검토가 시작됩니다.

검토가 실행되면 여러 에이전트가 Anthropic 인프라에서 병렬로 diff 및 주변 코드를 분석합니다. 각 에이전트는 다른 클래스의 문제를 찾고, 검증 단계에서 후보를 실제 코드 동작과 비교하여 거짓 양성을 필터링합니다. 결과는 중복 제거되고 심각도별로 순위가 지정되며 문제가 발견된 특정 라인에 인라인 댓글로 게시됩니다. 문제가 발견되지 않으면 Code Review는 GitHub 확인 실행을 업데이트하여 문제가 감지되지 않았음을 표시합니다. Claude는 또한 PR에 짧은 확인 댓글을 게시할 수 있습니다.

검토는 PR 크기 및 복잡도에 따라 비용이 증가하며 평균 20분 내에 완료됩니다. 관리자는 분석 대시보드를 통해 검토 활동 및 지출을 모니터링할 수 있습니다.

심각도 수준

각 결과는 심각도 수준으로 태그가 지정됩니다:

결과에는 확장 가능한 확장 추론 섹션이 포함되어 있으므로 Claude가 문제를 플래그한 이유와 문제를 검증한 방법을 이해할 수 있습니다.

결과에 대한 평가 및 응답

Claude의 각 검토 댓글은 이미 👍 및 👎가 첨부되어 있으므로 두 버튼 모두 GitHub UI에 나타나 한 번의 클릭으로 평가할 수 있습니다. 결과가 유용했으면 👍을 클릭하고 잘못되었거나 노이즈가 많으면 👎를 클릭합니다. Anthropic은 PR이 병합된 후 반응 개수를 수집하고 이를 사용하여 검토자를 조정합니다. 반응은 재검토를 트리거하거나 PR의 어떤 것도 변경하지 않습니다.

인라인 댓글에 응답해도 Claude가 응답하거나 PR을 업데이트하도록 프롬프트하지 않습니다. 결과에 대해 조치하려면 코드를 수정하고 푸시합니다. PR이 푸시 트리거 검토에 구독되어 있으면 다음 실행이 문제가 수정되었을 때 스레드를 해결합니다. 푸시하지 않고 새로운 검토를 요청하려면 최상위 PR 댓글로 @claude review를 댓글로 작성합니다.

결과를 코드 변경 없이 해제하려면 해당 스레드를 해결합니다. 응답하는 것은 해제하지 않습니다.

확인 실행 출력

인라인 검토 댓글 외에도 각 검토는 CI 확인과 함께 나타나는 Claude Code Review 확인 실행을 채웁니다. Details 링크를 확장하여 심각도별로 정렬된 모든 결과의 요약을 한 곳에서 확인합니다:

각 결과는 Files changed 탭의 주석으로도 나타나며 관련 diff 라인에 직접 표시됩니다. Important 결과는 빨간색 마커로 렌더링되고, nit은 노란색 경고로, 기존 버그는 회색 공지로 렌더링됩니다. 주석과 심각도 테이블은 인라인 검토 댓글과 독립적으로 확인 실행에 기록되므로 GitHub가 이동한 라인의 인라인 댓글을 거부하더라도 사용 가능한 상태로 유지됩니다.

확인 실행은 항상 중립적인 결론으로 완료되므로 분기 보호 규칙을 통해 병합을 차단하지 않습니다. Code Review 결과에 따라 병합을 제어하려면 자신의 CI에서 확인 실행 출력에서 심각도 분석을 읽으십시오. Details 텍스트의 마지막 라인은 워크플로우가 gh 및 jq로 구문 분석할 수 있는 기계 판독 가능한 댓글입니다. 확인 실행 ID를 찾으려면 커밋의 확인 실행을 gh api repos/OWNER/REPO/commits/<commit-sha>/check-runs --jq '.check_runs[] | {id, name}'로 나열하고 Claude Code Review 실행의 id를 가져옵니다. OWNER, REPO, CHECK_RUN_ID를 리포지토리 소유자, 리포지토리 이름, 해당 ID로 바꿉니다:

gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \
  --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'

이는 심각도별 개수가 포함된 JSON 객체를 반환합니다(예: {"normal": 2, "nit": 1, "pre_existing": 0}). normal 키는 Important 결과의 개수를 보유합니다. 0이 아닌 값은 Claude가 병합 전에 수정할 가치가 있는 버그를 발견했음을 의미합니다.

Code Review가 확인하는 항목

기본적으로 Code Review는 정확성에 중점을 두고 있습니다: 형식 기본 설정이나 누락된 테스트 범위가 아닌 프로덕션을 중단할 버그입니다. 리포지토리에 지침 파일을 추가하여 확인하는 항목을 확장할 수 있습니다.

Code Review 설정

관리자는 조직에 대해 한 번 Code Review를 활성화하고 포함할 리포지토리를 선택합니다.

리포지토리 테이블은 최근 활동을 기반으로 각 리포지토리의 평균 검토 비용도 표시합니다. 행 작업 메뉴를 사용하여 리포지토리별로 Code Review를 켜거나 끄거나 리포지토리를 완전히 제거할 수 있습니다.

설정을 확인하려면 테스트 PR을 열어보십시오. 자동 트리거를 선택한 경우 Claude Code Review라는 확인 실행이 몇 분 내에 나타납니다. 수동을 선택한 경우 PR에서 @claude review를 댓글로 작성하여 첫 번째 검토를 시작합니다. 확인 실행이 나타나지 않으면 리포지토리가 관리자 설정에 나열되어 있고 Claude GitHub 앱이 액세스할 수 있는지 확인하십시오.

수동으로 검토 트리거

댓글 명령은 요청 시 검토를 시작합니다. 이들은 리포지토리의 구성된 트리거와 관계없이 작동하므로 수동 모드에서 특정 PR을 검토에 옵트인하거나 다른 모드에서 즉시 재검토를 받을 수 있습니다.

수동 모드로 설정된 리포지토리의 높은 우선순위 PR과 같이 PR에 대한 모든 후속 푸시가 새로운 검토를 시작하기를 원할 때 @claude review always를 사용합니다. 기본 명령이 PR을 구독하지 않으므로 이후 푸시가 검토를 트리거하는지 여부를 변경하지 않고 일회성 두 번째 의견을 요청할 수 있습니다.

이러한 명령 중 하나가 검토를 트리거하려면:

• 최상위 PR 댓글로 게시하고 diff 라인의 인라인 댓글로는 게시하지 않습니다
• 댓글의 시작 부분에 명령을 입력하고, once 또는 always를 명령의 나머지 부분과 같은 라인에 입력합니다
• 리포지토리에 대한 쓰기, 유지 관리 또는 관리자 권한이 있어야 합니다
• PR은 열려 있어야 합니다

리포지토리가 조직에 속하고 해당 조직의 멤버십이 비공개인 경우(GitHub의 기본값), GitHub는 Claude에게 사용자를 멤버로 식별하지 않습니다. Claude는 여전히 댓글에 👀로 반응할 수 있지만 팀이나 조직의 기본 권한이 쓰기 액세스를 제공하더라도 리포지토리에 협력자로 직접 추가되지 않으면 검토를 시작하지 않습니다. 이를 해결하려면 조직 멤버십을 공개로 설정하거나 리포지토리 관리자에게 협력자로 리포지토리에 추가해 달라고 요청하세요.

자동 트리거와 달리 수동 트리거는 명시적 요청이 초안 상태와 관계없이 지금 검토를 원한다는 신호이므로 초안 PR에서 실행됩니다.

해당 PR에서 검토가 이미 실행 중인 경우 요청은 진행 중인 검토가 완료될 때까지 대기열에 추가됩니다. PR의 확인 실행을 통해 진행 상황을 모니터링할 수 있습니다.

포크에서 풀 요청 검토

Claude는 리포지토리의 검토 동작 설정과 관계없이 포크의 풀 요청을 자동으로 검토하지 않습니다. 검토를 시작하려면 풀 요청에 @claude review를 댓글로 작성하세요. 댓글 명령의 요구 사항은 여전히 적용되며 필요한 쓰기 액세스는 포크가 아닌 기본 리포지토리에 대한 것입니다.

포크 풀 요청의 다른 검토를 받으려면 새로운 @claude review 댓글을 게시하세요. @claude review always도 작동하지만 나중의 푸시에 대한 검토에 풀 요청을 구독하지 않습니다. 댓글 명령 외에는 포크 풀 요청에 대한 검토를 시작하지 않습니다:

• 확인 실행에서 다시 실행을 클릭해도 검토를 시작하지 않습니다
• 새 커밋을 푸시해도 검토를 시작하지 않습니다. 모든 푸시 후로 설정된 리포지토리에서도 마찬가지입니다

검토 사용자 정의

Code Review는 리포지토리에서 두 개의 파일을 읽어 플래그할 항목을 안내합니다. 이들은 검토에 영향을 미치는 강도가 다릅니다:

• CLAUDE.md: Claude Code가 검토뿐만 아니라 모든 작업에 사용하는 공유 프로젝트 지침입니다. Code Review는 이를 프로젝트 컨텍스트로 읽고 새로 도입된 위반을 nit으로 플래그합니다.
• REVIEW.md: 검토 전용 지침으로 검토 파이프라인의 에이전트가 결과를 찾고 검증하며 에이전트가 결과를 순위 지정하고 보고할 때 참조합니다. 이를 사용하여 팀이 플래그하려는 항목, 심각도 및 결과 보고 방식을 지정합니다.

CLAUDE.md

Code Review는 리포지토리의 CLAUDE.md 파일을 읽고 새로 도입된 위반을 nit 수준 결과로 처리합니다. 이는 양방향으로 작동합니다: PR이 CLAUDE.md 문을 오래된 것으로 만드는 방식으로 코드를 변경하면 Claude는 문서도 업데이트해야 한다고 플래그합니다.

Claude는 디렉토리 계층 구조의 모든 수준에서 CLAUDE.md 파일을 읽으므로 하위 디렉토리의 CLAUDE.md의 규칙은 해당 경로 아래의 파일에만 적용됩니다. CLAUDE.md 작동 방식에 대한 자세한 내용은 메모리 설명서를 참조하십시오.

일반 Claude Code 세션에 적용하지 않으려는 검토 전용 지침의 경우 대신 REVIEW.md를 사용하십시오.

REVIEW\.md

REVIEW.md는 리포지토리 루트의 파일로 Code Review를 리포지토리에 맞게 조정합니다. 검토 파이프라인에서 결과를 찾고 검증하는 에이전트는 Code Review의 기본 검토 지침과 함께 리포지토리의 검토 지침으로 그 내용을 받으며, 결과를 순위 지정하고 보고하는 에이전트는 심각도를 결정하고 검토를 작성하기 전에 이를 참조합니다.

REVIEW.md에 적용하려는 규칙을 직접 입력합니다.

조정할 수 있는 항목

REVIEW.md는 자유 형식 마크다운이므로 검토 지침으로 표현할 수 있는 모든 것이 범위 내입니다. 아래 패턴은 실제로 가장 큰 영향을 미칩니다.

심각도: 리포지토리에 대해 🔴 Important가 의미하는 바를 재정의합니다. 기본 보정은 프로덕션 코드를 대상으로 합니다. 문서 리포지토리, 구성 리포지토리 또는 프로토타입은 훨씬 더 좁은 정의를 원할 수 있습니다. Important인 결과 클래스와 최대 Nit인 결과 클래스를 명시적으로 명시합니다. 다른 방향으로도 확대할 수 있습니다. 예를 들어 기본 nit이 아닌 Important로 CLAUDE.md 위반을 처리합니다.

Nit 볼륨: 단일 검토가 게시하는 🟡 Nit 댓글의 수를 제한합니다. 산문 및 구성 파일은 영원히 다듬어질 수 있습니다. "최대 5개의 nit을 보고하고 나머지를 요약에 개수로 언급"과 같은 제한은 검토를 실행 가능하게 유지합니다.

규칙 건너뛰기: Claude가 결과를 게시하지 않아야 하는 경로, 분기 패턴 및 결과 카테고리를 나열합니다. 일반적인 후보는 생성된 코드, lockfile, 공급된 종속성 및 기계 작성 분기이며, linting 또는 맞춤법 검사와 같이 CI가 이미 적용하는 모든 것입니다. 완전한 정밀 검사를 보장하지 않지만 일부 검토를 보장하는 경로의 경우 완전히 건너뛰는 대신 더 높은 기준을 설정합니다: "scripts/에서는 거의 확실하고 심각한 경우에만 보고합니다."

리포지토리별 확인: 모든 PR에서 플래그하려는 규칙을 추가합니다. 예: "새 API 경로에는 통합 테스트가 있어야 합니다." REVIEW.md가 모든 결과 찾기 및 검증 에이전트에 직접 도달하기 때문에 이들은 긴 CLAUDE.md의 동일한 규칙보다 더 안정적으로 도착합니다.

검증 기준: 결과 클래스가 게시되기 전에 증거를 요구합니다. 예를 들어 "동작 주장은 명명에서의 추론이 아닌 소스의 file:line 인용이 필요합니다"는 그렇지 않으면 작성자에게 왕복을 비용으로 하는 거짓 양성을 줄입니다.

재검토 수렴: PR이 이미 검토되었을 때 Claude가 어떻게 작동해야 하는지 알려줍니다. "첫 번째 검토 후 새로운 nit을 억제하고 Important 결과만 게시"와 같은 규칙은 한 줄 수정이 스타일만으로 7라운드에 도달하는 것을 방지합니다.

요약 형태: 검토 본문이 2 factual, 4 style과 같은 한 줄 집계로 시작하도록 요청하고 그것이 경우일 때 "factual 문제 없음"으로 시작하도록 요청합니다. 작성자는 세부 사항 전에 작업의 형태를 알고 싶어합니다.

예시

이 REVIEW.md는 백엔드 서비스의 심각도를 재보정하고, nit을 제한하고, 생성된 파일을 건너뛰고, 리포지토리별 확인을 추가합니다.

# 검토 지침

## Important가 여기서 의미하는 바

동작을 중단하거나 데이터를 유출하거나 롤백을 차단할 결과에 대해 Important를 예약합니다: 잘못된 논리, 범위가 지정되지 않은 데이터베이스 쿼리, 로그 또는 오류 메시지의 PII, 그리고 역호환되지 않는 마이그레이션입니다. 스타일, 명명 및 리팩토링 제안은 최대 Nit입니다.

## Nit 제한

검토당 최대 5개의 Nit을 보고합니다. 더 많이 발견한 경우 인라인으로 게시하는 대신 요약에서 "plus N similar items"라고 말합니다. 발견한 모든 것이 Nit인 경우 "No blocking issues"로 요약을 시작합니다.

## 보고하지 않음

- CI가 이미 적용하는 모든 것: lint, 형식, 타입 오류
- `src/gen/` 아래의 생성된 파일 및 모든 `*.lock` 파일
- 의도적으로 프로덕션 규칙을 위반하는 테스트 전용 코드

## 항상 확인

- 새 API 경로에는 통합 테스트가 있습니다
- 로그 라인에 이메일 주소, 사용자 ID 또는 요청 본문이 포함되지 않습니다
- 데이터베이스 쿼리는 호출자의 테넌트로 범위가 지정됩니다

초점 유지

길이는 비용이 있습니다: 긴 REVIEW.md는 가장 중요한 규칙을 희석합니다. 검토 동작을 변경하는 지침으로 유지하고 일반 프로젝트 컨텍스트는 CLAUDE.md에 남겨둡니다.

사용량 보기

claude.ai/analytics/code-review로 이동하여 조직 전체의 Code Review 활동을 확인합니다. 대시보드는 다음을 표시합니다:

대시보드 비용 수치는 활동 모니터링을 위한 추정치입니다. 청구서 정확한 지출의 경우 Anthropic 청구서를 참조하십시오.

가격

Code Review는 토큰 사용량을 기반으로 청구됩니다. 각 검토는 평균 $15-25의 비용이 소요되며, PR 크기, 코드베이스 복잡도 및 검증이 필요한 문제의 수에 따라 확장됩니다. Code Review 사용량은 사용량 크레딧을 통해 별도로 청구되며 계획에 포함된 사용량에 포함되지 않습니다.

선택한 검토 트리거는 총 비용에 영향을 미칩니다:

• PR 생성 후 한 번: PR당 한 번 실행됩니다
• 모든 푸시 후: 각 푸시에서 실행되어 푸시 수만큼 비용이 곱해집니다
• 수동: 열린 PR이나 푸시에서 자동으로 검토가 실행되지 않으므로 누군가 요청한 검토에서만 비용이 발생합니다

PR 생성 후 한 번 또는 수동 모드에서 @claude review always 댓글을 작성하면 PR이 푸시 트리거 검토에 옵트인되므로 해당 댓글 이후 푸시당 추가 비용이 발생합니다. 모든 푸시 후 모드에서는 푸시가 이미 검토를 트리거하므로 구독이 푸시당 비용을 변경하지 않습니다. @claude review를 댓글로 작성하면 향후 푸시에 구독하지 않고 단일 검토를 실행합니다. Claude는 포크에서 풀 요청을 누군가 @claude review를 댓글로 작성할 때만 검토하므로, 포크 풀 요청은 어떤 모드에서도 푸시당 비용이 발생하지 않습니다.

비용은 조직이 다른 Claude Code 기능에 Amazon Bedrock 또는 Google Cloud의 Agent Platform을 사용하는지 여부와 관계없이 Anthropic 청구서에 나타납니다. Code Review의 월간 지출 한도를 설정하려면 claude.ai/admin-settings/usage로 이동하여 Claude Code Review 서비스의 한도를 구성합니다.

분석의 주간 비용 차트 또는 관리자 설정의 리포지토리별 평균 비용 열을 통해 지출을 모니터링합니다.

문제 해결

검토 실행은 최선의 노력입니다. 실패한 실행은 PR을 차단하지 않지만 자동으로 재시도하지도 않습니다. 이 섹션에서는 실패한 실행에서 복구하는 방법과 확인 실행이 찾을 수 없는 문제를 보고할 때 어디를 봐야 하는지 다룹니다.

실패하거나 시간 초과된 검토 재트리거

검토 인프라가 내부 오류에 도달하거나 시간 제한을 초과하면 확인 실행이 Code review encountered an error 또는 Code review timed out 제목으로 완료됩니다. 결론은 여전히 중립적이므로 병합을 차단하는 것은 없지만 결과가 게시되지 않습니다.

검토를 다시 실행하려면 PR에서 @claude review를 댓글로 작성하십시오. 이렇게 하면 PR을 향후 푸시에 구독하지 않고 새로운 검토를 시작합니다. PR이 포크에서 나온 것이 아니면 GitHub의 Checks 탭에서 Claude Code Review 확인 옆의 Re-run을 클릭할 수 있습니다. 재실행도 PR을 구독하지 않고 새로운 검토를 시작합니다.

검토가 실행되지 않았고 PR이 지출 한도 메시지를 표시합니다

조직의 월간 지출 한도에 도달하면 Code Review는 검토가 건너뛰어졌음을 설명하는 단일 댓글을 PR에 게시합니다. 검토는 다음 청구 기간의 시작 시 자동으로 재개되거나 관리자가 claude.ai/admin-settings/usage에서 한도를 높일 때 즉시 재개됩니다.

인라인 댓글로 표시되지 않는 문제 찾기

확인 실행 제목이 문제가 발견되었다고 말하지만 diff에서 인라인 검토 댓글을 보지 못하면 결과가 표시되는 다른 위치를 확인하십시오:

• Check run Details: Checks 탭의 Claude Code Review 확인 옆에 있는 Details를 클릭합니다. 심각도 테이블은 인라인 댓글이 수락되었는지 여부와 관계없이 파일, 라인 및 요약과 함께 모든 결과를 나열합니다.
• Files changed annotations: PR의 Files changed 탭을 엽니다. 결과는 검토 댓글과 별도로 diff 라인에 직접 첨부된 주석으로 렌더링됩니다.
• Review body: 검토가 실행 중인 동안 PR을 푸시한 경우 일부 결과는 현재 diff에 더 이상 존재하지 않는 라인을 참조할 수 있습니다. 이들은 인라인 댓글이 아닌 검토 본문 텍스트의 Additional findings 제목 아래에 나타납니다.

로컬에서 diff 검토

/code-review 명령은 GitHub 앱을 설치하지 않고 터미널에서 diff를 검토합니다. 정확성 버그 및 재사용, 단순화 및 효율성 정리를 보고합니다.

/review는 /code-review의 별칭입니다. v2.1.223 이전에는 GitHub pull request의 단일 패스, 읽기 전용 검토를 실행하는 별도의 명령이었습니다.

/code-review

Claude는 호스트 애플리케이션이 아래에 설명된 결과 목록을 요청하는 경우에도 두 가지 실행 모두에서 회신의 텍스트로 결과를 보고합니다:

• 터미널 세션에서, /code-review는 forked subagent로 검토를 실행합니다
• 텍스트 또는 JSON 출력이 있는 -p 실행에서

결과 목록을 요청하는 호스트 애플리케이션(예: desktop app)에서, Claude는 ReportFindings 도구를 통해 검토의 결과를 보고합니다. Claude Code는 보고서를 결과 목록으로 렌더링하며, 각 항목은 파일 위치, 한 문장 요약 및 결과가 있을 때 correctness와 같은 카테고리 태그를 표시합니다. 호스트 요청은 모든 노력 수준에서 적용되며 Claude Code v2.1.218 이상이 필요합니다.

Claude가 나중에 세션에서 보고된 결과를 수정할 때, 다시 보고하며, Claude Code는 업데이트된 결과 목록의 각 결과를 수정됨, 건너뜀 또는 변경 필요 없음으로 표시합니다.

검토가 읽고 편집하는 내용

검토는 모든 Claude Code 세션처럼 CLAUDE.md를 따르지만, REVIEW.md는 읽지 않습니다. 백그라운드 검토는 --fix 편집을 세션의 checkpoints 외부에 적용하므로, /rewind는 이를 취소하지 않습니다. git을 사용하여 이를 되돌립니다. 검토가 포그라운드에서 실행될 때, 자신의 차례 동안 작업 트리를 편집하므로, /rewind는 평소대로 편집을 복원합니다.

노력 및 인수 조정

노력 수준을 전달하여 범위와 신뢰도를 교환합니다. low 및 medium에서 검토는 가장 확신하는 결과만 보고하므로 거짓 양성이 적습니다. high부터 max까지는 범위를 확대하며 검토가 덜 확신하는 결과를 포함할 수 있습니다.

수준을 입력하지 않으면, 검토는 이전 세션에서도 입력한 low부터 max까지의 마지막 수준을 재사용하며, Claude Code는 Reusing high effort, the level you typed last time과 같은 알림을 표시합니다. /code-review high와 같은 수준을 입력하여 나중에 실행이 재사용할 내용을 변경합니다. 비대화형 -p 실행에서 전달하는 수준은 이를 업데이트하지 않습니다. ultra는 기억된 수준을 업데이트하거나 사용하지 않습니다. 수준을 입력한 적이 없으면, 검토는 세션의 현재 노력을 사용합니다. v2.1.223 이전에는 수준 없는 /code-review는 항상 세션의 현재 노력을 사용했습니다.

노력 수준과 플래그 후, Claude Code는 다음 두 가지 방법 중 하나로 줄의 나머지를 읽습니다:

• ultra 없음: 남은 모든 것이 검토 대상입니다. 다른 명령 이름으로 시작하더라도 마찬가지입니다. /code-review /fix-issue 123은 /fix-issue 123을 대상 텍스트로 검토하며, 두 번째 stacked skill로 /fix-issue를 로드하지 않습니다. v2.1.218 이전에는 /code-review 후에 스택된 명령이 자체 스킬로 확장되었습니다.
• ultra 포함: Claude Code는 단일 단어를 기본 브랜치 또는 PR 번호로 읽고, 브랜치 또는 PR을 명명하지 않는 더 긴 텍스트를 검토에 첨부된 노트로 변환합니다. /code-review ultra check my auth changes는 현재 브랜치를 검토하며, Claude는 결과를 노트와 연관시킵니다.

포그라운드에서 실행

검토는 기본적으로 백그라운드에서 실행됩니다. v2.1.218 이전에는 대화 내에서 실행되었습니다. 다음과 같은 경우에는 포그라운드에서 실행됩니다:

• 이전 검토가 아직 진행 중인 동안 /code-review를 다시 실행합니다
• 비대화형 모드에서 실행합니다. -p 플래그 또는 Agent SDK를 사용합니다. Claude Code는 검토를 기다리고 응답에 결과를 포함합니다. ultra는 제외하며, 클라우드 검토를 대기 없이 시작합니다
• CLAUDE_CODE_DISABLE_BACKGROUND_TASKS를 1로 설정합니다. 이는 다른 모든 백그라운드 작업 기능도 끕니다

Claude가 검토를 시작하도록 허용

Claude는 자체적으로 /code-review를 시작할 수 있습니다. 일반 언어로 변경 사항을 검토하도록 요청하면 명령을 입력하지 않고도 스킬을 실행할 수 있으며, /code-review를 프롬프트로 하는 scheduled task는 검토를 실행합니다.

예약된 작업은 클라우드 검토를 시작하지 않으므로, ultra 인수 없이 /code-review를 예약합니다.

Claude와 예약된 작업이 검토를 시작하는 것을 중지하면서 /code-review를 입력할 수 있도록 유지하려면, ~/.claude/settings.json과 같은 settings file에 skillOverrides 항목을 추가합니다:

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

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

ultrareview로 확대

/code-review ultra --fix는 클라우드에서 더 깊은 ultrareview를 실행한 다음, 세션으로 돌아올 때 결과를 작업 트리에 적용합니다.

Ultrareview는 자체 범위를 사용합니다: 현재 브랜치와 저장소의 기본 브랜치, 그리고 작업 트리의 커밋되지 않은 및 스테이징된 변경 사항입니다. 자격 증명 또는 키처럼 명명된 파일의 커밋되지 않은 변경 사항(예: .env 및 *.tfvars 파일)의 경우, Claude Code는 클라우드 세션에 로컬 저장소 업로드에 대한 규칙을 따릅니다. 다른 기본과 비교하려면 /code-review ultra develop과 같은 브랜치 이름을 전달합니다.

대상이 github.com pull request인 경우, Claude가 완료된 결과를 PR에 게시하도록 GitHub 계정의 댓글로 할 수 있습니다. Claude Code v2.1.227 이상이 필요합니다.

스크립트 또는 CI에서 클라우드 검토를 시작하려면 claude -p '/code-review ultra'를 실행합니다. Claude Code는 검토를 시작하고 추적을 위한 링크를 출력합니다. Claude Code v2.1.218 이상이 필요합니다.

검토가 usage credits를 청구할 경우, Claude Code는 청구 확인이 대화형 세션이 필요하기 때문에 시작하기 전에 중지합니다. 대신 claude ultrareview subcommand를 실행합니다. 이를 실행하면 요금에 동의하는 것입니다.

이 명령은 v2.1.147 이전에 /simplify로 명명되었으며, 기본적으로 수정 사항을 적용했습니다. /simplify는 버그를 찾지 않고 수정 사항을 적용하는 별도의 정리 전용 검토를 실행합니다. 버그 찾기를 위해 /simplify를 스크립트했다면, /code-review --fix로 전환합니다.

관련 리소스

• Commands: 로컬 Claude Code 세션에서 /code-review를 실행하여 푸시 전에 diff를 확인합니다
• GitHub Actions: 코드 검토 이상의 사용자 정의 자동화를 위해 자신의 GitHub Actions 워크플로우에서 Claude를 실행합니다
• GitLab CI/CD: GitLab 파이프라인을 위한 자체 호스팅 Claude 통합
• Memory: Claude Code 전체에서 CLAUDE.md 파일이 작동하는 방식
• Analytics: 코드 검토 이상으로 Claude Code 사용량을 추적합니다
• How Anthropic secures its AI-native software development lifecycle: 자동화된 검토가 Anthropic의 안전한 개발 프로세스의 한 계층으로 어떻게 적합한지에 대한 설명