> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-sdk-testing-latest.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> W&B Weave を使用すると、Claude Code セッションのトレースを自動的に取得し、詳しく確認できます。これには、会話の各ターン、ツールの Call、サブエージェントとのやり取りが含まれます。

`weave-claude-plugin` は、[Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview) のコマンドライン インターフェース (CLI) 向けプラグインで、Claude Code セッションからトレースを自動的に取得して W\&B Weave に送信します。会話の各ターン、ツールの Call、サブエージェントとのやり取りは、コードやワークフローを変更することなく、すべて記録されます。これは、エージェントの動作のデバッグ、セッション履歴の監査、チーム全体での Claude Code の使用状況の監視に役立ちます。

<div id="prerequisites">
  ## 前提条件
</div>

プラグインをインストールする前に、以下を用意していることを確認してください。

* [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview) がインストールされていること。
* [Node.js](https://nodejs.org/) と `npm` がインストールされていること。
* 有効なAPIキーを持つW\&Bアカウント。APIキーを取得するには、[API keys](/ja/platform/app/settings-page/user-settings#api-keys)を参照してください。

<div id="wb-dedicated-cloud-and-self-managed-instances">
  ## W\&B 専用クラウドおよびセルフマネージド インスタンス
</div>

組織で W\&B Dedicated Cloud または W\&B Self-Managed を使用している場合、プラグインがトレースを送信するには、デプロイメントのベース URL が必要です。Claude Code を起動する前に、次のいずれかの方法でデプロイメントのベース URL を設定する必要があります。

* `WANDB_BASE_URL` 環境変数に、デプロイメントのベース URL を設定します。

```bash lines theme={null}
export WANDB_BASE_URL=https://your-instance.wandb.io
```

* `host` フラグを付けて `wandb login` コマンドを実行すると、ベース URL をセッションをまたいで保持できます。これにより、ホスト URL が `$HOME/.config/wandb/settings` に書き込まれ、環境変数を設定しなくても Weave クライアントが自動的に読み込みます。

```bash lines theme={null}
wandb login --host https://your-instance.wandb.io
```

`WANDB_BASE_URL` または `host` フラグを、プラグインのデーモンの起動後に変更する必要がある場合は、変更を反映するためにデーモンを再起動してください。

```bash lines theme={null}
printf '{"command":"shutdown"}' | nc -U -w1 ~/.weave_claude_plugin/daemon.sock
```

その後、Claude Code を再起動します。デーモンは更新後のベース URL で起動します。

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

CLI をグローバルにインストールし、その後インストーラーを一度実行します:

```bash lines theme={null}
npm install -g weave-claude-plugin
weave-claude-plugin install
```

インストーラーは `~/.weave_claude_plugin/settings.json` を作成し、Claude Code にプラグインを登録したうえで、Weave プロジェクト名と W\&B APIキーの入力を求めます。`install` を実行する前に、環境で `WEAVE_PROJECT` と `WANDB_API_KEY` が設定されている場合、インストーラーはそれらを使用するため、プロンプトでこれらの値を入力する必要はありません。完了したら、Claude Code を起動または再起動してください。プラグインは Claude Code CLI の起動時にバックグラウンドデーモンを開始し、トレースを Weave に送信します。

CI、ブートストラップスクリプト、またはプロンプトを表示してはいけないその他のオートメーションでは、`--non-interactive` フラグを設定してください。最初に環境変数を設定して、インストーラーが W\&B で認証し、Weave プロジェクトを設定できるようにしてから、インストーラーを実行します。インストーラーは同じ方法でプラグインを設定し、Claude Code を登録します。環境変数が設定されている場合はそれらを使用し、いずれかが不足している場合は警告を表示します:

```bash lines theme={null}
export WEAVE_PROJECT=[YOUR-TEAM-NAME/YOUR-PROJECT-NAME]
export WANDB_API_KEY=[YOUR-API-KEY]
weave-claude-plugin install --non-interactive
```

`[YOUR-TEAM-NAME/YOUR-PROJECT-NAME]` と `[YOUR-API-KEY]` を、ご自身の値に置き換えてください。

<div id="data-disclosure">
  ## データの開示
</div>

このプラグインは、Claude Code のセッションデータを Weave に送信します。このデータには、次のような機密性の高い内容が含まれる場合があります。

* ユーザーのプロンプトとモデルの応答。
* ツールへの入力とツールの出力。
* Claude Code のツールが読み取ったファイルパスとファイル内容。
* シェルコマンドとシェルの出力。
* 取得した URL と取得したページの内容。

セッション中に Claude Code がシークレット、認証情報、専有のソースコード、個人データ、またはその他の機密情報に触れた場合、その情報はトレースの一部として Weave にログされる可能性があります。

<Note>
  現在のプラグインでは、PII のスクラビングや機密データのマスキングは実装されていません。セキュリティ要件またはコンプライアンス要件上、この種のデータを Weave に送信できない場合は、プラグインをインストールまたは有効化しないでください。
</Note>

<div id="view-traces-in-weave">
  ## Weave でトレースを表示する
</div>

プラグインをインストールして Claude Code を実行したら、Weave プロジェクト の **Traces** タブを開いてトレースを表示します。各 Claude Code セッションは最上位のトレースとして表示され、その子エントリとして個々のターンとツールの Call が含まれます。各トレースには、token 使用量、モデル名、ツールの入力と出力、タイミング、さらにプロンプトと応答に関連付けられたテキスト内容が含まれます。

```text theme={null}
claude_code.session
  └─ claude_code.turn                          (ユーザーメッセージごとに1つ。)
       ├─ claude_code.tool.*                   (Read、Bash、Grep などの各ツール呼び出し。)
       │    └─ claude_code.permission_request  (ユーザーの承認が必要な場合。)
       └─ claude_code.subagent                 (Claude がサブエージェントを生成した場合。)
            └─ claude_code.tool.*
```

<div id="check-status-and-logs">
  ## ステータスとログを確認する
</div>

これらのコマンドを使用して、プラグインが実行中であることを確認し、問題のトラブルシューティングを行います。ステータスを確認して、デーモンがアクティブであり、Claude Code が登録されていることを確認してください。Weave にトレースが表示されない場合や、`status` に対応が必要と表示される場合は、ログを確認してください。

ターミナルで、次を実行します。

```bash lines theme={null}
weave-claude-plugin status
```

出力の各行には、次のいずれかのラベルが付きます。

* `OK`: トレースに必要なものはすべて設定されており、正常に動作しています。
* `Action needed`: 設定に問題があるか、必要なものが不足しています。詳細については、以下のようにデーモンのログを確認してください。
* `Not yet active`: エラーではありません。プラグインはまだアクティビティを記録していません。Claude Code セッションを開始または継続し、少し待ってからコマンドを再実行してください。

セッションが Weave に表示されない場合は、問題のデバッグに役立てるため、デーモンのログを確認できます。

```bash lines theme={null}
weave-claude-plugin logs
```

リアルタイムでログを確認するには:

```bash lines theme={null}
weave-claude-plugin logs --follow
```

`~/.weave_claude_plugin/logs/daemon.log` のログファイルを直接開くこともできます。

<div id="skills-in-claude-code">
  ## Claude Code のスキル
</div>

自動トレースに加えて、このプラグインには Claude Code セッション内から呼び出せるスキルが用意されています。プラグインをインストールすると、以下のスキルをどの Claude Code セッションでもスラッシュコマンドとして使用できます。Claude Code に組み込まれているスキルとの競合を避けるため、スキル名には `weave:weave-*` という命名規則を使用しています。

<div id="weaveweave-install">
  ### `/weave:weave-install`
</div>

インストールと設定をインタラクティブに案内します。新しいマシンで使用する場合や、セットアップの不具合を診断する場合に使ってください。Claude は CLI を確認し、インストーラーを実行して、不足している値の入力を促し、すべてが正しく動作することを検証します。

```text theme={null}
/weave:weave-install
```

<div id="weaveweave-status">
  ### `/weave:weave-status`
</div>

現在のプラグインのステータスを報告し、修正が必要な点を説明します。これは `weave-claude-plugin status` を実行するのと同等で、Claude がその出力を解釈してくれます。

```text theme={null}
/weave:weave-status
```

<div id="weaveweave-config">
  ### `/weave:weave-config`
</div>

Claude Codeを離れずに、プラグインの設定を確認または更新できます。

```text theme={null}
# 現在の設定を表示します。
/weave:weave-config

# 値を直接設定します。
/weave:weave-config set weave_project [YOUR-TEAM-NAME/YOUR-PROJECT-NAME]
/weave:weave-config set wandb_api_key [YOUR-API-KEY]
```

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

プラグインとその設定を削除するには、次の手順を実行します。

```bash lines theme={null}
weave-claude-plugin uninstall
```

これにより、設定ディレクトリが削除され、デーモンが停止されます。