API de Analytics do Claude Code

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

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, 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.

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

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:

{
  "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.

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, do Claude no Microsoft Foundry, do Claude no Google Cloud ou da 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
• Referência da Admin API
• 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 Compliance - Recupere dados de auditoria e atividade
• Gerenciamento de identidade e acesso
• Monitoramento de uso com OpenTelemetry para métricas e alertas personalizados