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

# Claude Code プラグイン

> Claude Code のセッションを Agent Lens でトラッキングし、可観測性の向上とデバッグに役立てます。

Claude Code 向けの Weave プラグインは、すべての Claude Code セッションを自動的にトレースし、構造化データを Agent Lens に送信します。コードを変更しなくても、すべてのターン、ツール呼び出し、サブエージェントがログされます。これらのトレースを使用すると、セッションのデバッグ、ツールの使用状況の監査、run 全体にわたるコストとレイテンシーの監視を行えます。

このガイドでは、プラグインのインストール方法、Agent Lens で Claude Code のトレースを表示する方法、プラグインの設定方法、およびライフサイクルの管理方法について説明します。

<Note>
  これは Weights & Biases の Weave プラグインです。CoreWeave Forge 版はまだ提供されていません。Agent Lens と Weave は同じトレースデータを共有しているため、このプラグインが送信したトレースは Agent Lens に表示されます。
</Note>

<Warning>
  このプラグインは Claude Code のセッションデータを Agent Lens に送信します。このデータには、ユーザー プロンプト、Claude の応答、ツールの入力と出力、Claude Code のツールが読み取ったファイルの内容、シェルコマンドとその出力、取得した URL とページの内容が含まれる場合があります。

  PII のスクラビングや機密データのマスキングには対応していません。セキュリティ要件やコンプライアンス要件により、このデータを Agent Lens に送信できない場合は、このプラグインをインストールしないでください。
</Warning>

<h2 id="prerequisites">
  前提条件
</h2>

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

<h2 id="install-the-plugin">
  プラグインをインストールする
</h2>

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

<Steps>
  <Step title="CLI をインストールする">
    ```bash lines theme={"system"}
    npm install -g weave-claude-code
    ```
  </Step>

  <Step title="インストーラーを実行する">
    ```bash lines theme={"system"}
    weave-claude-code install
    ```

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

    * `~/.weave-claude-code/settings.json` を作成します。
    * Claude Code にプラグインを登録します。
    * Agent Lens の project (`[YOUR-TEAM]/[YOUR-PROJECT]`) と Forge の APIキーが未設定の場合は、入力を求めます。

    CI、ブートストラップスクリプト、その他の自動化システムで入力プロンプトをスキップするには、実行前に環境変数を設定します。

    ```bash lines theme={"system"}
    WEAVE_PROJECT=[YOUR-TEAM]/[YOUR-PROJECT] \
    WANDB_API_KEY=[YOUR-API-KEY] \
    weave-claude-code install --non-interactive
    ```

    非対話モードでも、インストーラーは設定ファイルの作成とプラグインの登録を行います。`WEAVE_PROJECT` と `WANDB_API_KEY` は環境変数から読み取られ、いずれかが設定されていない場合は警告が表示されます。
  </Step>

  <Step title="Claude Code を起動する">
    ```bash lines theme={"system"}
    claude
    ```

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

<h2 id="view-claude-code-traces-in-agent-lens">
  Agent Lens で Claude Code のトレースを表示する
</h2>

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

1. [CoreWeave Forge](https://forge.coreweave.com) にアクセスし、プロダクト メニューから Agent Lens を選択します。次に、サイド メニュー上部の project セレクターで対象の project を選択します。
2. サイド メニューで **Conversations** を選択します。
3. **Conversations** タブを選択すると、project に保存されているエージェントの会話がすべて表示されます。
4. 会話を選択すると、会話ツリー全体を確認できます。

Conversation タブの詳細については、[エージェントのアクティビティを表示する](/ja/products/agent-lens/conversations/view-activity)を参照してください。

ユーザー プロンプトごとに、[GenAI セマンティック規約](https://opentelemetry.io/docs/specs/semconv/gen-ai/)に準拠した OTEL トレースが 1 つ生成されます。トレースには、ターンの階層全体が表示されます。

```text theme={"system"}
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` 環境変数で変更できます ([プラグインを設定する](#configure-the-plugin)を参照してください) 。サブエージェントには、それぞれ独自のタイプ名がそのまま使用されます。

マルチターンの会話はサーバー側で会話 ID によって関連付けられるため、複数のトレースにまたがって会話を追跡できます。各スパンには、トークン使用量、モデル名、ツールの入出力、処理時間、プロンプトと応答のテキスト内容が含まれます。トレースされるデータの詳細については、GitHub の [What Gets Traced](https://github.com/wandb/weave-claude-code/blob/main/README.md#what-gets-traced) を参照してください。

<h2 id="configure-the-plugin">
  プラグインを設定する
</h2>

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

```bash lines theme={"system"}
# 現在のすべての設定を表示します。
weave-claude-code config show

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

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

# (オプション) Conversations タブに表示されるエージェント名を変更します。
weave-claude-code config set agent_name [YOUR-AGENT-NAME]
```

デフォルトでは、会話は Conversations タブにエージェント名 `claude-code` で表示されます。チームや project を区別する場合など、別の名前を使用するには `agent_name` を設定します。名前を空にすることはできません。また、前後の空白は自動的に削除されます。

環境変数は設定ファイルよりも優先されます:

```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="agent-lens-skills">
  Agent Lens スキル
</h2>

インストール後は、Agent Lens 専用の 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 内から Agent Lens の値を設定できます。

```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">
  プラグインのステータスを確認する
</h2>

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

```bash lines theme={"system"}
weave-claude-code status
```

各行には `✓` (正常) 、`✗` (対応が必要) 、`-` (まだ有効ではないがエラーではない) のいずれかが表示されます。

Agent Lens に会話が表示されない場合は、デーモンのログを確認してください。

```bash lines theme={"system"}
weave-claude-code logs
```

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

```bash lines theme={"system"}
weave-claude-code logs --follow
```

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

<h2 id="uninstall">
  アンインストール
</h2>

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

```bash lines theme={"system"}
weave-claude-code uninstall
```

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