> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugin Claude Code

> Suivez les sessions Claude Code dans Agent Lens à des fins d’observabilité et de débogage.

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.

<Note>
  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.
</Note>

<Warning>
  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.
</Warning>

<h2 id="prerequisites">
  Prérequis
</h2>

* [Node.js](https://nodejs.org/) v18 ou version ultérieure (`npm` inclus).
* [Claude Code](https://claude.ai/code) installé et authentifié.
* Un compte CoreWeave Forge et une [clé API](https://forge.coreweave.com/settings#apikeys) définie dans la variable d’environnement `WANDB_API_KEY`.
* Un projet Agent Lens (`[YOUR-TEAM]/[YOUR-PROJECT]`) destiné à recevoir les traces.

<h2 id="install-the-plugin">
  Installer le plugin
</h2>

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.

<Steps>
  <Step title="Installer la CLI">
    ```bash lines theme={"system"}
    npm install -g weave-claude-code
    ```
  </Step>

  <Step title="Exécuter le programme d’installation">
    ```bash lines theme={"system"}
    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 :

    ```bash lines theme={"system"}
    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.
  </Step>

  <Step title="Démarrer Claude Code">
    ```bash lines theme={"system"}
    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.
  </Step>
</Steps>

<h2 id="view-claude-code-traces-in-agent-lens">
  Afficher les traces Claude Code dans Agent Lens
</h2>

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

1. Accédez à [CoreWeave Forge](https://forge.coreweave.com), 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.
2. Dans le menu latéral, sélectionnez **Conversations**.
3. Sélectionnez l’onglet **Conversations** pour afficher toutes les conversations d’agents enregistrées dans votre projet.
4. Sélectionnez une conversation pour examiner son arborescence complète.

Pour plus d’informations sur l’onglet Conversation, consultez [Afficher l’activité des agents](/fr/products/agent-lens/conversations/view-activity).

Chaque prompt utilisateur génère une trace OTEL conforme aux [conventions sémantiques GenAI](https://opentelemetry.io/docs/specs/semconv/gen-ai/). La trace présente la hiérarchie complète des tours de conversation :

```text theme={"system"}
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](#configure-the-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](https://github.com/wandb/weave-claude-code/blob/main/README.md#what-gets-traced) sur GitHub.

<h2 id="configure-the-plugin">
  Configurer le plugin
</h2>

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

```bash lines theme={"system"}
# 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 :

```bash lines theme={"system"}
export WEAVE_PROJECT=[YOUR-TEAM]/[YOUR-PROJECT]
export WANDB_API_KEY=[YOUR-API-KEY]
export WEAVE_AGENT_NAME=[YOUR-AGENT-NAME]
```

<h2 id="agent-lens-skills">
  Skills Agent Lens
</h2>

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 :

```text theme={"system"}
/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]
```

<h2 id="check-plugin-status">
  Vérifier le statut du plugin
</h2>

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

```bash lines theme={"system"}
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 :

```bash lines theme={"system"}
weave-claude-code logs
```

Pour suivre le journal en temps réel :

```bash lines theme={"system"}
weave-claude-code logs --follow
```

Le fichier journal est également disponible à l’emplacement `~/.weave-claude-code/logs/daemon.log`.

<h2 id="uninstall">
  Désinstallation
</h2>

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

```bash lines theme={"system"}
weave-claude-code uninstall
```

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