Claude Code v2.1.317, 비용 분석 API, OTel 사용자 속성, 실패 시 차단 훅 추가

Claude Code v2.1.317은 게이트웨이를 통해 앱을 실행하거나, OpenTelemetry로 모니터링하거나, Agent SDK 위에서 구축하는 팀을 위한 몇 가지 추가 사항이 포함된 유지보수 릴리스입니다.

게이트웨이 비용 보고

Claude 앱 게이트웨이 관리자 API가 이제 GET /v1/organizations/analytics/cost를 제공합니다. 이 엔드포인트는 날짜 범위에 걸친 과거 지출을 전체, 개발자별, 일별, 또는 IdP 그룹별로 분류하여 반환합니다. IdP 그룹화를 지원하기 위해 admin:이 설정된 게이트웨이는 이제 각 개발자의 IdP 그룹 일일 기록을 보관하며, admin.identity_retention_days 동안 유지됩니다.

OpenTelemetry 속성

OTel 메트릭, 이벤트, 스팬에 네 가지 새로운 속성이 추가됩니다:

• anthropic.plan
• anthropic.seat_type
• anthropic.provider
• anthropic.custom_base_url

이미 Claude Code 텔레메트리를 대시보드로 스크래핑하고 있다면, 이를 통해 구독 계층별 또는 요청이 어떤 제공자/기본 URL을 통해 전송되었는지에 따라 트레이스를 분할할 수 있습니다.

Agent SDK 훅 동작

훅 콜백이 이제 onFailure: "block"을 허용합니다. 이전에는 실패한 콜백이 작업을 계속 진행하도록 허용했지만, 이 설정을 사용하면 실패 시 작업이 차단됩니다.

개인정보 및 일정 보호

두 가지 새로운 프롬프트가 예기치 않은 데이터 노출을 줄입니다:

• 웹 또는 셸 도구 호출이 계정 이메일 주소를 네트워크로 전송하기 전에 확인을 요청합니다.
• /schedule은 새 클라우드 예약 작업이 요청하지 않은 커넥터를 선택할 때 경고하고 제거 방법을 알려줍니다.

또한 Claude Desktop의 Code 탭에서 조직의 원격 관리 설정이 아직 로드되지 않았을 때와 로드되었을 때 알림이 표시됩니다. 자동 모드에서 하위 에이전트의 도구 호출에 대한 검사 답변이 없을 때 기본 보기가 비어 있지 않고 알림이 표시됩니다.

자체 호스팅 러너 이스케이프 해치

자체 호스팅 러너에서 CLAUDE_CODE_DISABLE_NESTED_SESSION_ID=1을 설정하면 세션 내 claude -p가 해당 세션의 ID와 트랜스크립트를 사용하여 변경 전 동작을 복원합니다.

주요 수정 사항

• 일부 데스크톱 세션에서 첫 턴 후 프로젝트 및 로컬 MCP 서버 연결이 끊기는 문제.
• LLM 게이트웨이 기본 URL이 서버 측 안전 검사에 403/422를 반환할 때 자동 모드가 매 턴 실패하는 문제(apiKeyHelper 사용 시 403은 변경 없음).
• claude auth status가 느린 토큰 갱신이 저장되기 전에 종료되어 다음 실행 시 로그아웃될 수 있는 문제.
• claude --from-pr이 세션이 많은 프로젝트에서 오래된 연결 세션에 대해 "No conversations found"를 보고하는 문제.
• claude -p가 디스크 가득 참 또는 할당량으로 트랜스크립트나 ~/.claude.json 쓰기를 잃었을 때 0으로 종료되는 문제; 이제 텍스트 및 JSON 출력에서 오류를 출력하고 1로 종료합니다. 전체 NFS 내보내기는 놓칠 수 있습니다.
• 실행 후 약 1초 이내에 설정 파일을 편집한 내용이 다른 설정 변경 전까지 적용되지 않는 문제.
• 실행이 정리를 건너뛸 때(예: --setting-sources 사용) 오래된 트랜스크립트가 정리되지 않는 문제.
• Claude 앱 게이트웨이가 Bedrock의 "Input is too long." 오류를 숨겨 세션이 압축 대신 "upstream rejected the request"로 매 턴 실패하는 문제.

에이전트 팀, /team-onboarding, /loop 깨우기, 클라우드 세션 제목, claude.ai에서 동기화된 스킬, 스크린 리더 상세 정보에 대한 또 다른 12가지 수정 사항이 있습니다. 전체 목록은 릴리스 노트에 있습니다.