Claude Code v2.1.74~76: MCP Elicitation, /effort 커맨드, 메모리 릭 수정까지

안녕하세요, Tom입니다.

Claude Code가 정말 무서운 속도로 업데이트되고 있어요. 지난번 v2.1.72 소식을 전해드린 게 엊그제 같은데, 벌써 v2.1.76까지 나왔네요. 3월 12일부터 16일까지 단 5일 사이에 세 번이나 릴리스가 되어서 이번에도 내용을 꽉꽉 눌러 담아 한 번에 정리해 드릴게요.

이번 업데이트들은 단순한 버그 수정을 넘어서, MCP 서버와의 상호작용 방식이 바뀌고 성능 최적화가 대거 이뤄졌어요. 특히 대규모 프로젝트를 다루는 분들이나 장시간 Claude와 대화하는 분들에게 반가운 소식이 많아요.

그럼 어떤 점들이 바뀌었는지 하나씩 아주 자세히 살펴볼까요?

주요 신기능

이번 릴리스의 주인공은 단연 MCP Elicitation과 /effort 커맨드예요.

🎯 MCP Elicitation 지원 (v2.1.76)

이 기능은 정말 혁신적이에요. 이제 MCP 서버가 작업을 수행하다가 중간에 사용자에게 추가 정보나 입력을 요청할 수 있어요.

기존에는 도구가 실행되면 결과가 나올 때까지 기다려야 했지만, 이제는 대화 도중에 인터랙티브한 다이얼로그(폼 필드나 브라우저 URL 등)를 통해 구조화된 입력을 받을 수 있게 된 거죠.

개발자분들을 위해 Elicitation과 ElicitationResult 훅도 함께 추가되었어요. 이를 통해 입력 요청이 발생했을 때나 결과가 돌아왔을 때 특정 로직을 실행하도록 커스텀할 수 있어요.

이 기능 덕분에 앞으로 더 복잡하고 인터랙티브한 MCP 도구들이 많이 나올 것 같아요. 예를 들어, 인증이 필요한 도구가 실행될 때 Claude가 사용자에게 로그인 URL을 보여주고 입력을 기다리는 식의 워크플로우가 가능해지겠죠.

🎯 /effort 슬래시 커맨드 (v2.1.76)

모델의 작업 강도(Model effort level)를 직접 설정할 수 있는 커맨드가 생겼어요.

복잡한 아키텍처 설계나 어려운 버그를 잡을 때는 높은 강도로 설정하고, 단순한 오타 수정이나 파일 목록 확인 같은 가벼운 작업은 낮은 강도로 설정해서 효율적으로 사용할 수 있어요. 상황에 맞게 Claude의 에너지를 조절한다고 생각하면 편해요.

불필요한 자원 소모를 줄이면서도 필요한 순간에는 최대의 성능을 끌어낼 수 있는 아주 합리적인 기능이에요.

🎯 대규모 모노레포를 위한 sparsePaths (v2.1.76)

worktree.sparsePaths 설정이 추가되었어요. Git의 sparse-checkout 기능을 활용하는 건데, 수만 개의 파일이 있는 거대한 모노레포에서 Claude가 전체를 다 훑지 않고 필요한 경로만 지정해서 작업할 수 있게 도와줘요.

프로젝트 규모가 너무 커서 초기 인덱싱이나 검색이 느렸던 분들에게는 정말 필수적인 기능이 될 것 같아요. 특히 수백 개의 패키지가 얽혀 있는 모노레포 환경에서 특정 패키지만 집중적으로 수정할 때 속도 차이가 확연할 거예요.

🎯 /context 커맨드의 진화 (v2.1.74)

이제 /context를 입력하면 단순히 현재 상태만 보여주는 게 아니라, 실행 가능한 제안(Actionable suggestions)들을 함께 띄워줘요.

