Claude Code v2.1.281: Bedrock assume_role, Guardrails, 그리고 다수의 재개 수정 사항

Claude Code v2.1.281이 출시되었습니다. 대부분 게이트웨이 관련 내부 개선과 세션 재개 및 프록시 버그 수정에 대한 빽빽한 변경 로그입니다. 게이트웨이나 Bedrock 업스트림 뒤에서 Claude Code를 운영한다면, 처음 세 가지 항목이 가장 중요합니다.

Claude 앱 게이트웨이 변경 사항

• 최신 Claude Desktop 키가 이제 데스크톱 정책 블록에서 지원됩니다. blockReadsOutsideWorkingDirectories와 disableBypassPermissionsMode가 포함됩니다.
• Bedrock 업스트림의 assume_role: 게이트웨이가 STS를 통해 맡은 IAM 역할로 Bedrock을 호출하며, 필요한 경우 다른 AWS 계정의 역할을, 선택적으로 개발자당 하나의 세션을 사용할 수 있습니다.
• Bedrock 업스트림의 guardrail: {id, version}은 해당 업스트림을 통해 전송되는 모든 요청에 Amazon Bedrock 가드레일을 적용합니다. 제약 사항에 유의하세요: 모든 Bedrock 업스트림에 설정하거나, 아예 설정하지 않아야 합니다.
• telemetry.resource_attributes를 사용하면 Claude Desktop 및 /login 세션의 텔레메트리에 고정 라벨을 붙일 수 있습니다.

Attribution 끄기, 그리고 버전 간 주의 사항

settings.json에 "attribution": false를 설정하면 모든 커밋 및 PR attribution이 숨겨집니다. 설정 파일을 공유 저장소에 커밋하는 경우 두 번 읽어볼 만한 주의 사항이 있습니다:

{
  "attribution": false
}

이전 CLI 버전은 이 키가 들어 있는 설정 파일을 건너뜁니다. 따라서 여러 버전에서 공유되는 파일에는 객체 형태로 유지하세요. 단독 불리언 형태는 피해야 할 버전입니다.

MCP 및 플러그인 도구

• 2026-07-28 프로토콜 연결에서의 MCP URL 모드 elicitation — 서버가 Claude Code에 브라우저 기반 흐름을 열도록 요청할 수 있습니다. 서버가 완료를 확인할 방법이 없을 때 화면에 대기 대화상자가 남지 않습니다.
• claude plugin validate가 이제 MCP 서버를 검사하고, 로드 시 조용히 무시될 .mcp.json 항목, 선언되지 않은 ${user_config.*} 참조, 안전하지 않은 URL을 보고합니다.
• /insights에 자동 모드 추천이 추가되어, 최근 세션에서 자동 모드가 처리할 수 있었던 권한 프롬프트 수를 추정합니다.
• /skills, /mcp, /plugin의 설치됨 목록이 전체 화면 모드에서 /workflows처럼 스크롤바(마우스 오버, 클릭, 드래그 가능)를 갖게 되었습니다.

수정 목록

이번 릴리스의 대부분은 재개된 세션과 스트림에 대한 수리 작업입니다. 주요 내용:

• API 요청 재시도 도중 세션을 종료시킬 수 있었던 충돌("복구 불가능한 인터페이스 오류").
• 모델이 파싱 불가능한 도구 호출과 출력 제한 잘림을 번갈아 발생시킬 때 --max-turns를 무시하고 턴이 무한 재시도될 수 있던 문제.
• 재개된 세션이 이전 턴을 변경된 형태로 다시 보내는 문제 — 병렬 도구 호출 턴, MCP 도구 호출 입력, 서버 재연결 중의 도구 검색 결과 — 이로 인해 API가 이전 추론을 버릴 수 있었습니다.
• 매우 큰 세션을 재개할 때 마지막 몇 개 메시지만 복원되던 문제.
• 대기 중인 권한 프롬프트 도중 재시작 후 재개된 세션이 이전과 다른 기록을 보내, 그 시점부터 프롬프트 캐시가 깨지던 문제.
• 도구 호출 중 종료된 세션을 재개할 때: Claude가 이제 해당 호출을 인식하고 결과가 알 수 없음을 통보받으며, 수동 재개 시 숨겨진 "Continue" 메시지가 더 이상 주입되지 않습니다.
• 대화 중 MCP 서버 연결이 끊기거나, 재개 후 아직 연결 중이고 도구 검색이 꺼져 있을 때(예: 프록시나 게이트웨이 뒤) 프롬프트 캐시가 손실되던 문제.
• 프록시가 스트림을 정상적으로 닫아 응답이 잘렸는데도 경고 없이 완료로 표시되던 문제, 그리고 중복 스트림 이벤트로 도구 호출이 두 번 실행되던 문제.
• 프록시가 응답 중간에 스트림 이벤트를 누락시킬 때 발생하던 "콘텐츠 블록을 찾을 수 없음" — 이제 부분 응답이 유지되고, 웹 검색은 이미 도착한 결과를 보존합니다.
• 스트림의 최종 이벤트 전에 연결이 끊겼을 때 빈 완료 응답이 두 번 요청되던 문제.
• 프록시가 사용량만 담은 마지막 프레임을 보낼 때 중지 이유가 손실되던 문제.
• CLAUDE_CODE_RETRY_WATCHDOG 세션이 429/529 대기 후 첫 5xx 또는 연결 끊김에서 실패하던 문제, 그리고 5xx의 긴 Retry-After에 대해 상한 없는 무음 대기가 발생하던 문제.
• 서버가 Retry-After: 0을 보냈을 때 빠른 모드가 속도 제한된 요청을 연이어 재시도하던 문제.
• 한 도구의 과대 이미지로 인해 형제 도구 호출이 응답되지 않거나 최종 메시지 없이 턴이 종료되던 문제.
• 너무 긴 도구 이름 이후 대화가 tool_use.name: String should have at most 200 characters에 영구적으로 고정되던 문제.
• Claude Code가 자체 메모리 사용량을 읽을 수 없을 때(예: 파일 디스크립터 고갈 후) 도구 호출이 "메모리 사용량을 가져오지 못함"으로 실패하거나 실행 후 실패로 보고되던 문제.
• --input-format stream-json 세션(Agent SDK, VS Code 확장)과 예약된 클라우드 세션이 매 턴 실패하던 문제.

Agent SDK, VS Code 확장, 또는 게이트웨이를 앞세운 Bedrock 설정을 사용 중이라면 곧바로 업그레이드할 만합니다 — 여러 수정 사항이 바로 그 경로를 겨냥하고 있습니다.