Anthropic 연동 및 대시보드

Anthropic의 API 플랫폼(Console)과 Claude.ai Enterprise Analytics 데이터를 한 화면에서 확인하는 대시보드 사용법입니다. API Key 연동 방법부터 두 탭의 각 위젯 해석, 동기화·다운로드까지 안내합니다.

Anthropic 연동 및 대시보드

조직의 Anthropic 사용 현황을 한 화면에서 분석합니다. 대시보드는 API Platform(API 비용·토큰·멤버·Claude Code 활동)과 Claude.ai Analytics(DAU/WAU/MAU·사용자 활동·프로젝트·스킬·커넥터) 두 탭으로 나뉘며, 각 탭은 해당하는 API Key를 등록했을 때 채워집니다. 매일 새벽 자동으로 동기화되고, 필요 시 탭별로 수동 새로고침을 할 수 있습니다.

1. 연동하기

단계 1: 연동 설정 화면 열기

사이드바에서 설정 > 연동 관리로 이동합니다.
AI 도구 섹션의 Anthropic API 카드에서 **연동하기**를 누릅니다.
Anthropic 연동 상세 화면(/settings/integration/anthropic)으로 이동합니다.

단계 2: API Key 등록

Anthropic API 연동하기 다이얼로그가 열립니다.
안내: “이 연동은 API 플랫폼(Console) 관리 기능입니다. Claude.ai 구독과는 별개입니다. Console Admin Key(sk-ant-admin-…)와 Enterprise Analytics Key(sk-ant-api01-…) 모두 지원합니다.”
API Key 입력란에 발급받은 키를 붙여 넣습니다 (placeholder: sk-ant-admin-... 또는 sk-ant-api01-...).
연동하기 버튼을 누릅니다.
두 탭을 모두 채우려면, 같은 방식으로 나머지 키도 한 번 더 등록합니다.

연동 후 관리

연동된 뒤에는 카드의 관리 메뉴에서 설정 화면으로 다시 들어가거나, **연동 해제하기**로 연동을 끊을 수 있습니다.
연동을 해제하면 안내됩니다: “정말 이 연동을 해제하시겠습니까? 연동 해제 후에는 관련 데이터 동기화가 중단됩니다.”

2. 대시보드 접근

사이드바의 AI > Anthropic 메뉴를 누릅니다.
또는 AI 메인 페이지(/ai)에서 Anthropic 카드의 열기 버튼을 누릅니다.

헤더 — 연동 설정 버튼

대시보드 헤더 우측의 연동 설정 버튼을 누르면 Anthropic 연동 상세 화면으로 이동해 키를 추가·교체·해제할 수 있습니다.

3. 탭 구성과 공통 도구

대시보드는 두 개의 탭으로 구성됩니다. 각 탭은 하나의 화면을 위에서 아래로 스크롤하는 구조이며, 별도의 하위 탭은 없습니다.

탭	채워지는 키	내용
`Claude.ai Analytics`	Analytics API Key	DAU/WAU/MAU·시트 활용률·초과 비용·사용자 활동·프로젝트·스킬·커넥터·사용량 추이
`API Platform`	Console Admin Key	멤버·이번 달 비용·총 토큰·모델별 비용·모델별 토큰·Claude Code 활동·멤버/초대 목록

Analytics 키가 연동돼 있으면 기본으로 Claude.ai Analytics 탭이 먼저 열리고, 그렇지 않으면 API Platform 탭이 열립니다.
한 쪽만 연동된 경우, 미연동 탭에는 “Admin API 연동이 필요합니다” 또는 “Analytics API 연동이 필요합니다” 안내와 연동 설정으로 이동 버튼이 표시됩니다.
각 탭 설명 아래에 **마지막 동기화: {시각}**이 탭별로 표시됩니다.

탭 우측 — 데이터 다운로드

탭 바 우측의 데이터 다운로드 버튼으로 화면의 데이터를 Excel(XLSX)로 내려받습니다.