예를 들어 컨텍스트를 너무 많이 잡아먹는 도구가 실행 중이라거나, 메모리 팽창(Memory bloat)이 감지되었을 때, 혹은 컨텍스트 용량 경고가 떴을 때 Claude가 어떻게 조치하면 좋을지 바로 알려줘요.

사용자가 일일이 상태를 체크하고 판단할 필요 없이, Claude가 가이드를 주니까 훨씬 스마트하게 도구를 관리할 수 있게 되었어요.

DX 및 UX 개선

개발자 경험을 높여주는 세세한 개선사항들도 정말 꼼꼼하게 챙겼더라고요.

세션 이름 지정: -n 또는 --name CLI 플래그로 세션에 이름을 붙일 수 있어요. 나중에 세션 목록을 관리할 때 훨씬 직관적이겠죠? (v2.1.76)
세션 품질 설문: feedbackSurveyRate 설정이 추가되었어요. 세션이 끝날 때 만족도 조사를 얼마나 자주 띄울지 조절할 수 있는데, 앤스로픽이 사용자 피드백을 더 정교하게 수집하려는 의도가 보이네요. (v2.1.76)
보이스 모드 개선: 이제 받아쓰기 중인 언어가 화면에 표시되고, 윈도우에서 npm을 통해 실행할 때 발생하던 문제도 해결되었어요. (v2.1.76)
코드 리뷰 개선: v2.1.75에서 추가된 내용인데, 인라인 코멘트를 달 때 confirmed=true를 전달해서 배치 출력이 더 깔끔하고 확실하게 처리되도록 개선되었어요. (v2.1.75)
커스텀 메모리 경로: autoMemoryDirectory 설정으로 자동 메모리 저장 위치를 직접 정할 수 있어요. 클라우드 드라이브에 동기화해서 여러 기기에서 메모리를 공유하고 싶은 분들에게 유용하겠네요. (v2.1.74)
원격 제어(Remote Control) 강화: 세션 타이틀이 첫 번째 프롬프트에서 자동으로 생성되고, 유휴 상태에서 세션이 끊기거나 메시지가 밀리는 현상들이 대폭 개선되었어요. (v2.1.76)
모델 폴백 알림: 모델이 자동으로 전환될 때 사용자 친화적인 이름으로 표시되고, 항상 눈에 잘 띄도록 개선되었어요. (v2.1.76)
다크 테마 가독성: 인용구(Blockquote)의 가독성이 다크 테마에서 더 좋아졌어요. (v2.1.76)
PostCompact 훅: 컨텍스트 압축이 끝난 후 실행되는 훅이 추가되어 자동화 워크플로우를 더 정교하게 짤 수 있게 되었어요. (v2.1.76)

버그 수정 및 안정성 개선

이번 업데이트에서 가장 중요한 부분 중 하나가 바로 안정성이에요. 특히 메모리 릭 수정은 모든 사용자에게 필수적인 업데이트예요.

⚠️ 메모리 릭 수정 (v2.1.74)

Node.js 환경에서 스트리밍 API 응답 버퍼가 조기에 종료될 때 제대로 해제되지 않아 메모리 점유율(RSS)이 무한정 높아지던 치명적인 버그가 잡혔어요. 장시간 세션을 유지할 때 시스템이 느려지던 현상의 주범이었는데, 이제는 안심하고 오래 켜두셔도 돼요.

⚠️ 자동 압축(Auto-compaction) 서킷 브레이커 (v2.1.76)

컨텍스트 압축이 실패할 때 무한 루프에 빠져서 계속 재시도하는 현상을 막기 위해, 3번 시도 후 멈추는 서킷 브레이커가 도입되었어요. 또한 1M 컨텍스트 세션에서 "Context limit reached" 오류가 발생하던 문제도 해결되었고요.

⚠️ 윈도우 환경 최적화 (v2.1.74, v2.1.76)

윈도우 사용자분들이 겪던 고질적인 문제들이 대거 수정되었어요.

