Plugin Claude Code - CoreWeave Docs

Le plugin Weave pour Claude Code trace automatiquement chaque session Claude Code et envoie les données structurées vers W&B Weave. Le plugin journalise chaque tour de conversation, chaque appel d’outil et chaque sous-agent, sans aucune modification de code. Utilisez ces traces pour déboguer les sessions, auditer l’utilisation des outils et surveiller le coût et la latence d’un run à l’autre. Ce guide vous explique comment installer le plugin, consulter vos traces Claude Code dans Weave, configurer le plugin et gérer son cycle de vie.

Ce plugin envoie les données de session Claude Code vers Weave. Ces données peuvent inclure les prompts des utilisateurs, les réponses de Claude, les entrées et sorties des outils, le contenu des fichiers lus par les outils de Claude Code, les commandes shell et leur sortie, ainsi que les URL récupérées et le contenu des pages.Le nettoyage des données personnelles (PII) et le masquage des données sensibles ne sont pas pris en charge. Si vos exigences de sécurité ou de conformité ne vous permettent pas d’envoyer ces données vers Weave, n’installez pas ce plugin.

Prérequis

Node.js v18 ou version ultérieure (npm inclus).
Claude Code installé et authentifié.
Un compte CoreWeave Forge et une clé API définie dans la variable d’environnement WANDB_API_KEY.
Un projet Weave ([YOUR-TEAM]/[YOUR-PROJECT]) où envoyer les traces.

Installer le plugin

Installez la CLI, exécutez le programme d’installation pour enregistrer le plugin auprès de Claude Code, puis démarrez une session Claude Code pour commencer le traçage.

Installer la CLI

npm install -g weave-claude-code

Exécuter le programme d’installation

weave-claude-code install

Le programme d’installation effectue les opérations suivantes :

Il crée ~/.weave-claude-code/settings.json.
Il enregistre le plugin dans Claude Code.
Il vous invite à saisir votre projet Weave ([YOUR-TEAM]/[YOUR-PROJECT]) et votre clé API W&B s’ils ne sont pas déjà définis.

Pour ignorer ces invites dans un environnement CI, des scripts d’amorçage ou d’autres systèmes automatisés, définissez les variables d’environnement avant l’exécution :

WEAVE_PROJECT=[YOUR-TEAM]/[YOUR-PROJECT] \
WANDB_API_KEY=[YOUR-API-KEY] \
weave-claude-code install --non-interactive

En mode non interactif, le programme d’installation crée tout de même le fichier de configuration et enregistre le plugin. Il lit WEAVE_PROJECT et WANDB_API_KEY dans l’environnement et affiche un avertissement si l’une de ces variables est absente.

Démarrer Claude Code

claude

Dès lors, le plugin trace automatiquement les sessions. Exécutez un ou deux prompts, puis ouvrez votre projet Weave pour voir les traces s’afficher.

Afficher les traces Claude Code dans Weave

Après avoir exécuté au moins une session Claude Code, ouvrez votre projet dans l’interface de Weights & Biases :

Accédez à Forge et sélectionnez votre projet.
Dans le menu latéral, sélectionnez Agents.
Sélectionnez l’onglet Conversations pour afficher toutes les conversations d’agents enregistrées dans votre projet.
Sélectionnez une conversation pour examiner son arborescence complète.

Pour plus d’informations sur la vue Agents, consultez Afficher l’activité des agents. Chaque prompt utilisateur génère une trace OTEL conforme aux conventions sémantiques GenAI. La trace présente la hiérarchie complète des tours de conversation :

invoke_agent claude-code               (Racine, une trace par prompt utilisateur.)
├─ chat <model>                        (Chaque appel LLM du tour de conversation.)
├─ execute_tool <tool_name>            (Chaque appel d’outil, comme Read, Bash ou Grep.)
└─ invoke_agent <subagent_type>        (Sous-agent lancé par l’outil Agent.)
   ├─ chat <model>
   └─ execute_tool <tool_name>

Le span racine invoke_agent claude-code utilise le nom de l’agent de premier niveau, qui est claude-code par défaut. Vous pouvez le modifier avec le paramètre agent_name ou la variable d’environnement WEAVE_AGENT_NAME (voir Configurer le plugin). Les sous-agents conservent leurs propres noms de type. Les conversations sur plusieurs tours de conversation sont liées côté serveur par l’ID de conversation, ce qui vous permet de suivre une conversation sur plusieurs traces. Chaque span inclut l’utilisation des jetons, le nom du modèle, les entrées et sorties des outils, les durées d’exécution, ainsi que le contenu textuel des prompts et des réponses. Pour en savoir plus sur les données tracées, consultez What Gets Traced sur GitHub.

