Weave for Agents はパブリック プレビューです。一般提供前に、機能、API、Agents view UI は変更される可能性があります。
このプラグインは、Claude Code のセッションデータを Weave に送信します。このデータには、ユーザーのプロンプト、Claude の応答、ツールの入力と出力、Claude Code ツールが読み取ったファイルの内容、シェルコマンドとその出力、取得した URL とページの内容が含まれる場合があります。PII のスクラビングと機密データのマスク処理は実装されていません。セキュリティ要件またはコンプライアンス要件のためにこのデータを Weave に送信できない場合は、このプラグインをインストールしないでください。
- Node.js v18 以降 (
npm を含む) 。
- Claude Code がインストール済みで、認証されていること。
- W&B アカウントを持ち、APIキー が
WANDB_API_KEY 環境変数として設定されていること。
- トレースの送信先となる 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 project (
[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 を起動します
この時点から、プラグインはセッションを自動的にトレースします。いくつかプロンプトを実行したら、Weave project を開いてトレースが表示されることを確認してください。 Weave で Claude Code のトレースを表示する
- https://wandb.ai にアクセスし、project を選択します。
- サイドバーメニューで Agents を選択して、project に保存されているすべてのエージェントとの会話を表示します。
- 会話を選択して、セッションツリー全体を確認します。
Agents ビューの詳細については、エージェントアクティビティを表示する を参照してください。
各ユーザーのプロンプトごとに、GenAI semantic conventions に従った 1 つの OTEL トレースが生成されます。トレースには、ターン の階層全体が表示されます。
invoke_agent claude-code (ルート。ユーザープロンプトごとに1つのトレース。)
├─ chat <model> (ターン内の各LLM呼び出し。)
├─ 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 によって関連付けられるため、複数のトレースにまたがって会話全体を追跡できます。各スパンには、トークン使用量、モデル名、tool の入力と出力、タイミング、およびプロンプトと応答のテキスト内容が含まれます。トレースされるデータの詳細については、GitHub の What Gets Traced を参照してください。
インストール後は、weave-claude-code config コマンドを使用してプラグインの設定を表示または更新できます:
# Show all current settings.
weave-claude-code config show
# Set your Weave project.
weave-claude-code config set weave_project [YOUR-TEAM]/[YOUR-PROJECT]
# Set your W&B API key.
weave-claude-code config set wandb_api_key [YOUR-API-KEY]
# (省略可能) Agents ビューに表示されるエージェント名をカスタマイズします。
weave-claude-code config set agent_name [YOUR-AGENT-NAME]
claude-code の下に表示されます。チームや project を区別するためなど、別の名を使用するには agent_name を設定します。名は空にできず、前後の空白は削除されます。
環境変数は settings file より優先されます。
export WEAVE_PROJECT=[YOUR-TEAM]/[YOUR-PROJECT]
export WANDB_API_KEY=[YOUR-API-KEY]
export WEAVE_AGENT_NAME=[YOUR-AGENT-NAME]
| Skill | Command | Description |
|---|
| Install | /weave:weave-install | インタラクティブに、インストールと設定の手順を順を追って案内します。新しいマシンでの使用時や、壊れたセットアップの診断に使用してください。 |
| Status | /weave:weave-status | 現在のプラグインのステータスを確認し、問題があればその内容を説明します。weave-claude-code status を実行するのと同等ですが、Claude が出力を解釈して、修正すべき内容を教えてくれます。 |
| Config | /weave:weave-config | Claude Code を離れることなく、プラグインの設定を確認または更新できます。 |
weave:weave-config スキルを使用できます。
/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]
✓ (OK) 、✗ (要対応) 、または - (まだ有効ではありませんが、エラーではありません) が表示されます。
Weave にセッションが表示されない場合は、デーモン ログを確認してください。
ログをリアルタイムで確認するには:
weave-claude-code logs --follow
~/.weave-claude-code/logs/daemon.log にもあります。
W&B 専用クラウドまたはセルフホスト インスタンス
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 を指定します。
