버전 2.1.328에서 변경된 사항
변경 로그 항목은 대부분의 모델에서 로컬 명령어에 대해 세 가지 변화를 명시합니다.
- 범위(Scope). 이제 리뷰는 "버그 및 CLAUDE.md 위반 사항만" 보고합니다.
- 라벨(Labels). 각 발견 사항은 Important, Pre-existing 또는 Nit으로 표시됩니다.
- 출력(Output). 각 요약은 제안된 수정 사항으로 끝납니다. 보고할 내용이 없는 리뷰는 이제 한 줄로 표시됩니다: Code review found no issues.
"대부분의 모델에서(on most models)"라는 한정어가 두 줄 모두에 등장합니다. 변경 로그에는 제외된 모델 목록이 없습니다. 업데이트 후에도 리뷰에 정리 제안이 포함되어 있다면, 사용 중인 모델이 예외 중 하나일 수 있습니다.
정리 작업이 사라진 것은 아닙니다. 별도의 명령어로 이동되었으며, 변경 로그는 이를 명시하고 있습니다: 재사용, 단순화 및 효율성 정리를 위해서는 /simplify를 실행하세요.
문서에 여전히 이전 범위가 설명되어 있는 이유
릴리스 당일에도 로컬 리뷰 페이지는 여전히 이전 설명으로 시작됩니다: "Claude는 브랜치의 변경 사항을 검토하고, 정확성 버그를 찾아 대화창에 보고합니다. 모델과 노력 수준(effort level)에 따라 리뷰에는 재사용, 단순화 및 효율성 정리도 포함됩니다."
명령어 참조 페이지에도 일치하는 문구가 있습니다: "모델과 노력 수준에 따라 리뷰에는 정리 기회도 포함됩니다."
변경 로그가 더 최신 소스입니다. 또한 남은 두 가지 카테고리를 명시하고 있으므로 더 구체적입니다. 릴리스 노트와 문서 페이지의 내용이 서로 다를 경우, 문서 페이지가 아직 업데이트되지 않았다고 해석하는 것이 안전합니다. claude --version으로 설치된 버전을 확인하고 2.1.328과 비교해 보세요.
이전 변경 로그 항목을 보면 이러한 기능 이동이 전에도 있었음을 알 수 있습니다. 한 릴리스에서는 "Opus 5.5 및 Sonnet 5.5를 포함하여 튜닝된 리뷰 설정이 없는 모델에서 중간 노력 수준의 리뷰가 정리 및 CLAUDE.md 컨벤션 발견 사항도 보고하도록" 변경되었습니다. /code-review의 범위는 한동안 모델과 노력 수준에 따라 변화해 왔습니다. 버전 2.1.328은 대부분의 모델에서 이 범위를 좁혔습니다.
Important, Pre-existing, Nit의 의미
변경 로그는 로컬 명령어에 대한 정의 없이 세 가지 태그의 이름만 나열합니다. GitHub의 관리형 Code Review 서비스도 동일한 세 가지 라벨을 사용하며, 해당 문서에서 이를 다음과 같이 정의합니다.
- Important: "머지하기 전에 수정해야 하는 버그"
- Nit: "수정할 가치는 있지만 머지를 막지는 않는 사소한 문제"
- Pre-existing: "코드베이스에 존재하지만 이번 PR로 인해 발생한 것은 아닌 버그"
Pre-existing은 가장 주의 깊게 읽어볼 가치가 있는 태그입니다. 이는 실제 버그이지만, 여러분의 변경 사항 때문에 발생한 것은 아닙니다. 이는 작업 범위를 결정하는 데 유용합니다. 지금 바로 수정할 수도 있고, 기록해 두었다가 별도로 처리할 수도 있으며, 현재 변경 사항의 차단 요소(blocker)로 간주하지 않아도 됩니다. 변경 로그는 이 태그들을 로컬 명령어의 변경 사항으로 설명하므로, 이번 릴리스 전에는 기존에 있던 버그와 새로 발생한 버그가 라벨 없이 같은 목록에 나란히 놓여 있었을 것입니다.
Nit은 사소한 문제를 다룹니다. 관리형 서비스에서는 팀이 리뷰 전용 파일을 통해 무엇을 Nit 또는 Important로 간주할지 재조정할 수 있습니다. 로컬 명령어는 다음에 설명할 다른 파일 세트를 읽습니다.
로컬 리뷰가 읽는 파일
이 부분에서 변경 사항이 여러분의 지침과 연결됩니다. 로컬 리뷰 페이지에는 다음과 같이 명시되어 있습니다: "리뷰는 비대화형 -p 실행을 포함하여 CLAUDE.md를 따릅니다. REVIEW.md는 읽지 않습니다."
따라서 여러분의 머신에서 실행되는 /code-review의 경우, CLAUDE.md가 프로젝트 규칙을 위한 문서화된 장소입니다. 같은 페이지에서 직접적으로 언급하고 있습니다: "모든 리뷰가 따를 프로젝트 규칙을 제공하려면 CLAUDE.md에 추가하세요."
새로운 범위가 적용되면서 이 점이 더 중요해졌습니다. 이제 대부분의 모델에서 CLAUDE.md 위반 사항은 리뷰가 보고하는 두 가지 항목 중 하나입니다. 팀 위키, 풀 리퀘스트 템플릿 또는 여러분의 머릿속에만 있는 컨벤션은 보고 대상이 아닙니다.
관리형 서비스의 커스터마이징 페이지에서도 반대 입장에서 같은 선을 긋고 있습니다: "서비스는 CLAUDE.md와 REVIEW.md를 모두 읽습니다. 자신의 머신에서 Claude Code 세션 내에 실행하는 /code-review 명령어는 CLAUDE.md 파일만 읽고 REVIEW.md는 읽지 않습니다." 이에 대한 조언은 다음과 같습니다: "두 곳 모두에 적용하고 싶은 지침은 CLAUDE.md에 넣고, REVIEW.md는 풀 리퀘스트 리뷰에 특화된 규칙을 위해 유지하세요."
서비스의 경우, 동일한 페이지에서 CLAUDE.md가 어떻게 적용되는지 설명합니다: "규칙 중 하나를 위반하는 변경 사항은 해당 문제에 적합한 심각도 수준의 발견 사항이 됩니다." 또한 서비스는 루트 파일과 변경된 각 파일의 상위 디렉토리에 있는 CLAUDE.md 파일들을 읽는다고 명시되어 있습니다.
/simplify가 적절한 명령어인 경우
/simplify는 정리 작업을 담당하는 짝꿍입니다. 명령어 참조 페이지에서는 이를 다음과 같이 설명합니다: "변경된 코드에서 정리 기회를 검토하고 수정을 적용합니다." 기존 헬퍼 재사용, 단순화, 효율성, 그리고 변경 사항이 적절한 추상화 수준에 있는지 등을 다루는 4개의 리뷰 에이전트가 병렬로 실행됩니다.
동일한 항목에서 경계선을 명확히 하고 있습니다: "이 리뷰는 정확성 버그를 찾지 않습니다. 버그를 찾으려면 /code-review를 사용하세요."
스크립트 작성 시 혼동을 줄 수 있는 명칭의 역사가 있습니다. 로컬 리뷰 페이지에 따르면: "이 명령어는 v2.1.147 이전에는 /simplify라는 이름이었으며, 당시에는 기본적으로 수정을 적용했습니다. 버그 탐색을 위해 /simplify를 스크립트로 작성했다면 /code-review --fix로 전환하세요."
이제 역할 분담이 깔끔해졌습니다.
/code-review는 버그와 CLAUDE.md 위반 사항을 찾아 보고합니다./simplify는 정리 기회를 찾아 수정을 적용합니다.
어떤 순서로든 실행할 수 있습니다. 합리적인 습관은 /code-review를 먼저 실행하여 정리가 코드를 재구성하기 전에 정확성 문제를 먼저 수정하는 것입니다.
리뷰 대상 선택하기
대상을 지정하지 않으면 로컬 페이지에 따라 "/code-review는 업스트림 브랜치보다 앞선 현재 브랜치의 커밋과 커밋되지 않은 변경 사항을 검토합니다." 브랜치에 업스트림이 없으면 main 또는 이전 커밋과 비교합니다.
노력 수준과 플래그 뒤에 대상을 입력하여 다른 곳을 가리킬 수 있습니다. 문서화된 대상에는 풀 리퀘스트 번호, 다른 브랜치와의 비교, 커밋 범위, 파일 또는 디렉토리 경로가 포함됩니다. 특정 모듈의 CLAUDE.md에 고유한 규칙이 있는 경우와 같이 특정 영역에만 새로운 범위를 적용하고 싶을 때 경로 지정이 유용합니다.
결과를 터미널에서 읽는 대신 게시하려면 --comment를 사용하세요. 이는 "GitHub 풀 리퀘스트에 인라인 코멘트로, 또는 GitLab 머지 리퀘스트에 단일 노트로 발견 사항을 게시합니다." 이러한 코멘트에는 동일한 태그가 포함되므로 풀 리퀘스트 스레드에서 Pre-existing 항목을 쉽게 식별할 수 있습니다.
Claude가 대신 리뷰를 시작하는 경우
항상 명령어를 직접 입력해야 하는 것은 아닙니다. 로컬 페이지에는 Claude가 리뷰를 시작할 수 있는 두 가지 방법이 나열되어 있습니다. 첫 번째는 평이한 언어로 요청할 때입니다: "Claude에게 변경 사항을 리뷰해 달라고 요청하면 해당 스킬을 실행할 수 있습니다." 두 번째는 프롬프트가 /code-review인 세션 범위의 예약된 작업(scheduled task)입니다.
두 방식 모두 직접 입력한 명령어와 동일한 범위를 사용하므로, 예약된 리뷰도 이제 버그와 CLAUDE.md 위반 사항을 보고합니다. 명령어를 수동으로만 사용하고 싶다면, 설정 파일의 skillOverrides 항목을 통해 스킬을 사용자 호출 전용으로 만드는 방법이 페이지에 설명되어 있습니다. 이렇게 하면 명령어는 계속 사용할 수 있으면서 Claude나 예약된 작업이 리뷰를 시작하는 것을 방지할 수 있습니다.
리뷰 변경 또는 교체
/code-review는 번들 스킬입니다. 페이지에서는 이것이 무엇을 의미하는지 설명합니다: "해당 지침은 Claude Code에 내장되어 있으므로 디스크에 열거나 편집할 수 있는 SKILL.md 파일이 존재하지 않습니다."
새로운 범위가 팀에 맞지 않는다면 문서화된 옵션이 있습니다. 페이지에 따르면 "code-review라는 이름의 프로젝트 또는 개인 스킬이 번들 스킬 대신 실행되며, /review 별칭은 계속해서 번들 리뷰를 실행합니다." 또한 직접 리뷰어 서브에이전트나 리뷰 스킬을 작성할 수도 있습니다.
교체하기 전에 페이지에서 먼저 제시하는 더 간단한 경로를 고려해 보세요. 규칙을 CLAUDE.md에 넣는 것입니다. 번들 리뷰는 이미 해당 파일을 따르고 있으며, 범위가 좁아졌기 때문에 그곳의 명확한 규칙은 긴 선호도 목록보다 발견 사항으로 나타날 가능성이 더 높습니다.
리뷰가 확인할 수 있는 규칙 작성하기
CLAUDE.md 위반 사항은 규칙이 구체적일 때 보고하기 가장 쉽습니다. 특정 디렉토리는 절대 수동으로 편집해서는 안 된다거나, 모든 API 라우트에는 특정 미들웨어가 필요하다거나, 테스트가 프로덕션 데이터베이스를 건드려서는 안 된다는 식의 문구는 리뷰가 비교할 수 있는 구체적인 근거를 제공합니다.
코드를 깔끔하게 유지하라는 식의 모호한 선호도는 /simplify가 처리하는 영역에 더 가깝습니다. 이러한 내용을 CLAUDE.md에서 제외하면 파일이 짧게 유지되어, 리뷰뿐만 아니라 Claude가 해당 파일을 읽는 모든 작업에 도움이 됩니다.
로컬 리뷰 실행 방식
문서의 몇 가지 세부 사항은 결과를 해석하는 데 도움이 됩니다.
백그라운드에서 실행됩니다. "터미널 세션에서 리뷰는 자체 컨텍스트 창을 가진 백그라운드 서브에이전트로 실행되므로 대화 내용을 채우지 않습니다. 리뷰가 완료되면 발견 사항이 대화창에 나타납니다."
수정을 요청하지 않는 한 보고만 합니다. --fix가 없으면 "리뷰 지침은 Claude에게 보고서만 요청합니다." --fix를 사용하더라도 편집은 여전히 사용자의 권한 모드를 거칩니다.
백그라운드 수정 후 리와인드(Rewind)에는 제한이 있습니다. 페이지에 따르면 백그라운드 리뷰는 세션의 체크포인트 외부에서 --fix 편집을 적용하므로, /rewind는 Claude가 대화 중에 이미 편집했던 파일만 복구합니다. 나머지에 대해서는 git을 사용하라는 것이 조언입니다.
노력 수준에 따른 범위 변화. "low에서는 리뷰가 가장 확신하는 발견 사항만 보고하므로 오탐(false positive)이 적습니다. medium에서 max로 갈수록 리뷰 범위가 넓어집니다." 수준을 입력하지 않으면 리뷰는 이전 세션에서라도 마지막으로 입력했던 수준을 재사용합니다.
데스크톱 앱은 목록을 보여줍니다. 데스크톱 앱과 같이 구조화된 결과를 요청하는 호스트 애플리케이션에서 각 항목은 "파일 위치, 한 문장 요약, 카테고리 태그를 보여줍니다." 수정 사항도 추적됩니다: "Claude가 나중에 세션에서 보고된 발견 사항을 수정하면 다시 보고합니다. 그러면 Claude Code는 업데이트된 발견 사항 목록에서 각 항목을 fixed, skipped 또는 no change needed로 표시합니다." 이 상태 목록은 작업 중에 유용하며 세션이 유지되는 동안 지속됩니다.
발견 사항 제한. --max-findings로 제한을 높이거나 낮출 수 있으며, 발견 사항 도구를 통해 보고되는 문서화된 제한은 32개입니다.
Code Review 및 ultrareview와의 차이점
세 가지 리뷰 도구가 이름을 공유하지만, 새로운 범위는 그중 하나에만 적용됩니다.
/code-review는 세션 내에서 로컬로 실행되고 CLAUDE.md를 읽으며, 이제 대부분의 모델에서 버그와 CLAUDE.md 위반 사항을 보고합니다.- Code Review는 조직의 GitHub 풀 리퀘스트를 검토하는 관리형 서비스로, CLAUDE.md와 REVIEW.md를 모두 읽습니다.
- Ultrareview는
/code-review ultra로 시작하며 클라우드에서 더 심층적인 리뷰를 실행합니다.
로컬 페이지에 따르면 /review는 /code-review의 별칭이므로 변경 사항은 두 이름 모두에 적용됩니다.
업로드되는 내용과 결과가 반환되는 위치를 포함한 클라우드 옵션은 Claude Code의 ultrareview 가이드에서 다루었습니다.
사람들이 흔히 하는 실수
/code-review에서 정리 제안을 찾는 것. 대부분의 모델에서 해당 기능은 /simplify로 이동했습니다.
로컬 리뷰를 위해 REVIEW.md에 리뷰 규칙을 넣는 것. 로컬 명령어는 이를 읽지 않습니다. CLAUDE.md를 사용하세요.
모든 발견 사항을 차단 요소로 취급하는 것. 서비스에서 Nit은 차단 요소가 아닌 것으로 정의되며, Pre-existing은 변경 사항으로 인해 도입된 것이 아닙니다.
오늘 당장 변경 로그보다 문서 페이지를 신뢰하는 것. 페이지에는 여전히 이전 범위가 설명되어 있습니다.
버그를 찾기 위해 /simplify를 사용하는 것. 이 명령어는 정확성 버그를 찾지 않습니다.
해결책: CLAUDE.md에 리뷰 규칙 담기
1단계: 업데이트 및 버전 확인
claude --version을 실행하세요. 새로운 범위는 2.1.328에서 도입되었습니다.
2단계: 리뷰 관련 규칙을 CLAUDE.md로 이동
위키나 템플릿에만 존재하는 컨벤션은 로컬 리뷰가 읽는 파일에 포함되지 않습니다.
3단계: 리뷰 습관 분리
버그와 규칙 위반을 위해 /code-review를 실행한 다음, 정리를 위해 /simplify를 실행하세요.
4단계: 미루기로 결정한 Pre-existing 발견 사항 기록
어떤 것을 남겨두었는지, 그 이유와 위치를 기록해 두세요.
MemoryLake에서 설정하기
CLAUDE.md는 Claude Code가 프로젝트 규칙을 읽는 곳이며, 이를 짧게 유지하는 것이 잘 사용하는 방법의 일부입니다. 규칙이 존재하는 이유, 미루기로 한 Pre-existing 버그, 계속해서 동일한 발견 사항이 발생하는 영역, 리뷰 후 결정 사항과 같은 일부 컨텍스트는 그곳에 어울리지 않습니다.
MemoryLake는 리뷰 결정, 미뤄둔 문제, 규칙 뒤의 이유와 같은 프로젝트 컨텍스트를 한곳에 유지하고 ChatGPT, Claude Code, Codex와 같이 연결된 어시스턴트가 사용할 수 있게 해주는 메모리 레이어입니다.
사용자는 자신의 언어로 직접 항목을 작성합니다. CLAUDE.md 파일, Claude Code 세션, 리뷰 발견 사항, 리포지토리 또는 벤더의 저장소에서 아무것도 읽거나 쓰거나 삭제하지 않습니다. Claude Code의 리뷰는 Anthropic이 설명한 방식 그대로 작동합니다.
1단계: API 키 생성
로그인 후 대시보드에서 키를 생성하세요. 다른 자격 증명과 마찬가지로 리포지토리 외부에 저장하세요.

