Skip to main content
Claude Code 向けの Weave プラグインは、すべての Claude Code セッションを自動的にトレースし、構造化データを Agent Lens に送信します。コードを変更しなくても、すべてのターン、ツール呼び出し、サブエージェントがログされます。これらのトレースを使用すると、セッションのデバッグ、ツールの使用状況の監査、run 全体にわたるコストとレイテンシーの監視を行えます。 このガイドでは、プラグインのインストール方法、Agent Lens で Claude Code のトレースを表示する方法、プラグインの設定方法、およびライフサイクルの管理方法について説明します。
これは Weights & Biases の Weave プラグインです。CoreWeave Forge 版はまだ提供されていません。Agent Lens と Weave は同じトレースデータを共有しているため、このプラグインが送信したトレースは Agent Lens に表示されます。
このプラグインは Claude Code のセッションデータを Agent Lens に送信します。このデータには、ユーザー プロンプト、Claude の応答、ツールの入力と出力、Claude Code のツールが読み取ったファイルの内容、シェルコマンドとその出力、取得した URL とページの内容が含まれる場合があります。PII のスクラビングや機密データのマスキングには対応していません。セキュリティ要件やコンプライアンス要件により、このデータを Agent Lens に送信できない場合は、このプラグインをインストールしないでください。

​
前提条件

  • Node.js v18 以降 (npm を含む) 。
  • Claude Code がインストールされ、認証済みであること。
  • CoreWeave Forge アカウントと、WANDB_API_KEY 環境変数に設定済みの APIキー。
  • トレースの送信先となる Agent Lens project ([YOUR-TEAM]/[YOUR-PROJECT]) 。

​
プラグインをインストールする

CLI をインストールし、インストーラーを実行してプラグインを Claude Code に登録します。その後、Claude Code のセッションを開始するとトレースが始まります。
1

CLI をインストールする

2

インストーラーを実行する

インストーラーは次の処理を行います。
  • ~/.weave-claude-code/settings.json を作成します。
  • Claude Code にプラグインを登録します。
  • Agent Lens の project ([YOUR-TEAM]/[YOUR-PROJECT]) と Forge の APIキーが未設定の場合は、入力を求めます。
CI、ブートストラップスクリプト、その他の自動化システムで入力プロンプトをスキップするには、実行前に環境変数を設定します。
非対話モードでも、インストーラーは設定ファイルの作成とプラグインの登録を行います。WEAVE_PROJECT と WANDB_API_KEY は環境変数から読み取られ、いずれかが設定されていない場合は警告が表示されます。
3

Claude Code を起動する

これ以降、プラグインがセッションを自動的にトレースします。プロンプトをいくつか実行したら Agent Lens の project を開き、トレースが表示されていることを確認してください。

​
Agent Lens で Claude Code のトレースを表示する

Claude Code のセッションを 1 回以上実行したら、Agent Lens UI で project を開きます。
  1. CoreWeave Forge にアクセスし、プロダクト メニューから Agent Lens を選択します。次に、サイド メニュー上部の project セレクターで対象の project を選択します。
  2. サイド メニューで Conversations を選択します。
  3. Conversations タブを選択すると、project に保存されているエージェントの会話がすべて表示されます。
  4. 会話を選択すると、会話ツリー全体を確認できます。
Conversation タブの詳細については、エージェントのアクティビティを表示するを参照してください。 ユーザー プロンプトごとに、GenAI セマンティック規約に準拠した OTEL トレースが 1 つ生成されます。トレースには、ターンの階層全体が表示されます。
ルートの invoke_agent claude-code スパンにはトップレベルのエージェント名が使用されます。デフォルトは claude-code です。この名前は agent_name 設定または WEAVE_AGENT_NAME 環境変数で変更できます (プラグインを設定するを参照してください) 。サブエージェントには、それぞれ独自のタイプ名がそのまま使用されます。 マルチターンの会話はサーバー側で会話 ID によって関連付けられるため、複数のトレースにまたがって会話を追跡できます。各スパンには、トークン使用量、モデル名、ツールの入出力、処理時間、プロンプトと応答のテキスト内容が含まれます。トレースされるデータの詳細については、GitHub の What Gets Traced を参照してください。

​
プラグインを設定する

インストール後にプラグインの設定を表示または更新するには、weave-claude-code config コマンドを使用します：
デフォルトでは、会話は Conversations タブにエージェント名 claude-code で表示されます。チームや project を区別する場合など、別の名前を使用するには agent_name を設定します。名前を空にすることはできません。また、前後の空白は自動的に削除されます。 環境変数は設定ファイルよりも優先されます:

​
Agent Lens スキル

インストール後は、Agent Lens 専用の 3 つのスキルをどの Claude Code セッションからでも直接使用できます。 weave:weave-config スキルを使用すると、Claude Code 内から Agent Lens の値を設定できます。

​
プラグインのステータスを確認する

プラグインのステータスの確認や問題のトラブルシューティングには、次の CLI コマンドを使用できます。
各行には ✓ (正常) 、✗ (対応が必要) 、- (まだ有効ではないがエラーではない) のいずれかが表示されます。 Agent Lens に会話が表示されない場合は、デーモンのログを確認してください。
ログをリアルタイムで表示するには、次のコマンドを実行します。
ログファイルは ~/.weave-claude-code/logs/daemon.log でも確認できます。

​
アンインストール

Claude Code からプラグインを削除するには、次のコマンドを実行します。
ログディレクトリを保持するには、--keep-logs を指定します。
最終更新日 2026年9月30日