API Claude Code Analytics

L'API d'administration Claude Code Analytics fournit un accès programmatique aux métriques d'utilisation quotidiennes agrégées pour les utilisateurs de Claude Code, permettant aux organisations d'analyser la productivité des développeurs et de créer des tableaux de bord personnalisés. Cette API comble l'écart entre le tableau de bord Analytics de base et l'intégration OpenTelemetry plus complexe.

Cette API vous permet de mieux surveiller, analyser et optimiser votre adoption de Claude Code :

• Analyse de la productivité des développeurs : Suivez les sessions, les lignes de code ajoutées/supprimées, les commits et les pull requests créés à l'aide de Claude Code
• Métriques d'utilisation d'outils : Surveillez les taux d'acceptation et de rejet pour différents outils Claude Code (Edit, MultiEdit, Write, NotebookEdit)
• Analyse des coûts : Consultez les coûts estimés et l'utilisation des tokens ventilés par modèle Claude
• Rapports personnalisés : Exportez les données pour créer des tableaux de bord exécutifs et des rapports destinés aux équipes de direction
• Justification de l'utilisation : Fournissez des métriques pour justifier et étendre l'adoption de Claude Code en interne



Démarrage rapide

Obtenez les analyses Claude Code de votre organisation pour un jour spécifique :

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 Claude Code Analytics

Suivez l'utilisation de Claude Code, les métriques de productivité et l'activité des développeurs dans l'ensemble de votre organisation avec le point de terminaison /v1/organizations/usage_report/claude_code.



Concepts clés

• Agrégation quotidienne : Renvoie les métriques pour un seul jour spécifié par le paramètre starting_at
• Données au niveau utilisateur : Chaque enregistrement représente l'activité d'un utilisateur pour le jour spécifié
• Métriques de productivité : Suivez les sessions, les lignes de code, les commits, les pull requests et l'utilisation d'outils
• Données de tokens et de coûts : Surveillez l'utilisation et les coûts estimés ventilés par modèle Claude
• Pagination basée sur curseur : Gérez de grands ensembles de données avec une pagination stable utilisant des curseurs opaques
• Fraîcheur des données : Les métriques sont disponibles avec un délai pouvant atteindre 1 heure pour garantir la cohérence

Pour obtenir les détails complets des paramètres et les schémas de réponse, consultez la référence de l'API Claude Code Analytics.



Exemples de base



Obtenir les analyses pour un jour spécifique

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"



Obtenir les analyses avec pagination

# Première requête
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"

# Requête suivante utilisant le curseur de la réponse
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"



Paramètres de requête



Métriques disponibles

Chaque enregistrement de réponse contient les métriques suivantes pour un seul utilisateur sur un seul jour :



Dimensions

• date : Date au format RFC 3339 (horodatage UTC)
• actor : L'utilisateur ou la clé API ayant effectué les actions Claude Code (soit user_actor avec email_address, soit api_actor avec api_key_name)
• organization_id : UUID de l'organisation
• customer_type : Type de compte client (api pour les clients API, subscription pour les clients Pro/Team)
• terminal_type : Type de terminal ou d'environnement dans lequel Claude Code a été utilisé (par exemple, vscode, iTerm.app, tmux)



Métriques principales

• num_sessions : Nombre de sessions Claude Code distinctes initiées par cet acteur
• lines_of_code.added : Nombre total de lignes de code ajoutées dans tous les fichiers par Claude Code
• lines_of_code.removed : Nombre total de lignes de code supprimées dans tous les fichiers par Claude Code
• commits_by_claude_code : Nombre de commits git créés via la fonctionnalité de commit de Claude Code
• pull_requests_by_claude_code : Nombre de pull requests créées via la fonctionnalité de PR de Claude Code



Métriques d'actions d'outils

Ventilation des taux d'acceptation et de rejet des actions d'outils par type d'outil :

• edit_tool.accepted/rejected : Nombre de propositions de l'outil Edit que l'utilisateur a acceptées/rejetées
• multi_edit_tool.accepted/rejected : Nombre de propositions de l'outil MultiEdit que l'utilisateur a acceptées/rejetées
• write_tool.accepted/rejected : Nombre de propositions de l'outil Write que l'utilisateur a acceptées/rejetées
• notebook_edit_tool.accepted/rejected : Nombre de propositions de l'outil NotebookEdit que l'utilisateur a acceptées/rejetées



Ventilation par modèle

Pour chaque modèle Claude utilisé :

