Anthropic 연동 및 대시보드
Anthropic Claude API의 비용, 토큰 사용량, 멤버, Claude Code 생산성을 실시간으로 확인하는 통합 대시보드 사용법입니다. 연동 방법부터 각 탭의 해석까지 안내합니다.
Anthropic 연동 및 대시보드
조직의 Anthropic Claude 사용 현황을 한 화면에서 분석합니다. API Platform (Admin) 과 Claude.ai Enterprise (Analytics) 두 영역의 키를 각각 등록하여 비용·토큰·Claude Code 생산성·Claude.ai 활동까지 함께 볼 수 있습니다. 매일 새벽 자동 동기화되고, 필요 시 수동 새로고침도 가능합니다.
1. 연동하기
필요한 준비물
API Platform: Anthropic Console → Settings → Admin Keys에서 발급한
sk-ant-admin-으로 시작하는 Admin API Key 1개.Claude.ai Enterprise: Claude.ai → Analytics → API Keys에서 발급한
sk-ant-api01-으로 시작하는 Analytics API Key 1개. (선택)
두 키 중 하나만 등록해도 동작합니다. 두 키를 모두 등록하면 API 비용과 Claude.ai 워크스페이스 활동을 교차로 분석할 수 있습니다.
단계 1: 연동 설정 화면 열기
사이드바에서 설정 > 연동 관리로 이동합니다.
AI 도구 섹션의 Anthropic Claude 카드를 클릭합니다.
단계 2: Admin API Key 입력 (API Platform)
상단 API Platform (Admin) 섹션을 엽니다.
안내: "Anthropic Console → Settings → Admin Keys에서 발급받은 Admin API Key를 입력해주세요."
Admin API Key입력 (placeholder:sk-ant-admin-...).연동하기버튼을 클릭합니다. (sk-ant-admin으로 시작하지 않으면 버튼이 비활성화됩니다)
이 키로 동기화되는 데이터: 조직, 멤버, 비용, 토큰 사용량, Claude Code
Admin Key 형식 확인 sk-ant-admin으로 시작하지 않으면 "Admin API Key는 sk-ant-admin으로 시작해야 합니다." 힌트가 표시됩니다. 개인용 API Key(sk-ant-api...)나 Analytics Key(sk-ant-api01-...) 로는 Admin 섹션에 연동되지 않습니다.
단계 3: Analytics API Key 입력 (Claude.ai Enterprise, 선택)
하단 Claude.ai Enterprise (Analytics) 섹션을 엽니다.
안내: "Claude.ai → Analytics → API Keys에서 발급받은 Analytics API Key를 입력해주세요."
Analytics API Key입력 (placeholder:sk-ant-api01-...).연동하기버튼을 클릭합니다. (sk-ant-api01으로 시작하지 않으면 버튼이 비활성화됩니다)
이 키로 동기화되는 데이터: DAU/WAU/MAU, 사용자 활동, 프로젝트, 스킬, 커넥터
Analytics API 가능 여부 Claude.ai Enterprise 플랜에서만 제공됩니다. Pro·Team 플랜은 API Platform (Admin) 연동만 가능합니다.
2. 대시보드 접근
사이드바의
AI>Anthropic메뉴를 클릭합니다.또는 AI 메인 페이지(
/ai)에서 Anthropic Claude 카드의열기버튼을 누릅니다.헤더에 "Anthropic Claude — {워크스페이스명} · 마지막 동기화: {시각}" 이 표시되면 연동이 정상 동작 중입니다.
헤더 우측 버튼:
새로고침(SplitButton 메인) — 즉시 수동 동기화를 실행합니다.연동 설정(SplitButton 드롭다운) — 설정 > 연동 관리 페이지로 이동합니다.
3. 탭 구성
대시보드는 두 개의 메인 탭으로 구성됩니다.
API Platform
Admin API Key 연동 시
API 비용·토큰 사용량·Claude Code 생산성·멤버 (개요/비용/사용량/Claude Code/멤버 5개 sub-tab)
Claude.ai Enterprise
Analytics API Key 연동 시
DAU/WAU/MAU 추이, 사용자 활동, 프로젝트·스킬·커넥터 사용 현황
기간은 오늘 기준 최근 30일로 고정되어 있습니다(별도 날짜 필터는 없습니다).
한 쪽만 연동된 경우, 미연동 탭은 비활성화되며 "Admin API 연동이 필요합니다" 또는 "Analytics API 연동이 필요합니다" 안내가 표시됩니다.
API Platform sub-tab:
개요
핵심 지표(KPI) 4장 + 모델별 비용 바차트 + Claude Code Top 5
멤버
워크스페이스 멤버 목록 + 대기 중인 초대
비용
모델별 비용 상세 (Priority Tier 제외 안내 포함)
사용량
모델별 토큰 사용량(입력·캐시·출력·합계) 테이블
Claude Code
사용자별 Claude Code 생산성(세션·커밋·PR·LOC·비용)
Claude.ai Enterprise 탭 주요 위젯:
활성 사용자 추이 (DAU) — 일별 DAU 라인 차트, WAU/MAU 보조 표시
프로젝트 목록 — 프로젝트별 사용자·메시지 활동
스킬 / 커넥터 사용 현황 — 워크스페이스에서 사용 중인 스킬·커넥터 집계
4. 개요 탭 — KPI 해석
총 멤버
연동된 Anthropic 워크스페이스의 총 멤버 수. 서브텍스트로 N 대기 중인 초대
이번 달 비용
이번 달 누적 API 비용(USD). 서브텍스트로 워크스페이스 수
총 토큰
30일 누적 토큰 사용량(K/M/B 단위). 서브텍스트로 캐시 효율 N%
Claude Code 사용자
최근 30일 내 Claude Code 세션을 가진 활성 개발자 수
모델별 비용 (수평 바차트): 각 모델의 사용 비중을 $금액 / %로 표시합니다. 비용이 큰 순서대로 정렬됩니다.
사용자별 Claude Code 활동 Top 5: 이메일 기준 상위 5명의 세션/커밋/비용.
5. 비용 탭
안내 배너(파란색): "Priority Tier 비용은 Anthropic Cost API에 포함되지 않습니다."
모델별 비용 바차트(개요와 동일)
실제 결제되는 비용과 본 대시보드 수치에 다소 차이가 있을 수 있다는 점을 유의하세요.
6. 사용량 탭
모델별 토큰 사용량 DataGrid입니다.
모델
Claude 모델명
입력 (비캐시)
캐시되지 않은 입력 토큰 수
캐시 읽기
캐시에서 읽은 입력 토큰 수 (비용 절감 지표)
출력
생성된 출력 토큰 수
합계
위 3항목 합계 (기본 내림차순 정렬)
캐시 효율이 낮다면 Anthropic 측의 프롬프트 캐싱 활용을 검토해 보세요.
7. Claude Code 탭
사용자별 Claude Code 개발 생산성을 집계합니다.
이메일
사용자 이메일
세션
Claude Code 사용 세션 수 (기본 내림차순)
LOC (+) / (-)
추가/삭제 라인 수
커밋
커밋 수
PR
Pull Request 수
활성 일수
30일 중 실제 사용한 일수
비용
해당 사용자의 Claude Code 관련 비용 (USD)
8. 멤버 탭
멤버 목록: 이름, 이메일, 역할, 추가일 (Anthropic 워크스페이스 기준)
초대 목록: 초대를 발송했지만 아직 수락되지 않은 항목. 상태가
pending/expired/accepted로 표시됩니다.
9. 동기화 방식
자동 동기화: 매일 한국시간 오전 4시 30분 배치로 실행됩니다(Anthropic Cost/Usage/Members API 호출).
수동 동기화: 대시보드 헤더의
새로고침버튼으로 즉시 트리거할 수 있습니다.수동 동기화는 서버에서 비동기로 실행되며, 완료 후 다음 로드 시 데이터가 반영됩니다.
Partial Sync 경고
일부 API만 실패한 경우 노란색 배너로 안내됩니다.
"일부 데이터 동기화에 실패했습니다: {사유}"
비용 데이터는 최신이 아닐 수 있으므로, 중요한 지표 확인 시 수동 새로고침을 한 번 더 실행하세요.
10. 아직 연동되지 않았을 때
연동 관리로 이동하기 버튼으로 설정 > 연동 관리 페이지로 바로 이동해 연동을 시작할 수 있습니다.
11. 권한 안내
Basic 플랜은 AI 메뉴 자체가 숨겨집니다 Basic 플랜(권한 0개)에서는 사이드바에 AI 메뉴가 표시되지 않습니다.
대시보드 조회
로그인된 워크스페이스 세션 (Standard 이상)
연동 설정 (설정 > 연동 관리) 접근
관리자(Admin) 역할
수동 동기화 실행
대시보드가 연동 상태일 때만 버튼 노출
12. 문제 해결
Q: 연동하기 버튼이 비활성화되어 있어요
원인: 입력한 키가 sk-ant-admin으로 시작하지 않았을 때입니다.
해결 방법: Anthropic Console → Settings → Admin Keys에서 발급받은 키를 붙여 넣으세요. 개인용 sk-ant-api... 키로는 연동되지 않습니다.
Q: 대시보드에 비용이 0으로 표시돼요
원인:
첫 자동 동기화(다음 날 새벽 4시 30분)가 아직 돌지 않았을 수 있습니다.
해당 기간에 실제 사용이 없었을 수 있습니다.
해결 방법:
헤더의
새로고침버튼으로 수동 동기화를 실행해 보세요.Anthropic Console에서 실제 사용량이 있는지 직접 확인하세요.
Q: 일부 데이터 동기화에 실패했다는 배너가 떴어요
원인: Anthropic API 일시 장애 또는 Admin Key 권한 부족.
해결 방법:
잠시 후
새로고침버튼으로 재시도합니다.계속 실패하면 Anthropic Console에서 Admin Key 권한을 확인합니다.
해결되지 않으면 채널톡으로 배너의 원문 메시지를 함께 알려주세요.
Q: Priority Tier 비용은 왜 제외되나요
Anthropic Cost API가 Priority Tier 요금을 포함하지 않기 때문입니다. 정확한 총액은 Anthropic Console에서 직접 확인하세요.
Q: 이 외의 문제
채널톡으로 문의해 주세요.
Last updated