본문으로 건너뛰기

© 2026 Molayo

Qiita헤드라인2026. 05. 28. 00:08

Claude Code v2.1.152 신기능 정리: /code-review --fix 자동 적용 및 MCP 버그 수정

요약

Claude Code v2.1.152 업데이트를 통해 코드 리뷰와 수정을 자동화하는 /code-review --fix 명령어가 도입되었습니다. 또한 MCP 서버 연결 버그 수정, 훅(Hook) 기능 확장, 스킬 동적 설치 등 개발 워크플로우 최적화를 위한 다양한 기능이 추가되었습니다.

핵심 포인트

  • /code-review --fix 명령어로 리뷰와 수정을 한 번에 수행 가능
  • 훅(Hook) 기능을 통한 기밀 정보 마스킹 및 출력 제어 지원
  • egress 프록시 환경에서의 MCP 서버 연결 버그 해결
  • 스킬 실행 중 도구(Tool)를 동적으로 제외하여 정밀 제어 가능
  • 프라이머리 모델 장애 시 fallback-model 지정 기능 지원

Claude Code v2.1.152가 출시되었습니다. 이번 버전에는 코드 리뷰와 수정을 통합한 /code-review --fix 도입, 훅 (Hook) 기능의 대폭 확장, MCP 서버 관련 중요한 버그 수정 등 개발 워크플로우에 직결되는 변경 사항이 다수 포함되어 있습니다.

특히 엔터프라이즈 환경에서 Claude Code를 이용 중인 분, MCP 서버를 커스텀 설정 중인 분, 스킬 (Skill) 및 훅 (Hook)을 활용 중인 분들은 필독하시기 바랍니다.

📌 영향을 받는 대상

  • Claude Code로 코드 리뷰 워크플로우를 자동화하고 있는 개발자
  • egress 프록시 환경에서 원격 MCP 서버를 사용 중인 팀
  • 스킬·훅 기능을 통해 커스텀 워크플로우를 구축하고 있는 분
  • claude agents (멀티 에이전트)를 실무에서 이용 중인 팀

코드 리뷰부터 수정 적용까지 하나의 명령어로 완결할 수 있게 되었습니다. /simplify 또한 동일한 동작의 에일리어스 (Alias)로 통일되었습니다.

명령어동작
/code-review리뷰 결과 표시만 수행
/code-review --fix리뷰 후, 재사용·간소화·효율화 제안을 워킹 트리 (Working Tree)에 직접 적용
/simplify/code-review --fix 의 에일리어스 (동일 동작)

스킬 실행 중에 불필요한 도구 (Tool)를 모델의 이용 가능 리스트에서 동적으로 제외할 수 있게 되었습니다. 의도치 않은 도구 사용을 방지하고, 스킬의 동작 범위를 정밀하게 제어할 수 있습니다.

---
name: my-skill
description: "보안 리뷰 전용 스킬"
...

어시스턴트의 출력 텍스트를 표시할 때 실시간으로 변환하거나 숨길 수 있는 새로운 훅 (Hook) 이벤트입니다.

// 훅 설정 예시
{
"hooks": {
...

주요 유스케이스:

  • 기밀 정보 (API 키, 토큰) 마스킹
  • 출력 텍스트에 커스텀 포맷 적용
  • 특정 조건의 메시지 숨기기

훅 (Hook)을 통해 스킬을 동적으로 설치한 후, 세션 내에서 즉시 이용할 수 있게 되었습니다.

{
"reloadSkills": true,
"sessionTitle": "프로젝트명 - 커스텀 스킬셋"
...

프라이머리 모델 (Primary Model)을 이용할 수 없는 경우, 요청마다 에러가 발생하던 문제가 해결되었습니다.

기동 시 --fallback-model을 지정해 두면, 프라이머리 모델의 장애나 액세스 제한 시에도 작업이 중단되지 않습니다.

Auto 모드 이용 시 필요했던 사전 동의 단계가 폐지되었습니다. 최초 이용 시의 마찰이 줄어들어 즉시 사용을 시작할 수 있습니다.

ID내용영향 범위
change-033모델·로그인 전환 후 thinking-block 시그니처가 남아 세션이 스택(Stack)되는 문제모델·로그인 전환을 빈번하게 하는 사용자 전반
ID내용영향 범위중요도
change-027egress 프록시 활성화 시 원격 MCP 서버 연결 실패프록시 환경 + MCP 이용자🔴 직접 영향
...
⚠️ Breaking Change 상당

v2.1.152 이전 버전을 사용 중인 경우, egress 프록시 환경에서 원격 MCP 서버로의 연결이 완전히 실패합니다. v2.1.152 이상으로 업데이트해 주세요.

# Claude Code 업데이트
npm install -g @anthropic-ai/claude-code@latest
# 버전 확인
...

환경 변수의 차이로만 구분하던 MCP 서버가 지금까지 잘못하여 하나로 중복 제거되었을 가능성이 있습니다. v2.1.152 이후부터는 올바르게 개별 취급됩니다. 설정이 제대로 반영되어 있는지 확인해 주세요.

// 설정 예시: 동일한 명령어로 서로 다른 환경 변수를 가진 MCP 서버
{
"mcpServers": {
...

서브 에이전트 (Sub-agent)를 취소한 후 남아있는 권한 프롬프트를 승인하면 크래시 (Crash)가 발생하던 문제가 있었습니다. v2.1.152 이후에는 수정되었으나, 구버전을 사용 중인 경우에는 주의가 필요합니다.

이전 (v2.1.151 이전)

# 리뷰와 적용이 별도 작업
claude "/code-review"
# → 리뷰 결과를 수동으로 읽고 수정을 수동으로 적용...

이후 (v2.1.152)

# 리뷰부터 적용까지 한 번에
claude "/code-review --fix"
# 또는
...

이전

claude --model claude-opus-4-7
# 프라이머리 모델 (Primary Model) 이용 불가 → 모든 요청이 에러 발생
# Error: Model not found

이후

claude --model claude-opus-4-7 --fallback-model claude-sonnet-4-6
# 프라이머리가 이용 불가 → 세션 전체에서 폴백 모델 (Fallback Model)로 자동 전환
# Switched to fallback model: claude-sonnet-4-6
// .claude/hooks/session-start.js
module.exports = async function sessionStart({ session }) {
// 동적으로 스킬 (Skill) 설치
...

Claude Code v2.1.152의 주요 변경 사항을 정리합니다.

카테고리변경 사항대응 우선순위
🔴 버그 수정egress 프록시 + MCP 연결 실패즉시 업데이트 권장
🆕 신기능/code-review --fix 자동 적용코드 리뷰 워크플로 개선에 활용
🆕 신기능disallowed-tools 스킬 제어스킬 개발자는 적극 활용
🆕 신기능MessageDisplay 훅 (Hook)출력 커스텀이 필요한 경우 활용
✅ 개선폴백 모델 자동 전환--fallback-model 옵션 설정 검토
✅ 개선Auto 모드 동의 폐지기존 사용자는 특히 대응 불필요

egress 프록시 환경에서 MCP를 이용 중인 팀은 v2.1.152로 즉시 업데이트할 것을 권장합니다. 그 외의 사용자들도 /code-review --fixMessageDisplay 훅 등 개발 경험을 향상시키는 신기능을 적극적으로 시도해 보시기 바랍니다.

AI 자동 생성 콘텐츠

본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0