Claude Code v2.1.267: 프롬프트 캐시 수정, 노력 상한, 보안 패치

Anthropic은 9월 9일에 Claude Code v2.1.267을 출시했습니다. 이 패치는 프롬프트 캐시 신뢰성, 모델 노력 상한, macOS 및 Linux의 마켓플레이스 경로에 대한 보안 수정에 중점을 둡니다. 캐시 누락이 발생하거나 동적 도구와 함께 MCP 서버를 사용하는 경우 이 업데이트를 읽어볼 가치가 있습니다.

새로운 설정 및 플래그

• maxEffortLevel: Bedrock, Vertex, Foundry를 포함한 모든 제공업체에서 노력 수준을 제한하는 새로운 최상위 또는 모델별 설정(modelSettings 아래)입니다. 사용자는 여전히 더 낮은 수준을 선택할 수 있지만 상한을 초과할 수 없습니다.
• --system-prompt-snapshot off: 대화의 기록된 프롬프트를 재사용하는 대신 각 요청에 대해 시스템 프롬프트를 새로 렌더링합니다. 프롬프트 텍스트를 반복할 때 유용합니다.

프롬프트 캐시 및 세션 안정성

이 릴리스는 프롬프트 캐시 누락이나 컨텍스트 손실을 유발하는 여러 시나리오를 수정합니다:

• 대화에서 포크된 백그라운드 작업자는 더 이상 세션 중간에 도구 블록에 EnterWorktree를 추가하지 않습니다.
• 세션 중간 MCP 및 플러그인 도구는 이제 ToolSearch가 없는 세션에서 지연되어 캐시 재사용을 보존합니다.
• /model로 모델을 전환해도 더 이상 모든 도구 정의를 다시 보내지 않습니다(이전 캐시 누락). 커밋 및 PR 귀속은 이제 모델 변경 시 업데이트되는 대화 메모로 도착합니다.
• 재개된 세션은 MCP 커넥터가 다른 시간에 다시 연결될 때 인라인 도구 세트를 다시 작성하지 않습니다.
• 재개된 세션은 첫 번째 턴에서 도구 설명을 다시 렌더링하는 대신 기록된 도구 설명을 재생합니다.
• claude.ai 커넥터의 도구가 세션과 재개 사이에 변경될 때 프롬프트 캐시 누락 및 확장된 사고 누락이 수정되었습니다.
• 재개된 세션은 커넥터가 다시 연결되기 전에 이전 MCP 도구 알림을 다시 작성하지 않습니다.
• 인터랙티브하게 재개된 -p 대화는 시스템 프롬프트 접두사를 변경하여 캐시를 깨지 않습니다.
• MCP 서버가 모델이 이미 로드한 도구를 다시 보낼 때 이전 추론이 더 이상 삭제되지 않습니다.
• 대화 중간에 도구가 사라지는 경우(MCP 연결 끊김 또는 업그레이드로 인해) 도구 목록이 다시 작성되지 않아 이전 생각이 버려지지 않습니다.

보안 및 인증 수정

• macOS 및 Linux에서 백슬래시가 포함된 마켓플레이스 항목 경로가 가져온 마켓플레이스 검사를 우회할 수 있는 포함 우회를 수정했습니다.
• allowedHttpHookUrls, httpHookAllowedEnvVars 및 allowedChannelPlugins에 대한 관리 설정은 이제 읽을 수 없을 때 모든 것을 허용하는 대신 아무것도 허용하지 않습니다.
• 만료된 AWS/Google Cloud 자격 증명은 재인증 프롬프트를 표시하기 전에 일반 오류로 10번 재시도하지 않습니다.
• 게이트웨이 로그인이 필요한 머신에서 /login Esc 동작이 수정되었습니다.
• claude remote-control은 이제 서버 자격 증명이 만료될 때 다시 등록하여 세션 끊김을 방지합니다.

기타 수정

• /context 및 기타 로컬 명령이 모바일 클라이언트에서 제대로 렌더링됩니다.
• 에이전트 보기에서 tmux/ssh 세션을 재개한 후 Shift+Enter 및 option+backspace가 다시 작동합니다.
• 전체 화면 모드에서 위로 스크롤할 때 흐릿한 마지막 프롬프트 헤더가 표시됩니다.
• 아티팩트 게시는 연결 끊김 후 알 수 없는 결과를 보고하는 대신 한 번 재시도합니다.
• 아티팩트 게시 오류에는 이제 페이지 파일이 유효한 UTF-8이 아니거나 U+FFFD를 포함하는 경우 줄/열이 포함됩니다.
• 사용자 정의 명령, 스킬 및 하위 에이전트의 effort: frontmatter는 이제 기본 노력 수준이 고정된 모델(Opus 4.7, Opus 4.8, Fable 5)에서 존중됩니다.
• /diff 패널은 더 이상 "0 files changed"가 먼저 깜박이지 않으며 빈 상태가 중앙에 배치됩니다.

업데이트해야 하는 대상

MCP 서버를 많이 사용하거나, 긴 세션을 재개하거나, 원격 제어 세션을 관리하는 팀은 안정성과 캐시 효율성에서 즉각적인 개선을 볼 수 있습니다. 마켓플레이스 경로 수정은 보안에 민감한 환경에서 중요합니다.