Claude Code v2.1.317 — AI 지출이 API가 되고, 이메일은 나가기 전에 묻습니다
v2.1.317은 기업 관점의 릴리스입니다. Claude apps 게이트웨이에 비용 분석 API — GET /v1/organizations/analytics/cost 가 추가돼, 날짜 범위의 과거 지출을 총액·개발자별·일별·IdP 그룹별로 조회할 수 있게 됐습니다.
한마디로 말하면, AI 지출이 정산서가 아니라 쿼리 가능한 데이터가 된 것이고, 개인 사용자에게는 이메일 주소가 네트워크로 나가기 전에 물어봐 주는 게이트가 달린 업데이트입니다.
비용이 API가 됐다 — FinOps의 마지막 조각
이번 비용 리포트의 설계가 실무적입니다. admin.identity_retention_days 설정으로 각 개발자의 IdP 그룹 소속을 일별 기록해두고, 그 기록을 기준으로 비용을 그룹별로 집계합니다. OTel 메트릭·이벤트·스팬에도 anthropic.plan, anthropic.seat_type, anthropic.provider, anthropic.custom_base_url 속성이 추가돼 어떤 플랜·시트·프로바이더 조합이 돈을 쓰는지 대시보드에서 분해됩니다. 지난 몇 주간 쌓은 기능들 — pooled group budgets(316), guardrail trace(314), policy_mode layered — 와 이 비용 API가 합치면, 기업은 "누가 얼마를 썼고 무엇에 막혔는지"를 하나의 데이터 파이프라인으로 관리하게 됩니다.
이메일이 나가기 전에 묻는다 — 프라이버시 게이트
웹이나 셸 도구 호출이 계정 이메일 주소를 네트워크로 전송하려 하면 먼저 확인을 요청하는 체크가 추가됐습니다. 에이전트가 curl이나 웹 요청에 이메일을 실어보내는 사고 — 개인 식별 정보의 조용한 유출 — 를 프롬프트 단에서 차단하는 장치입니다. 함께 온 /schedule 경고도 같은 계열입니다. 새 클라우드 예약 작업에 요청하지 않은 커넥터가 붙는 경우, 제거 방법과 함께 알려줍니다. 자동 모드가 서브에이전트 도구 호출에 대해 답을 내지 못할 때 아무 표시 없이 지나가던 침묵 구간도 메인 뷰에 공지로 남게 됐습니다.
훅 실패는 이제 차단한다 — fail-closed의 Agent SDK 확장
Agent SDK 훅 콜백에 onFailure: "block"이 추가돼, 콜백이 실패하면 해당 액션을 실행 대신 차단합니다. 295의 fail-closed 훅, 304의 decider: "person", 314의 쓰기 범위 잠금에 이어, 이제 "검증하려고 붙인 코드 자체가 실패했을 때"까지 막는 마지막 모서리가 닫힌 것입니다. 버그 수정 중 눈에 띄는 것은 claude auth status가 느린 토큰 갱신 저장 전에 종료해 다음 실행 때 로그아웃 상태가 되던 문제, 데스크톱 세션에서 프로젝트·로컬 MCP 서버가 첫 턴 후 끊기던 문제, LLM 게이트웨이가 자체 안전 체크에 403·422를 반환하면 자동 모드가 매 턴 실패하던 문제입니다.
실전 가이드
게이트웨이 운영 팀은 이번 버전이 사실상 FinOps 도입 타이밍입니다 — 비용 API와 그룹 기록은 admin: 권한 게이트웨이에서 바로 조회됩니다. 자동화 파이프라인을 운영하는 개인이라면 onFailure: "block"으로 훅을 다시 감싸고, 이메일 전송 체크는 그대로 두는 것을 권합니다. auth status 수정은 SSH 환경에서 로그인이 자주 풀리던 분들의 원인일 수 있습니다.
마무리로 — 314(범위 잠금)→316(예산·정책)→317(비용 조회·프라이버시 게이트)로 이어진 3연타의 방향은 하나입니다. 에이전트를 쓰는 조직이 통제 없이는 못 쓰게 만드는 것 — 그리고 그 통제가 이제 쿼리 가능한 데이터로 남습니다.
출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.317
태그: AI Claude Claude Code 개발도구