> ## 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 W&B Weave à des fins d’observabilité et de débogage.

export const AgentLensBanner = ({href}) => <Tip>
    <strong>This workflow is also available in CoreWeave Agent Lens.</strong> Agent Lens is the Forge experience built for tracing, monitoring, and analyzing AI agents, with automated insights into agent failures and user intents. It uses the same trace data as Weights & Biases Weave, so the traces you already send appear there with nothing to migrate.{' '}
    <a href={href || '/products/agent-lens'}>{href ? 'See how to do this in Agent Lens' : 'Learn about Agent Lens'}</a>.
  </Tip>;

<AgentLensBanner href="/fr/products/agent-lens/integrations/claude-code" />

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.

<Warning>
  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.
</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 Weave (`[YOUR-TEAM]/[YOUR-PROJECT]`) où envoyer 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 commencer 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 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 :

    ```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 Weave pour voir les traces s’afficher.
  </Step>
</Steps>

<h2 id="view-claude-code-traces-in-weave">
  Afficher les traces Claude Code dans Weave
</h2>

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

1. Accédez à [Forge](https://forge.coreweave.com/wandb) et sélectionnez votre projet.
2. Dans le menu latéral, sélectionnez **Agents**.
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 la vue Agents, consultez [Afficher l’activité des agents](/fr/products/wandb/weave/guides/tracking/view-agent-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é 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](#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 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](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 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 :

```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="weave-skills">
  Compétences Weave
</h2>

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 :

```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, mais sans erreur).

Si les conversations n'apparaissent pas dans Weave, 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 se trouve également dans `~/.weave-claude-code/logs/daemon.log`.

<h3 id="wb-dedicated-cloud-or-self-hosted-instances">
  Cloud dédié W\&B ou instances autohébergées
</h3>

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 :

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

1. Arrêtez le démon :
   ```bash lines theme={"system"}
   printf '{"command":"shutdown"}' | nc -U -w1 ~/.weave-claude-code/daemon.sock
   ```
2. 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.
3. Relancez Claude Code. Le démon redémarre automatiquement et utilise la bonne URL.

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