Plugin Claude Code - CoreWeave Docs

Le plugin Weave pour Claude Code trace automatiquement chaque session Claude Code et envoie les données structurées à Agent Lens. Il journalise chaque tour de conversation, chaque appel d’outil et chaque sous-agent, sans aucune modification de code. Servez-vous de 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, afficher vos traces Claude Code dans Agent Lens, configurer le plugin et gérer son cycle de vie.

Il s’agit d’un plugin Weights & Biases Weave. Aucune version CoreWeave Forge n’est encore disponible. Les traces envoyées par le plugin apparaissent dans Agent Lens, car Agent Lens et Weave partagent les mêmes données de trace.

Ce plugin envoie les données de session Claude Code à Agent Lens. Ces données peuvent inclure les prompts utilisateur, 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 implémentés. Si vos exigences de sécurité ou de conformité ne vous permettent pas d’envoyer ces données à Agent Lens, 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 Agent Lens ([YOUR-TEAM]/[YOUR-PROJECT]) destiné à recevoir 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 lancer 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 Agent Lens ([YOUR-TEAM]/[YOUR-PROJECT]) et votre clé API Forge s’ils ne sont pas déjà définis.

Pour ignorer ces invites en CI, dans des scripts d’amorçage ou dans d’autres systèmes automatisés, définissez des 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 Agent Lens pour voir les traces s’afficher.

Afficher les traces Claude Code dans Agent Lens

Après avoir exécuté au moins une session Claude Code, ouvrez votre projet dans l’interface d’Agent Lens :

Accédez à CoreWeave Forge, sélectionnez Agent Lens dans le menu des produits, puis sélectionnez votre projet dans le sélecteur de projet, en haut du menu latéral.
Dans le menu latéral, sélectionnez Conversations.
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 l’onglet Conversation, 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é via 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 par défaut claude-code. 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 leur ID de conversation, ce qui vous permet de suivre une conversation à travers 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 Forge.
weave-claude-code config set wandb_api_key [YOUR-API-KEY]

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

Par défaut, les conversations apparaissent sous le nom d’agent claude-code dans l’onglet Conversations. 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]

Skills Agent Lens

Une fois l’installation terminée, trois skills propres à Agent Lens sont disponibles directement dans n’importe quelle session Claude Code.

Skill	Commande	Description
Install	`/weave:weave-install`	Vous guide de manière interactive tout au long du processus d’installation et de configuration. Utilisez-le sur une nouvelle machine ou pour diagnostiquer une configuration défaillante.
Status	`/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.
Config	`/weave:weave-config`	Lire ou mettre à jour la configuration du plugin sans quitter Claude Code.

Vous pouvez utiliser le skill weave:weave-config pour définir des valeurs Agent Lens 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, sans que ce soit une erreur). Si les conversations n’apparaissent pas dans Agent Lens, 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 est également disponible à l’emplacement ~/.weave-claude-code/logs/daemon.log.

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 Agent Lens

​Configurer le plugin

​Skills Agent Lens

​Vérifier le statut du plugin

​Désinstallation

Prérequis

Installer le plugin

Afficher les traces Claude Code dans Agent Lens

Configurer le plugin

Skills Agent Lens

Vérifier le statut du plugin

Désinstallation