The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
L’API d’Administration d’Analyse de Code Claude 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 comble le fossé entre notre tableau de bord d’Analyse de base et l’intégration complexe OpenTelemetry. Cette API vous permet de mieux surveiller, analyser et optimiser votre adoption de Claude Code :
  • Analyse de Productivité des Développeurs : Suivez les sessions, les lignes de code ajoutées/supprimées, les commits et les pull requests créées en utilisant Claude Code
  • Métriques d’Utilisation des Outils : Surveillez les taux d’acceptation et de rejet pour différents outils Claude Code (Edit, MultiEdit, Write, NotebookEdit)
  • Analyse des Coûts : Visualisez 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 pour les équipes de direction
  • Justification d’Utilisation : Fournissez des métriques pour justifier et étendre l’adoption de Claude Code en interne
Clé API d’administration requiseCette API fait partie de l’API d’Administration. Ces endpoints nécessitent une clé API d’Administration (commençant par sk-ant-admin...) qui diffère des clés API standard. Seuls les membres de l’organisation avec le rôle d’administrateur peuvent provisionner des clés API d’Administration via la Console Anthropic.

​
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"
Définissez un en-tête User-Agent pour les intégrationsSi vous créez une intégration, définissez votre en-tête User-Agent pour nous aider à comprendre les modèles d’utilisation :
User-Agent: VotreApp/1.0.0 (https://votreapp.com)

​
API d’Analyse de Code Claude

Suivez l’utilisation de Claude Code, les métriques de productivité et l’activité des développeurs dans votre organisation avec l’endpoint /v1/organizations/usage_report/claude_code.

​
Concepts clés

  • Agrégation quotidienne : Retourne 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 des 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 jusqu’à 1 heure de délai pour la cohérence
Pour les détails complets des paramètres et les schémas de réponse, voir la référence de l’API d’Analyse de Code Claude.

​
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

ParamètreTypeRequisDescription
starting_atstringOuiDate UTC au format YYYY-MM-DD. Retourne les métriques pour ce seul jour uniquement
limitintegerNonNombre d’enregistrements par page (par défaut : 20, max : 1000)
pagestringNonToken de curseur opaque du champ next_page de la réponse précédente

​
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 ou 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é 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-3-5-sonnet-20241022)
  • 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 réponse

L’API retourne les données dans le format suivant : 
{
  "data": [
    {
      "date": "2025-09-01T00: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-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
}

​
Pagination

L’API prend en charge la pagination basée sur curseur pour les organisations avec 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 prochaine requête
  3. Continuez jusqu’à ce que has_more soit false
Le curseur encode la position du dernier enregistrement et assure une pagination stable même lorsque de nouvelles données arrivent. Chaque session de pagination maintient une limite de données cohérente pour s’assurer que vous ne manquez pas ou ne dupliquez pas d’enregistrements.

​
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 IA : Exportez les métriques pour comparer Claude Code avec d’autres outils de codage IA comme Copilot et Cursor
  • Analyse de 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 modèles de dépenses et allouez les coûts par équipe ou projet
  • Surveillance de l’adoption : Identifiez quelles équipes et utilisateurs 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

​
À quel point les données d’analyse sont-elles fraîches ?

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 assurer des résultats de pagination cohérents, seules les données de plus d’1 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 la surveillance en temps réel, considérez l’utilisation de 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 façons :
  • 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 via clé API
Le champ customer_type indique si l’utilisation provient de clients api (API PAYG) ou de clients subscription (plans 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. 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 ne suit que l’utilisation de Claude Code sur l’API Anthropic (1ère partie). L’utilisation sur Amazon Bedrock, Google Vertex AI ou d’autres plateformes tierces n’est pas incluse.

​
Combien coûte l’utilisation de cette API ?

L’API d’Analyse de Code Claude est gratuite pour toutes les organisations ayant accès à l’API d’Administration.

​
Comment calculer les taux d’acceptation des outils ?

Taux d’acceptation des outils = accepted / (accepted + rejected) pour chaque type d’outil. Par exemple, si l’outil edit montre 45 acceptés et 5 rejetés, le taux d’acceptation est de 90%.

​
Quel fuseau horaire est utilisé pour le paramètre 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 de Code Claude vous aide à comprendre et optimiser le flux de travail de développement de votre équipe. Apprenez-en plus sur les fonctionnalités connexes :