v2.1.274

변경 사항

• 메모리 사용량이 심각한 경우 시각적 경고를 추가하고, 메모리를 해제하거나 안전하게 재시작하는 단계 제공
• 첫 번째 비대화형 턴이 MCP 서버 연결을 대기하는 시간을 제한하는 CLAUDE_CODE_MCP_STARTUP_WAIT_MS 추가 (0 = 대기 안 함)
• api_request 이벤트와 일치하도록 claude_code.llm_request OpenTelemetry 추적 스팬에 effort 속성 추가
• claude_code.managed_settings_resolved OTel 이벤트 추가: 관리 설정 소스 및 정책 헬퍼 상태, OTEL_LOG_MANAGED_SETTINGS=1로 설정 및 다이제스트 제거
• Claude 앱 게이트웨이 설정에 store.connect_timeout_seconds 추가하여 Postgres 연결 타임아웃 연장 (기본값 5초), 데이터베이스에 도달할 수 없을 때 부팅 오류를 개선하여 store.postgres_url과 설정된 타임아웃 표시
• Claude Desktop과 Cowork가 Claude 앱 게이트웨이를 통해 보내는 원격 측정에 IdP 주체인 enduser.sub 추가
• 복제본이 한 번에 업스트림으로 전송하는 256개보다 많은 요청을 열어두는 경우 Claude 앱 게이트웨이 경고 추가, 해당 제한을 보여주는 시작 로그 라인 추가
• 전체 화면 모드에서 접힌 팀원 및 에이전트 메시지에 대해 클릭하여 확장하는 기능 추가
• "unexpected tool_use_id" 400 오류로 인해 세션이 무한 재시도로 멈추는 문제 수정: 손상된 트랜스크립트는 가능한 한 자체 수리되고, 그렇지 않으면 명확한 오류 (/rewind 힌트 포함)로 루프 종료
• 레거시 HTTP+SSE만 사용하는 http로 설정된 MCP 서버가 첫 요청에 422 또는 다른 4xx 오류로 응답할 때 연결 실패하는 문제 수정
• 더 긴 서버별 timeout이 설정된 경우에도 약 5분 후 스트림 가능한 HTTP MCP 도구 호출이 타임아웃되는 문제 수정
• 서버가 listChanged 선언 없이 목록 변경 알림을 보낼 때 MCP 프롬프트 및 리소스가 새로고침되지 않는 문제 수정
• 403 insufficient_scope로 거부된 MCP 도구 호출이 만료된 로그인으로 보고되는 문제 수정: 오류가 이제 누락된 권한을 명시하고 /mcp 재인증을 가리킴
• 반응형 압축 후 컨텍스트가 다시 오버플로우될 때 후크 기반 세션 (활성 /goal 등)이 "Prompt is too long" 대신 압축으로 종료되는 문제 수정
• 세션 재개(--continue / --resume)할 때 활성 /goal이 손실되는 문제 수정 (세션이 압축된 경우)
• 자동 업데이트 재시작 후 claude agents가 --model, --effort, --permission-mode, --allow-dangerously-skip-permissions 및 --agent 손실하는 문제 수정
• 언어 서버가 수천 개의 파일에 대해 프로젝트 전체 진단을 게시할 때 턴당 속도 저하 문제 수정
• Bedrock, Vertex 또는 Foundry의 model: "opus"를 사용하는 서브에이전트가 모델 ID에 인식 가능한 모델 제품군이 없을 때 세션의 모델을 남기는 문제 수정 (ANTHROPIC_DEFAULT_OPUS_MODEL 설정되지 않은 경우)
• 자체 호스팅 러너 세션이 몇 번의 실패한 토큰 새로고침 후 401로 매 턴마다 실패하는 문제 수정 (다음 예약된 새로고침까지), 러너가 이제 재시도를 계속 진행하고 401 후 새 토큰 가져오기
• VS Code 및 file:// URI가 필요한 다른 터미널에서 로컬 파일 경로로의 클릭 가능한 링크가 작동하지 않는 문제 수정
• 트랜스크립트가 자신의 메시지에서 정렬된 목록의 번호를 다시 매기는 문제 수정 (typing "3. 2. 1."이 "3. 4. 5." 표시됨), 숫자와 "N)" 마커가 입력된 그대로 표시됨
• AskUserQuestion 미리보기 노트가 강조된 옵션 대신 이전에 선택한 옵션에 첨부되는 문제 수정
• AskUserQuestion 미리보기 모드가 Enter로 노트를 제출할 때 강조된 옵션이 삭제되는 문제 수정
• 재개된 백그라운드 에이전트가 메시지로 승인된 호출 중 하나가 있을 때 중단된 도구 배치의 절반을 유지하는 문제 수정
• CLAUDE_CODE_RESUME_INTERRUPTED_TURN으로 시작된 로컬 claude -p --resume이 이전 프로세스가 남긴 미완료 백그라운드 작업을 보고하지 않는 문제 수정
• 클라우드 세션의 첫 턴이 아직 연결 중인 SDK 호스팅 MCP 서버의 도구 없이 시작되는 경우가 있는 문제 수정
• 백그라운드 에이전트가 여전히 자신의 백그라운드 작업을 기다리고 있고 재개될 때 백그라운드 에이전트 알림이 에이전트에게 활성 백그라운드 작업이 없다고 주장하는 문제 수정
• Claude Desktop 세션의 오류 힌트를 그곳에서 사용할 수 없는 CLI 플래그 대신 /usage-credits와 같은 슬래시 명령을 제안하도록 수정
• /schedule이 Claude가 목록 루틴 반환 형태로 루틴을 쓸 때 메시지 역할 없이 루틴의 프롬프트를 저장하는 문제 수정
• /status가 자신의 오류 배너에서 확인하도록 말한 apiKeyHelper 실패를 표시하지 않는 문제 수정
• 조직의 관리 빠른 모드 정책에서 비대화형 세션의 /fast on이 켜짐을 보고한 후 끄는 문제 수정, 이제 조직이 비활성화했음을 표시
• 아티팩트 도구가 아티팩트 업데이트를 승인하도록 요청한 후 세션이 최신 버전을 읽지 않아 거부하는 문제 수정
• 네트워크 액세스가 있는 Cowork 및 claude.ai 클라우드 세션이 팀원의 아티팩트 읽기를 네트워크 액세스가 꺼진 것처럼 취급하는 문제 수정
• 자신의 git 저장소가 없는 플러그인 또는 마켓플레이스 디렉터리가 ~/.claude와 같은 둘러싼 git 저장소에서 버전을 가져오는 문제 수정
• --strict-mcp-config가 빈 --mcp-config를 사용하여 우발적 MCP 서버에서 첫 번째 비대화형 턴을 MCP_TIMEOUT까지 대기하도록 하는 문제 수정
• Stop 프롬프트 후크가 대화의 모든 블록에서 전체 프롬프트를 다시 보내는 문제 수정, 반복 블록이 이제 500자 레이블로 조건을 명시
• Linux의 Wayland에서 Cursor 또는 VS Code 터미널 내부에서 실행할 때 시작 시 추가 빈 편집기 창이 열리는 문제 수정
• Postgres가 지출 확인 중에 연결을 드롭할 때 Claude 앱 게이트웨이의 처리되지 않은 프로미스 거부 수정
• Claude 앱 게이트웨이가 SIGTERM에서 모든 열린 스트림을 차단하는 문제 수정: 이제 진행 중인 요청이 종료 전에 최대 25초 동안 완료되도록 허용 (CLAUDE_GATEWAY_DRAIN_TIMEOUT_MS)
• 플러그인 정책이 원격 관리 설정에서 올 때 거의 모든 시작에서 installed_plugins.json이 다시 작성되는 문제 수정 (Claude Desktop이 모든 열린 세션의 플러그인을 다시 로드하게 함)
• 헤드리스 및 SDK 세션이 완료된 모든 백그라운드 작업에 대해 별도의 모델 호출을 만드는 문제 수정, 이미 대기 중인 완료는 이제 하나의 호출로 응답됨
• 플러그인 다시 로드 후 Bash 도구가 셸 프로필을 다시 소싱하는 문제 수정 (다음 명령에서 몇 초 이상 지연), 이제 플러그인의 bin/ 디렉터리가 변경되었을 때만 수행
• hooks/hooks.json에 최상위 $schema가 있는 플러그인이 "unknown key" 알림을 표시하는 문제 수정
• MCP 연결 오류 및 MCP 로그인 도구의 설명이 MCP 설정의 ${VAR} 자리 표시자에서 확인된 비밀을 표시하는 문제 수정
• 특정 특수 셸 변수를 순환하거나 할당하는 명령에 대한 Bash 권한 확인 수정, 이제 이러한 명령이 권한을 요청
• 워크트리 격리 세션이 특정 중첩 셸 확장이 있는 Bash 명령을 허용하는 문제 수정, 이제 거부됨
• 편집 권한 프롬프트 미리보기가 다중 바이트 문자가 있는 파일에서 승인된 편집과 다른 위치를 표시하는 경우가 있는 문제 수정
• 가벼운 메모리 압박 상태의 머신에서 백그라운드 명령이 30분 유휴 후 중지되는 문제 수정, 이제 메모리가 심각하게 낮을 때만 중지되고 디버그 로그에서 이유를 표시
• 서브에이전트가 메인 세션으로 보낸 메시지가 재시작 후 Claude Desktop 트랜스크립트에서 사라지는 문제 수정
• .zip에서 로드된 플러그인이 여러 겹침 다시 로드 후 부실한 추출에서 제공되는 문제 수정
• 서브에이전트의 진행 요약이 폭발적 다단락 회신으로 바뀌는 문제 수정
• --input-format stream-json 세션에서 시작 개선: 첫 턴이 도구 검색을 연기하는 아직 연결 중인 MCP 서버를 위해 최대 2초를 더 이상 대기하지 않음, 나중의 턴에 도착
• Monitor 도구 알림 개선: 스크립트의 최종 출력과 종료가 두 개의 알림 대신 하나로 도착하여 모델 턴 절약
• 아티팩트 도구 오류 개선: claude.ai에 로그인하지 않은 경우 터미널이 첫 시도에서 그렇게 표시되고, Claude는 거부된 호출 재시도를 더 빨리 중지하도록 지시됨
• 아티팩트 게시 개선: 이전 버전에 기반한 게시가 전송되기 전에 중지되고, 새로운 페이지를 병합
• 서브모듈 체크아웃을 포함하는 에이전트 워크트리를 제거하기 전 안전 확인 개선
• OTEL_LOG_RAW_API_BODIES=file:<dir> 출력 개선: 새로운 index.jsonl 및 request_body_id / message.id 이벤트 속성이 각 응답을 요청 파일 및 트랜스크립트 메시지에 연결
• Claude 앱 게이트웨이 부팅 개선: 이제 첫 Postgres 연결을 종료하기 전에 최대 3번 시도하므로, 몇 초 후에 도달 가능한 데이터베이스가 더 이상 부팅 실패하지 않음
• 부하 상태에서 Claude 앱 게이트웨이의 지출 제한 확인 개선: 이제 4번 대신 하나의 데이터베이스 왕복을 수행하므로, 바쁜 게이트웨이에서 더 적은 확인 타임아웃
• Claude 앱 게이트웨이 로그인 속도 제한 오류 개선: /login이 이제 거부를 설명하고, 게이트웨이 로그는 어느 제한에 도달했는지 및 어떤 설정을 변경할지 표시
• Bedrock, Vertex, Foundry 및 원격 측정 비활성화 설치를 기본적으로 다른 설치가 이미 하는 것처럼 직접 HTTP 서버로 v2 MCP 클라이언트 및 MCP 2026-07-28 협상을 사용하도록 변경 (옵트아웃: MCP_SDK_GENERATION=v1 또는 MCP_PROTOCOL_NEGOTIATION=legacy)
• 모든 모델이 자신의 조정된 설정이 없는 경우 많은 검토 서브에이전트를 생성하는 대신 모든 모델에 대해 더 간단한 인라인 검토 프롬프트를 사용하도록 /code-review 변경
• .mcp.json, 설정, 플러그인 및 에이전트 파일의 "type": "sdk" MCP 항목을 경고와 함께 건너뛰도록 변경: SDK 호스트 애플리케이션만 프로세스 내 서버를 등록할 수 있음
• 로컬 세션의 아티팩트 감시 변경: 다른 곳에서 게시된 새 버전이 더 이상 턴을 시작하지 않음, Claude는 나중의 아티팩트 도구 결과에서 이를 학습
• 플러그인 및 마켓플레이스 클론을 Git LFS 파일을 다운로드하는 대신 포인터로 남기도록 변경, 체크아웃의 git lfs pull이 이를 가져옴
• 자체 호스팅 러너를 세션 시작 실패하는 대신 Git 호스트가 액세스 확인에서 거부하는 읽기 전용 저장소를 건너뛰도록 변경
• /status GitHub 라인이 "Cloud sessions"로 읽도록, /web-setup, /ultrareview, 및 텔레포트 메시지가 "Claude Code on the web" 대신 "cloud session"이라고 표시하도록 변경
• [VSCode] 윈도우 다시 로드가 중단한 단계를 계속하는 기능 추가 (채팅에 레이블 표시), Claude Code: Continue After Reload 설정으로 끄기 가능
• [VSCode] Customize 메뉴에 Memory 및 Instructions 항목 추가: Memory는 자동 메모리 토글, 저장된 메모리 및 메모리 폴더를 표시, Instructions는 CLAUDE.md 파일을 편집
• [VSCode] Claude가 열고 있는 편집기 그룹을 잠금하지 않도록 하는 claudeCode.lockEditorGroups 설정 추가
• [VSCode] 새 대화의 처음 몇 초에서 /btw 측면 질문이 다른 세션의 측면 질문 기록을 표시하는 경우가 있는 문제 수정
• [VSCode] 확장이 전역 gitignore 파일을 처음 조회할 때 간단한 프리징 수정
• [VSCode] Claude가 도구를 실행하는 동안 보낸 메시지가 윈도우 다시 로드 후 대화에서 사라지는 문제 수정
• [VSCode] Manage Plugins 활성화 토글 및 MCP 서버 대화 행이 키보드에서 도달할 수 없는 문제 수정
• [VSCode] Environment Variables 설정에서 CLAUDE_CONFIG_DIR이 변경된 후 터미널에서 수행된 로그인 및 로그아웃이 다시 로드 후까지 표시되지 않는 문제 수정
• [VSCode] 채팅의 Edit 차이가 일부 패널 너비 및 긴 줄 바꿈에서 아래쪽에서 잘리는 문제 수정, 차이 상자가 이제 표시된 행에 맞음
• [VSCode] 확장의 겹치는 설정 쓰기로 인해 ~/.claude/settings.json이 구문 분석 불가능하거나 설정이 삭제되는 문제 수정
• [VSCode] Open in New Tab (Ctrl/Cmd+Shift+Esc)이 새 탭의 메시지 상자를 포커스 해제하는 경우가 있어 입력이 클릭할 때까지 아무데도 가지 않는 문제 수정
• [VSCode] 닫은 Claude 탭을 다시 열 때 잠긴 그룹이 다른 Claude 탭과 파일을 계속 보유하고 있으면 편집기 레이아웃이 분할되는 문제 수정
• [VSCode] New session이 파일 탭이 Claude 탭과 같은 그룹을 공유할 때마다 다른 잠긴 편집기 그룹을 여는 문제 수정
• [VSCode] 세션 피커에서 세션 이름이 검색 쿼리를 입력하는 동안 옆으로 이동하는 문제 수정
• [VSCode] 계획 검토 카드가 계획에 여러 의견이 있을 때 Send feedback 버튼 및 사유 필드를 자르는 문제 수정, 의견 목록이 이제 스크롤됨
• [VSCode] 채팅 회신의 인라인 코드 및 코드 블록이 High Contrast 테마에서 읽을 수 없는 문제 수정
• [VSCode] 대화의 스크린 리더 탐색 개선: 각 메시지는 도구 단계의 경우 도구 이름과 함께 "You" 또는 "Claude"로 발표됨
• [VSCode] XDG_CONFIG_HOME이 절대 경로일 때 기본 전역 gitignore 파일을 $XDG_CONFIG_HOME/git/ignore로 변경
• [Claude Code on the web] 클라우드 세션의 diff 보기에 "Compare against" 분기 선택기 추가, 기본 분기 대신 모든 분기에 대해 변경 사항을 diff할 수 있음
• [Claude Code on the web] GitHub의 토큰 갱신이 일시적으로 오류를 발생할 때 클라우드 세션의 git 작업이 "service unavailable"로 실패하는 문제 수정
• [Claude Code on the web] 루틴 편집이 두 번 실행되거나 일시 중지된 루틴을 다시 활성화하는 경우가 있는 문제 수정
• [Claude Code on the web] 클라우드 세션의 커밋이 세션의 자격 증명 새로고침 후 몇 분 동안 서명 오류로 실패하는 경우가 있는 문제 수정
• [Claude Code on the web] GitHub 트리거를 저장한 후 표시되는 토스트가 "edit to retry"만 표시하는 대신 저장소별 트리거 제한과 같은 이유를 표시하도록 수정
• [Claude Code on the web] 세션이 읽기 상태로 표시한 후 읽지 않음으로 다시 플립되는 경우가 있는 문제 수정
• [Claude Code on the web] 소유자의 GitHub 연결이 없을 때 루틴이 실행을 건너뛰고 첫 번째 실패한 확인에서 루틴을 끄는 대신 최대 72시간 동안 재시도하도록 변경
• [Claude Code on the web] 루틴의 대기 중 알림 변경: 구독이 일시 중지된 경우 자동 재개를 약속하는 대신 루틴을 직접 다시 켜도록 알림
• [Claude Tag] Claude Tag 관리 설정에서 Add channel 및 Add workspace 양식에 Guests 설정 추가, 소유자가 미리 Inherit, Allow, Channel only 또는 Restrict 선택 가능
• [Claude Tag] 다른 Slack 앱 또는 봇이 @mention할 때 Claude가 응답하지 않는 문제 수정, 태그가 이제 회신을 받고 며칠 동안 따라가기를 중지한 채널에서 Claude를 깨움
• [Claude Tag] Claude가 새 Slack 채널이 생성된 직후 @claude를 태그하는 다른 앱의 메시지를 놓치는 문제 수정, Claude가 가입한 후 배달됨
• [Claude Tag] Claude가 마지막 Slack 메시지 후 몇 분 후에 보낸 후속을 무음 편집으로 접는 문제 수정, 차단기와 같은 늦은 업데이트가 이제 알림을 보내는 새 회신으로 게시됨
• [Claude Tag] Claude의 Slack 검색이 단일 채널 내에서 검색할 때마다 오류로 실패하는 문제 수정, 이제 그 채널의 일치하는 메시지를 반환
• [Claude Tag] 안전 필터 중지가 아무도 기다리지 않을 때 조용히 Slack 스레드의 컨텍스트를 재설정하는 문제 수정, Claude가 이제 항상 표시하고 계속 실행 중인 백그라운드 작업을 더 이상 취소하지 않음
• [Claude Tag] Claude의 Slack 회신의 이메일 주소가 보이는 mailto: 접두사로 렌더링되는 문제 수정, 이제 평문 클릭 가능한 주소로 표시
• [Claude Tag] Claude가 다른 워크스페이스에서 요청될 때 전체 조직과 공유되는 Enterprise Grid 채널을 감시하기를 거부하는 문제 수정
• [Claude Tag] Claude Tag 관리 설정의 Environment 선택기가 아카이브되거나 앱에서 생성된 환경에 대해 환경 이름 대신 원시 환경 ID를 표시하는 문제 수정
• [Claude Tag] Claude의 Slack 라이브 진행 체크리스트 개선: 2,000자로 제한, 바쁜 스레드에서 최대 15분마다 다시 게시, 이전 "Latest task list" 링크 업데이트
• [Claude Tag] "Channel only" 게스트 설정을 사용하는 채널에서 Claude가 Slack 캔버스를 편집할 때마다 첨부된 반복 게스트 기여도 메모 제거
• [Code Review] 새 검토도 아래에 더 낮은 심각도 메모를 제출할 때 재검토가 가끔 고정된 발견의 스레드를 열린 상태로 남기는 문제 수정
• [Code Review] GitHub 또는 내부 서비스가 시작 시 일시적으로 실패할 때 드물게 검토가 "Code review encountered an error"로 종료되는 문제 수정, 이제 대기 후 재시도
• [Code Review] Code Review가 각 게시된 발견을 구성하는 방식 개선: 누가 영향을 받는지, 코드가 어디서 잘못되었는지, 수정이 앞에 있는 짧은 평문 문장
• [Code Review] 조직 제한 때문에 검토가 건너뛰어질 때 확인 실행 카드 및 PR 의견 개선: 각 원인이 이를 수정하는 관리자 페이지에 링크됨