Claude Code 코드 리뷰 변경, 정리는 simplify로
Claude Code 2.1.328부터 대부분의 모델에서 코드 리뷰가 버그와 CLAUDE.md 위반 위주로 바뀌었습니다. 정리는 /simplify로 받으세요.
이 소식, 나한테 해당될까요?
- 지금 해 보기/code-review로 버그와 정리 제안을 한꺼번에 받아 오던 사람claude --version으로 2.1.328 이상인지 보고, 정리 제안이 필요하면 /simplify를 따로 돌리기
- 조건 확인 후/code-review 결과를 스크립트나 예약 작업이 읽어 처리하는 사람결과 문구와 지적 분류가 바뀌어 처리 규칙이 어긋나지 않는지 한 번 돌려 보기
- 기다려도 됨업데이트로 결과가 달라지는 게 부담스러운 사람stable 채널로 다음 업데이트를 늦추되 native 설치라면 지금 버전을 minimumVersion으로 함께 정하기(정하지 않으면 더 낮은 버전으로 내려갈 수 있고, 이미 2.1.328이면 이번 변경은 그대로 남음)
2.1.328 변경 기록 항목은 '대부분의 모델'이라고만 적었고, 어떤 모델이 예외인지는 밝히지 않았습니다.
읽는 대신, 내 AI에게 시켜 보세요
팀이나 내가 지켜 온 코드 규칙 메모를 붙여 넣으면 CLAUDE.md에 넣을 규칙 문장과 확인이 필요한 부분을 나눠 줍니다. 서로 맞지 않는 숫자나 판단할 수 없는 표현은 따로 모읍니다.
프롬프트 내용 펼쳐 보기프롬프트 내용 접기
너는 Claude Code 프로젝트의 CLAUDE.md에 넣을 코드 리뷰 규칙을 정리하는 도우미야. 아래 메모를 읽고, 리뷰어가 코드만 보고 지켰는지 판단할 수 있는 규칙 문장으로 바꿔 줘. 규칙 - 메모에 없는 규칙, 숫자, 파일 이름, 도구 이름은 지어내지 마. - 숫자와 이름은 메모에 적힌 그대로 옮겨. 고치거나 반올림하지 마. - 메모 안에서 서로 맞지 않는 내용(예: 같은 항목에 다른 숫자)이 있으면 하나로 고르지 말고 "확인 필요" 목록에 두 내용을 모두 적어. - "항상 깔끔하게", "절대 문제 없이"처럼 코드만 보고 지켰는지 판단할 수 없는 말은 규칙으로 옮기지 말고 "판단 불가 표현" 목록에 모아. - 기한이 붙은 임시 규칙은 오늘 날짜와 비교해, 기한이 지났으면 "기한 지남, 확인 필요"로 표시해. 할 일 1. 규칙 문장 목록: 한 줄에 규칙 하나, "~한다" 또는 "~하지 않는다"로 짧게 써 줘. 2. 확인 필요 목록: 서로 맞지 않는 내용과 기한이 지난 규칙. 3. 판단 불가 표현 목록. 4. 버그나 규칙 위반이 아니라 중복 줄이기, 단순화 같은 코드 정리 요청은 따로 모아 "정리 요청"으로 표시해. 오늘 날짜 [예: 2026년 11월 20일] 팀 규칙 메모 [팀이나 내가 지켜 온 코드 규칙 메모 붙여 넣기]
회사 비밀이나 고객 정보가 든 메모는 지우고 넣고, 만들어진 규칙은 CLAUDE.md에 넣기 전에 직접 읽고 고치세요.

