Claude Code usage tracking by LangWatch

LangWatch : Le Guide Complet pour Suivre et Optimiser votre Utilisation de Claude Code

Dans le paysage actuel du développement assisté par l'intelligence artificielle, la maîtrise de ses outils et de leur consommation est devenue primordiale. LangWatch se positionne comme la plateforme d'ingénierie LLM de référence pour les équipes qui déploient l'IA en production. Que vous utilisiez Claude Code, Codex, OpenCode, Copilot, Cursor ou Pi, LangWatch vous permet de capturer l'historique complet de vos traces, d'améliorer votre flux de travail et de surveiller précisément vos dépenses en tokens.

Qu'est-ce que le suivi LangWatch pour Claude Code ?

LangWatch est une plateforme d'observabilité LLM conçue pour apporter une visibilité totale sur les interactions avec les agents de codage. Le suivi pour Claude Code permet de transformer chaque session de travail en une trace détaillée. Contrairement aux lecteurs de logs locaux qui sont limités à une seule machine, LangWatch utilise la route OpenTelemetry, ce qui permet de vous suivre sur différentes machines et de conserver vos données même après un nettoyage des logs locaux.

En utilisant LangWatch, vous accédez à une interface utilisateur riche où chaque tour de modèle, chaque appel d'outil et chaque coût théorique est répertorié. C'est l'outil indispensable pour comprendre comment vos agents IA comme Claude Code consomment des ressources et comment ils interagissent avec votre environnement de développement.

Fonctionnalités Clés de LangWatch

LangWatch propose une suite d'outils puissants pour analyser et optimiser vos sessions d'IA.

Suivi de l'historique complet et UI dédiée

Tout ce qu'une session laisse derrière elle est capturé dans l'interface utilisateur de la plateforme. Vous pouvez visualiser le résumé des traces, l'origine des appels, la durée des sessions, ainsi que le coût et le nombre de tokens utilisés.

Comptabilité précise des tokens et du cache

LangWatch distingue les lectures de cache et les écritures de cache comme des classes de tokens distinctes sur chaque segment (span). Dans les sessions d'agent prolongées, les lectures de cache constituent souvent la majeure partie du volume. Un tracker classique qui regrouperait tout dans les entrées (input) fausserait les calculs de coûts. LangWatch assure une précision maximale en séparant ces données.

Analyse des coûts : Théorique vs Facturé

Pour les utilisateurs bénéficiant de forfaits (Pro, Max, Team) sans facturation au token, LangWatch affiche un label "Bundled". La plateforme calcule alors un coût théorique basé sur les prix de liste de l'API. Cela vous permet de visualiser ce que vous dépenseriez si vous n'étiez pas sur un forfait individuel ou d'équipe.

Surveillance des outils, compétences et MCP

Chaque commande Bash, modification de fichier, invocation de compétence ou appel MCP (Model Context Protocol) est enregistré comme un segment avec sa durée et les détails complets des entrées et sorties. Vous pouvez ainsi inspecter les commandes exactes exécutées par l'agent, comme des listes de services gcloud ou des recherches Grep.

Serveur MCP LangWatch

Le serveur MCP expose vos propres traces à l'agent lui-même. Cela signifie que Claude Code peut interroger ses propres exécutions de la semaine passée, identifier où les tokens sont consommés et éditer son propre flux de travail pour gagner en efficacité.

Analyses et graphiques personnalisés

N'importe quelle métrique présente sur une trace peut être transformée en graphique. Vous pouvez suivre :

• Les sessions s'exécutant en parallèle.
• Le coût par session.
• Le temps d'inactivité pendant que l'agent attend votre réponse.

Comment utiliser LangWatch avec Claude Code ?

L'installation et la configuration de LangWatch sont conçues pour être instantanées. Une seule commande suffit pour commencer le suivi de votre utilisation de Claude Code.

1. Lancement du suivi : Ouvrez votre terminal et exécutez la commande suivante : $ npx langwatch claude
2. Configuration automatique : Cette commande configure l'exportation native OpenTelemetry de Claude Code vers LangWatch.
3. Visualisation : Chaque session est instantanément envoyée vers la plateforme LangWatch sous forme de trace, incluant les tours de modèle et les appels d'outils.

Une fois configuré, vous pouvez continuer à travailler normalement. LangWatch s'occupe de tout en arrière-plan.

Cas d'Utilisation de LangWatch

L'utilisation de LangWatch s'avère cruciale dans plusieurs scénarios de développement réel basés sur les capacités de Coding Agent.

Débogage et diagnostic système

Imaginez un agent tentant de configurer une API Google Ads. Grâce aux traces de LangWatch, vous pouvez voir l'entrée utilisateur, la commande Bash exécutée par l'agent (gcloud services list --enabled) et le diagnostic de sortie expliquant qu'aucun projet n'a l'API activée. La trace permet de remonter à la source de l'erreur en quelques secondes.

Gestion des modifications de design complexes

Lors de demandes de changements de design multiples (comme l'ajout de stickers ou l'ajustement de tokens d'application), LangWatch permet de suivre comment l'agent traite chaque requête, le temps passé sur chaque tâche et le nombre massif de tokens générés (parfois plus de 500K tokens pour des sessions intensives).

Résolution de bugs et maintenance

LangWatch est idéal pour suivre les processus de correction de bugs. Par exemple, lorsqu'un agent réinitialise un worktree pour reproduire un bug, écrit un test défaillant, puis applique un correctif, chaque étape est documentée. Vous pouvez voir comment l'agent a réordonné des migrations de base de données pour résoudre des erreurs de dépendance.

Nettoyage et optimisation de l'environnement

L'agent peut être utilisé pour supprimer des artefacts obsolètes (déploiements de prévisualisation orphelins, volumes de cache). LangWatch enregistre précisément l'espace libéré (par exemple 4.2GB) et confirme qu'aucune référence CI n'a été compromise, offrant ainsi une piste d'audit claire.

FAQ (Foire Aux Questions)

Comment puis-je suivre mon utilisation de Claude Code ?

Il suffit d'exécuter npx langwatch claude. Cela configure l'exportation OpenTelemetry de Claude Code vers LangWatch. Chaque session devient une trace accessible en ligne, contrairement aux logs locaux qui sont volatils.

Est-ce que cela fonctionne avec Codex, OpenCode, Copilot, Cursor et Pi ?

Oui. Chaque agent exporte ses données via le même point de terminaison OTLP, ce qui permet de centraliser toutes vos statistiques de tokens, de coûts et de traces dans un seul et même magasin de données.

Que signifie le label de coût "Bundled" ?

Les sessions effectuées sur un abonnement Claude (Pro, Max, Team) n'ont pas de facture par token. LangWatch marque ces sessions comme "Bundled" et calcule un total théorique aux prix catalogue de l'API pour vous donner une estimation de la valeur consommée.

Les tokens mis en cache sont-ils comptabilisés ?

Absolument. Les lectures et écritures de cache sont traitées comme des classes de tokens distinctes et tarifées à leurs propres taux. C'est essentiel pour obtenir un coût total exact, surtout dans les sessions d'agent de longue durée.

Que se passe-t-il si je colle accidentellement des clés secrètes dans ma session Claude ?

LangWatch dispose d'un système de détection PII (Presidio). Les secrets d'API et les informations personnelles identifiables sont automatiquement masqués et ne sont jamais stockés sur les serveurs de LangWatch. Pour un contrôle encore plus strict, des options d'auto-hébergement et des politiques d'entreprise sont disponibles.

Note : LangWatch est gratuit pour un usage individuel et repose sur une architecture robuste (EU, US, UK, APAC) respectant les standards Apache2.