Anthropic API

Anthropic API Platform 비용·사용량 + Claude.ai Enterprise 활동을 통합 관리하기 위한 연동 가이드입니다.

Anthropic Console Admin API와 Claude.ai Enterprise Analytics API를 심플리에 연동하여 조직의 API 비용·토큰 사용량은 물론, Claude Code 생산성과 Claude.ai 워크스페이스 활동까지 한 곳에서 관리할 수 있습니다.

연동 설정 화면과 사이드바 카드에는 Anthropic API로 표시됩니다. 이 연동은 API 플랫폼(Console) 관리 기능이며, 개인용 Claude.ai 구독과는 별개입니다.

주요 기능

기능	설명
조직 관리	멤버, 워크스페이스, 초대 현황 조회
비용 추적	모델별, 워크스페이스별 API 사용 비용 분석 (USD)
토큰 사용량	입력/출력/캐시 토큰 및 웹 검색 요청 현황
Claude Code 생산성	세션 수, 코드 라인 추가/삭제, 커밋, PR 통계
Claude.ai 활동	DAU/WAU/MAU, 사용자 활동, 프로젝트·스킬·커넥터 사용 현황

사전 요구사항

연동을 시작하기 전에 다음 조건을 확인하세요.

요구사항	설명
Anthropic 조직 계정	Anthropic Console에 조직이 등록되어 있어야 합니다
Admin 또는 Owner 권한	조직의 Admin 또는 Owner 권한이 필요합니다
Claude.ai Enterprise	Analytics API 연동은 Claude.ai Enterprise 플랜에서만 가능합니다 (선택)
SMPLY 관리자	SMPLY에서 연동 설정 권한이 필요합니다

연동 범위

Anthropic 연동 시 다음 정보가 동기화됩니다.

키 종류	동기화 항목
Admin API Key	조직 정보, 멤버, 워크스페이스, 비용(USD), 토큰 사용량, Claude Code 생산성
Analytics API Key	DAU/WAU/MAU, 사용자 활동, 프로젝트, 스킬, 커넥터

연동 방법

심플리의 Anthropic API 연동 설정은 하나의 API Key 입력란을 사용합니다. 여기에 Admin API Key(sk-ant-admin-...) 또는 Analytics API Key(sk-ant-api01-...) 중 어느 쪽이든 입력할 수 있으며, 입력한 키 종류에 따라 동기화되는 데이터가 결정됩니다. 두 영역을 모두 보려면 키를 하나씩 차례로 연동하면 됩니다.

먼저 필요한 키를 Anthropic에서 발급받은 뒤, 심플리 연동 설정 화면에서 입력합니다.

1. Admin API Key 발급 (API Platform)

Anthropic Console에서 키 발급
1. Anthropic Console에 로그인합니다.
2. 좌측 메뉴에서 Settings → Admin Keys로 이동합니다.
3. Create Admin Key 버튼을 클릭하여 새 키를 생성합니다.
4. 생성된 키(sk-ant-admin-...)를 안전한 곳에 복사해 둡니다.

이 키로 동기화되는 데이터: 조직 정보, 멤버, 비용(USD), 토큰 사용량, Claude Code 생산성

2. Analytics API Key 발급 (Claude.ai Enterprise)

Claude.ai에서 키 발급
1. Claude.ai에 Primary Owner 계정으로 로그인합니다.
2. Analytics → API keys로 이동합니다.
3. Analytics API 아래의 Access 토글을 켭니다. (이 토글을 켜야 키를 발급할 수 있습니다)
4. + Create key 버튼을 클릭하여 새 키를 생성합니다.
5. 생성된 키(sk-ant-api01-...)를 안전한 곳에 복사해 둡니다.

이 키로 동기화되는 데이터: DAU/WAU/MAU, 사용자 활동, 프로젝트, 스킬, 커넥터

3. 심플리에서 연동하기

