> ## 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 のセッションを W&B Weave でトラッキングし、可観測性の向上とデバッグに役立てます。

export const AgentLensBanner = ({href}) => <Tip>
    <strong>This workflow is also available in CoreWeave Agent Lens.</strong> Agent Lens is the Forge experience built for tracing, monitoring, and analyzing AI agents, with automated insights into agent failures and user intents. It uses the same trace data as Weights & Biases Weave, so the traces you already send appear there with nothing to migrate.{' '}
    <a href={href || '/products/agent-lens'}>{href ? 'See how to do this in Agent Lens' : 'Learn about Agent Lens'}</a>.
  </Tip>;

<AgentLensBanner href="/ja/products/agent-lens/integrations/claude-code" />

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

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

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

  PII の除去や機密データのマスキングは実装されていません。セキュリティ要件やコンプライアンス要件により、このデータを Weave に送信できない場合は、このプラグインをインストールしないでください。
</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)。
* トレースの送信先となる Weave プロジェクト (`[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 にプラグインを登録します。
    * Weave プロジェクト (`[YOUR-TEAM]/[YOUR-PROJECT]`) と W\&B 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
    ```

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

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

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

1. [Forge](https://forge.coreweave.com/wandb) にアクセスし、project を選択します。
2. サイドバーメニューで **Agents** を選択します。
3. **Conversations** タブを選択すると、project に保存されたすべてのエージェントの会話が表示されます。
4. 会話を選択すると、会話ツリー全体を確認できます。

Agents ビューの詳細については、[エージェントのアクティビティを表示する](/ja/products/wandb/weave/guides/tracking/view-agent-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]

# 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` を設定します。名前を空にすることはできません。また、前後の空白は自動的に削除されます。

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

```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="weave-skills">
  Weave スキル
</h2>

インストール後は、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 の値を設定できます。

```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
```

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

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

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

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

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

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

<h3 id="wb-dedicated-cloud-or-self-hosted-instances">
  W\&B 専用クラウドまたはセルフホストインスタンス
</h3>

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

```bash lines theme={"system"}
export WANDB_BASE_URL=https://[YOUR-INSTANCE].wandb.io
```

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

1. デーモンを停止します。
   ```bash lines theme={"system"}
   printf '{"command":"shutdown"}' | nc -U -w1 ~/.weave-claude-code/daemon.sock
   ```
2. `WANDB_BASE_URL` を設定します。または、`wandb login --host https://[YOUR-INSTANCE].wandb.io` を実行すると、この設定がセッションをまたいで保持されます。
3. Claude Code を再起動します。デーモンが自動的に再起動し、正しい URL を使用します。

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

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

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

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


## Related topics

- [エージェント統合を選択](/ja/products/wandb/weave/agent-integration-quickstart.md)