LSP 서버가 파일 URI 형식이 잘못되어 작동하지 않던 버그 수정
Windows Terminal, conhost, VS Code에서 히브리어, 아랍어 등 우측 정렬(RTL) 텍스트 렌더링 개선
보이스 모드 권한 다이얼로그에서 키 입력이 무시되던 현상 수정
npm을 통한 /voice 커맨드 실행 오류 수정

💡 기타 주요 수정 사항

슬래시 커맨드: "Unknown skill"이라고 뜨거나 입력이 조용히 사라지던 문제, 그리고 소프트 히든(Soft-hidden) 커맨드를 찾지 못하던 버그가 해결되었어요.
MCP 연결: 재연결 스피너가 계속 떠 있거나 OAuth 인증 시 콜백 포트 충돌로 멈추던 현상, 토큰 만료 후 재인증이 안 되던 문제들이 수정되었어요.
플러그인: 마켓플레이스 업데이트 시 Git 서브모듈이 동기화되지 않던 문제와 로컬 개발 복사본이 마켓플레이스 플러그인을 제대로 덮어쓰지 못하던 로직이 개선되었어요.
보안: 사용자의 허용 규칙이 관리 정책을 우회하던 문제나 스킬에 허용된 도구 관련 권한 로직이 더 깐깐해졌어요.
Bash 권한: 따옴표가 포함된 인자가 있는 명령어를 실행할 때 권한 규칙이 제대로 매칭되지 않던 버그가 수정되었어요.
스크롤 및 UI: VS Code 익스텐션에서 스크롤 휠 반응성이 좋아졌고, 텍스트 선택 후 트랜스크립트가 자동으로 스크롤되지 않던 문제도 해결되었어요.
지연된 도구(Deferred tools): 압축 후에 입력 스키마를 잃어버리던 문제가 수정되었어요.
플랜 모드: 이미 승인된 작업에 대해 다시 승인을 요청하던 번거로움이 사라졌어요.
적응형 생각(Adaptive thinking): 표준이 아닌 모델 문자열을 사용할 때 지원되지 않는다는 오류가 뜨던 현상이 수정되었어요.

성능 및 기타 개선

시작 속도: --worktree 옵션을 사용할 때의 시작 성능이 향상되었어요. (v2.1.76)
백그라운드 에이전트: 에이전트를 강제 종료해도 부분적인 결과는 보존되도록 개선되었어요. (v2.1.76)
정리 로직: 병렬 실행 중 중단된 세션의 지저분한 워크트리를 자동으로 청소해 주는 기능이 추가되었어요. (v2.1.76)
클립보드: SSH를 통한 tmux 환경에서도 클립보드 복사가 잘 작동하게 되었어요. (v2.1.76)
플러그인 경로: --plugin-dir 플래그가 이제 하나의 경로만 받도록 업데이트되었어요. 여러 경로를 쓰려면 플래그를 여러 번 사용하면 돼요. (v2.1.76)
세션 종료 훅: SessionEnd 훅이 1.5초 만에 강제 종료되던 문제를 환경 변수로 조절 가능하게 수정했어요. (v2.1.74)

Tom의 생각

이번 v2.1.74~76 업데이트를 보면서 느끼는 건, Claude Code가 이제 단순한 CLI 도구를 넘어 하나의 완성된 개발 플랫폼으로 진화하고 있다는 거예요.

특히 MCP Elicitation은 정말 큰 변화라고 생각해요. 지금까지는 AI가 도구를 실행하면 사용자는 그 결과를 기다리기만 했잖아요? 이제는 AI와 도구, 그리고 사용자가 실시간으로 소통하며 작업을 완성해 나가는 그림이 그려져요. 이건 마치 옆에 있는 동료 개발자가 "이 부분은 어떻게 할까요?"라고 물어보는 것과 비슷한 경험을 줄 것 같아요.

