API d'analyse Claude Code

L'API Admin d'analyse Claude Code fournit un accès programmatique aux métriques d'utilisation agrégées quotidiennement 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 fournit plus de détails que le tableau de bord d'analyse de base, sans la complexité de l'intégration OpenTelemetry.

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éées à l'aide de Claude Code
• Métriques d'utilisation d'outils : surveillez les taux d'acceptation et de rejet pour les différents outils de Claude Code (Edit, MultiEdit, Write, NotebookEdit)
• Analyse des coûts : consultez les coûts estimés et l'utilisation de tokens ventilés par modèle Claude
• Rapports personnalisés : exportez les données pour créer des tableaux de bord 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ADMIN_API_KEY"

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



API d'analyse Claude Code

Suivez l'utilisation de Claude Code, les métriques de productivité et l'activité des développeurs dans toute 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 des curseurs : gérez de grands ensembles de données avec une pagination stable à l'aide de curseurs opaques
• Fraîcheur des données : les métriques sont disponibles avec un délai pouvant aller jusqu'à 1 heure pour garantir la cohérence

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



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" \
  -H "anthropic-version: 2023-06-01" \
  -H "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" \
  -H "anthropic-version: 2023-06-01" \
  -H "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=" \
  -H "anthropic-version: 2023-06-01" \
  -H "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 qui a 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 où 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-5)
• tokens.input/output : nombre de tokens d'entrée et de sortie pour ce modèle
• tokens.cache_read/cache_creation : utilisation de tokens liée 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 au 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-5",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 141
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}



Pagination

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

1. Effectuez votre requête initiale avec le paramètre facultatif 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 d'enregistrements.



Cas d'utilisation courants

• Tableaux de bord pour la direction : 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 tels que 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
• Suivi 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



Questions fréquemment posées



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

Les données d'analyse Claude Code apparaissent généralement dans l'heure qui suit 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 quotidiennement. 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 (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 avec paiement à l'usage) ou de clients subscription (forfaits Pro/Team).



Quelle est la période de conservation des données ?

Les données historiques d'analyse Claude Code sont conservées et accessibles via l'API. Il n'y a pas de période de suppression 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 dans Amazon Bedrock, Claude dans Microsoft Foundry, Claude sur Google Cloud ou Claude Platform sur AWS n'est pas incluse.



Combien coûte l'utilisation de cette API ?

L'API d'analyse Claude Code 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 d'analyse Claude Code vous aide à comprendre et à optimiser le flux de travail de développement de votre équipe. Apprenez-en davantage sur les fonctionnalités associées :

• API Admin
• Référence de l'API Admin
• Tableau de bord d'analyse Claude Code
• API Usage and Cost - Suivez l'utilisation de l'API sur l'ensemble des 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 des alertes personnalisées