## 변경 사항 - 명령어 및 HTTP 훅에 `onFailure: "block"` 추가: 시작할 수 없거나, 시간 초과되거나, 예상치 못한
요약
Claude Code 및 Claude apps gateway에 여러 기능 개선 사항이 적용되었습니다. 명령어/HTTP 훅에 `onFailure: "block"`을 추가하여 오류 발생 시 액션을 차단하고, Program Status Protocol (OSC 7501) 지원으로 상태 표시가 가능해졌습니다. 또한, 다양한 클라우드 업스트림(Bedrock, Vertex 등)의 시간 초과 및 모델 지정 기능이 강화되었습니다.
핵심 포인트
- `onFailure: "block"` 추가로 오류 시 액션 실행 차단 기능을 제공합니다.
- Program Status Protocol (OSC 7501) 지원으로 Claude Code 상태 표시가 가능해졌습니다.
- 다양한 클라우드 업스트림에 `timeouts.upstream_ttfb_ms` 및 선택적 `models` 목록을 추가했습니다.
- 여러 버그 수정 사항이 포함되어 안정성과 사용자 경험이 개선되었습니다.
변경 사항
-
명령어 및 HTTP 훅에
onFailure: "block"추가: 시작할 수 없거나, 시간 초과되거나, 예상치 못한 코드로 종료되는 훅은 액션을 통과시키지 않고 차단합니다. -
Program Status Protocol (OSC 7501) 지원 추가: 이를 구현하는 터미널에서 Claude Code가 작동 중인지, 사용자를 기다리는 중인지, 아니면 완료되었는지 표시할 수 있습니다.
-
/copy선택기에 따옴표 텍스트 추가: 초안 메시지가>마커 없이 복사됩니다. -
설정 파일이 로드되지 않을 때
claude plugin install,enable,disable및marketplace add에 경고 추가 -
터미널인 경우, 마지막 턴 이후 열려 있는
claude -p실행이 무엇을 기다리는지 stderr에 줄 추가 -
Claude apps gateway의 Bedrock, Vertex, Foundry 및 기타 클라우드 업스트림에
timeouts.upstream_ttfb_ms지원 추가: 이제 설정하는 값은 스트림이 거기서 시작하는 데 걸릴 수 있는 최대 시간을 제한하며, 그 이후에는 장애 조치되거나 502 오류가 발생합니다. -
←가 현재 도구 완료를 기다리는 동안 턴을 중지할 때 "Backgrounding cancelled" 메시지 추가 -
모든 Claude apps gateway 업스트림에 선택적
models목록 추가: 나열된 모델만 전송되며, 장애 조치 시에도 마찬가지이며, 항목의*는 와일드카드입니다. -
관리형 설정이 없는 장치의 사용자 자체 설정에
forceLoginMethod: "gateway"및forceLoginGatewayUrl지원 추가: 따라서/login이 해당 Claude apps gateway에서 열립니다. -
플러그인의 README에 설치 라인이 없는 경우
claude plugin validate에 조언 추가: 붙여넣을 줄을 출력하고--strict를 사용하더라도 종료 코드를 변경하지 않습니다. -
Claude apps gateway의
inference감사 이벤트에upstream_request_id추가: 지원 사례용으로 Amazon Bedrock, Anthropic API 또는 다른 업스트림의 요청 ID입니다. -
모드(mods)를 위한
$.ui.notify추가: 자체 알림 설정을 통해 네이티브 알림을 발생시키고 어떤 채널에서 전송되었는지 알려줍니다. -
모드의
Button에 문자열(strings) 및Text를 추가: 리스트의 행이 칩이나 디밍된 상세 정보가 있는 하나의 클릭 가능한 요소가 되도록 함 -
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS를 추가하여, 무인 재시도 모드(CLAUDE_CODE_RETRY_WATCHDOG)가 429 및 529 오류로 인해 대기하는 최대 시간을 제한함 -
Claude 앱 게이트웨이의 성공적인 추론 응답에
request-id헤더를 추가하여, Claude Code 원격 측정에서request_id가 게이트웨이 감사 로그와 일치하도록 함 -
게이트웨이, Bedrock, Vertex 또는 Foundry가 context-1m 베타를 거부할 때
[1m]모델에서 요청이 실패하는 모든 경우를 수정: 이제 Claude Code는 해당 컨텍스트 없이 다시 전송함 -
백그라운드 작업으로 인해 다른 턴이 시작될 때
claude -p의 텍스트 출력이 이전 응답을 누락하던 문제를 수정: 각 턴의 응답은 이제 턴이 끝날 때 출력됨 -
헤드리스 및 SDK 세션에서 원격 MCP 서버가 15초보다 긴 장애 후 연결 해제되거나, 연결 직후 연결을 끊는 서버에 루프처럼 재연결되는 문제를 수정: 반복적인 연결 끊김은 이제 최대 30초까지 백오프(back off)함
-
서버의 오류 응답이 네트워크 오류 이름을 포함하는 경우 원격 MCP 연결이 끊기던 문제 수정
-
MCP 서버가 페이지네이션 커서를 반복적으로 요청하여 매번 연결 시 같은 페이지를 최대 20회 요청하던 문제 수정
-
MCP 도구가 반환하는 CSS, JavaScript 및 XML 파일이
.bin으로 저장되어 읽기 도구(Read tool)가 거부하던 문제를 수정: 이제 글꼴 및 아이콘 파일도 자체 확장자를 갖게 됨 -
모델이
description대신command_description을 전달할 때 Bash 도구 호출이 실패하던 문제 수정 -
Chrome의 Claude가 포트 80으로 작성된 사이트 거부 규칙(
host:80)을 해당 호스트의 일반http://페이지에 적용하지 않던 문제를 수정 -
/plugin의 오류(Errors) 탭에서 로드에 실패한 마켓플레이스를 제거하고, 사용자에게 먼저 묻지 않고 플러그인을 제거하던 문제 수정 -
claude plugin marketplace add가 어떤 플러그인도 설치할 수 없는 이름의 마켓플레이스에 대해 성공을 보고하던 문제를 수정: 이제 그러한 추가는 거부됨
CLAUDE_AUTO_BACKGROUND_TASKS가 편집 또는 셸 명령이 대기하는 동안 서브 에이전트를 백그라운드로 이동시키면서, 서브 에이전트가 완료되기 전에 해당 호출을 시작했던 문제를 수정했습니다./config토글 없이 전화 메시지 직후 또는 Claude Code 내부에서 시작된claude remote-control세션에서 푸시가 전송되지 않았다고 알리는 PushNotification을 수정했습니다.- 원격 세션에서 한 번에 256개 이상의 파일을 전송할 때 "보증할 수 없음(could not be vouched for)"으로 거부되던 문제를 수정했습니다.
- 로그인 새로고침 직후에 관리 설정(managed settings)을 로드하는 데 실패하던 드문 문제를 수정했습니다.
- Claude Code를 다시 시작할 수 없을 때
/tui가 메시지 없이 종료되거나 원시 시스템 오류(raw system error)와 함께 종료되던 문제를 수정했습니다. - 답변이 남긴 색상이나 가리기 스타일(conceal style)에 의해 텍스트로 표시된 링크 주소가 숨겨지던 문제를 수정했습니다. 여기에는 테이블 내에서 줄 바꿈되거나 질문 미리보기(question preview) 영역에 있는 경우도 포함됩니다.
availableModels에 나열된 Fable 모델이 Claude apps gateway에 로그인한 세션의/model피커에 나타나지 않던 문제를 수정했습니다. 이제 해당 모델은 동일 모델을 위해 추가되었던modelPicker행 대신 자체 내장된 행을 표시합니다.- Claude apps gateway의 관리 지출(admin spend) 뷰가 개발자의 세션이 그룹을 포함하지 않게 된 후에도 이전 그룹과 그룹 한도(group cap)를 표시하던 문제를 수정했습니다.
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC가/usage및 상태 표시줄에서 Claude apps gateway 지출 한도를 숨기던 문제를 수정했습니다.
지출 한도 요청은 세션이 로그인된 게이트웨이로 전송됩니다.
-
독립적인 연결 작업 공간(linked worktree)에 있는 서브 에이전트가 부모 세션의 git 브랜치, 상태 및 최근 커밋을 표시하도록 수정되었습니다.
-
프롬프트에 입력한 텍스트로 인해 현재 도구 사용이 취소될 때 Claude가 배경으로 전환되는 것을 멈추던 문제가 수정되었습니다. 이제 Claude는 전경에서 계속 작동합니다.
-
--tools와--restricted가 실행 후 등록되는 내장 도구 및 호출자 도구 세트 외부의 구식 도구 이름에 적용되지 않던 문제가 수정되었으며, 이로 인해 오류가 발생하던 문제도 해결되었습니다. -
Claude가 MCP 서버의 리소스 목록을 기다리는 동안 인터럽트가 타임아웃이 될 때까지 턴(turn)을 종료시키지 못하던 문제가 수정되었습니다.
-
모드의 후크(hook)에 깊게 중첩된 도구 입력이 오류 없이 잘려서 전달되어 가드가 본 적 없는 내용을 포함할 수 있던 문제가 수정되었습니다.
-
←로 배경으로 이동한 자체 진행형/loop가 Esc 키를 눌러도 멈추지 않던 문제가 수정되었으며, 보류 중인 깨우기(wakeup) 취소 시 이제 알림이 표시됩니다. -
배경 세션의 명령어 및 후크가
FORCE_COLOR=3을 상속받아 Claude가 읽는 출력에 색상 이스케이프 코드를 포함시키던 문제가 수정되었습니다. -
세션이 열려 있는 상태에서
claude agents가 종료될 때 새로운 배경 서비스를 시작하던 문제(예: 재부팅 시)가 수정되어, 종료 지연 및 중단된 세션의 재시작을 방지합니다. -
사용자 지정 에이전트인
worker가 자동 모드 거절 알림과 작업 상세 보기 활동 목록에서 -
작업 패널 또는 연결된 클라이언트에서 장시간 실행되는 MCP 도구 호출을 중지할 때 Claude에게 알리지 않던 문제를 수정했습니다.
-
세션 프로세스가 다운된 상태에서 다음 깨어남(wakeup) 시간이 되었을 때 백그라운드 세션의
/loop가 아무런 통보 없이 중지되던 문제를 수정했습니다. 이제 세션이 이를 알리고 Claude에게도 알려줍니다. -
원본 터미널 하이퍼링크 바이트가 응답이나 팀원 메시지에 포함될 경우, 숨겨진 주소를 가진 클릭 가능한 링크로 표시되던 문제를 수정했습니다.
-
리포지토리에 대규모 git 서브모듈을 가진 플러그인 마켓플레이스가 추가하거나 새로고침하는 데 실패하던 문제를 수정했습니다. 이제 플러그인 파일을 담고 있는 서브모듈만 가져옵니다.
-
더 이상 사용할 수 없는 저장된 어드바이저 모델에 체크 표시가 된 상태로
/advisor대화 상자가 표시되던 문제를 수정했습니다. 이제 "어드바이저 없음(No advisor)"으로 열립니다. -
백그라운드로 이동한 MCP 도구 호출에 대한 알림이 축약된 작업 ID를 표시하던 문제를 수정했습니다.
-
vim 모드에서
~가 커서를 줄의 마지막 문자 너머로 이동시켜, 그 뒤에 오는x는 아무 동작도 하지 않고,3~는 다음 줄까지 실행되던 문제를 수정했습니다. -
macOS에서 복사한 악센트 문자가 포함된 텍스트(예: 파일 이름)를 프롬프트 중간에 붙여넣은 후 커서가 한 문자만큼 너무 멀리 위치하던 문제를 수정했습니다.
-
응답이 수만 줄로 길어질 때 터미널이 프리징되고, ctrl+c 명령을 무시하던 문제를 수정했습니다.
-
모드가 플러그인 훅 워커 재시작 중에 호출하는 내용이
.catch를 가진 다른 모드의 가드 훅을 통과시키던 문제를 수정했습니다. 이제 그러한 호출은 거부됩니다. -
훅 모듈이 수천 레벨 깊이로 코드를 중첩시킨 플러그인들이 로드하거나 유효성 검사하는 데 실패하고 단순히 스택 오버플로우 메시지만 표시되던 문제를 수정했습니다.
-
claude plugin test가 실제 세션이 유지하는 도구 호출, 도구 결과 또는 사고 블록을 제거하는session.append훅을 통과시키던 문제를 수정했습니다. -
세션이 종료되었다가 두 번째로 재개된 후에도 Claude가 SendMessage를 통해 백그라운드 서브 에이전트를 재개할 수 있다는 사실을 알지 못하던 문제를 수정했습니다.
-
cat같은 Bash 명령어가 파일을 읽었음에도 불구하고 내용을 출력하지 않고 파일이 이미 읽힌 것으로 처리되던 문제를 수정했습니다. -
플러그인 옵션 중
constructor또는prototype으로 이름 지어졌을 때 항상 기본값으로 읽히고 편집 시 플러그인이 다시 로드되지 않던 문제 수정 -
모드가
/reload-plugins실행이나 세션 시작 시 파일을 읽는 동안 저장한 내용이 누락되던 문제 수정 -
답변 선택 없이 승인될 경우, 모드 핫 리로딩 질문이 매 턴마다 전체 세션에서 반복적으로 나타나던 문제 수정
-
/model,/fast, 그리고/output-style설정이 플러그인의config.set후크를 요청하지 않고 저장되던 문제 수정 -
어두운(dim) 텍스트 바로 뒤에 이어질 때 볼드(bold) 텍스트가 파이프 출력에서 흐릿하게 그려지던 문제 수정
-
인용구가 몇 줄마다 더 깊게 중첩되어 터미널을 몇 초 동안 멈추게 하고 기가바이트의 메모리를 사용하던 답변 수정 기능 문제 수정
-
모드의 핫 리로드가 마지막 재로드 직후 수 밀리초 이내에 저장한 내용이 누락되어, 다음 저장까지 모드가 이전 버전으로 남아있던 문제 수정
-
claude mcp serve백그라운드 Bash 결과가 출력 파일을 이름 지정하지 못하고, 도구 설명은 도착하지 않는 알림을 약속하던 문제 수정 -
비동기(async) SessionStart 후크의 변경되지 않은 컨텍스트가 재개 시마다 대화에 다시 추가되던 문제 수정
-
SessionStart 후크가
CLAUDE_ENV_FILE에 기록하는 변수들이 인앱/resume또는/branch실행 후 Bash 도달하지 못하던 문제 수정 -
스킬의
allowed-tools와effort가 스킬 도구가 응답 스트림이 끝날 때 전에 종료되면서 누락되어,-p실행에서 해당 스킬의 Bash 명령어가 거부되던 문제 수정 -
서버 관리 설정의 변조된 캐시가 개인 플러그인을 조직 관리형으로 간주하게 만들었던 문제 수정 (관리 설정 목록 또는 플러그인 활성화 시)
-
Claude 3 Opus 및 Claude 3.x Sonnet 세션에서 해당 모델이 거부하는 도구 검색 기능이 제공되던 문제 수정 (기능 플래그 사용 불가)
-
생성된 타입 파일이
-p및 SDK 세션에서--plugin-dir플러그인 폴더에 기록되던 문제 수정; 이제 모드가 개발되는 곳에만 기록됨 -
탭 또는 양방향 제어 문자로 인해 화면 가장자리에서 끝을 잃거나 근처 행 위에 그려지던 텍스트 문제 수정
-
/model이 새 세션의 기본값으로 Max effort 선택이 저장된다고 알리는 문제를 수정함; Max는 현재 세션에만 적용됨 -
비동기 후크(async hook)의 JSON 출력이 여러 줄에 걸쳐 출력될 때 무시되던 문제 수정
-
Read 도구가 빈
pages매개변수로 호출을 거부하는 대신 누락된 것으로 처리하도록 수정 -
드라이브 문자 대소문자 때문에 Windows에서 프로젝트 범위 플러그인이 VS Code에 로드되지 않던 문제 수정 (#74612)
-
드라이브 문자 케이스만 다른 경우, Windows에서 프로젝트 또는 로컬 범위의
plugin install및uninstall이 설치 기록을 누락하거나 두 번째 기록을 추가하던 문제 수정 -
←직후에↑또는Esc로 되돌아올 때 대기 중인 메시지가 손실되던 문제 수정: 이제 프롬프트 히스토리가 이를 유지함 -
SDK 호스트가 아무도 답변하기 전에 활성화 질문을 닫았을 때 모드(mod)의 핫 리로딩이 전체 세션 동안 꺼지던 문제 수정; 이제 해당 질문은 최대 세 번까지 요청됨
-
모드의
prompt.submit후크가 재작성하거나 삭제한 프롬프트가 여전히 타이핑된 것처럼 프롬프트 히스토리와 스크립트의 대기 중인 프롬프트 기록에 저장되던 문제 수정 -
요청이 MCP 서버를 사용하지 않을 때, 비대화형 세션에서 인증이 필요한 MCP 서버에 대해 알려주던 문제 수정
-
Claude 앱 게이트웨이 로그인 시
claude_code.authOpenTelemetry 로그인 이벤트가 방출되지 않던 문제 수정. 이 이벤트는 OpenTelemetry가 장치에 구성될 때 또는
AI 자동 생성 콘텐츠
본 콘텐츠는 RSS: GitHub anthropics/claude-code releases의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기