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번 재시도하지 않습니다.
- 게이트웨이 로그인이 필요한 머신에서
/loginEsc 동작이 수정되었습니다. 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 서버를 많이 사용하거나, 긴 세션을 재개하거나, 원격 제어 세션을 관리하는 팀은 안정성과 캐시 효율성에서 즉각적인 개선을 볼 수 있습니다. 마켓플레이스 경로 수정은 보안에 민감한 환경에서 중요합니다.
📖 전체 소스 읽기: GitHub Claude-Code
👀 See Also

AutoDream: 안전 기능이 포함된 Claude Code용 11-후크 메모리 시스템
AutoDream은 Claude Code에 프로젝트 메모리 지속성과 명령어 안전성을 추가하는 오픈소스 도구입니다. 6개 이벤트에 걸쳐 11개의 훅을 사용하여 컨텍스트를 주입하고, 위험한 명령어를 차단하며, /compact 작업을 견뎌냅니다.

CC-Wiki: 클로드 코드 세션을 공유 가능한 쿼츠 지식 베이스로 변환하기
CC-Wiki는 ~/.claude 세션 기록을 Quartz 기반 지식 베이스로 변환합니다. 단일 명령어로 설치하고 Claude Code 세션에서 /cc-wiki를 실행하면 대화 내용이 패키징됩니다.

로컬 XMind 마인드 맵 파일을 위한 MCP 서버가 출시되었습니다
한 개발자가 로컬 XMind 마인드맵 파일을 읽고 쓸 수 있는 22가지 도구를 제공하는 MCP 서버를 공개했습니다. 이 서버는 Claude Desktop 및 Cursor와 같은 MCP 호환 AI 클라이언트와 함께 작동합니다.

클로드 코드의 7-에이전트 시스템, 솔로 개발자 위한 스프린트 의식 대체
PM에서 솔로 개발자로 전향한 개발자가 Claude Code 내에 7개의 에이전트 팀을 구축해 QA, PR 리뷰, 보안, 아키텍처, 백로그 정리를 모두 단일 /review 명령어로 처리합니다.