API de Análise de Código Claude

The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

A API de Administração de Análise de Código Claude fornece acesso programático a métricas de uso agregadas diariamente para usuários do Claude Code, permitindo que organizações analisem a produtividade do desenvolvedor e construam painéis personalizados. Esta API preenche a lacuna entre nosso painel de Análises básico e a integração complexa do OpenTelemetry. Esta API permite que você monitore, analise e otimize melhor sua adoção do Claude Code:

Análise de Produtividade do Desenvolvedor: Rastreie sessões, linhas de código adicionadas/removidas, commits e pull requests criados usando Claude Code
Métricas de Uso de Ferramentas: Monitore taxas de aceitação e rejeição para diferentes ferramentas do Claude Code (Edit, Write, NotebookEdit)
Análise de Custos: Visualize custos estimados e uso de tokens divididos por modelo Claude
Relatórios Personalizados: Exporte dados para construir painéis 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

Chave de API de administrador necessáriaEsta API faz parte da API de Administração. Estes endpoints requerem uma chave de API de Administrador (começando com sk-ant-admin...) que difere das chaves de API padrão. Apenas membros da organização com função de administrador podem provisionar chaves de API de Administrador através do Console Claude.

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"

Defina um cabeçalho User-Agent para integraçõesSe você está construindo uma integração, defina seu cabeçalho User-Agent para nos ajudar a entender padrões de uso:

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

API de Análise de Código Claude

Rastreie o uso do Claude Code, métricas de produtividade e atividade do desenvolvedor em toda 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 para o dia especificado
Métricas de produtividade: Rastreie sessões, linhas de código, commits, pull requests e uso de ferramentas
Dados de token e custo: Monitore uso e custos estimados divididos por modelo Claude
Paginação baseada em cursor: Manipule grandes conjuntos de dados com paginação estável usando cursores opacos
Atualização de dados: Métricas estão disponíveis com até 1 hora de atraso para consistência

Para detalhes completos de parâmetros e esquemas de resposta, veja a referência da API de Análise de Código Claude.

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 solicitaçã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"

# Solicitação subsequente usando 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 de solicitaçã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áx: 1000)
`page`	string	Não	Token de cursor opaco do campo `next_page` da resposta anterior

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 API, subscription para clientes Pro/Team)
terminal_type: Tipo de terminal ou ambiente onde o Claude Code foi usado (ex: 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ção de ferramenta

Divisão das taxas de aceitação e rejeição de ação de ferramenta por tipo de ferramenta:

edit_tool.accepted/rejected: Número de propostas da ferramenta Edit que o usuário aceitou/rejeitou

Divisão por modelo

Para cada modelo Claude usado:

model: Identificador do modelo Claude (ex: claude-3-5-sonnet-20241022)
tokens.input/output: Contagens de tokens de entrada e saída para este modelo
tokens.cache_read/cache_creation: Uso de tokens relacionados ao cache para este modelo
estimated_cost.amount: Custo estimado em centavos 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-01T00: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
        },
        "write_tool": {
          "accepted": 8,
          "rejected": 1
        },
        "notebook_edit_tool": {
          "accepted": 3,
          "rejected": 0
        }
      },
      "model_breakdown": [
        {
          "model": "claude-3-5-sonnet-20241022",
          "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 grandes números de usuários:

Faça sua solicitação inicial com parâmetro limit opcional
Se has_more for true na resposta, use o valor next_page em sua próxima solicitação
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

Painéis 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 Claude Code com outras ferramentas de codificação de IA como Copilot e Cursor
Análise de produtividade do desenvolvedor: Rastreie métricas de produtividade individual 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 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 via OAuth (mais comum)
api_actor: Contém api_key_name para usuários que se autenticam via chave de API

O campo customer_type indica se o uso é de clientes api (API PAYG) ou clientes subscription (planos Pro/Team).

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

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 estes dados.

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

Esta API rastreia apenas o uso do Claude Code na API Claude (1ª parte). O uso no Amazon Bedrock, Google Vertex AI ou outras plataformas de terceiros não está incluído.

Quanto custa usar esta API?

A API de Análise de Código Claude é gratuita para usar para todas as organizações com acesso à API de Administração.

Como calcular 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 aceitos e 5 rejeitados, a taxa de aceitação é 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 meia-noite UTC para aquele dia.

Veja também

A API de Análise de Código Claude ajuda você a entender e otimizar o fluxo de trabalho de desenvolvimento da sua equipe. Saiba mais sobre recursos relacionados:

Visão geral da API de Administração
Referência da API de Administração
Painel de Análise de Código Claude
API de Uso e Custo - Rastreie o uso da API em todos os serviços Anthropic
Gerenciamento de identidade e acesso
Monitoramento de uso com OpenTelemetry para métricas personalizadas e alertas

Release Notes

​Início rápido

​API de Análise de Código Claude

​Conceitos principais

​Exemplos básicos

​Obter análises para um dia específico

​Obter análises com paginação

​Parâmetros de solicitação

​Métricas disponíveis

​Dimensões

​Métricas principais

​Métricas de ação de ferramenta

​Divisão por modelo

​Estrutura da resposta

​Paginação

​Casos de uso comuns

​Perguntas frequentes

​Quão atualizados são os dados de análise?

​Posso obter métricas em tempo real?

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

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

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

​Quanto custa usar esta API?

​Como calcular taxas de aceitação de ferramentas?

​Qual fuso horário é usado para o parâmetro de data?

​Veja também

Início rápido

API de Análise de Código Claude

Conceitos principais

Exemplos básicos

Obter análises para um dia específico

Obter análises com paginação

Parâmetros de solicitação

Métricas disponíveis

Dimensões

Métricas principais

Métricas de ação de ferramenta

Divisão por modelo

Estrutura da resposta

Paginação

Casos de uso comuns

Perguntas frequentes

Quão atualizados são os dados de análise?

Posso obter métricas em tempo real?

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

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

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

Quanto custa usar esta API?

Como calcular taxas de aceitação de ferramentas?

Qual fuso horário é usado para o parâmetro de data?

Veja também