그리고 메모리 릭 수정은 정말 반가워요. 저도 가끔 Claude Code를 오래 띄워두면 컴퓨터가 무거워지는 느낌을 받았는데, 이번 업데이트로 훨씬 쾌적하게 코딩할 수 있을 것 같아요. 앤스로픽이 성능 최적화와 안정성에 얼마나 진심인지 알 수 있는 대목이죠.

sparsePaths 기능도 주목할 만해요. 요즘 모노레포를 쓰는 팀이 정말 많은데, 전체 코드를 다 읽지 않아도 된다는 건 속도 면에서나 비용 면에서나 엄청난 이득이거든요.

윈도우 환경에 대한 지원이 계속 강화되는 것도 긍정적이에요. 초기에는 맥 위주라는 느낌이 강했는데, 이제는 어떤 OS에서도 최고의 경험을 주려고 노력하는 게 보이네요. 특히 RTL 텍스트 지원이나 윈도우 전용 버그들을 빠르게 잡아내는 걸 보면 앤스로픽의 실행력이 대단하다는 생각이 들어요.

마지막으로 /effort 커맨드는 Claude를 더 똑똑하게 쓰는 방법을 제시해 줘요. 무조건 최고 성능으로 돌리는 게 아니라, 작업의 난이도에 맞춰서 자원을 배분하는 건 아주 합리적인 접근이죠.

여러분도 지금 바로 업데이트해서 새로운 기능들을 써보세요! 특히 /effort 커맨드로 작업 강도를 조절해 보면서 본인에게 맞는 설정을 찾아보시는 걸 추천드려요.

Claude Code가 어디까지 발전할지 정말 기대되네요. 저는 또 새로운 소식으로 찾아올게요!

💡 업데이트 팁: 새로운 기능 100% 활용하기

이번 업데이트로 추가된 기능들을 더 잘 활용할 수 있는 몇 가지 팁을 정리해 봤어요.

1. /effort 커맨드 활용법

Low Effort: 간단한 코드 설명 요청, 파일 목록 확인, 오타 수정 등 가벼운 작업에 사용하세요. 토큰 소모를 줄이고 응답 속도를 높일 수 있습니다.
High Effort: 새로운 기능 구현, 복잡한 버그 디버깅, 대규모 리팩토링 등 깊은 사고가 필요한 작업에 설정하세요. Claude가 더 신중하고 꼼꼼하게 코드를 분석합니다.

2. sparsePaths 설정하기

모노레포를 사용 중이라면 .claude/config.json 파일에 다음과 같이 설정해 보세요.

{
  "worktree.sparsePaths": ["src/packages/my-app", "src/shared/utils"]
}

이렇게 하면 Claude가 지정된 경로 외의 파일들은 무시하므로, 훨씬 쾌적한 작업 환경을 만들 수 있습니다.

3. 세션 이름 지정하기

여러 프로젝트를 동시에 진행하거나, 특정 주제로 긴 대화를 나눌 때는 세션을 시작할 때 이름을 붙여주세요.

claude -n "auth-refactoring"

나중에 claude list 명령어로 세션을 확인할 때 어떤 작업을 했는지 한눈에 알 수 있어 관리가 매우 편해집니다.

4. /context 제안 확인하기

작업 중에 Claude가 갑자기 느려지거나 답변이 이상하다면 바로 /context를 입력해 보세요. Claude가 현재 컨텍스트 상태를 분석해서 "메모리가 너무 많이 사용되고 있으니 세션을 새로 시작하세요" 같은 구체적인 조언을 해줄 거예요.

🚀 업데이트 방법

Claude Code를 최신 버전으로 업데이트하는 방법은 아주 간단해요. 터미널에서 다음 명령어를 입력해 주세요.

npm install -g @anthropics/claude-code

만약 pnpm이나 yarn을 사용하신다면 각각의 패키지 매니저에 맞는 명령어를 사용하시면 됩니다. 업데이트 후에는 claude --version 명령어로 v2.1.76이 잘 설치되었는지 확인해 보세요!

참고 링크:

출처 및 참고 링크: