Claude Code 2.1.117 업데이트

무엇이 바뀌었나?

Claude Code 2.1.117이 2026년 4월 22일에 릴리스되었습니다. Opus 4.7의 /context 퍼센트가 기존엔 200K 기준으로 계산돼 조기 autocompact이 발생하던 버그가 네이티브 1M 컨텍스트로 정정되었습니다. /model 선택이 재시작 후에도 유지되고, /resume이 오래된 대용량 세션을 재읽기 전 요약을 제안합니다. macOS·Linux 네이티브 빌드에서는 별도의 Glob/Grep 도구 대신 Bash의 내장 bfs·ugrep를 통해 검색이 수행됩니다.

새 기능·개선

Opus 4.7 /context 계산을 1M 네이티브로 수정

Claude Code가 Opus 4.7 세션의 컨텍스트를 200K 창 기준으로 계산해 실제 사용량보다 퍼센트가 부풀려 표시되고 autocompact이 일찍 걸리는 문제가 있었습니다. 이제 Opus 4.7의 네이티브 1M 컨텍스트 창을 기준으로 계산합니다.
/model 선택이 재시작 후에도 유지

프로젝트 또는 관리자 설정이 다른 모델을 핀으로 고정해 두면, 사용자가 /model로 바꾼 선택이 재시작 시 되돌아가 혼란스러웠습니다. 이제 사용자 선택이 유지되며, 시작 헤더에 현재 활성 모델이 프로젝트 핀·관리자 설정에서 오는지 함께 표시됩니다.
/resume의 stale 대용량 세션 요약 제안

오래된 대용량 세션을 /resume할 때 재읽기만으로 시간이 많이 걸렸습니다. 이제 --resume 플래그와 마찬가지로 /resume도 재개 전에 요약 옵션을 제안합니다.
네이티브 빌드의 Glob/Grep이 Bash의 bfs/ugrep로 교체

macOS·Linux 네이티브 빌드에서 Glob·Grep 도구가 별도의 도구 라운드트립을 거쳐 실행되었습니다. 이제 bfs와 ugrep가 Bash 도구 내에 내장돼 라운드트립 없이 더 빠르게 검색됩니다. Windows와 npm 설치 빌드는 기존 방식 그대로.
로컬+claude.ai MCP 서버 동시 연결

로컬 MCP 서버와 claude.ai MCP 서버가 함께 설정된 환경에서 시작 연결이 순차적이어서 시동이 느렸습니다. 이제 concurrent connect가 기본이 되어 두 쪽을 동시에 연결합니다.
Pro/Max 기본 effort를 high로 상향

Pro/Max 구독자가 Opus 4.6·Sonnet 4.6을 쓸 때 기본 effort가 medium이었습니다. 이제 high가 기본이며, 속도보다 지능이 필요한 일상 작업에서 별도 /effort 조정 없이 나은 결과를 얻습니다.
포크 서브에이전트를 외부 빌드에서도 활성화

CLAUDE_CODE_FORK_SUBAGENT=1로 외부 빌드에서도 포크 기반 서브에이전트를 켤 수 있습니다.
메인 스레드 에이전트가 mcpServers도 상속

--agent로 메인 스레드 에이전트를 실행할 때 agent frontmatter의 mcpServers가 로드되지 않아 전용 MCP 세팅이 비어 있던 문제가 2.1.116의 hooks: 수정에 이어 이번에 보완되었습니다.
plugin install이 누락 의존성만 보충

이미 설치된 플러그인에 plugin install을 실행하면 “already installed”에서 멈춰 의존성이 모자라도 추가되지 않았습니다. 이제 의존성만 따로 설치합니다.
플러그인 의존성 오류 메시지 개선

“not installed” 표시와 함께 설치 힌트가 붙고, claude plugin marketplace add가 설정된 마켓플레이스에서 누락 의존성을 자동 해결합니다.
Managed-settings 플러그인 정책 전 구간 적용

blockedMarketplaces·strictKnownMarketplaces가 이제 install·update·refresh·autoupdate 전 경로에서 강제됩니다. 관리자가 설정한 화이트리스트/블랙리스트가 자동 업데이트에 의해 우회되는 문제 해결.
Advisor Tool (experimental) 정돈

