Claude Code プラグイン

Weave Claude Code プラグインは、すべての Claude Code セッションを自動的にトレースし、構造化されたデータを W&B Weave に送信します。コードを変更する必要はなく、すべてのターン、ツール呼び出し、サブエージェントがログされます。これらのトレースを使用して、セッションのデバッグやツールの使用状況の監査を行ったり、複数の run にわたるコストとレイテンシーを監視したりできます。このガイドでは、プラグインのインストール、Weave での Claude Code トレースの表示、プラグインの設定、およびライフサイクルの管理方法について説明します。

このプラグインは Claude Code のセッションデータを Weave に送信します。このデータには、ユーザープロンプト、Claude の応答、ツールの入力と出力、Claude Code のツールが読み取ったファイルの内容、シェルコマンドとその出力、取得した URL とページの内容が含まれる場合があります。PII の除去や機密データのマスキングは実装されていません。セキュリティ要件やコンプライアンス要件により、このデータを Weave に送信できない場合は、このプラグインをインストールしないでください。

前提条件

Node.js v18 以降 (npm を含む) 。
Claude Code がインストールされ、認証が完了していること。
CoreWeave Forge アカウントと、WANDB_API_KEY 環境変数に設定した APIキー。
トレースの送信先となる Weave プロジェクト ([YOUR-TEAM]/[YOUR-PROJECT]) 。

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

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

CLI をインストールする

npm install -g weave-claude-code

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

weave-claude-code install

インストーラーは次の処理を行います。

~/.weave-claude-code/settings.json を作成します。
Claude Code にプラグインを登録します。
Weave プロジェクト ([YOUR-TEAM]/[YOUR-PROJECT]) と W&B APIキーがまだ設定されていない場合は、入力を求めます。

CI、ブートストラップスクリプト、その他の自動化システムで入力を求められないようにするには、実行前に環境変数を設定します。

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

非対話モードでも、インストーラーは設定ファイルを作成し、プラグインを登録します。その際、環境変数の WEAVE_PROJECT と WANDB_API_KEY を使用し、どちらかが設定されていない場合は警告を表示します。

Claude Code を起動する

claude

これ以降、プラグインはセッションを自動的にトレースします。プロンプトをいくつか実行してから Weave プロジェクトを開くと、トレースが表示されていることを確認できます。

Weave で Claude Code のトレースを表示する

Claude Code のセッションを 1 回以上実行したら、Weights & Biases UI で project を開きます。

Forge にアクセスし、project を選択します。
サイドバーメニューで Agents を選択します。
Conversations タブを選択すると、project に保存されたすべてのエージェントの会話が表示されます。
会話を選択すると、会話ツリー全体を確認できます。

Agents ビューの詳細については、エージェントのアクティビティを表示するを参照してください。ユーザープロンプトごとに、GenAI セマンティック規約に準拠した OTEL トレースが 1 つ生成されます。トレースには、次のようにターンの階層全体が表示されます。

invoke_agent claude-code               （ルート。ユーザー プロンプトごとに 1 つのトレース）
├─ chat <model>                        （ターン内の各 LLM Call）
├─ execute_tool <tool_name>            （Read、Bash、Grep などの各ツール呼び出し）
└─ invoke_agent <subagent_type>        （Agent ツール経由で呼び出されたサブエージェント）
   ├─ chat <model>
   └─ execute_tool <tool_name>

ルートの invoke_agent claude-code スパンには最上位のエージェント名が使用されます。デフォルトは claude-code です。この名前は agent_name 設定または WEAVE_AGENT_NAME 環境変数で変更できます (プラグインを設定するを参照してください) 。サブエージェントには、それぞれ独自のタイプ名がそのまま使用されます。マルチターンの会話はサーバー側で会話 ID によって関連付けられるため、複数のトレースにまたがって会話を追跡できます。各スパンには、トークン使用量、モデル名、ツールの入力と出力、処理時間、プロンプトと応答のテキスト内容が含まれます。トレースされるデータの詳細については、GitHub の What Gets Traced を参照してください。

プラグインを設定する

インストール後にプラグインの設定を表示または更新するには、weave-claude-code config コマンドを使用します：

# 現在のすべての設定を表示します。
weave-claude-code config show

# Weave プロジェクトを設定します。
weave-claude-code config set weave_project [YOUR-TEAM]/[YOUR-PROJECT]

# W&B APIキーを設定します。
weave-claude-code config set wandb_api_key [YOUR-API-KEY]

# （オプション）Agents ビューに表示されるエージェント名を変更します。
weave-claude-code config set agent_name [YOUR-AGENT-NAME]

デフォルトでは、会話は Agents ビューにエージェント名 claude-code で表示されます。チームや project を区別する場合など、別の名前を使用するには agent_name を設定します。名前を空にすることはできません。また、前後の空白は自動的に削除されます。環境変数は設定ファイルよりも優先されます。

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

Weave スキル

インストール後は、Weave 専用の 3 つのスキルを任意の Claude Code セッション内で直接使用できます。

スキル	コマンド	説明
Install	`/weave:weave-install`	インストールと設定の手順をインタラクティブに案内します。新しいマシンでのセットアップや、正常に動作しないセットアップの診断に使用します。
Status	`/weave:weave-status`	プラグインの現在のステータスを確認し、問題があればその内容を説明します。`weave-claude-code status` の実行と同等ですが、Claude が出力を解釈し、修正すべき点を教えてくれます。
Config	`/weave:weave-config`	Claude Code を離れずに、プラグインの設定を確認または更新します。

weave:weave-config スキルを使用すると、Claude Code 内から Weave の値を設定できます。

/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]

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

プラグインのステータスの確認や問題のトラブルシューティングには、次の CLI コマンドを使用できます。

weave-claude-code status

各行には ✓ (OK) 、✗ (対応が必要) 、- (まだ有効になっていないがエラーではない) のいずれかが表示されます。 Weave に会話が表示されない場合は、デーモンのログを確認してください。

weave-claude-code logs

ログをリアルタイムで監視するには、次のコマンドを実行します。

weave-claude-code logs --follow

ログファイルは ~/.weave-claude-code/logs/daemon.log でも確認できます。

W&B 専用クラウドまたはセルフホストインスタンス

W&B 専用クラウドまたはセルフホストインスタンスを使用している場合は、Claude Code を起動する前に WANDB_BASE_URL を設定してください。

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

このプラグインはバックグラウンドでデーモンを実行し、デーモンは起動時に WANDB_BASE_URL を読み取ります。変数を設定した時点でデーモンがすでに実行中の場合、変更は検出されません。デーモンを再起動するには、次の手順を実行します。

デーモンを停止します。

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

WANDB_BASE_URL を設定します。または、wandb login --host https://[YOUR-INSTANCE].wandb.io を実行すると、この設定がセッションをまたいで保持されます。
Claude Code を再起動します。デーモンが自動的に再起動し、正しい URL を使用します。

アンインストール

Claude Code からプラグインを削除するには、次のコマンドを実行します。

weave-claude-code uninstall

ログディレクトリを残すには、--keep-logs を指定します。

​前提条件

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

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

​プラグインを設定する

​Weave スキル

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

​W&B 専用クラウドまたはセルフホストインスタンス

​アンインストール