# Anthropic 연동 및 대시보드

## Anthropic 연동 및 대시보드

조직의 Anthropic Claude 사용 현황을 한 화면에서 분석합니다. **API Platform (Admin)** 과 **Claude.ai Enterprise (Analytics)** 두 영역의 키를 각각 등록하여 비용·토큰·Claude Code 생산성·Claude.ai 활동까지 함께 볼 수 있습니다. 매일 새벽 자동 동기화되고, 필요 시 수동 새로고침도 가능합니다.

***

### 1. 연동하기

{% hint style="info" %}
**필요한 준비물**

* **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 워크스페이스 활동을 교차로 분석할 수 있습니다.
{% endhint %}

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

1. 사이드바에서 **설정** > **연동 관리**로 이동합니다.
2. **AI 도구** 섹션의 **Anthropic Claude** 카드를 클릭합니다.

**단계 2: Admin API Key 입력 (API Platform)**

1. 상단 **API Platform (Admin)** 섹션을 엽니다.
2. 안내: *"Anthropic Console → Settings → Admin Keys에서 발급받은 Admin API Key를 입력해주세요."*
3. `Admin API Key` 입력 (placeholder: `sk-ant-admin-...`).
4. **`연동하기`** 버튼을 클릭합니다. (`sk-ant-admin`으로 시작하지 않으면 버튼이 비활성화됩니다)

이 키로 동기화되는 데이터: **조직, 멤버, 비용, 토큰 사용량, Claude Code**

{% hint style="warning" %}
**Admin Key 형식 확인** `sk-ant-admin`으로 시작하지 않으면 *"Admin API Key는 sk-ant-admin으로 시작해야 합니다."* 힌트가 표시됩니다. 개인용 API Key(`sk-ant-api...`)나 Analytics Key(`sk-ant-api01-...`) 로는 Admin 섹션에 연동되지 않습니다.
{% endhint %}

**단계 3: Analytics API Key 입력 (Claude.ai Enterprise, 선택)**

1. 하단 **Claude.ai Enterprise (Analytics)** 섹션을 엽니다.
2. 안내: *"Claude.ai → Analytics → API Keys에서 발급받은 Analytics API Key를 입력해주세요."*
3. `Analytics API Key` 입력 (placeholder: `sk-ant-api01-...`).
4. **`연동하기`** 버튼을 클릭합니다. (`sk-ant-api01`으로 시작하지 않으면 버튼이 비활성화됩니다)

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

{% hint style="info" %}
**Analytics API 가능 여부** Claude.ai Enterprise 플랜에서만 제공됩니다. Pro·Team 플랜은 API Platform (Admin) 연동만 가능합니다.
{% endhint %}

***

### 2. 대시보드 접근

1. 사이드바의 **`AI`** > **`Anthropic`** 메뉴를 클릭합니다.
2. 또는 **AI 메인 페이지**(`/ai`)에서 Anthropic Claude 카드의 **`열기`** 버튼을 누릅니다.
3. 헤더에 *"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일**로 고정되어 있습니다(별도 날짜 필터는 없습니다).

{% hint style="info" %}
한 쪽만 연동된 경우, 미연동 탭은 비활성화되며 *"Admin API 연동이 필요합니다"* 또는 *"Analytics API 연동이 필요합니다"* 안내가 표시됩니다.
{% endhint %}

**API Platform sub-tab:**

| 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. 아직 연동되지 않았을 때

```
[Anthropic 로고]
Anthropic이 아직 연결되지 않았습니다.
연동 관리에서 Anthropic을 연결하면 비용, 사용량, 생산성 데이터를 대시보드에서 확인할 수 있습니다.
[연동 관리로 이동하기]
```

**`연동 관리로 이동하기`** 버튼으로 설정 > 연동 관리 페이지로 바로 이동해 연동을 시작할 수 있습니다.

***

### 11. 권한 안내

{% hint style="info" %}
**Basic 플랜은 AI 메뉴 자체가 숨겨집니다** Basic 플랜(권한 0개)에서는 사이드바에 AI 메뉴가 표시되지 않습니다.
{% endhint %}

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

***

### 12. 문제 해결

#### Q: 연동하기 버튼이 비활성화되어 있어요

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

**해결 방법**: Anthropic Console → **Settings → Admin Keys**에서 발급받은 키를 붙여 넣으세요. 개인용 `sk-ant-api...` 키로는 연동되지 않습니다.

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

**원인**:

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

**해결 방법**:

1. 헤더의 **`새로고침`** 버튼으로 수동 동기화를 실행해 보세요.
2. Anthropic Console에서 실제 사용량이 있는지 직접 확인하세요.

#### Q: 일부 데이터 동기화에 실패했다는 배너가 떴어요

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

**해결 방법**:

1. 잠시 후 **`새로고침`** 버튼으로 재시도합니다.
2. 계속 실패하면 Anthropic Console에서 Admin Key 권한을 확인합니다.
3. 해결되지 않으면 채널톡으로 배너의 원문 메시지를 함께 알려주세요.

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

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

#### Q: 이 외의 문제

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.smply.one/ai/anthropic-dashboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.