---
title: API de Analytics do Claude Code
url: https://platform.claude.com/docs/pt-BR/manage-claude/claude-code-analytics-api
description: Acesse programaticamente as análises de uso e as métricas de produtividade do Claude Code da sua organização com a Admin API de Analytics do Claude Code.
---
**A Admin API não está disponível para contas individuais.** Para colaborar com colegas de equipe e adicionar membros, configure sua organização na página [Organization](https://platform.claude.com/settings/organization) (`platform.claude.com/settings/organization`) no Claude Console.
A Admin API de Analytics do Claude Code oferece acesso programático a métricas de uso agregadas diariamente para usuários do Claude Code. Com ela, as organizações podem analisar a produtividade dos desenvolvedores e criar dashboards personalizados. Esta API fornece mais detalhes do que o [dashboard de Analytics](https://platform.claude.com/claude-code) básico, sem a complexidade da integração com OpenTelemetry.
Esta API permite que você monitore, analise e otimize melhor a adoção do Claude Code:
* **Análise de produtividade dos desenvolvedores:** Acompanhe sessões, linhas de código adicionadas/removidas, commits e pull requests criados usando o Claude Code
* **Métricas de uso de ferramentas:** Monitore as taxas de aceitação e rejeição das diferentes ferramentas do Claude Code (Edit, MultiEdit, Write, NotebookEdit)
* **Análise de custos:** Visualize custos estimados e uso de tokens detalhados por modelo Claude
* **Relatórios personalizados:** Exporte dados para criar dashboards executivos e relatórios para equipes de gestão
* **Justificativa de uso:** Forneça métricas para justificar e expandir a adoção do Claude Code internamente
**Credenciais da Admin API necessárias.** Estes endpoints fazem parte da Admin API. Você pode acessá-los usando uma [chave de API Admin](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api-keys), um token OAuth com o escopo `org:admin`, ou uma chave pessoal ou de conta de serviço que não esteja restrita a um workspace; chaves de API de workspace não funcionam. Consulte [Autenticação](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api#authentication) para mais detalhes.
**Claude Platform on AWS:** A API de Analytics do Claude Code não está disponível no momento. Em vez disso, visualize o uso do Claude Code na página **Usage** do Claude Console.
**Organizações Claude Enterprise:** A atividade do Claude Code de usuários do claude.ai é reportada pela API de Analytics do Claude Enterprise, que usa uma chave de API de Analytics em vez de uma chave de API de Admin. Consulte [APIs de Analytics](https://platform.claude.com/docs/pt-BR/manage-claude/analytics-api) para descobrir qual API e qual tipo de chave sua organização precisa.
## Início rápido
Obtenha as análises do Claude Code da sua organização para um dia específico:
```bash cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
**Defina um cabeçalho User-Agent para integrações**
Se você estiver criando uma integração, defina seu cabeçalho User-Agent para ajudar a Anthropic a entender os padrões de uso:
```text wrap
User-Agent: YourApp/1.0.0 (https://yourapp.com)
```
## API de Analytics do Claude Code
Acompanhe o uso do Claude Code, as métricas de produtividade e a atividade dos desenvolvedores em toda a sua organização com o endpoint `/v1/organizations/usage_report/claude_code`.
### Conceitos principais
* **Agregação diária:** Retorna métricas para um único dia especificado pelo parâmetro `starting_at`
* **Dados por usuário:** Cada registro representa a atividade de um usuário no dia especificado
* **Métricas de produtividade:** Acompanhe sessões, linhas de código, commits, pull requests e uso de ferramentas
* **Dados de tokens e custos:** Monitore o uso e os custos estimados detalhados por modelo Claude
* **"Cursor-based pagination" (paginação baseada em cursor):** Lide com grandes conjuntos de dados com paginação estável usando cursores opacos
* **Atualização dos dados:** As métricas ficam disponíveis com atraso de até 1 hora para garantir consistência
Para detalhes completos dos parâmetros e esquemas de resposta, consulte a [referência da API de Analytics do Claude Code](https://platform.claude.com/docs/pt-BR/api/beta/organization/usage_report/retrieve_claude_code).
### Exemplos básicos
#### Obter análises para um dia específico
```bash cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
#### Obter análises com paginação
```bash cURL
# Primeira requisição
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
# Requisição seguinte usando o cursor da resposta
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
page=page_MjAyNS0wNS0xNFQwMDowMDowMFo=" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
### Parâmetros da requisição
| Parâmetro | Tipo | Obrigatório | Descrição |
| ------------- | ------- | ----------- | --------------------------------------------------------------------------- |
| `starting_at` | string | Sim | Data UTC no formato YYYY-MM-DD; retorna métricas apenas para este único dia |
| `limit` | integer | Não | Número de registros por página (padrão: 20, máximo: 1000) |
| `page` | string | Não | Token de cursor opaco do campo `next_page` da resposta anterior |
### Métricas disponíveis
Cada registro da resposta contém as seguintes métricas para um único usuário em um único dia:
#### Dimensões
* **date:** Data no formato RFC 3339 (timestamp UTC)
* **actor:** O usuário ou a chave de API que executou as ações do Claude Code (`user_actor` com `email_address` ou `api_actor` com `api_key_name`)
* **organization\_id:** UUID da organização
* **customer\_type:** Tipo de conta do cliente (`api` para clientes da API, `subscription` para clientes Pro/Team)
* **terminal\_type:** Tipo de terminal ou ambiente em que o Claude Code foi usado (por exemplo, `vscode`, `iTerm.app`, `tmux`)
#### Métricas principais
* **num\_sessions:** Número de sessões distintas do Claude Code iniciadas por este ator
* **lines\_of\_code.added:** Número total de linhas de código adicionadas em todos os arquivos pelo Claude Code
* **lines\_of\_code.removed:** Número total de linhas de código removidas em todos os arquivos pelo Claude Code
* **commits\_by\_claude\_code:** Número de commits git criados por meio da funcionalidade de commit do Claude Code
* **pull\_requests\_by\_claude\_code:** Número de pull requests criados por meio da funcionalidade de PR do Claude Code
#### Métricas de ações de ferramentas
Detalhamento das taxas de aceitação e rejeição de ações de ferramentas por tipo de ferramenta:
* **edit\_tool.accepted/rejected:** Número de propostas da ferramenta Edit que o usuário aceitou/rejeitou
* **multi\_edit\_tool.accepted/rejected:** Número de propostas da ferramenta MultiEdit que o usuário aceitou/rejeitou
* **write\_tool.accepted/rejected:** Número de propostas da ferramenta Write que o usuário aceitou/rejeitou
* **notebook\_edit\_tool.accepted/rejected:** Número de propostas da ferramenta NotebookEdit que o usuário aceitou/rejeitou
#### Detalhamento por modelo
Para cada modelo Claude usado:
* **model:** Identificador do modelo Claude (por exemplo, `claude-opus-5`)
* **tokens.input/output:** Contagens de tokens de entrada e saída para este modelo
* **tokens.cache\_read/cache\_creation:** Uso de tokens relacionado a cache para este modelo
* **estimated\_cost.amount:** Custo estimado em centavos de USD para este modelo
* **estimated\_cost.currency:** Código da moeda do valor do custo (atualmente sempre `USD`)
### Estrutura da resposta
A API retorna dados no seguinte formato:
```json
{
"data": [
{
"date": "2025-09-08T00:00:00Z",
"actor": {
"type": "user_actor",
"email_address": "developer@company.com"
},
"organization_id": "dc9f6c26-b22c-4831-8d01-0446bada88f1",
"customer_type": "api",
"terminal_type": "vscode",
"core_metrics": {
"num_sessions": 5,
"lines_of_code": {
"added": 1543,
"removed": 892
},
"commits_by_claude_code": 12,
"pull_requests_by_claude_code": 2
},
"tool_actions": {
"edit_tool": {
"accepted": 45,
"rejected": 5
},
"multi_edit_tool": {
"accepted": 12,
"rejected": 2
},
"write_tool": {
"accepted": 8,
"rejected": 1
},
"notebook_edit_tool": {
"accepted": 3,
"rejected": 0
}
},
"model_breakdown": [
{
"model": "claude-opus-5-5",
"tokens": {
"input": 100000,
"output": 35000,
"cache_read": 10000,
"cache_creation": 5000
},
"estimated_cost": {
"currency": "USD",
"amount": 113
}
}
]
}
],
"has_more": false,
"next_page": null
}
```
## Paginação
A API oferece suporte a paginação baseada em cursor para organizações com grande número de usuários:
1. Faça sua requisição inicial com o parâmetro opcional `limit`.
2. Se `has_more` for `true` na resposta, use o valor de `next_page` na sua próxima requisição.
3. Continue até que `has_more` seja `false`.
O cursor codifica a posição do último registro e garante uma paginação estável mesmo quando novos dados chegam. Cada sessão de paginação mantém um limite de dados consistente para garantir que você não perca nem duplique registros.
## Casos de uso comuns
* **Dashboards executivos:** Crie relatórios de alto nível mostrando o impacto do Claude Code na velocidade de desenvolvimento
* **Comparação de ferramentas de IA:** Exporte métricas para comparar o Claude Code com outras ferramentas de programação com IA, como Copilot e Cursor
* **Análise de produtividade dos desenvolvedores:** Acompanhe métricas de produtividade individuais e de equipe ao longo do tempo
* **Acompanhamento e alocação de custos:** Monitore padrões de gastos e aloque custos por equipe ou projeto
* **Monitoramento de adoção:** Identifique quais equipes e usuários estão obtendo mais valor do Claude Code
* **Justificativa de ROI:** Forneça métricas concretas para justificar e expandir a adoção do Claude Code internamente
## Perguntas frequentes
### Quão atualizados são os dados de análise?
Os dados de análise do Claude Code normalmente aparecem em até 1 hora após a conclusão da atividade do usuário. Para garantir resultados de paginação consistentes, apenas dados com mais de 1 hora são incluídos nas respostas.
### Posso obter métricas em tempo real?
Não, esta API fornece apenas métricas agregadas diariamente. Para monitoramento em tempo real, considere usar a [integração com OpenTelemetry](https://code.claude.com/docs/en/monitoring-usage).
### Como os usuários são identificados nos dados?
Os usuários são identificados por meio do campo `actor` de duas formas:
* **`user_actor`:** Contém `email_address` para usuários que se autenticam via OAuth (mais comum)
* **`api_actor`:** Contém `api_key_name` para usuários que se autenticam com uma chave de API
O campo `customer_type` indica se o uso vem de clientes `api` (API pré-paga por uso) ou de clientes `subscription` (planos Pro/Team).
### Qual é o período de retenção dos dados?
Os dados históricos de análise do Claude Code são retidos e ficam acessíveis por meio da API. Não há um período de exclusão especificado para esses dados.
### Quais implantações do Claude Code são suportadas?
Esta API acompanha apenas o uso do Claude Code na Claude API. O uso por meio do [Claude no Amazon Bedrock](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-amazon-bedrock), do [Claude no Microsoft Foundry](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-microsoft-foundry), do [Claude no Google Cloud](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-on-vertex-ai) ou da [Claude Platform on AWS](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-platform-on-aws) não está incluído.
### Quanto custa usar esta API?
A API de Analytics do Claude Code é gratuita para todas as organizações com acesso à Admin API.
### Como calculo as taxas de aceitação de ferramentas?
Taxa de aceitação da ferramenta = `accepted / (accepted + rejected)` para cada tipo de ferramenta. Por exemplo, se a ferramenta de edição mostrar 45 aceitas e 5 rejeitadas, a taxa de aceitação é de 90%.
### Qual fuso horário é usado para o parâmetro de data?
Todas as datas estão em UTC. O parâmetro `starting_at` deve estar no formato YYYY-MM-DD e representa a meia-noite UTC daquele dia.
## Veja também
A API de Analytics do Claude Code ajuda você a entender e otimizar o fluxo de trabalho de desenvolvimento da sua equipe. Saiba mais sobre recursos relacionados:
* [Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api)
* [Referência da Admin API](https://platform.claude.com/docs/pt-BR/api/beta/organization)
* [Dashboard de Analytics do Claude Code](https://platform.claude.com/claude-code)
* [API de Uso e Custos](https://platform.claude.com/docs/pt-BR/manage-claude/usage-cost-api) - Acompanhe o uso da API em todos os serviços da Anthropic
* [API de Compliance](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api) - Recupere dados de auditoria e atividade
* [Gerenciamento de identidade e acesso](https://code.claude.com/docs/en/iam)
* [Monitoramento de uso com OpenTelemetry](https://code.claude.com/docs/en/monitoring-usage) para métricas e alertas personalizados