Configurer le plugin

Après l’installation, utilisez les commandes weave-claude-code config pour afficher ou modifier les paramètres du plugin :

# Afficher tous les paramètres actuels.
weave-claude-code config show

# Définir votre projet Weave.
weave-claude-code config set weave_project [YOUR-TEAM]/[YOUR-PROJECT]

# Définir votre clé API W&B.
weave-claude-code config set wandb_api_key [YOUR-API-KEY]

# (Facultatif) Personnaliser le nom de l’agent affiché dans la vue Agents.
weave-claude-code config set agent_name [YOUR-AGENT-NAME]

Par défaut, les conversations apparaissent sous le nom d’agent claude-code dans la vue Agents. Définissez agent_name pour utiliser un autre nom, par exemple pour distinguer des équipes ou des projets. Le nom ne peut pas être vide, et les espaces en début et en fin de chaîne sont supprimés. Les variables d’environnement sont prioritaires sur le fichier de paramètres :

export WEAVE_PROJECT=[YOUR-TEAM]/[YOUR-PROJECT]
export WANDB_API_KEY=[YOUR-API-KEY]
export WEAVE_AGENT_NAME=[YOUR-AGENT-NAME]

Compétences Weave

Une fois l’installation terminée, trois compétences propres à Weave sont disponibles directement dans n’importe quelle session Claude Code.

Compétence	Commande	Description
Installation	`/weave:weave-install`	Vous guide de manière interactive tout au long de l’installation et de la configuration. Utilisez-la sur une nouvelle machine ou pour diagnostiquer une configuration défaillante.
Statut	`/weave:weave-status`	Vérifie le statut actuel du plugin et explique les éventuels problèmes. Équivaut à exécuter `weave-claude-code status`, mais Claude interprète la sortie et vous indique ce qu’il faut corriger.
Configuration	`/weave:weave-config`	Lit ou met à jour la configuration du plugin sans quitter Claude Code.

Vous pouvez utiliser la compétence weave:weave-config pour définir des valeurs Weave directement depuis Claude Code :

/weave:weave-config set weave_project [YOUR-TEAM]/[YOUR-PROJECT]
/weave:weave-config set wandb_api_key [YOUR-API-KEY]
/weave:weave-config set agent_name [YOUR-AGENT-NAME]

Vérifier le statut du plugin

Vous pouvez utiliser les commandes CLI suivantes pour vérifier le statut du plugin ou résoudre d’éventuels problèmes :

weave-claude-code status

Chaque ligne affiche ✓ (OK), ✗ (action requise) ou - (pas encore actif, mais sans erreur). Si les conversations n’apparaissent pas dans Weave, consultez le journal du démon :

weave-claude-code logs

Pour suivre le journal en temps réel :

weave-claude-code logs --follow

Le fichier journal se trouve également dans ~/.weave-claude-code/logs/daemon.log.

Cloud dédié W&B ou instances autohébergées

Si vous utilisez le Cloud dédié W&B ou une instance autohébergée, définissez WANDB_BASE_URL avant de lancer Claude Code :

export WANDB_BASE_URL=https://[YOUR-INSTANCE].wandb.io

Le plugin exécute en arrière-plan un démon qui lit WANDB_BASE_URL au démarrage. Si le démon est déjà en cours d’exécution lorsque vous définissez la variable, il ne détectera pas la modification. Pour redémarrer le démon :

Arrêtez le démon :

printf '{"command":"shutdown"}' | nc -U -w1 ~/.weave-claude-code/daemon.sock

Définissez WANDB_BASE_URL, ou exécutez wandb login --host https://[YOUR-INSTANCE].wandb.io pour conserver ce paramètre d’une session à l’autre.
Relancez Claude Code. Le démon redémarre automatiquement et utilise la bonne URL.

Désinstallation

Pour supprimer le plugin de Claude Code, exécutez la commande suivante :

weave-claude-code uninstall

Ajoutez l’option --keep-logs pour conserver le répertoire des journaux.

​Prérequis

​Installer le plugin

​Afficher les traces Claude Code dans Weave

​Configurer le plugin

​Compétences Weave

​Vérifier le statut du plugin

​Cloud dédié W&B ou instances autohébergées

​Désinstallation