Claude Code v2.1.314: blockWritesOutsideWorkingDirectories 및 20개 이상의 버그 수정

Claude Code v2.1.314는 새로운 파일 시스템 가드와 함께 Bedrock, Vertex, MCP, VS Code, CLI 전반에 걸친 안정성 수정을 대거 포함합니다. 가장 눈에 띄는 기능은 Write, Edit, NotebookEdit가 작업 디렉터리 외부 경로를 건드리지 못하게 막는 권한 설정입니다.

새 권한: blockWritesOutsideWorkingDirectories

설정에 다음을 추가하면 파일 편집 도구가 모든 권한 모드(기본 모드뿐 아니라)에서 작업 디렉터리 외부 경로를 거부합니다:

{
  "permissions": {
    "blockWritesOutsideWorkingDirectories": true
  }
}

CI나 공유 머신에서 에이전트를 실행하는 경우, 활성 모드에 따라 도구가 /etc, 홈 닷파일, 또는 형제 저장소에 쓸 수 있었던 틈을 이 설정으로 막을 수 있습니다.

게이트웨이 및 관리자 제어

• Claude 앱 게이트웨이 업스트림이 이제 선택적 groups 목록을 받습니다. 나열된 IdP 그룹의 개발자만 해당 업스트림으로 라우팅되며, 장애 조치 중에도 유지됩니다.
• Bedrock 업스트림에 guardrail_trace가 추가되어, 요청에 어떤 Amazon Bedrock 가드레일 필터가 작동했는지 일치 텍스트를 기록하지 않고 로그로 남깁니다.
• 관리 설정의 관리자 TLS 신뢰 설정이 이제 Claude Desktop 세션에서 실제로 적용됩니다.
• 원격 관리 설정에만 설정된 forceRemoteSettingsRefresh는 저장된 사본이 만료된 후에도 적용이 중단되지 않습니다. 이전에는 서버에 연결할 수 없으면 세션이 정책 없이 시작될 수 있었습니다.

CLI 정확성 수정

• 시작에 실패하면 claude -p가 출력 없이 종료 코드 0으로 끝나던 문제가 수정되었습니다. 이제 오류를 출력하고 종료 코드 1로 종료하므로, 스크립트와 CI가 고장 난 시작을 성공으로 처리하지 않습니다.
• 조직에서 강제한 노력 상한이 있는 세션에서 "Invalid effort level." 오류로 턴이 계속 실패하던 문제가 해결되었습니다. Claude Code가 노력 수준을 낮추고 재시도하며 사용한 수준을 알려줍니다.
• claude ultrareview와 claude remote-control은 CI가 설정된 경우 워크스페이스 신뢰 질문을 하지 않고, 신뢰할 수 없는 폴더를 즉시 거부합니다.
• claude mcp logout은 로그인 제거가 실패한 경우(예: SSH를 통한 잠긴 macOS 키체인) 성공으로 보고하지 않습니다.
• 8초 이상 걸리는 Remote Control 모델 전환이 "still pending" 오류 대신 최종 결과를 반환하며, 세션 서비스가 느릴 때 워커 등록이 점증 대기로 재시도합니다.

Bedrock, Foundry, TLS

• 이미지가 많은 Bedrock 세션이 매 턴 실패하거나 /compact가 "400 Input is too long"을 반환하던 문제가 해결되었습니다. 압축 전에 오래된 이미지가 제거됩니다.
• 기본 Sonnet, Opus, Haiku 모델이 없는 Microsoft Foundry 배포는 실패하는 대신 같은 계열의 이전 모델로 대체됩니다.
• 시스템 인증서 저장소에 이전 인증서와 교차 서명된 갱신 루트가 있을 때 TLS 연결에서 발생하던 UNABLE_TO_GET_ISSUER_CERT 오류가 수정되었습니다.
• 도구 검색의 tool_reference 블록을 거부하는 게이트웨이는 도구 검색 없이 한 번 재시도하며, 세션이 해당 대체 동작을 기억합니다.

UI 및 백그라운드 세션 수정

• VS Code와 Claude Desktop의 Code 탭이 이제 유휴 압축을 수행합니다. 유휴 상태인 20만+ 토큰 대화는 요약되며, 프롬프트 캐시가 만료된 경우 다음 메시지에 해당 요약이 사용됩니다.
• PreCompact 훅의 출력이 10,000자로 잘리므로, 출력이 많은 훅이 압축을 실패시키거나 반복시키지 않습니다.
• 백그라운드 diff 새로고침이 잠시 저장소 인덱스 잠금을 잡아 "Unable to create '.git/index.lock': File exists." 오류로 동시 git 명령이 깨지던 문제가 해결되었습니다.
• Markdown 표가 스트리밍 중 반쯤 입력된 행에서 그리드와 스택 레이아웃 사이를 오가지 않으며, 긴 표도 원시 파이프로 대체되지 않습니다.
• "Continue automatically at usage limit"은 작업이 대기 사이에 스스로 재시작될 때 세 번의 계속에서 중지됩니다.
• Ultracode는 비활성화된 후 다음 백그라운드 또는 클라우드 세션 시작 시 다시 활성화되지 않고 꺼진 상태로 유지됩니다.

기타 수정

• /resume 선택기가 세션이 슬래시 명령만 실행한 경우 CLAUDE.md 또는 CLAUDE.local.md 텍스트를 세션 제목으로 표시하지 않습니다.
• 서브에이전트 트랜스크립트에서 실행한 /btw는 이제 메인 대화가 아닌 해당 트랜스크립트를 기반으로 답변합니다.
• SSH를 통해 Linux로 이미지를 붙여넣을 때 아무 반응 없이 끝나는 대신, 파일을 복사하고 경로를 붙여넣으라는 안내를 출력합니다.
• 사용자가 제공한 --plugin-dir 또는 --plugin-url 플러그인이 관리 플러그인 설정과 함께 존재하는 경우에도 모델 전환이 작동합니다.
• 관리 설정에서 모델을 고정한 경우 Bedrock/Vertex 모델 업그레이드 제안이 매 시작 시 다시 나타나지 않습니다.

CI에서, 여러 클라우드 제공자에 걸쳐, 또는 게이트웨이 뒤에서 Claude Code를 실행하는 분이라면 이 버전을 적용해야 합니다. claude -p 종료 코드 수정만으로도 조용히 묻히던 실패를 잡아낼 수 있습니다.