Repository navigation
v2.8.0 — Usage and Cost Analytics API, Security posture card, Claude Tag, IP allowlist readiness
LatestEnglish
Cost data now comes from Anthropic's Usage and Cost Analytics API, with the legacy reports as a fallback. The release also adds a Security posture card to Audit, Claude Tag active users to Trends, and readiness for an organization IP allowlist.
Added
- Audit: a "Security posture" card shows the current result of every control on the Security posture page in claude.ai Organization settings: how many failed, were never attested, passed, or are informational. Failed and unattested controls are listed first with their current and recommended values; the full list opens by section. The data comes from the Compliance API's Security posture endpoint (beta). Who attested and any comment are not shown.
- Audit: a change to a Security posture attestation (
org_security_control_attestation_updated) now counts as a risk event. - Trends: Claude Tag (Claude in Slack) active users appear as their own line in "Active users by product". The count is Slack users, including people who have not linked a Claude account, so it can be higher than total active users; a note says so when the line has people on it.
- The collector archives each linked user's Claude Tag active days and messages in two new
claude_code_analyticscolumns, and the chatbot's SQL tool knows about them. - IP allowlist readiness. An organization owner can now restrict the organization to a list of IP ranges, and that list also covers the Compliance API.
- When Anthropic refuses the server's address, every page shows a banner that says why, and
/api/healthreports the time of the refusal. - The collector Lambda runs inside the dashboard VPC so it leaves through the same NAT gateway addresses as the server (
collectorFixedEgressininfra/cdk.json). - A runbook lists the addresses to allow and the recovery steps.
- When Anthropic refuses the server's address, every page shows a banner that says why, and
Changed
- Cost data now comes from the Usage and Cost Analytics API (beta). Anthropic marked the four report endpoints the Cost pages were built on as legacy on 2026-10-29. Figures are the same: a live comparison matched to six decimals.
- If the new API rejects a call, the server retries on the legacy report and keeps that organization there for 30 minutes.
CCD_COST_API=legacypins the legacy reports. /api/cost/livereports which API served it incost_api.
- If the new API rejects a call, the server retries on the legacy report and keeps that organization there for 30 minutes.
- Cost: the Claude in Slack product is labeled "Claude Tag (Slack)", the name Trends uses.
Validation
- Server and structure checks: 100 passed, including new tests for the cost API adapter, the cost routes against a stubbed upstream, the Security posture shaper and the IP-allowlist detector.
- Frontend regression tests: 148 passed.
- Desktop and mobile browser checks: 68 passed on the production build with synthetic API responses, including the Security posture card and the Claude Tag line.
- An independent code review found no structural defects. Its four findings (one intermittently failing test, a fallback that could call both APIs repeatedly, an unverified paging path, and unmasked emails in control values) were all fixed before deployment.
- Live data, both organizations: the new cost API and the legacy reports produced identical results through the dashboard's own reshaping code, for organization totals, per-user spend by model, product and RBAC group, and per-user tokens. The Security posture endpoint returned results for both organizations.
- Production (2026-11-14): storage, collector and compute were deployed; ECS task definition
:130, both tasks healthy. After deployment the cost cache warm-up finished with no failures for both organizations and the server logged no fallback to the legacy reports. The collector ran once from inside the VPC with no errors, and Athena reads the new Claude Tag columns. - Not verified: the IP-allowlist banner has not been seen against a real refusal, because no allowlist is on. The ALB origin-verification change in this release's source (
infra/lib/compute-stack.ts) is not applied through CloudFormation yet; it needs the listener imported first, and the live listener already enforces the header.
한국어
비용 데이터를 Anthropic의 Usage and Cost Analytics API에서 가져오고, 기존 리포트는 폴백으로 둡니다. 감사 페이지에 보안 태세 카드를, 추세 페이지에 Claude Tag 활성 사용자를 추가했고, 조직 IP 허용 목록에 대비했습니다.
추가
- 감사: "보안 태세" 카드를 추가했습니다. claude.ai 조직 설정의 Security posture 페이지에 있는 통제 항목별 현재 결과를 실패, 미확인, 통과, 참고용 개수로 보여 줍니다. 실패하거나 확인되지 않은 항목을 현재 값, 권장 값과 함께 먼저 나열하고, 전체 목록은 섹션별로 펼쳐 볼 수 있습니다. 데이터는 Compliance API의 Security posture 엔드포인트(베타)에서 가져옵니다. 누가 확인했는지와 코멘트는 표시하지 않습니다.
- 감사: Security posture 확인 내용이 바뀐 이벤트(
org_security_control_attestation_updated)를 위험 이벤트로 분류합니다. - 추세: "제품별 활성 사용자"에 Claude Tag(Slack의 Claude) 활성 사용자를 별도 선으로 그립니다. Claude 계정을 연결하지 않은 사람까지 포함한 Slack 사용자 수라서 전체 활성 사용자보다 클 수 있고, 선에 사용자가 있을 때 이를 안내합니다.
- 컬렉터가 계정을 연결한 사용자의 Claude Tag 활동일과 메시지 수를
claude_code_analytics의 새 컬럼 두 개로 보관하고, 챗봇의 SQL 도구도 이 컬럼을 압니다. - IP 허용 목록 대비. 조직 소유자가 조직을 IP 범위 목록으로 제한할 수 있게 됐고, 이 목록은 Compliance API에도 적용됩니다.
- Anthropic이 서버 주소를 거부하면 모든 페이지에 이유를 알리는 배너를 띄우고,
/api/health가 거부 시각을 알려 줍니다. - 컬렉터 Lambda를 대시보드 VPC 안에서 실행해 서버와 같은 NAT 게이트웨이 주소로 나가게 했습니다(
infra/cdk.json의collectorFixedEgress). - 허용할 주소와 복구 절차를 런북으로 정리했습니다.
- Anthropic이 서버 주소를 거부하면 모든 페이지에 이유를 알리는 배너를 띄우고,
변경
- 비용 데이터를 Usage and Cost Analytics API(베타)에서 가져옵니다. 비용 페이지가 쓰던 리포트 네 개를 Anthropic이 2026-10-29에 legacy로 지정했습니다. 수치는 같습니다. 실데이터 비교에서 소수 여섯 자리까지 일치했습니다.
- 새 API가 호출을 거부하면 서버가 기존 리포트로 다시 시도하고 그 조직을 30분 동안 기존 리포트에 둡니다.
CCD_COST_API=legacy로 기존 리포트를 고정할 수 있습니다. /api/cost/live가 어느 API로 응답했는지cost_api로 알립니다.
- 새 API가 호출을 거부하면 서버가 기존 리포트로 다시 시도하고 그 조직을 30분 동안 기존 리포트에 둡니다.
- 비용: Claude in Slack 제품 라벨을 추세 페이지와 같은 "Claude Tag (Slack)"로 바꿨습니다.
검증
- 서버·구조 검사: 100건 통과 (비용 API 어댑터, 가짜 업스트림을 쓴 비용 라우트, 보안 태세 변환 함수, IP 허용 목록 감지의 새 테스트 포함)
- 프런트엔드 회귀 테스트: 148건 통과
- 데스크톱·모바일 브라우저 검사: 합성 API 응답으로 프로덕션 빌드에서 68건 통과 (보안 태세 카드와 Claude Tag 선 포함)
- 독립 코드 리뷰에서 구조적 결함은 없었습니다. 지적된 네 가지(간헐적으로 실패하는 테스트 하나, 두 API를 반복해서 함께 부를 수 있는 폴백, 확인되지 않은 페이지 조회 경로, 통제 항목 값 안의 마스킹되지 않은 이메일)는 배포 전에 모두 고쳤습니다.
- 실제 데이터(두 조직): 새 비용 API와 기존 리포트를 대시보드의 변환 코드에 넣은 결과가 같았습니다. 조직 합계, 모델별·제품별·RBAC 그룹별 사용자 지출, 사용자별 토큰을 비교했습니다. Security posture 엔드포인트도 두 조직 모두 결과를 돌려줬습니다.
- 운영(2026-11-14): storage, collector, compute 스택을 배포했습니다. ECS 태스크 정의
:130, 두 태스크 모두 정상입니다. 배포 뒤 비용 캐시 예열이 두 조직 모두 실패 없이 끝났고, 기존 리포트로 폴백했다는 로그는 없습니다. 컬렉터는 VPC 안에서 한 번 실행해 오류가 없었고, Athena가 새 Claude Tag 컬럼을 읽습니다. - 확인하지 못한 것: 허용 목록이 켜져 있지 않아 IP 차단 배너를 실제 차단 상황에서 보지 못했습니다. 이 릴리스 소스에 든 ALB 오리진 검증 변경(
infra/lib/compute-stack.ts)은 아직 CloudFormation으로 적용되지 않았습니다. 리스너 import가 먼저 필요하고, 라이브 리스너는 이미 헤더를 검사하고 있습니다.