Claude Code v2.1.300, /advisor, Mod 후크 및 분할 캐시 원격 측정 추가

Claude Code v2.1.300이 출시되었고, 변경 로그의 대부분은 모드 API 표면과 텔레메트리 수정 사항입니다. 모드를 작성하거나 OpenTelemetry를 통해 Claude Code를 실행한다면, 이 버전 번호가 시사하는 것보다 더 중요합니다.

새 기능: Claude Platform on AWS의 /advisor

Claude Platform on AWS에 새로운 /advisor 명령이 있습니다. 실제로 어드바이저를 선택하기 전까지는 아무것도 실행되지 않습니다. /advisor, advisorModel 구성 값 또는 --advisor 플래그를 통해 설정할 수 있습니다. CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1을 설정하면 전체 기능이 꺼집니다.

텔레메트리: 수명별로 분할된 캐시 쓰기

OpenTelemetry api_request 이벤트에 이제 두 개의 새로운 필드, cache_creation_5m_tokens 및 cache_creation_1h_tokens가 포함됩니다. 이전에는 단일 캐시 생성 숫자를 보았지만, 이제 5분 및 1시간 프롬프트 캐시 쓰기를 분리할 수 있어 TTL 계층별로 세션 비용을 계산할 때 중요합니다.

추적 스팬에는 GenAI 의미 규약 속성도 추가되었습니다: gen_ai.provider.name, gen_ai.conversation.id, gen_ai.tool.name, error.type.

모드 API 변경 사항

• 프롬프트 장식에 virtualText 추가: 프롬프트 상자에 그려지지만 초안이나 제출된 프롬프트에 들어가지 않는 텍스트.
• $.ui.view({ agentId })는 에이전트의 트랜스크립트를 메인 뷰에 표시하고, $.ui.view({})는 돌아갑니다.
• 모드의 Text에 오른쪽에서 왼쪽 텍스트를 위한 새로운 dir prop 추가 — Windows 및 VS Code 터미널에서 행이 RTL로 읽히고 오른쪽에 붙습니다.
• 새로운 prompt.change 훅: 입력된 편집 없이 프롬프트 상자 텍스트가 변경될 때 발생합니다: 불러온 기록, 지우기, 실행 취소 또는 플러그인 채우기.
• agent.spawn 훅이 이제 워크플로 에이전트의 prompt와 model을 재작성할 수 있습니다. 이 릴리스 이전에는 워크플로 에이전트를 거부할 수만 있었습니다.

주목할 만한 수정 사항

• 모드의 prompt.submit 훅을 통한 프롬프트 재작성이 OTel user_prompt 이벤트, 상호작용 스팬 및 세션 제목 요청에 여전히 입력된 것으로 기록되었습니다.
• 에이전트 훅이 model을 무시하고 있었습니다: haiku와 같은 별칭이 이제 해결되고, 서브에이전트의 모델이 더 이상 이를 재정의하지 않으며, 사용할 수 없는 모델은 액션을 실행하는 대신 호출자의 모델로 대체됩니다.
• 클라우드 세션이 호스트를 차단한 조직 정책을 비난했지만 실제로는 세션 자체의 네트워크 설정이었습니다.
• 메시지를 입력한 서브에이전트가 완료 직후 /tasks에서 사라졌습니다.
• 에이전트 뷰가 "up", "down", "escape"와 같이 연속으로 입력된 단어를 실제 키로 취급하여 응답 중간에 미리보기를 이동하거나 초안을 지울 수 있었습니다.
• ENABLE_TOOL_SEARCH=auto가 대화 중간에, 예를 들어 재개 후 MCP 서버가 재연결되는 동안 꺼질 수 있었습니다.
• 플러그인 WorktreeCreate 및 WorktreeRemove 훅이 --worktree에서 실행되지 않았습니다 (--tmux에서는 여전히 실행되지 않음).
• --worktree 세션이 태그나 브랜치가 커밋 ID처럼 명명된 경우 잘못된 커밋에서 시작될 수 있었고, reftable 저장소에서 워크트리를 다시 열지 못했습니다.

전체 변경 로그는 아래에 있습니다 — /branch, claude purge, 유니코드 줄 구분 기호(U+2028/U+2029), forceLoginOrgUUID가 토큰을 남기는 문제, Artifact 도구의 장황한 줄 읽기 등에 대한 더 많은 수정 사항이 있습니다.