버튼 본문을 누르면 다운로드가 실행됩니다. 두 탭이 모두 연동돼 있으면 “다운로드 파일 선택” 창이 떠 두 파일 모두 / Claude.ai Analytics / API Platform 중 하나를 고릅니다. 한 쪽만 연동돼 있으면 곧바로 해당 파일이 받아집니다.
API Platform 파일은 Claude Code 사용자·모델별 토큰·모델별 비용·멤버·초대 5개 시트로, Claude.ai Analytics 파일은 사용자 활동·Chat 프로젝트·스킬·커넥터·사용자별 리포트 5개 시트로 구성됩니다.
버튼의 드롭다운(▾) 안에는 **새로고침**이 있어 현재 탭의 데이터를 즉시 다시 동기화합니다.

4. API Platform 탭

API Platform 탭은 위에서부터 KPI 카드 → Priority Tier 안내 → 모델별 비용 → 모델별 토큰 → Claude Code 활동 → 멤버/초대 목록 순으로 이어집니다.

KPI 카드 (3장)

카드	의미
총 멤버	연동된 Anthropic 조직의 총 멤버 수. 대기 중인 초대가 있으면 함께 표시됩니다.
이번 달 비용	모델별 비용의 합계(USD). 서브텍스트로 워크스페이스 수가 표시됩니다.
총 토큰	누적 토큰 사용량(K/M/B 단위). 서브텍스트로 `캐시 효율 N%`가 표시됩니다.

모델별 비용

각 모델의 비용을 수평 바로 표시하고, 비용이 큰 순서로 정렬합니다. 모델로 귀속되지 않는 항목(서버 툴·미분류)은 기타/미분류로 묶입니다.

모델별 토큰 사용량

컬럼	의미
모델	Claude 모델명
입력 (비캐시)	캐시되지 않은 입력 토큰 수
캐시 읽기	캐시에서 읽은 입력 토큰 수 (비용 절감 지표)
출력	생성된 출력 토큰 수
합계	위 3항목 합계 (기본 내림차순 정렬)

사용자별 Claude Code 활동

이메일 단위로 Claude Code 생산성을 집계한 표입니다. 검색·정렬이 가능하며 기본 정렬은 세션 내림차순입니다(상위 일부만 보여주는 것이 아니라 전체가 표시됩니다).

컬럼	의미
이메일	사용자 이메일
세션	Claude Code 사용 세션 수
LOC (+) / (-)	추가/삭제 라인 수
커밋	커밋 수
PR	Pull Request 수
활성 일수	실제 사용한 일수
비용	해당 사용자의 Claude Code 관련 비용(USD)

멤버 / 초대 목록

멤버 목록: 이름, 이메일, 역할, 추가일 (Anthropic 조직 기준). 검색·정렬 가능.
초대 목록: 발송했지만 아직 수락되지 않은 초대가 있을 때만 표시됩니다. 상태가 대기 중 / 만료 / 수락됨으로 구분됩니다.

5. Claude.ai Analytics 탭

Claude.ai Analytics 탭은 안내 배너 → KPI 카드 → DAU 추이 → 활동/프로젝트/스킬/커넥터 표 → 사용량·초과 비용 추이 → 사용자별 사용량 순으로 이어집니다.

KPI 카드 (5장)

카드	의미
일간 활성 사용자 (DAU)	가장 최근일의 활성 사용자 수. 지난주 대비 증감을 함께 표시
주간 활성 사용자 (WAU)	주간 활성 사용자 수. 지난주 대비 증감
월간 활성 사용자 (MAU)	월간 활성 사용자 수. 지난달 대비 증감
시트 활용률	MAU ÷ 보유 시트 수. `사용자 / 전체 석`을 함께 표시
초과 비용	시트 한도를 넘겨 소진된 Usage Credits 비용(USD). 초과 사용한 사용자 수를 함께 표시

위젯

활성 사용자 추이 (DAU) — 일별 DAU를 면적 차트로 표시합니다. 마우스를 올리면 해당일의 DAU/WAU/MAU를 함께 보여줍니다.
사용자 활동 — 사용자별 대화·메시지·프로젝트·파일·아티팩트·웹 검색·스킬·커넥터 사용 건수 표.
Chat 프로젝트 — 프로젝트별 사용자·대화·메시지·생성자 표.
스킬 사용량 — 스킬별 사용자 수와 Chat/Code/Office 사용 횟수 표.
커넥터 사용량 — 커넥터별 사용자 수와 Chat/Code 사용 횟수 표.
사용량 및 초과 비용 추이 — 한 카드 안에 토큰 사용량 면적 차트와 초과 비용(USD) 면적 차트를 위아래로 함께 표시합니다.
사용자별 사용량 — 사용자·날짜별 입력/캐시/출력/합계 토큰과 초과 비용(USD)을 한 표로 묶어 보여줍니다.