Claude Code로 홈페이지, 자동화 스크립트, 사내 도구를 만들고 마무리 점검을 /code-review에 맡겨 온 실무자를 위한 글입니다. 그동안 버그와 함께 보이던 코드 정리 제안이 요즘 보이지 않는다면 이번 업데이트 때문일 수 있습니다.
이 글에서는 Claude Code 2.1.328에서 /code-review가 무엇을 덜 알려 주게 됐는지, /simplify와 어떻게 나눠 쓰는지, 새 지적 분류를 읽는 법과 요금·한국 사용 여부를 공식 문서 기준으로 정리합니다.
Claude Code 2.1.328에서 코드 리뷰는 무엇이 바뀌었나요?
Claude Code 2.1.328부터 대부분의 모델에서 /code-review는 버그와 CLAUDE.md 위반만 알려 줍니다. 변경 기록 날짜는 2026년 11월 19일이고, GitHub 릴리스는 같은 날 01시 14분(UTC), 한국 시간 오전 10시 14분에 올라왔습니다.
/code-review를 입력하면 Claude가 지금 브랜치에서 고친 부분을 살펴보고, 찾은 문제를 대화로 돌려줍니다. /review라고 쳐도 같은 명령이 실행됩니다. 이번 변경으로 대부분의 모델에서 코드 재사용, 단순화, 효율에 관한 정리 제안은 /code-review 결과에서 빠졌고, 변경 기록은 이런 정리는 /simplify로 받으라고 안내합니다.
| 구분 | 2.1.328에서 달라진 점 |
|---|---|
| 알려 주는 범위 | 대부분의 모델에서 버그와 CLAUDE.md 위반만 |
| 지적 표시 | 대부분의 모델에서 지적마다 Important, Pre-existing, Nit 중 하나 |
| 요약 | 끝에 고칠 방법을 제안 |
| 문제가 없을 때 | 목록에 "Code review found no issues."라고 표시 |
같은 업데이트에서 /bug는 보내기 전에 Yes·No를 묻도록 바뀌었습니다. Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, Claude apps gateway 경로에서 Opus 4.6과 Sonnet 4.6의 auto 모드도 추가됐습니다. 이 항목은 이런 클라우드·게이트웨이를 거쳐 Claude Code를 쓰는 조직에 해당하는 변화로 보입니다.
/code-review와 /simplify는 무엇이 다른가요?
/code-review는 버그를 찾는 명령이고, /simplify는 코드를 정리하는 명령입니다. 공식 명령 목록 기준으로 /simplify는 바뀐 코드에서 다듬을 부분을 찾아 그 자리에서 고쳐 주며, 버그 찾기는 하지 않습니다.
| 항목 | /code-review | /simplify |
|---|---|---|
| 보는 것 | 정확성 버그, CLAUDE.md 위반 | 기존 함수 재사용, 단순화, 효율, 추상화 수준 |
| 고치기 | 리뷰 중에는 --fix를 붙였을 때만 적용, 리뷰 뒤 Claude에게 따로 맡길 수도 있음 | 찾은 정리 내용을 적용 |
| 실행 방식 | 터미널에서는 별도 하위 에이전트가 뒤에서 검토 | 검토 에이전트 4개가 동시에 검토 |
그래서 앞으로는 순서를 나누는 편이 깔끔합니다. 먼저 /code-review로 버그를 잡고, 정리가 필요하면 /simplify를 따로 돌리는 방식입니다. --fix로 고친 내용도 지금 쓰는 권한 모드를 따르므로, 모드에 따라 승인을 요청받을 수 있습니다.
한 가지 주의할 점이 있습니다. 11월 19일 15시(UTC)에 확인한 공식 /code-review 안내 문서와 명령 목록은 모델과 effort 수준에 따라 정리 제안도 나올 수 있다고 설명합니다. 2.1.328 변경 기록 항목도 어떤 모델이 예외인지 밝히지 않았으니, 내 환경의 실제 결과를 직접 보고 판단하세요.
Important·Pre-existing·Nit 표시는 어떻게 읽나요?
대부분의 모델에서 지적마다 세 가지 표시 중 하나가 붙습니다. 변경 기록은 각 표시의 정확한 기준을 설명하지 않았으므로, 아래 풀이는 영어 단어 뜻을 바탕으로 한 읽는 법이고 처리 방법은 이 글의 권장입니다.
| 표시 | 단어 뜻 | 권장 처리(공식 기준 아님) |
|---|---|---|
| Important | 중요함 | 배포 전에 먼저 확인 |
| Pre-existing | 이미 있던 것 | 이번 작업 범위인지 따로 판단 |
| Nit | 사소한 지적 | 시간 날 때 정리 |
리뷰 결과를 사람이 읽는다면 큰 문제는 없습니다. 다만 결과를 스크립트가 읽어 "문제 없음"을 판단하던 자동화라면, 문제 없을 때 결과 목록에 나오는 문구가 "Code review found no issues."로 정해졌으니 판정 규칙을 한 번 맞춰 보세요.
CLAUDE.md 규칙은 왜 더 중요해졌나요?
대부분의 모델에서 이제 /code-review가 알려 주는 것이 버그와 CLAUDE.md 위반이기 때문입니다. 공식 문서 기준으로 /code-review가 참고하는 프로젝트 규칙 파일은 CLAUDE.md이고, -p를 붙여 대화 없이 돌려도 마찬가지입니다. 이름이 비슷한 REVIEW.md는 GitHub 풀 리퀘스트를 자동 검토하는 별도 관리형 Code Review 서비스가 쓰는 파일이고, /code-review는 이 파일을 읽지 않습니다.
CLAUDE.md에 "꼼꼼하게 짤 것"처럼 흐릿한 말만 있으면 리뷰어가 위반 여부를 판단하기 어렵습니다. 위 프롬프트로 팀 메모를 "~한다, ~하지 않는다" 형태의 규칙 문장으로 바꿔 두면 리뷰 결과를 읽기도 쉬워집니다. 다만 CLAUDE.md에 적은 정리 규칙을 /code-review가 위반으로 다루는지는 이번에 확인한 공식 문서(/code-review 안내·2.1.328 변경 기록)에 나와 있지 않습니다.
업데이트 직후 최근 작업 하나를 골라 /code-review와 /simplify를 차례로 돌려 보세요. 무엇이 어느 쪽에 나오는지 내 프로젝트에서 직접 확인하면, 다음부터 어떤 명령을 먼저 쓸지 정하기 쉽습니다.
요금은 따로 들고 한국에서도 쓸 수 있나요?
/code-review는 모든 요금제에서 쓸 수 있고, 세션 사용량으로 계산됩니다. 공식 문서 설명으로는 리뷰가 내 세션 안에서 돌기 때문에, 평소처럼 요금제 사용량이나 API 요금에 함께 잡힙니다. 2.1.328 변경 기록에는 요금 변경 내용이 없습니다.
클라우드에서 여러 에이전트가 더 깊게 보는 /code-review ultra는 다릅니다. 공식 문서 기준으로 Pro·Max·Ultra 요금제에는 계정당 한 번만 주는 무료 3회가 있습니다. 무료 횟수를 다 쓰면 사용량 크레딧으로 결제되는데, 공식 문서가 든 보통 금액은 변경 규모에 따라 회당 5~25달러입니다. 유료 실행은 사용량 크레딧을 켜 둬야 하고, 이 기능은 연구 미리보기라 요금과 제공 범위가 바뀔 수 있습니다.
한국은 Anthropic의 지원 지역 목록(2026년 11월 12일 시행본)에 들어 있고, 이 정책은 Claude Code에도 적용됩니다. 이번 변경에 한국만 다르게 적용된다는 내용은 없습니다.
업데이트는 어떻게 확인하나요?
터미널에서 claude --version을 쳐서 2.1.328 이상인지 확인합니다. 기본 설치 프로그램(native installer)으로 설치했다면 뒤에서 자동으로 업데이트되고, Homebrew·WinGet 등으로 설치했다면 기본 설정에서는 직접 업데이트해야 합니다.
| 상황 | 할 일 |
|---|---|
| 바로 써 보고 싶음 | claude --version으로 버전 확인 |
| 변화가 부담스러움 | /config의 Auto-update channel을 stable로 바꾸고 지금 버전 유지 선택 |
| Homebrew 사용자 | claude-code는 stable, claude-code@latest는 latest 채널 |
latest가 기본값이고, stable을 고르면 조금 묵힌 버전을 받으면서 큰 결함이 있는 버전은 건너뜁니다. stable은 보통 1주가량 늦게 따라가므로, 이번 변경도 늦게 들어올 가능성이 큽니다. native 설치라면 minimumVersion을 지금 버전으로 적어 두면, 그보다 낮은 stable 버전으로 내려가지 않고 지금 버전을 지킵니다. 이미 2.1.328이라면 최소 버전을 정해도 이번 변경은 그대로 남습니다. 채널을 옮길 때 버전이 내려가지 않게 하는 방법은 Claude Code 2.1.326 업데이트 글에 정리했습니다.
오늘 무엇부터 하면 되나요?
먼저 버전을 확인하고, 최근 작업 하나로 /code-review와 /simplify를 차례로 돌려 결과가 어떻게 나뉘는지 봅니다.
그다음 위 프롬프트로 팀 규칙 메모를 CLAUDE.md 규칙 문장으로 정리해 두세요. 스킬과 MCP를 어떻게 나눠 쓰는지 궁금하다면 Claude Code 스킬과 MCP 비교 글을, Claude Code를 처음 배운다면 무료 입문 강의를 참고하세요.
참고 자료
- ▸Anthropic, 「Claude Code changelog」 2.1.328(2026-11-19) — https://code.claude.com/docs/en/changelog
- ▸Anthropic, 「anthropics/claude-code v2.1.328」 GitHub 릴리스(2026-11-19) — https://github.com/anthropics/claude-code/releases/tag/v2.1.328
- ▸Claude Code Docs, 「Review locally with /code-review」(2026-11-19 UTC 확인) — https://code.claude.com/docs/en/code-review-local
- ▸Claude Code Docs, 「Commands」(2026-11-19 UTC 확인) — https://code.claude.com/docs/en/commands
- ▸Claude Code Docs, 「Find bugs with ultrareview」(2026-11-19 UTC 확인) — https://code.claude.com/docs/en/ultrareview
- ▸Claude Code Docs, 「Advanced setup」(2026-11-19 UTC 확인) — https://code.claude.com/docs/en/setup
- ▸Anthropic, 「Supported Regions Policy」(2026-11-12 시행) — https://www.anthropic.com/legal/supported-regions
함께 읽으면 좋은 글
최신 소식 글을 먼저, 그다음 최신 글을 보여 드려요

챗GPT 스페이스 Plus 확대, 페이지 공유 전 확인할 조건
챗GPT 스페이스가 2026년 11월 20일부터 Plus 요금제로 넓어지기 시작했습니다. 무료 계정 열람 제한, 공유 권한, 학습 설정을 확인하고 써 보세요.

클로드 컴퓨터 사용 팀 플랜 베타, 켜기 전 확인할 것
클로드 컴퓨터 사용이 Team·Enterprise 플랜에 베타로 차례차례 열립니다. 소유자가 켜는 곳과 앱 차단 목록, 화면 캡처 주의점을 확인하세요.

Claude Code 예약 작업, 2.1.329 뒤 다시 걸기
Claude Code 2.1.329부터 예전에 저장한 예약 작업 대부분은 로그인한 새 세션에서 다시 걸어야 합니다. 확인 순서와 바뀐 점을 보세요.