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

​
前提条件

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

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

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

CLI をインストールする

このプラグインは、Weave ガイドで説明している weave-claude-code プラグインとは別のものです。このプラグインの CLI は forge-agent-lens-for-claude-code で、スキルには forge という名前が使われます。weave-claude-code または以前の @coreweave/forge-claude-code パッケージをインストール済みの場合は、トレースが重複して送信されないよう、このプラグインをインストールする前にアンインストールしてください。
どちらのパッケージの設定も引き継がれません。インストーラーから入力を求められたら、project と APIキーを改めて設定してください。プラグインの環境変数を設定している場合は、WEAVE_PROJECT を FORGE_TRACE_PROJECT に、WEAVE_AGENT_NAME を FORGE_CLAUDE_CODE_AGENT_NAME にリネームしてください。
2

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

インストーラーは次の処理を行います。
  • ~/.forge-agent-lens-for-claude-code/settings.json を作成します。
  • Claude Code にプラグインを登録します。
  • Agent Lens の project ([YOUR-TEAM]/[YOUR-PROJECT]) と Forge API キーが未設定の場合は、入力を求めます。
CI、ブートストラップスクリプト、その他の自動化システムで入力プロンプトを省略するには、実行前に環境変数を設定します。
非対話型モードでも、インストーラーは設定ファイルを作成し、プラグインを登録します。環境変数の FORGE_TRACE_PROJECT と WANDB_API_KEY を使用し、いずれかが未設定の場合は警告を表示します。これらの値は settings.json には書き込まれません。デフォルトでは、インストーラーは GitHub からプラグインを登録します。CI システムやコンテナーから GitHub にアクセスできない場合は、--source=local を指定すると、前のステップでインストールした npm パッケージからプラグインを登録できます。
3

Claude Code を起動する

Claude Code がすでに起動している場合は、代わりにそのセッションで /reload-plugins を実行してください。以降、プラグインがセッションを自動的にトレースします。特定の project 内のセッションに限らず、このマシン上のすべての Claude Code セッションがトレース対象になります。

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

​
プラグインを設定する

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

​
Agent Lens スキル

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

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

以下の CLI コマンドを使用して、プラグインのステータスを確認したり、問題のトラブルシューティングを行ったりできます。
各行には ✓ (OK) 、✗ (対応が必要) 、- (まだ有効ではないが、エラーではない) のいずれかが表示されます。 Agent Lens に会話が表示されない場合は、次のコマンドを実行して、デーモンログの末尾 50 行を出力してください。
さらに多くの行を表示するには、--tail オプションに行数を指定します。
ログをリアルタイムで監視するには、次のコマンドを実行します。
ログファイルは ~/.forge-agent-lens-for-claude-code/logs/daemon.log にも保存されています。 問題の診断時にデーモンのより詳細な出力を確認するには、デバッグモードを有効にします。
現在のシェルセッションに限ってデバッグモードを有効にする場合は、代わりに FORGE_CLAUDE_CODE_DEBUG=1 を設定してください。

​
アンインストール

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