## 변경된 내용 - `desktop` 정책 블록에 새로운 Claude Desktop 키를 위한 Claude apps gateway 지원을 추가
요약
Claude apps gateway에 Claude Desktop 키 지원 및 AWS Bedrock upstreams에 대한 기능 개선이 이루어졌습니다. 특히, 다른 AWS 계정의 IAM 역할을 가정하여 Bedrock을 호출하는 `assume_role` 기능과 모든 요청에 Amazon Bedrock guardrail을 적용할 수 있는 기능이 추가되었습니다. 또한, 세션 재개 및 스트리밍 관련 다양한 버그 수정으로 안정성이 크게 향상되었습니다.
핵심 포인트
- Claude Desktop 키 지원을 위한 apps gateway 정책 블록 업데이트
- AWS STS를 통한 IAM 역할 가정(assume_role) 기능 추가
- 모든 요청에 Amazon Bedrock guardrail 적용 가능
- 세션 재개 및 스트리밍 관련 안정성 버그 수정 다수 반영
변경된 내용
-
desktop정책 블록에 새로운 Claude Desktop 키를 위한 Claude apps gateway 지원을 추가했습니다. 여기에는blockReadsOutsideWorkingDirectories와disableBypassPermissionsMode가 포함됩니다. -
Claude apps gateway Bedrock upstreams에
assume_role을 추가했습니다: 게이트웨이가 필요할 경우 다른 AWS 계정의 STS를 통해 가정하는 IAM 역할로 Bedrock을 호출합니다. 개발자당 선택적으로 한 세션이 제공됩니다. -
모든 요청에 Amazon Bedrock guardrail을 적용하기 위해 Claude apps gateway Bedrock upstreams에
guardrail: {id, version}을 추가했습니다 (모든 Bedrock upstreams에 설정하거나 아무것도 설정하지 않을 수 있습니다). -
Claude apps gateway 구성에
telemetry.resource_attributes를 추가하여 Claude Desktop 및/login세션의 텔레메트리(telemetry)에 고정 레이블을 지정할 수 있게 했습니다. -
모든 커밋 및 PR 기여도를 숨기도록
settings.json에 ` -
변경된 형식의 이전 턴(병렬 도구 호출 턴, MCP 도구 호출의 입력 또는 서버가 아직 재연결 중인 도구 검색 결과, 또는 로딩 턴이 중단된 도구 검색 결과)을 재전송하여 API가 대화의 이전 추론을 누락시킬 수 있던 세션 재개 문제를 수정했습니다.
-
매우 큰 세션을 재개할 때 가끔 마지막 몇 개의 메시지만 복원되던 문제를 수정했습니다.
-
보류 중인 권한 프롬프트 도중에 재시작된 후 세션을 재개하면 이전과 다른 기록을 전송하여 해당 시점부터 프롬프트 캐시가 깨지던 문제를 수정했습니다.
-
도구 호출 중에 종료된 세션을 재개할 때: Claude는 이제 호출을 인식하고 그 결과가 알 수 없다고 통보받으며, 수동 재개 시 더 이상 숨겨진 "계속하기" 메시지가 추가되지 않습니다.
-
이전 어드바이저 결과로 인해 API가 매 턴마다 읽지 못하는 요청에 실패하여 이전 추론을 반복적으로 손실시키던 세션을 수정했습니다. 이제 기록은 한 번만 복구됩니다.
-
MCP 서버가 대화 도중에 연결이 끊기거나, 검색 기능이 꺼진 상태(예: 프록시 또는 게이트웨이 뒤)에서 재개 후에도 여전히 연결 중일 때 프롬프트 캐시가 손실되던 문제를 수정했습니다.
-
스트림을 깨끗하게 닫는 프록시나 게이트웨이에 의해 응답이 잘렸을 때 완료된 것으로 표시되고 경고가 없었으며, 도구 호출이 중복된 스트림 이벤트에서 두 번 실행되던 문제를 수정했습니다.
-
프록시가 응답 중간에 스트림 이벤트를 누락할 때 "Content block not found"로 실패하던 응답을 수정했습니다. 이제 부분 응답은 유지되고 웹 검색은 이미 도착한 결과를 유지합니다.
-
연결이 스트림의 최종 이벤트 전에 끊겼을 때 빈 완료 응답이 두 번 요청되던 문제를 수정했습니다.
-
프록시가 사용량 전용 트레일링 프레임을 전송할 때 중지 이유(stop reason)가 손실되던 문제를 수정했습니다.
-
CLAUDE_CODE_RETRY_WATCHDOG세션이 429/529 대기 실행 후 첫 번째 5xx 또는 연결 끊김에 실패하고, 무제한으로 수면 상태에 들어가거나 5xx의 긴Retry-After값에 침묵하던 문제를 수정했습니다. -
빠른 모드(fast mode)가 서버에서
Retry-After: 0을 보낼 때 제한된 요청을 연속적으로 재시도하던 문제를 수정했습니다. -
도구 호출(tool call) 시 이미지 크기가 너무 커서 형제 도구 호출(sibling tool calls)을 응답하지 못하고 계속 실행되거나, 최종 메시지 없이 턴이 끝나는 문제를 수정했습니다.
-
모델이 이름이 너무 긴(overlong) 이름으로 도구를 호출한 후 대화가 "tool_use.name: String should have at most 200 characters" 상태에서 영구적으로 멈추는 문제를 수정했습니다.
-
Claude Code가 자체 메모리 사용량을 읽을 수 없을 때, 예를 들어 파일 디스크립터(file descriptor)가 부족할 경우 "Failed to get memory usage" 오류로 도구 호출이 실패하거나 실행된 후에도 실패로 보고되는 문제를 수정했습니다.
-
--input-format stream-json세션(Agent SDK, VS Code 확장 프로그램) 및 예약된 클라우드 세션에서 이전 어시스턴트 메시지에 일반 문자열 콘텐츠가 포함되었을 때 매 턴마다 오류가 발생하는 문제를 수정했습니다. -
비대화형 세션(
-p, Agent SDK)에서 시작한 디렉토리가 세션 중간에 삭제되었을 때 다음 턴에서 실패하는 문제를 수정했습니다. -
호스트 측(SDK) MCP 서버를 사용하는 헤드리스 세션이 호스트가 핸드셰이크 도중 응답을 중단할 때 첫 번째 메시지에서 지연되는 문제를 수정했습니다. 이제 원격 세션은 최대 몇 초 동안 대기합니다.
-
MCP 서버나 플러그인이 구성되지 않은 경우, 상호작용 시작 시 관리 설정(managed-settings) 네트워크 요청을 기다리느라 지연되던 문제(약 80ms, 네트워크 연결 불가 시 17초 이상)를 수정했습니다.
-
3MB가 넘는 PDF 파일을 읽거나 @멘션할 때 응답하기까지 최대 두 분까지 지연되는 문제를 수정했습니다.
-
특정 PDF 페이지를 읽다가 중단되어 페이지 렌더링이 최대 두 분 동안 계속 실행되던 문제를 수정했습니다.
-
승인 전 macOS의
/.vol,/.nofollow또는/.resolve(네트워크 마운트를 포함할 수 있음) 경로에 있는 권한 대화 상자 및 첨부 파일 검사에서 문제가 발생하던 것을 수정했습니다. -
대상이 명령어 치환 출력(command-substitution output), 예를 들어
rm -rf "$(pwd)"인 재귀적rm명령어가 자동 모드와--dangerously-skip-permissions모드에서 사용자에게 프롬프트 없이 실행되던 문제를 수정했습니다. 이제 Bash 허용 규칙이 있어도 질문을 합니다. 단,CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1로 실행하는 경우는 제외합니다. -
NUL 바이트를 포함하는 권한 규칙이 와일드카드 일치로 확장되는 문제를 수정했습니다. 이제 그러한 규칙은 아무것도 일치시키지 않습니다.
-
샌드박스
excludedCommands항목이git rev-parse --git-dir, 셸 내장 명령어와 유사한 이름의 프로그램, 그리고[WIP]또는#라인을 포함하는 커밋 메시지를 일치시키지 않던 문제를 수정했습니다. -
CLAUDE_CODE_TMPDIR가 설정된 경우 샌드박스 Bash 명령이$TMPDIR에 쓰기할 수 없던 문제를 수정했습니다. -
작업 공간 신뢰 프롬프트를 통과하지 않은 디렉토리에서
claude --bg가 백그라운드 세션을 시작하고 프로젝트 후크를 실행하던 문제를 수정했습니다. 이제 먼저 신뢰 여부를 묻거나, 대화형으로 실행되지 않으면 종료합니다. -
--setting-sources(및 SDK의settingSources)가 생성된 세션(teammates,/bg,claude agents세션 및--worktree --tmux)으로 전달되지 않던 문제를 수정했습니다. 이제 부모의 제한 사항을 가지고 시작합니다. -
Read, Write, Edit 및 NotebookEdit: 널 바이트를 포함하는 파일 경로가 전체 턴을 종료시키는 대신 명확한 오류와 함께 해당 도구 호출에 실패하던 문제를 수정했습니다.
-
Write가 동일한 값을 두 개의 매개변수 이름으로 두 번 제공하는 호출을 거부하던 문제를 수정했습니다.
-
작업 디렉토리 내부의
--add-dir에서 가져온 CLAUDE.md 및 규칙 파일이 헤드리스 세션과 SDK 세션에서 모델로 두 번 전송되던 문제를 수정했습니다. -
원격 세션이 권한 프롬프트와 샌드박스 네트워크 액세스 프롬프트가 중첩되어 모두 답변된 후에도
-
조직 정책상 비활성화되었다고 보고되던 원격 제어(Remote Control) 기능이 실제로는 조직 정책 로딩이 완료되지 않았을 때도 수정되었습니다. 이제는 데이터를 다시 가져오기(fetch)를 시도하고 확인할 수 없다고 표시합니다.
-
Claude Desktop, claude.ai 또는 모바일 앱에서
claude remote-control을 시작할 때 원격 제어 세션에서 아티팩트 도구(Artifact tool)가 누락되던 문제가 수정되었습니다. -
로그인 키체인(login keychain)이 잠겨 있을 때 (예: 깨어난 직후) macOS 자격 증명 쓰기 과정에서 저장된 MCP OAuth 토큰을 삭제하거나 키체인 항목을 지우던 문제가 수정되었습니다.
-
Claude Code가 종료되거나 새로 고침 시간이 초과될 때
gcpAuthRefresh/awsAuthRefresh로그인 프로세스가 계속 실행 상태로 남아 (Windows의 localhost 콜백 포트를 점유하는) 문제가 수정되었습니다. -
다른 Claude Code 프로세스에서 로그인한 후에도 세션에
-
--scope가 생략된 경우 프로젝트 범위 플러그인에 대한claude plugin update실패 문제 수정 — 이제 사용자가 가정하는 대신 플러그인이 설치된 범위를 해결합니다. -
claude plugin validate가plugin.json의privacyPolicyUrl,supportUrl및 기타 목록 메타데이터 키를 알 수 없는 필드로 보고하던 문제 수정 -
원격에 도달할 수 없을 때 마켓플레이스를 새로 고침으로 기록하는
known_marketplaces.json문제 수정 및CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE가 기존 클론을 유지하도록 수정 -
/plugin오류 탭이 마지막 오류가 해결된 후에도 아무런 확인 메시지를 표시하던 문제 수정 -
첫 번째 제거 또는 업데이트가 여전히 실행 중일 때 Enter를 다시 누르면 동일한 플러그인의 두 번째 제거 또는 업데이트를 시작하던 문제 수정
-
y키를 누른 상태에서/plugin이 마켓플레이스 소스를 확인하는 동안, -
/feedback, /bug 및 /share가 대화 상자가 열려 있는 동안 원격 제어 중지(Remote Control Stop)가 도착한 후 'Couldn't send feedback' 오류로 인해 전송할 때마다 실패하는 문제 수정
-
실행 중인 IDE를 나열함과 동시에
/ide에서 'No available IDEs detected'가 표시되는 문제 수정 -
새 설정을 적용하기 위해 Claude Code가 재시작될 때
/setup-bedrock또는/setup-vertex사용 시 터미널이 손상된 상태(충돌 또는 깨진 입력)로 남는 문제 수정 -
~/.claude.json에서respectGitignore또는copyFullResponse값이null일 때/config가 종료되는 문제 수정 -
Claude가 다중 선택 질문을 하는 동안 /rename으로 세션 이름을 변경하는 것이 사라지는 문제 수정, 따라서 나란히 열린 세션이 식별 가능하게 유지됨
-
VS Code 또는 원격 제어에서 온 프롬프트의 경우, 전송된 메시지에서 한 줄 붙여넣기가 자체 줄에 표시되는 문제 수정 및 확장 붙여넣기 플레이스홀더도 마찬가지로 수정
-
Claude가 작업하는 동안 대기열에 추가된 메시지가 작성되었던 IDE 선택을 잃거나 변경하고, 대기열 메시지에 해당 선택이 표시되지 않던 문제 수정
-
Shift+Tab을 빠르게 두 번 누를 때 (문장이 잘림)
AI 자동 생성 콘텐츠
본 콘텐츠는 Claude Code Releases의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기