API Claude Code Analytics

L'API Admin Claude Code Analytics 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 Analytics 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éés à l'aide de Claude Code.
• Métriques d'utilisation d'outils : surveillez les taux d'acceptation et de rejet pour les 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

API Claude Code Analytics

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 par 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 aller jusqu'à 1 heure pour des raisons de cohérence.

Pour obtenir tous les détails 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_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: $ANTHROPIC_ADMIN_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: $ANTHROPIC_ADMIN_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 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-5).
• 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é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": "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
}

Pagination

L'API prend en charge la pagination par curseur 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 vaut true dans la réponse, utilisez la valeur next_page dans votre requête suivante.
3. Continuez jusqu'à ce que has_more vaille 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 afin que vous ne manquiez ni ne dupliquiez 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 à 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 répartition des coûts : surveillez les tendances de dépenses et répartissez 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.

Foire aux questions

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 durée de conservation des données ?

Les données d'analyse historiques 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 dans Amazon Bedrock, Claude dans Microsoft Foundry, Claude sur Google Cloud ou Claude Platform on AWS 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 associées :

• 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 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 alertes personnalisées