API d'Analyse de Code Claude

• 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

​

Démarrage rapide

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: VotreApp/1.0.0 (https://votreapp.com)

​

API d’Analyse de Code Claude

​

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

​

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

​

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

• 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

• 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

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

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

​

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 ?

​

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

​

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

• 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

​

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

​

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

​

Combien coûte l’utilisation de cette API ?

​

Comment calculer les taux d’acceptation des outils ?

​

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

​

Voir aussi

• Aperçu de l’API d’Administration
• Référence de l’API d’Administration
• Tableau de bord d’Analyse de Code Claude
• API d’Utilisation et de Coût - Suivez l’utilisation de l’API dans tous les services Anthropic
• Gestion des identités et des accès
• Surveillance de l’utilisation avec OpenTelemetry pour des métriques personnalisées et des alertes