> For the complete documentation index, see [llms.txt](https://docs.smply.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smply.one/ai/anthropic-dashboard.md).

# Anthropic 연동 및 대시보드

## Anthropic 연동 및 대시보드

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

***

### 1. 연동하기

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

Anthropic은 한 화면에서 두 종류의 키를 받습니다. 둘 다 등록하면 API 비용과 Claude.ai 활동을 함께 볼 수 있고, 하나만 등록하면 해당 탭만 채워집니다.

* **Console Admin Key** — `sk-ant-admin-`으로 시작. Anthropic Console에서 발급합니다. `API Platform` 탭(조직·멤버·모델별 비용·토큰·Claude Code 활동)을 채웁니다.
* **Analytics API Key** — `sk-ant-api01-`으로 시작. Claude.ai Enterprise에서 발급합니다. `Claude.ai Analytics` 탭(DAU/WAU/MAU·사용자 활동·프로젝트·스킬·커넥터)을 채웁니다.

이 연동은 **API 플랫폼(Console) 관리 기능**으로, Claude.ai 개인 구독과는 별개입니다.
{% endhint %}

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

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

**단계 2: API Key 등록**

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

{% hint style="warning" %}
**API Key 형식 확인** 키는 `sk-ant-admin` 또는 `sk-ant-api01`으로 시작해야 합니다. 형식이 맞지 않으면 *"API Key는 sk-ant-admin 또는 sk-ant-api01로 시작해야 합니다."* 안내가 표시됩니다. 개인용 키(`sk-ant-...`)로는 연동되지 않습니다.
{% endhint %}

**연동 후 관리**

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

***

### 2. 대시보드 접근

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

**헤더 — `연동 설정` 버튼**

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

{% hint style="info" %}
**아직 연동되지 않았을 때** 키가 하나도 등록되지 않은 경우 빈 화면과 함께 *"Anthropic API가 연결되지 않았습니다. 연동 설정에서 API Key를 등록해주세요."* 안내가 표시됩니다. **`연동 관리로 이동하기`** 버튼으로 바로 연동을 시작할 수 있습니다.
{% endhint %}

***

### 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개 시트로 구성됩니다.
* 버튼의 드롭다운(▾) 안에는 \*\*`새로고침`\*\*이 있어 현재 탭의 데이터를 즉시 다시 동기화합니다.

{% hint style="warning" %}
**새로고침은 탭별로, 5분에 한 번** 새로고침은 보고 있는 탭(`API Platform` 또는 `Claude.ai Analytics`)만 동기화하며, 한 번 누르면 5분 동안 다시 누를 수 없습니다. 쿨다운 중에는 메뉴 항목에 **`새로고침 (M:SS)`** 형태로 남은 시간이 표시됩니다.
{% endhint %}

***

### 4. API Platform 탭

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

**KPI 카드 (3장)**

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

**모델별 비용**

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

{% hint style="info" %}
**Priority Tier 비용은 제외됩니다** 파란색 안내 배너로 \*"Priority Tier 비용은 Anthropic Cost API에 포함되지 않습니다."\*가 표시됩니다. 정확한 총액은 Anthropic Console에서 직접 확인하세요.
{% endhint %}

**모델별 토큰 사용량**

| 컬럼           | 의미                         |
| ------------ | -------------------------- |
| **모델**       | 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 추이 → 활동/프로젝트/스킬/커넥터 표 → 사용량·초과 비용 추이 → 사용자별 사용량 순으로 이어집니다.

{% hint style="info" %}
**가장 최근 데이터는 3일 전 기준** 탭 최상단에 파란색 안내 배너로 \*"Anthropic Analytics 데이터는 API 정책에 따라 3일 지연이 있어, 가장 최근 데이터는 3일 전 기준입니다."\*가 표시됩니다. 오늘·어제 데이터가 비어 보이는 것은 정상입니다.
{% endhint %}

**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분 쿨다운).

{% hint style="info" %}
**빈 화면의 안내 문구 참고** 비용 데이터가 아직 없을 때 화면에는 \*"API 사용 후 최대 1일 이내에 모델별 비용이 동기화됩니다. 동기화 주기: 매일 오전 5시 (KST)."\*가 표시됩니다. 실제 배치는 **오전 4시 30분**에 돌며, 이 빈 화면 문구의 시각은 안내용 근사치입니다.
{% endhint %}

#### 일부 동기화 실패

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

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

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

***

### 7. 권한 안내

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

| 작업                      | 필요 권한                        |
| ----------------------- | ---------------------------- |
| 대시보드 조회                 | 로그인된 워크스페이스 세션 (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분)가 아직 돌지 않았을 수 있습니다.
* 해당 기간에 실제 사용이 없었을 수 있습니다.

**해결 방법**:

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

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

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

**해결 방법**:

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

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

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

#### Q: 이 외의 문제

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