Aller au contenu

Claude Code OpenTelemetry : paramètres gérés

Claude Code envoie sa télémétrie OpenTelemetry à l’adresse de collecte que nous vous donnons, dès que votre administrateur l’active. Il n’y a rien à installer : c’est un réglage de Claude Code, posé depuis la console claude.ai, sans toucher aux postes. Pour l’usage de Claude en entreprise, sièges et agents compris, voir Claude en entreprise.

  • Claude Code à jour sur les postes des développeurs, connecté au compte Claude Team ou Claude Enterprise de l’organisation.
  • Le propriétaire ou le propriétaire principal de l’organisation claude.ai, pour régler les paramètres gérés.
  • L’adresse de collecte et le jeton d’accès que nous vous donnons au lancement de l’audit.
Variable Valeur Rôle
CLAUDE_CODE_ENABLE_TELEMETRY 1 Active la télémétrie.
OTEL_LOGS_EXPORTER otlp Envoie les événements.
OTEL_METRICS_EXPORTER otlp Envoie les métriques.
OTEL_EXPORTER_OTLP_PROTOCOL grpc Le protocole de l’adresse de collecte.
OTEL_EXPORTER_OTLP_ENDPOINT l’adresse donnée Où partent les données.
OTEL_EXPORTER_OTLP_HEADERS Authorization=Bearer … Le jeton d’accès donné.
OTEL_LOG_USER_PROMPTS 1 Ajoute le texte des demandes, sans quoi le Cockpit ne peut pas lire les cas d’usage.
OTEL_LOG_ASSISTANT_RESPONSES 1 Ajoute le texte des réponses.
OTEL_RESOURCE_ATTRIBUTES department=… Le pôle du poste, pour lire les résultats par pôle. Sans espace dans la valeur.
  1. Écrire les paramètres gérés

    Dans la console claude.ai, le propriétaire ouvre « Paramètres de l’organisation », puis « Claude Code », puis « Paramètres gérés ». Il place les variables dans le bloc env et enregistre. Les paramètres atteignent chaque membre de l’organisation au lancement suivant de Claude Code.

    {
    "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "<adresse de collecte>",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer <jeton>",
    "OTEL_LOG_USER_PROMPTS": "1",
    "OTEL_LOG_ASSISTANT_RESPONSES": "1",
    "OTEL_RESOURCE_ATTRIBUTES": "department=<pole>"
    }
    }
  2. Faire accepter l’adresse de collecte

    Au lancement suivant de Claude Code, chaque développeur voit une fenêtre qui nomme l’adresse de collecte, et l’accepte une fois. Claude Code demande cet accord pour toute adresse d’envoi réglée à distance ; si le développeur refuse, Claude Code se ferme.

  3. Vérifier l’arrivée

    Après une première session de Claude Code, l’écran Sources de données du Cockpit montre la source et la date de son dernier envoi.

Les paramètres de la console n’atteignent pas une session de Claude Code passée par Amazon Bedrock, Google Cloud ou Microsoft Foundry, ni une session connectée par une clé de la Claude Console. Dans ces cas, ou si vous gérez déjà vos postes avec un outil de gestion, placez le même bloc env dans le fichier de paramètres gérés de Claude Code, puis déployez-le sur les postes. L’emplacement du fichier selon le système est dans la documentation d’Anthropic sur les paramètres gérés.

  • Mesuré : chaque demande et chaque réponse, les requêtes au modèle avec le modèle, les tokens, le coût estimé et la durée, et le pôle si OTEL_RESOURCE_ATTRIBUTES le donne.
  • Pas rétroactif : la mesure commence à l’activation ; les sessions antérieures ne sont pas récupérables.
  • Pas couvert : les conversations de claude.ai et de l’application Claude, qui ont leur propre connecteur claude.ai.

Non. La télémétrie part du poste vers l’adresse de collecte réglée dans les paramètres ; elle ne passe pas par Anthropic.

L’API Analytics de Claude Code ne suffit-elle pas ?

Section intitulée « L’API Analytics de Claude Code ne suffit-elle pas ? »

Elle donne des compteurs par personne et par jour : sessions, lignes de code, commits, coût. Elle ne dit pas à quoi servent les sessions. La télémétrie donne les demandes elles-mêmes, et c’est d’elles que se tirent les cas d’usage.

Pour voir ce que l'outil montre sur vos propres outils, prenez rendez-vous.