연동 설정 화면 열기
1. 심플리에 로그인한 후, 설정 → 연동 관리 페이지로 이동합니다.
2. AI 섹션에서 Anthropic API 카드를 클릭합니다.
API Key 입력
1. API Key 입력란에 발급받은 키를 붙여 넣습니다. (Admin Key sk-ant-admin-... 또는 Analytics Key sk-ant-api01-... 중 하나)
2. 연동하기 버튼을 클릭합니다.
3. 연동이 완료되면 AI → Anthropic 메뉴에서 대시보드를 확인할 수 있습니다.
4. 다른 종류의 키도 함께 보려면, 같은 방식으로 나머지 키를 다시 한번 연동합니다.

문제 해결

연동이 실패합니다

원인 1: 잘못된 키 형식

Admin API Key는 sk-ant-admin-으로 시작해야 합니다. 일반 API Key(sk-ant-api03-...)나 Analytics Key(sk-ant-api01-...)를 Admin 섹션에 입력하지 않았는지 확인하세요.
Analytics API Key는 sk-ant-api01-으로 시작해야 하며, Claude.ai Enterprise 워크스페이스에서 발급한 키여야 합니다.

원인 2: 권한 부족

Anthropic Console에서 본인 계정의 역할이 Admin 또는 Owner인지 확인하세요.
Claude.ai Enterprise에서는 Primary Owner 권한이 필요하며, Analytics → API keys 화면에서 Analytics API > Access 토글을 먼저 켜야 키를 발급할 수 있습니다.

원인 3: 자격증명 만료

Anthropic 측에서 키를 회수하거나 만료시킨 경우 연동 상태가 자격증명 오류로 표시됩니다. 새 키를 발급받아 다시 연동하세요.

비용/사용량 데이터가 보이지 않습니다

원인: 동기화 지연

연동 직후 조직 정보(멤버, 워크스페이스)는 바로 동기화됩니다.
비용 및 사용량 데이터는 Anthropic API 제공 주기에 따라 최대 24시간이 소요될 수 있습니다. 자동 동기화는 매일 오전 5시(KST) 배치로 실행됩니다.
Claude.ai Analytics 데이터는 Anthropic Analytics API 정책상 약 3일의 지연이 있어, 가장 최근 데이터는 3일 전 기준으로 표시됩니다.

자주 묻는 질문

Q: Admin API Key와 Analytics API Key를 모두 등록해야 하나요?

아니요. 필요한 영역만 등록할 수 있습니다. API 비용·Claude Code 생산성만 보고 싶다면 Admin Key만, Claude.ai 워크스페이스 활동만 보고 싶다면 Analytics Key만 등록해도 됩니다. 두 키를 모두 등록하면 API 비용과 Claude.ai 활동을 교차 분석할 수 있습니다.

Q: 일반 API Key (sk-ant-api03-...)로 연동할 수 있나요?

아니요. 심플리 연동에는 조직 관리용 Admin API Key (sk-ant-admin-...) 또는 Analytics API Key (sk-ant-api01-...)가 필요합니다. 일반 API Key는 모델 호출 권한만 있고 조직·비용·활동 정보 조회 권한이 없습니다.

Q: 연동 후 데이터가 바로 보이나요?

연동 직후 조직 정보(멤버, 워크스페이스)는 바로 동기화됩니다. 비용 및 사용량 데이터는 Anthropic API 제공 주기에 따라 최대 24시간이 소요될 수 있으며, 자동 동기화는 **매일 오전 5시(KST)**에 실행됩니다. 더 빨리 확인하려면 대시보드 헤더의 새로고침 버튼으로 수동 동기화를 실행하세요.

Q: API Key를 교체하고 싶어요.

연동 관리 페이지의 Anthropic API 카드에서 연동 해제 후 새 키로 다시 연동하세요.

Q: 연동을 해제하면 데이터가 삭제되나요?

연동을 해제해도 이미 수집된 데이터는 유지됩니다. 단, 더 이상 Anthropic과 동기화되지 않으며, 심플리에 저장된 API Key는 삭제됩니다.

Q: 여러 Anthropic 조직을 연동할 수 있나요?

하나의 SMPLY 워크스페이스에는 하나의 Anthropic 조직만 연동할 수 있습니다.

Q: Claude.ai Pro·Team 플랜도 Analytics 연동이 되나요?

아니요. Analytics API는 Claude.ai Enterprise 플랜에서만 제공됩니다. Pro·Team 플랜은 API Platform (Admin) 연동만 가능합니다.