## 변경 사항 - 모드(mod)의 `turn.step` 훅 결과에 `serverToolUses`를 추가했습니다: 도구가 직접 API를 실행
요약
Claude 모드의 개발자 경험을 대폭 개선하는 다양한 변경 사항들이 발표되었습니다. `turn.step` 훅에 `serverToolUses`를 추가하여 도구 호출 기록을 상세히 추적할 수 있게 되었으며, 플러그인 및 관리 기능의 권한 확인(gating)과 테마 색상 지정 등 구조적인 안정성과 확장성이 강화되었습니다.
핵심 포인트
- 모드 훅에 `serverToolUses`를 추가하여 도구 사용 기록을 상세하게 추적 가능
- 플러그인 훅에 서브 에이전트 권한 확인(`agentId`) 기능 도입
- 관리 설정 및 게이트웨이에 대한 경고/진단(doctor) 기능 강화
- 긴 세션 처리 안정성 개선: 대용량 텍스트, 스트리밍 문제 등 다수 수정
변경 사항
-
모드(mod)의
turn.step훅 결과에serverToolUses를 추가했습니다: 도구가 직접 API를 실행한 호출 기록(어드바이저)을 ID, 이름, 입력, 시작 및 종료 시간과 함께 포함합니다. -
플러그인 훅의
tool.check이벤트에agentId를 추가하여, 훅이 메인 세션의 권한 확인이 아닌 서브 에이전트(subagent)의 권한 확인임을 알릴 수 있게 했습니다. -
모드(mod)의
tool.check훅이 읽는 질문과 판결에 '천장(ceiling)'을 추가하여, 도구 사용에 대해 조직이 요구하는 승인 수준을 명명할 수 있게 했습니다. -
플러그인 훅 타입 정의에
ThemeKey와Color타입을 추가하여, 모드가 그리는 내용의 테마 색상을 편집기에서 나열할 수 있게 했습니다. -
claude plugin validate에 다음 내용을 추가했습니다: 게이팅 사이트(gating site)에 등록된 각 훅과 해당 훅이.catch를 가지고 있는지 여부(--json아래gatingHooks)를 나열합니다. -
Claude 앱스 게이트웨이(apps gateway)의 로그인 승인 페이지에 거부(Deny) 버튼을 추가했습니다: 이 버튼은 보류 중인 로그인을 종료하여 대기 터미널을 몇 초 내에 멈추게 합니다.
-
claude attach <name>및claude logs <name>을 추가했습니다: 세션 이름의 일부가 ID 대신 사용될 수 있습니다. -
/claude-api managed-agents-onboard <url>를 추가하여, 페이지에서ant apply파일로 설명하는 관리 에이전트 패턴(Managed Agents pattern)을 설정할 수 있게 했습니다. -
/claude-api managed-agents-onboard <quickstart-name>을 추가하여,antCLI를 사용하여deep-researcher와 같은 콘솔 퀵스타트 템플릿을 구축할 수 있게 했습니다. -
관리 설정 파일이 관리 설정 폴더 외부의 파일을 가리키는 링크인 경우 경고 메시지를 추가했습니다.
-
관리 설정이 사용자가 구성한 sandbox allowRead 경로 또는 허용된 도메인을 무시하는 경우
/status및doctor경고를 추가했습니다. -
Claude Code의 베타 헤더 중 하나가 400 상태 코드가 아닌 다른 상태 코드로 거부하는 프록시나 게이트웨이 뒤에서 요청 실패 문제를 수정했습니다.
-
수백 개의 이미지가 포함된 긴 세션에서
-
실행 중 메시지를 받은 후 서브 에이전트와 팀원이 이전에 생각했던 내용과 프롬프트 캐시를 잃는 문제 수정
-
WebFetch가 100,000자를 초과하는 페이지 텍스트를 조용히 누락하던 문제 수정; 이제 읽지 못한 양을 표시하고
offset을 받아 읽어옵니다. -
응답에 중첩된 리스트나 따옴표가 수천 레벨 깊이로 들어갈 때 발생하는 충돌(
-
Remote Control 및 클라우드 세션에서 매우 긴 응답이 스트리밍되지 않고 한 번에 블록으로 나타날 수 있던 문제 수정
-
claude daemon run및claude daemon logs하에서 백그라운드 데몬의 로그가 터미널 제어 문자를 화면으로 전달하던 문제 수정; 이제 이들은\uXXXX이스케이프로 표시됩니다. -
셀프 호스팅 러너: 세션 오류 출력의 매우 긴 조작된 라인이 러너를 몇 초 동안 멈추게 하던 문제 수정
-
플러그인 후크에서
.catch가 언로드되고, 그.catch가 건너뛰어지면서 후크가 프롬프트 또는 도구 호출에 의해 후크 워커를 바쁘게 유지하던 문제 수정 -
모드의
turn.step결과 목록에 중간 응답 모델 폴백(fallback)이 폐기한 도구 호출이 포함되던 문제 수정 -
Cowork 클라우드 세션의 응답이 Claude가 메시지나 파일을 보낸 직후 컨테이너가 재시작될 때 가끔 완료되지 않던 문제 수정
-
claude plugin validate및 플러그인 로딩 시, 옵션을 그 최상위 함수 이름과 유사하게 구조 분해하던 후크 모듈을 거부하던 문제 수정 -
git 설정에서
core.safecrlf=true가 설정된 경우/ultrareview가 커밋되지 않은 변경 사항을 업로드하지 못하던 문제 수정 -
플래그 지정된 메시지가 다른 레벨이 설정된 폴백 모델에 재시도될 때 노력 수준(effort level)이 변경되던 문제 수정
-
Windows: 스킬 및 명령어에서 여러 줄의
!셸 블록이 파일이 CRLF 라인 엔딩으로 저장될 때 실패하던 문제 수정 -
전체 화면 모드에서
/permissions탭을 클릭하는 동안 Claude Code가 죽지 않아 멈추던 문제 수정 -
대화 압축(conversation compaction)이 가끔
-
모드가 끝난 후 높이가 변경되는 트리를 따라갈 때, 모드의 패널이나 밴드가 끝나지 않고 계속 다시 그려지는 문제 수정
-
macOS와 Windows에서 이미지 읽기 시, 읽는 도중에 링크가 교체될 경우 승인된 범위를 벗어나는 파일을 반환할 수 있던 문제 수정
-
사용자가 설치한 모드가 조직의 플러그인을 언로드하게 만들 수 있던 사례를 수정했습니다. 이제 해당 모드가 언로드됩니다.
-
disableClaudeAiConnectors및allowedMcpServersURL 규칙이.mcp.json에 선언된 일부 MCP 항목, 플러그인 또는 에이전트에 적용되지 않던 문제를 수정 -
모드의 인라인 패널이 트리의 높이가 그릴 때마다 변경되면서 끝나지 않고 계속 다시 그려지던 문제 수정
-
읽기 블록이나
--restricted아래의@-멘션이 읽는 도중에 링크가 변경된 경우 작업 디렉터리를 벗어나는 파일을 읽을 수 있던 문제를 수정 -
에이전트 뷰에서 Esc 키를 누르면
-
매우 긴 메시지를 전송한 후 발생하는 멈춤 현상 수정
-
스크립트 확장(Ctrl+O) 또는 화살표, 대시, 박스 그리기 문자 같은 비-ASCII 문자가 포함된 큰 도구 출력 영역을 크기 조정할 때 느려지는 현상 수정
-
claude respawn이 저장된 스크립트가 없는 백그라운드 세션에 이전 메시지를 재전송하는 문제 수정 (빈 대화로 시작하는 대신) -
에이전트 뷰에서
n:또는 Ctrl+F 검색 후 Esc 키를 누르면 포커스가 섹션 헤더로 이동하고, 여기서 Ctrl+X를 두 번 누르면 해당 섹션의 모든 세션을 삭제하던 문제 수정 -
claude agents가 전달할 수 없는 슬래시 명령어를 중지된 세션에 저장한 다음, 다음에 해당 세션이 재시작될 때 스스로 실행시키던 문제 수정 -
/ultrareview가unset또는unspecified라는 이름의 git 필터 드라이버 아래 파일에 커밋되지 않은 변경 사항을 필터링 없이 업로드하던 문제 수정; 이제 업로드가 중단되고 드라이버 이름을 변경하라고 요청함 -
자동 모드 거부(auto mode denials)가 전체 도구에 대한 권한 규칙을 제안하거나 Claude Code가 무시할 수 있는 것을 제안하던 문제 수정
-
claude --teleport및/teleport가 스테이시(stash)를 선택했을 때 추적된 파일과 같은 이름의 폴더 내 파일을 삭제하던 문제 수정: 이제 스테이시는 거부되며 그 이유를 알려줌 -
에이전트 뷰에서
-
claude agents가 백그라운드 세션 충돌 직후 전송한 답변이 2초 후에 거부되던 문제 수정: 이제 최대 12초 동안 재시도되며 세션이 재개됩니다 -
claude agents가 실행 중인 세션에 전달할 수 없었던 슬래시 명령어 및 객관식 질문 답변이 다음 재시작 시 스스로 저장되고 전송되던 문제 수정 -
다른 명령어에 heredoc을 파이프하는 격리된(sandboxed) 명령어(
cat <<EOF | python3)가 실행될 때마다 승인을 요청하던 문제 수정 -
claude agents가 Homebrew 업그레이드 후( -
PostgreSQL 버전에서 2025년 11월 수정 사항이 없는 경우, Claude apps gateway의 보존 스윕(retention sweep)이 돌아오는 개발자의 아이덴티티 행을 삭제하던 문제 수정
-
sandboxed Monitor 도구 명령어가 sandbox 자동 허용(auto-allow) 하에서 권한 프롬프트를 건너뛰던 문제 수정; 이제는 사용자의 권한 규칙을 따릅니다
-
identity provider에 제시하는 인증서의 subject가 비어 있을 때 Claude apps gateway가 시작하지 않던 문제 수정
-
store.postgres_url을 구문 분석할 수 없을 때 Claude apps gateway가 단순히
AI 자동 생성 콘텐츠
본 콘텐츠는 Claude Code Releases의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기