2단계: 첫 번째 메모리 업로드
해결책의 4단계에서 작성한 내용인 미뤄둔 발견 사항과 그 이유부터 시작하세요. 항목당 하나의 결정사항을 담습니다.

3단계: AI 및 에이전트 연결
Claude Code, Codex 및 사용하는 다른 어시스턴트를 연결하세요. 다음 리뷰나 수정 작업은 동일한 결정 사항에서 시작할 수 있습니다.

실제적인 변화
첫 번째 차이점은 반복되는 발견 사항이 줄어든다는 점입니다. 미뤄둔 Pre-existing 버그는 그 이유와 함께 기록에 남습니다.
두 번째는 더 가벼워진 CLAUDE.md입니다. 규칙은 그곳에 머물고, 그 뒤의 역사는 다른 곳에 저장됩니다.
세 번째는 도구 간의 일관성입니다. 동일한 리뷰 결정 사항을 Claude Code와 다른 어시스턴트에서 모두 사용할 수 있습니다.
/code-review를 위한 베스트 프랙티스
버전을 확인하세요. 범위 변경은 2.1.328에서 적용되었습니다.
규칙은 CLAUDE.md에 유지하세요. 로컬 리뷰가 따르는 파일입니다.
REVIEW.md는 관리형 서비스 전용으로만 사용하세요. 로컬 명령어는 이를 읽지 않습니다.
태그를 읽으세요. Important는 머지 전 수정, Nit은 비차단 요소, Pre-existing은 이번 변경으로 도입된 것이 아닙니다.
정리를 위해 /simplify를 실행하세요. 수정을 적용하며 버그는 찾지 않습니다.
의도적으로 노력 수준을 선택하세요. Low는 확신도를 우선시하고, 높은 수준은 범위를 넓힙니다.
백그라운드 수정 후에는 git을 사용하세요. Rewind는 백그라운드 리뷰가 편집한 모든 파일을 복구하지는 못합니다.
결론
2026년 11월 19일에 릴리스된 Claude Code 2.1.328은 대부분의 모델에서 /code-review의 범위를 버그 및 CLAUDE.md 위반 사항으로 좁히고, 각 발견 사항을 Important, Pre-existing 또는 Nit으로 표시하며, 각 요약 끝에 제안된 수정 사항을 추가합니다. 정리 작업은 수정을 적용하고 정확성 버그를 찾지 않는 /simplify로 이동되었습니다. 로컬 문서 페이지는 여전히 이전 범위를 설명하고 있으므로 변경 로그와 버전을 대조해 보시기 바랍니다.
로컬 리뷰는 CLAUDE.md를 따르며 관리형 서비스가 사용하는 REVIEW.md는 읽지 않습니다. 새로운 범위에서 CLAUDE.md는 리뷰가 확인하는 두 가지 핵심 요소 중 하나이므로, 로컬에서 강제하고 싶은 규칙은 그곳에 두어야 합니다. 그 뒤의 이유와 결정 사항은 단일 리뷰보다 오래 지속되는 곳에 보관하세요.