API de Analytics do Claude Code

A Admin API de Analytics do Claude Code fornece acesso programático a métricas de uso agregadas diariamente para usuários do Claude Code, permitindo que organizações analisem a produtividade dos desenvolvedores e criem dashboards personalizados. Esta API preenche a lacuna entre o dashboard de Analytics básico e a complexa integração com OpenTelemetry.

Esta API permite que você monitore, analise e otimize melhor a adoção do Claude Code:

• Análise de produtividade de 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 taxas de aceitação e rejeição para 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

Início rápido

Obtenha as análises do Claude Code da sua organização para um dia específico:

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

User-Agent: YourApp/1.0.0 (https://yourapp.com)

API de Analytics do Claude Code

Acompanhe o uso do Claude Code, métricas de produtividade e atividade de 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 para o 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 custos estimados detalhados por modelo Claude
• 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 estão disponíveis com atraso de até 1 hora para garantir consistência

Para detalhes completos de parâmetros e esquemas de resposta, consulte a referência da API de Analytics do Claude Code.

Exemplos básicos

Obter análises para um dia específico

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Obter análises com paginação

# Primeira requisição
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

# Requisição subsequente usando o cursor da resposta
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
page=page_MjAyNS0wNS0xNFQwMDowMDowMFo=" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Parâmetros da requisição

Métricas disponíveis

Cada registro de 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 chave de API que executou as ações do Claude Code (seja 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 de API, subscription para clientes Pro/Team)
• terminal_type: Tipo de terminal ou ambiente onde 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 através da funcionalidade de commit do Claude Code
• pull_requests_by_claude_code: Número de pull requests criados através 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-4-8)
• tokens.input/output: Contagens de tokens de entrada e saída para este modelo
• tokens.cache_read/cache_creation: Uso de tokens relacionados a cache para este modelo
• estimated_cost.amount: Custo estimado em centavos de USD para este modelo
• estimated_cost.currency: Código da moeda para o valor do custo (atualmente sempre USD)

Estrutura da resposta

A API retorna dados no seguinte formato:

{
  "data": [
    {
      "date": "2025-09-08T00:00:00Z",
      "actor": {
        "type": "user_actor",
        "email_address": "[email protected]"
      },
      "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-4-8",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 1025
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

Paginação

A API suporta 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 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 ou 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 codificação com IA, como Copilot e Cursor
• Análise de produtividade de desenvolvedores: Acompanhe métricas de produtividade individuais e de equipe ao longo do tempo
• Rastreamento 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 dentro de 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.

Como os usuários são identificados nos dados?

Os usuários são identificados através do campo actor de duas maneiras:

• user_actor: Contém email_address para usuários que se autenticam através de 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 é de clientes api (API pay-as-you-go) ou clientes subscription (planos Pro/Team).

Qual é o período de retenção de dados?

Os dados históricos de análise do Claude Code são retidos e acessíveis através da API. Não há período de exclusão especificado para esses dados.

Quais implantações do Claude Code são suportadas?

Esta API rastreia apenas o uso do Claude Code na API do Claude. O uso através do Claude Platform na AWS, Claude no Microsoft Foundry, Claude no Amazon Bedrock ou Claude no Vertex AI 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 de ferramenta = accepted / (accepted + rejected) para cada tipo de ferramenta. Por exemplo, se a ferramenta edit mostra 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
• Referência da Admin API
• Dashboard de Analytics do Claude Code
• API de Uso e Custo - Acompanhe o uso da API em todos os serviços da Anthropic
• API de Compliance - Recupere dados de auditoria e atividade
• Gerenciamento de identidade e acesso
• Monitoramento de uso com OpenTelemetry para métricas personalizadas e alertas