# Anthropic Claude

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

## 주요 기능

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

{% hint style="info" %}
Anthropic 연동은 **두 종류의 API Key**를 사용합니다.\
**Admin API Key** (`sk-ant-admin-...`) — Console Admin API의 비용·사용량·Claude Code 데이터용\
**Analytics API Key** (`sk-ant-api01-...`) — Claude.ai Enterprise의 활동·프로젝트·스킬·커넥터 데이터용\
필요한 영역만 부분 연동하거나, 두 가지를 모두 연동할 수 있습니다.
{% endhint %}

***

#### 사전 요구사항

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

| 요구사항                     | 설명                                                      |
| ------------------------ | ------------------------------------------------------- |
| **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 Platform (Admin)** 과 **Claude.ai Enterprise (Analytics)** 두 섹션이 분리되어 있습니다. 필요한 섹션만 따로 연동할 수 있으며, 두 섹션을 모두 연동하면 API 비용과 Claude.ai 활동을 교차 분석할 수 있습니다.

### 1. API Platform (Admin) 연동

{% stepper %}
{% step %}

#### Admin API Key 발급

1. [Anthropic Console](https://console.anthropic.com)에 로그인합니다.
2. 좌측 메뉴에서 **Settings → Admin Keys**로 이동합니다.
3. **Create Admin Key** 버튼을 클릭하여 새 키를 생성합니다.
4. 생성된 키(`sk-ant-admin-...`)를 안전한 곳에 복사해 둡니다.
   {% endstep %}

{% step %}

#### 심플리에서 연동하기

1. 심플리에 로그인한 후, **설정 → 연동 관리** 페이지로 이동합니다.
2. **AI 도구** 섹션에서 Anthropic Claude 카드를 클릭합니다.
3. **API Platform (Admin)** 섹션에 복사해 둔 Admin API Key를 입력하고 **연동하기** 버튼을 클릭합니다.
4. 연동이 완료되면 **AI → Anthropic** 메뉴에서 대시보드를 확인할 수 있습니다.
   {% endstep %}
   {% endstepper %}

{% hint style="warning" %}
Admin API Key는 생성 직후에만 전체 값을 확인할 수 있습니다. 키를 분실한 경우 새로 발급받아야 합니다.
{% endhint %}

### 2. Claude.ai Enterprise (Analytics) 연동

{% hint style="info" %}
**Analytics API**는 Claude.ai Enterprise 플랜에서만 제공됩니다. Pro·Team 플랜에서는 사용할 수 없습니다.
{% endhint %}

{% stepper %}
{% step %}

#### Analytics API Key 발급

1. [Claude.ai](https://claude.ai)에 Enterprise 워크스페이스 관리자 계정으로 로그인합니다.
2. **Analytics → API Keys**로 이동합니다.
3. **Create API Key** 버튼을 클릭하여 새 키를 생성합니다.
4. 생성된 키(`sk-ant-api01-...`)를 안전한 곳에 복사해 둡니다.
   {% endstep %}

{% step %}

#### 심플리에서 연동하기

1. 심플리 **설정 → 연동 관리 → Anthropic Claude** 페이지의 **Claude.ai Enterprise (Analytics)** 섹션을 엽니다.
2. 복사해 둔 Analytics API Key를 입력합니다.
3. **연동하기** 버튼을 클릭하면 DAU/WAU/MAU, 사용자 활동, 프로젝트·스킬·커넥터 데이터가 동기화됩니다.
   {% endstep %}
   {% endstepper %}

***

#### 문제 해결

**연동이 실패합니다**

**원인 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에서는 워크스페이스 **Owner** 또는 **Admin** 권한이 필요합니다.

**원인 3: 자격증명 만료**

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

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

**원인: 동기화 지연**

* 연동 직후 조직 정보(멤버, 워크스페이스)는 바로 동기화됩니다.
* 비용 및 사용량 데이터는 Anthropic API 제공 주기에 따라 최대 24시간이 소요될 수 있습니다.
* Claude.ai Analytics 데이터도 별도 배치로 동기화되므로 첫 적재까지 다소 시간이 걸릴 수 있습니다.

***

#### 자주 묻는 질문

**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시간이 소요될 수 있습니다.

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

연동 관리 페이지에서 해당 섹션의 **연동 해제** 후 새 키로 다시 연동하세요. Admin과 Analytics는 각각 독립적으로 해제·재연동할 수 있습니다.

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

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

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

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

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

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


---

# 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/saas-integration/guide-main/anthropic-claude.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.