
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-027 | egress 프록시 활성화 시 원격 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 --fix나 MessageDisplay 훅 등 개발 경험을 향상시키는 신기능을 적극적으로 시도해 보시기 바랍니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기