6. 동기화 방식

자동 동기화: 매일 한국시간 오전 4시 30분 배치로 실행됩니다.
- API Platform(Admin Key): 첫 동기화 때 최근 30일치를 모아 오고, 이후에는 전날 데이터만 채웁니다.
- Claude.ai Analytics(Analytics Key): API 정책상 3일 지연이 있어 가장 최근 사용 가능한 날(3일 전)까지만 수집합니다.
수동 동기화: 탭별 데이터 다운로드 드롭다운의 **새로고침**으로 현재 탭만 즉시 동기화합니다(5분 쿨다운).

일부 동기화 실패

일부 데이터만 수집에 실패하면 노란색 배너로 안내됩니다.

“일부 데이터 수집에 실패했습니다. 다음 동기화 시 재시도됩니다.”

다음 자동 동기화 때 자동으로 재시도되며, 급하면 해당 탭에서 **새로고침**을 한 번 더 실행하세요.

7. 권한 안내

작업	필요 권한
대시보드 조회	로그인된 워크스페이스 세션 (Standard 이상)
연동 설정 (`설정 > 연동 관리`) 접근	관리자(Admin) 역할
수동 새로고침 실행	대시보드가 연동 상태일 때만 메뉴 노출

8. 문제 해결

Q: 연동하기 버튼을 눌렀는데 키가 등록되지 않아요

원인: 입력한 키가 sk-ant-admin 또는 sk-ant-api01으로 시작하지 않았을 때입니다.

해결 방법: Anthropic Console에서 발급한 Admin Key(sk-ant-admin-...) 또는 Claude.ai Enterprise의 Analytics Key(sk-ant-api01-...)를 붙여 넣으세요. 개인용 키(sk-ant-...)로는 연동되지 않습니다.

Q: 한 탭이 회색으로 비어 있고 “연동이 필요합니다”라고 떠요

해당 탭에 맞는 키가 아직 등록되지 않은 경우입니다. API Platform 탭은 Admin Key(sk-ant-admin-...), Claude.ai Analytics 탭은 Analytics Key(sk-ant-api01-...)가 각각 필요합니다. 연동 설정으로 이동 버튼으로 나머지 키를 추가하세요.

Q: Claude.ai Analytics 탭에 오늘 데이터가 없어요

정상입니다. Anthropic Analytics API는 3일 지연이 있어 가장 최근 데이터가 3일 전 기준입니다. 탭 상단의 안내 배너에도 같은 내용이 표시됩니다.

Q: 새로고침 버튼이 비활성화되어 있고 시간이 표시돼요

수동 새로고침은 한 번 누르면 5분 동안 다시 누를 수 없습니다. 메뉴 항목의 새로고침 (M:SS) 카운트다운이 끝나면 다시 활성화됩니다. 새로고침은 보고 있는 탭만 동기화한다는 점도 참고하세요.

Q: 대시보드에 비용이 0으로 표시돼요

원인:

첫 자동 동기화(다음 날 새벽 4시 30분)가 아직 돌지 않았을 수 있습니다.
해당 기간에 실제 사용이 없었을 수 있습니다.

해결 방법:

API Platform 탭에서 데이터 다운로드 드롭다운의 **새로고침**으로 수동 동기화를 실행해 보세요.
Anthropic Console에서 실제 사용량이 있는지 직접 확인하세요.

Q: 일부 데이터 수집에 실패했다는 배너가 떴어요

원인: Anthropic API 일시 장애 또는 Key 권한 부족.

해결 방법:

다음 자동 동기화에서 자동 재시도되므로 잠시 기다리거나, 해당 탭에서 **새로고침**으로 재시도합니다.
계속 실패하면 Anthropic Console에서 Key 권한을 확인합니다.
해결되지 않으면 채널톡으로 알려주세요.

Q: Priority Tier 비용은 왜 제외되나요

Anthropic Cost API가 Priority Tier 요금을 포함하지 않기 때문입니다. 정확한 총액은 Anthropic Console에서 직접 확인하세요.

Q: 이 외의 문제

채널톡으로 문의해 주세요.