대화상자에 “experimental” 레이블, learn-more 링크, 활성화 시 시작 알림이 추가되었습니다. 프롬프트와 /compact마다 “Advisor tool result content could not be processed” 오류로 세션이 막히던 문제도 함께 해결.
cleanupPeriodDays 정리 범위 확장

기존에는 일부 디렉토리만 정리되었습니다. 이제 ~/.claude/tasks/, ~/.claude/shell-snapshots/, ~/.claude/backups/까지 동일한 보존 기간 스윕에 포함됩니다.
OpenTelemetry 메트릭 확장 및 리댁션

user_prompt 이벤트에 슬래시 커맨드의 command_name·command_source가 포함되고, cost.usage·token.usage·api_request·api_error에 모델이 지원할 때 effort 속성이 추가됩니다. 커스텀/MCP 커맨드 이름은 OTEL_LOG_TOOL_DETAILS=1이 설정돼 있지 않으면 리댁트됩니다.
Windows where.exe 캐싱

프로세스 단위로 실행 파일 조회를 캐시해 서브프로세스 실행이 빨라집니다.

주요 버그 수정

인증·세션

Plain-CLI OAuth 세션이 “Please run /login”으로 죽던 문제 — 세션 중 액세스 토큰이 만료되면 401이 리액티브로 잡혀 토큰이 자동 리프레시됩니다.
CLAUDE_CODE_OAUTH_TOKEN으로 시작한 세션의 /login 무효 — 해당 환경변수로 시작했을 때 토큰 만료 후 /login이 아무 효과가 없던 문제 수정.

모델·백엔드

Opus 4.7 Bedrock 400 — application-inference-profile ARN을 Opus 4.7로 쓰면서 thinking을 비활성화했을 때 400이 나던 문제 수정.
MCP elicitation/create 자동 취소 — print/SDK 모드에서 서버가 턴 중에 연결을 마치면 요청이 자동 취소되던 문제 수정.
SDK reload_plugins의 MCP 직렬 재연결 — 모든 MCP 서버를 순차적으로 재연결하던 것을 병렬화.
서브에이전트 malware 경고 오탐 — 메인과 다른 모델로 실행되는 서브에이전트가 파일 읽기를 malware로 오탐하던 문제 수정.

네트워크·도구

WebFetch의 대용량 HTML hang — HTML→Markdown 변환 전에 입력을 잘라내 멈춤 해결.
프록시 HTTP 204 크래시 — TypeError 대신 명확한 오류 메시지가 표시됩니다.
Bun에서 NO_PROXY 미반영 — Bun 런타임으로 실행할 때 원격 API 요청에도 NO_PROXY가 적용됩니다.

터미널·입력

Ctrl+_ 프롬프트 undo — 타이핑 직후 undo가 동작하지 않거나 한 단계를 건너뛰던 문제 수정.
Slow connection spurious escape/return — 키 이름이 coalesced 텍스트로 들어올 때 드물게 escape·return이 잘못 트리거되던 문제 수정.

기타

Linux idle re-render 루프 — 백그라운드 태스크가 있을 때 메모리가 계속 늘어나던 문제 수정.
[VS Code] Manage Plugins 패널 — 대용량 마켓플레이스가 여럿 설정된 경우 패널이 깨지던 문제 수정.

알아두면 좋은 점

Opus 4.7을 길게 쓰는 워크플로우라면 /context 퍼센트와 autocompact 타이밍이 크게 달라집니다. 이전 빌드에서 “자꾸 컨텍스트가 빨리 차는 것 같다”는 체감이 있었다면 이번 릴리스에서 정상화됩니다.
macOS·Linux 네이티브 빌드에서는 검색이 Glob/Grep 대신 Bash의 bfs/ugrep로 수행됩니다. 권한 allowlist에 Glob/Grep을 따로 넣어두었다면 Bash 쪽 룰로도 동작 확인 필요.
Pro/Max 구독자는 Opus 4.6·Sonnet 4.6 기본 effort가 high로 올라가므로, 필요 시 /effort로 개별 세션에서 낮출 수 있습니다.