Claude Code v2.1.251: 모델 전환 훅, 지출 한도 바, 및 보안 수정

Claude Code v2.1.251이 몇 가지 새로운 기능과 보안 수정 사항을 포함하여 출시되었습니다. 주요 내용으로는 모델 전환 훅, Remote Control로의 실시간 서브에이전트 스트리밍, 지출 한도 바, 파일 도구 심볼릭 링크 및 플러그인 경로 탐색 취약점 패치가 있습니다.

모델 전환 훅 및 세션 시작 개선

두 가지 새로운 훅 이벤트(PreModelSwitch, PostModelSwitch)를 통해 모델 변경을 가로챌 수 있습니다. 이를 통해 전환을 차단하거나 확인하거나 주석을 달 수 있습니다. 또한 SessionStart 재개 훅은 이제 세션의 오래됨과 예상 재캐시 비용을 수신하여 세션 재개 시 더 많은 컨텍스트를 제공합니다.

Remote Control로의 실시간 서브에이전트 스트리밍

포그라운드 서브에이전트의 도구 호출 및 결과가 이제 Remote Control 클라이언트로 실시간 스트리밍됩니다. 백그라운드 서브에이전트(기본값)는 여전히 상태만 표시합니다. 이는 서브에이전트가 실시간으로 정확히 무엇을 하는지 확인해야 할 때 디버깅에 유용합니다.

지출 한도 바 및 캐시 통계

지출 한도가 있는 Claude 앱 게이트웨이 뒤의 팀을 위해 /usage에 이제 지출 한도 바가 표시됩니다. 상태 줄 스크립트는 rate_limits.spend_limit에 접근할 수 있습니다. 또한 /cost는 이제 세션별 프롬프트 캐시 줄(적중률, 미스, 재캐시된 토큰, 웜/콜드)과 상태 줄 스크립트를 위한 일치하는 prompt_cache 객체를 표시합니다.

CLI 도움말 개선

claude --help에 이제 attach, logs, stop, respawn, rm 명령이 포함됩니다. 실행 중인 백그라운드 세션에 대한 --resume 메시지는 이제 사용할 정확한 claude attach <id> 명령을 지정합니다.

보안 수정

이번 릴리스는 여러 보안 문제를 해결합니다:

• 파일 도구(읽기, 쓰기, 편집)는 권한 확인 후 작업 디렉터리 내부에서 교체된 심볼릭 링크를 더 이상 따르지 않아 승인된 위치 외부의 읽기/쓰기를 방지합니다.
• 마켓플레이스 항목에 선언된 플러그인 명령은 더 이상 플러그인 디렉터리 외부를 가리킬 수 없으며, 이러한 경로는 경로 탐색 오류로 거부됩니다.
• 프로젝트 설정은 더 이상 상세 베타 추적 또는 원시 API 본문 로깅을 활성화할 수 없으며, 하위 범위 베타 추적 엔드포인트는 관리 설정 또는 호스트 앱에 고정된 OTLP 수집기를 더 이상 우회할 수 없습니다.
• Workflow 도구는 이제 세션의 허용 범위 외부의 scriptPath를 읽기 전에 권한을 확인합니다.
• Grep 및 Glob은 이제 심볼릭 링크된 검색 경로를 통해 도달한 파일에 Read(...) 거부 규칙을 적용합니다.

버그 수정 및 개선

기타 주목할 만한 수정 사항:

• 생각만 있는 턴 후 "텍스트 콘텐츠 블록은 비어 있지 않아야 합니다" 오류로 대화가 멈추는 문제를 수정했습니다.
• 새 설치 시 첫 실행이 이제 자동 모드 기본값을 따릅니다.
• 생각 비활성화된 Opus 5 요청(노력 xhigh/max)은 이제 노력을 high로 보냅니다.
• 다른 Claude Desktop 세션의 메시지에 답장이 이제 올바르게 전달됩니다.
• 많은 병렬 서브에이전트가 있을 때 TUI 지연이 줄었습니다: 초당 진행 틱이 이전 것을 대체하여 쌓이지 않습니다.
• 에이전트 팀: 팀원의 최종 답변이 이제 유휴 알림을 통해 팀 리더에게 도달합니다.
• 백그라운드 서브에이전트는 이제 이름 없는 형제 또는 상위 에이전트의 메시지에 답장할 수 있습니다.
• 세션 중간에 도착하는 관리 설정 disableAutoMode가 이제 올바르게 기본 모드로 전환됩니다.
• 현재 모델이 이미 1M 컨텍스트인 경우 Opus 1M으로 전환하라는 오해의 소지가 있는 팁을 수정했습니다.
• 게이트웨이 세션은 더 이상 저장된 Anthropic 프로필을 활성으로 취급하지 않습니다.
• Remote Control은 정책에 의해 허용되지 않을 때 실패를 보고하지 않고 조용한 알림을 표시합니다.
• Remote Control의 /mcp reconnect는 일반 오류 대신 실제 해결책을 표시합니다.
• 보조 도구 호출에 메시지 ID가 없을 때 --input-format stream-json이 결과를 잃는 문제를 수정했습니다.
• 세션 기록이 디렉터리 변경으로 세션이 이동될 때 더 이상 조용히 덮어쓰이지 않습니다.
• 백그라운드 세션은 이제 자신이 만든 git 작업 트리 내의 파일을 편집할 수 있습니다.
• 다른 프로세스가 마켓플레이스를 새로 고칠 때 플러그인 기술 없이 백그라운드 세션이 시작되는 문제를 수정했습니다.
• tmux over SSH에서 텍스트 선택이 포그라운드 세션처럼 tmux 버퍼에 복사됩니다.

전체 세부 사항 및 다운로드 링크는 공식 릴리스 노트에 있습니다.