Claude Code v2.1.152 변경점 정리 — 코드 리뷰 자동 적용과 Skills 신규 프론트매터 (frontmatter)

본 기사는 Claude Code (Anthropic)를 활용하여 작성되었습니다.

검증 가능한 범위 내에서 공개 정보를 정리한 것이지만,

코드 예시 등은 실제 환경에서의 동작 확인을 권장합니다.

2026년 5월 27일, Claude Code v2.1.152가 출시되었다. 이번 업데이트는 /code-review의 대폭 강화와 Skills 프론트매터 (frontmatter)의 확장이 중심이다. "리뷰하고 끝"에서 "리뷰하고 고치기"로 한 걸음 나아간 릴리스라고 할 수 있다. 공식 릴리스 노트와 공식 changelog를 기반으로, 실제 워크플로우에 미치는 영향을 정리한다.

v2.1.152의 변경 사항은 다음 4가지 포인트로 요약할 수 있다.

• /code-review --fix — 리뷰 결과를 working tree에 직접 적용
• /simplify의 변경 — /code-review --fix를 호출하는 에일리어스 (alias)로 통합
• Skills frontmatter의 disallowed-tools 대응 — 스킬 실행 중에 무효화할 도구를 지정 가능하게 함
• /reload-skills 커맨드 추가 — 재시작 없이 스킬을 재스캔

지금까지의 /code-review는 차이점 (diff)을 해석하여 문제점이나 개선안을 열거할 뿐이었다. 수정은 수동으로 진행해야 했으며, 지적 사항이 많으면 대응 비용도 높아지기 쉬웠다.

v2.1.152부터는 --fix 플래그를 붙임으로써, 리뷰 결과를 working tree에 직접 작성하는 단계까지 자동화된다. 공식 릴리스 노트에 따르면 정확성, 재사용성, 간략화, 효율 개선의 4개 축으로 리뷰를 수행하고, 그 자리에서 수정을 적용한다.

effort 레벨과 조합하는 것도 가능하다.

# 공식 docs의 기술에 기반함. 실행 전에 git 작업 트리가 clean한 상태를 권장
/code-review --fix
/code-review high --fix

effort를 high 이상으로 설정하면 지적의 망라성은 높아지지만, 정확도가 낮은 제안도 포함될 가능성이 있다. medium (기본값)으로 --fix를 일상적으로 사용하면서, 중요한 PR 전후에 high로 정밀 조사하는 식의 구분 사용이 공개 정보로 볼 때 자연스러워 보인다.

또한 --comment 플래그 (GitHub PR의 인라인 코멘트 게시)와 --fix는 배타적이지 않으며, 조합도 가능하다.

/simplify는 지금까지 독립된 커맨드로 기능해 왔으나, v2.1.152부터는 /code-review --fix를 호출하는 에일리어스로 변경되었다.

"기존 사용자에게 미치는 영향"이라는 관점에서 중요한 점은, /simplify를 입력하면 제안 표시가 아니라 자동 수정이 실행된다는 점이다. 의도치 않게 파일이 변경되는 사고를 방지하기 위해, 실행 전에 git status로 작업 트리를 확인하는 습관을 들여두는 것이 좋다. 팀에서 Claude Code를 사용하고 있다면, 이 동작 변경을 멤버 간에 공유할 가치가 있다.

Claude Code의 Skills는 .claude/skills/ 이하의 마크다운 (markdown) 파일로 정의하는 커스텀 커맨드다 (공식 스킬 문서). 기존에 frontmatter로 지정할 수 있었던 allowed-tools는 "사용 가능한 도구를 명시적으로 제한하는 허용 리스트"로 기능했다.

v2.1.152에서 추가된 disallowed-tools는 반대로 거부 리스트로 기능한다.

---
name: audit-check
description: 파일을 읽기만 하는 감사 스킬
...

allowed-tools와 disallowed-tools의 구분 사용법을 정리한다.

필드	동작	적합한 케이스
allowed-tools	지정된 도구만 사용 가능	사용할 도구를 엄격하게 제한하고 싶을 때
disallowed-tools	지정된 도구만 무효화	거의 모든 도구를 사용하게 하면서 일부만 금지하고 싶을 때

공개 정보에 따르면, allowed-tools와 disallowed-tools가 모두 지정된 경우 allowed-tools가 우선되며 disallowed-tools는 무시된다. disallowed-tools

가 효력을 발휘하는 것은 allowed-tools가 지정되지 않은 경우뿐이라는 점을 유의해야 한다 (Feature Request #6005 참조).

또한, allowed-tools의 강제 실행에 대해서는 과거 여러 GitHub Issues에서 "설정해도 무시된다"는 보고가 있었다 (Issue #18837). disallowed-tools가 실제 운영 환경에서 어느 정도까지 강제될지는 향후 커뮤니티 리포트를 추적하는 것이 확실하다.

스킬 (Skills)을 추가하거나 편집한 후에는 지금까지 Claude Code의 세션을 재시작해야 했다. v2.1.152에서 추가된 /reload-skills 명령어를 사용하면, 세션을 유지한 채로 .claude/skills/를 재스캔할 수 있다.

스킬을 시행착오를 거치며 개발하는 상황에서는 "편집 → 재시작 → 확인" 사이클을 "편집 → /reload-skills → 확인"으로 단축할 수 있다. 작은 개선이지만, 스킬을 빈번하게 수정하는 개발 단계에서는 누적되어 큰 효과를 발휘하는 변경 사항이다.

v2.1.152의 변경 방향은 명확하다 — 코드 리뷰 (Code Review)가 "지적에서 그치는 문제"를 해소하고, 스킬 (Skills)의 제어를 더욱 세밀하고 반복하기 쉽게 정비하는 것이다.

그중에서도 /code-review --fix는 "리뷰 → 수동 수정" 사이클을 단 하나의 명령어로 줄일 가능성을 가지고 있다. /simplify의 동작 변경은 기존 사용자에게 영향이 있을 수 있으므로 주의가 필요하다. disallowed-tools는 "모든 도구를 허용하면서 일부만 제한하고 싶다"는 설정의 간결함이 매력적이며, 스킬 설계의 폭을 넓혀준다.