API de Analytics do Claude Code

A API Admin de Analytics do Claude Code fornece acesso programático a métricas de uso agregadas diariamente para usuários do Claude Code, permitindo que as organizações analisem a produtividade dos desenvolvedores e criem dashboards personalizados. Esta API fornece mais detalhes do que o dashboard de Analytics 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 de 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

API de Analytics do Claude Code

Acompanhe o uso do Claude Code, métricas de produtividade e 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 em nível de 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
• Paginação baseada em cursor: Lide com grandes conjuntos de dados com paginação estável usando cursores opacos
• Atualidade dos dados: As métricas ficam disponíveis com até 1 hora de atraso 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.

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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_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=" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_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 (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 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 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 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": "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",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 141
          }
        }
      ]
    }
  ],
  "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 com a chegada de novos dados. 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 codificaçã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 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 por meio do campo actor de duas maneiras:

• 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 é de clientes api (API com pagamento conforme o uso) ou 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 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, Claude no Microsoft Foundry, Claude no Google Cloud ou 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 à API Admin.

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 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:

• API Admin
• Referência da API Admin
• Dashboard de Analytics do Claude Code
• API de Uso e Custos - Acompanhe o uso da API em todos os serviços da Anthropic
• API de Conformidade - Recupere dados de auditoria e atividade
• Gerenciamento de identidade e acesso
• Monitoramento de uso com OpenTelemetry para métricas personalizadas e alertas