• model : Identifiant du modèle Claude (par exemple, claude-opus-4-8)
• tokens.input/output : Nombre de tokens d'entrée et de sortie pour ce modèle
• tokens.cache_read/cache_creation : Utilisation des tokens liés au cache pour ce modèle
• estimated_cost.amount : Coût estimé en cents USD pour ce modèle
• estimated_cost.currency : Code de devise pour le montant du coût (actuellement toujours USD)



Structure de la réponse

L'API renvoie les données dans le format suivant :

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



Pagination

L'API prend en charge la pagination basée sur curseur pour les organisations comptant un grand nombre d'utilisateurs :

1. Effectuez votre requête initiale avec le paramètre optionnel limit
2. Si has_more est true dans la réponse, utilisez la valeur next_page dans votre requête suivante
3. Continuez jusqu'à ce que has_more soit false

Le curseur encode la position du dernier enregistrement et garantit une pagination stable même lorsque de nouvelles données arrivent. Chaque session de pagination maintient une limite de données cohérente pour garantir que vous ne manquez ni ne dupliquez aucun enregistrement.



Cas d'utilisation courants

• Tableaux de bord exécutifs : Créez des rapports de haut niveau montrant l'impact de Claude Code sur la vélocité de développement
• Comparaison d'outils d'IA : Exportez les métriques pour comparer Claude Code avec d'autres outils de codage IA comme Copilot et Cursor
• Analyse de la productivité des développeurs : Suivez les métriques de productivité individuelles et d'équipe au fil du temps
• Suivi et allocation des coûts : Surveillez les schémas de dépenses et allouez les coûts par équipe ou par projet
• Surveillance de l'adoption : Identifiez les équipes et les utilisateurs qui tirent le plus de valeur de Claude Code
• Justification du ROI : Fournissez des métriques concrètes pour justifier et étendre l'adoption de Claude Code en interne



Foire aux questions



Quelle est la fraîcheur des données d'analyse ?

Les données d'analyse de Claude Code apparaissent généralement dans l'heure suivant la fin de l'activité de l'utilisateur. Pour garantir des résultats de pagination cohérents, seules les données datant de plus d'une heure sont incluses dans les réponses.



Puis-je obtenir des métriques en temps réel ?

Non, cette API fournit uniquement des métriques agrégées quotidiennes. Pour une surveillance en temps réel, envisagez d'utiliser l'intégration OpenTelemetry.



Comment les utilisateurs sont-ils identifiés dans les données ?

Les utilisateurs sont identifiés via le champ actor de deux manières :

• user_actor : Contient email_address pour les utilisateurs qui s'authentifient via OAuth (cas le plus courant)
• api_actor : Contient api_key_name pour les utilisateurs qui s'authentifient avec une clé API

Le champ customer_type indique si l'utilisation provient de clients api (API à la consommation) ou de clients subscription (forfaits Pro/Team).



Quelle est la période de rétention des données ?

Les données historiques d'analyse de Claude Code sont conservées et accessibles via l'API. Aucune période de suppression n'est spécifiée pour ces données.



Quels déploiements de Claude Code sont pris en charge ?

Cette API suit uniquement l'utilisation de Claude Code sur l'API Claude. L'utilisation via Claude Platform sur AWS, Claude dans Microsoft Foundry, Claude dans Amazon Bedrock ou Claude sur Google Cloud n'est pas incluse.



Combien coûte l'utilisation de cette API ?

L'API Claude Code Analytics est gratuite pour toutes les organisations ayant accès à l'API Admin.



Comment calculer les taux d'acceptation des outils ?

Taux d'acceptation d'un outil = accepted / (accepted + rejected) pour chaque type d'outil. Par exemple, si l'outil Edit affiche 45 acceptations et 5 rejets, le taux d'acceptation est de 90 %.



Quel fuseau horaire est utilisé pour le paramètre de date ?

Toutes les dates sont en UTC. Le paramètre starting_at doit être au format YYYY-MM-DD et représente minuit UTC pour ce jour.



Voir aussi

L'API Claude Code Analytics vous aide à comprendre et à optimiser le flux de travail de développement de votre équipe. En savoir plus sur les fonctionnalités connexes :

• API Admin
• Référence de l'API Admin
• Tableau de bord Claude Code Analytics
• API Usage and Cost - Suivez l'utilisation de l'API sur tous les services Anthropic
• API Compliance - Récupérez les données d'audit et d'activité
• Gestion des identités et des accès
• Surveillance de l'utilisation avec OpenTelemetry pour des métriques et alertes personnalisées