Skip to content

Monitor ツール: バックグラウンドスクリプトからのイベントストリーミング

原文(日本語に翻訳)

バックグラウンドスクリプトからのイベントをストリーミングする Monitor ツールを追加しました。

原文(英語)

Added Monitor tool for streaming events from background scripts

概要

Claude Code v2.1.98 では、バックグラウンドで実行中のスクリプトやプロセスからリアルタイムでイベントをストリーミング受信できる Monitor ツールが追加されました。このツールを使うことで、Claude Code はバックグラウンドプロセスの出力を継続的に監視し、特定のイベントや条件が発生した際にそれに応じたアクションを実行できます。長時間実行されるビルドプロセス、テスト実行、デプロイメントの監視など、非同期処理の結果を待ちながら別の作業を進めるワークフローに特に有用です。

基本的な使い方

Monitor ツールは Claude Code の内部ツールとして提供されており、Claude がバックグラウンドプロセスの出力を監視する際に自動的に活用されます。

bash
# バックグラウンドでスクリプトを実行
./long-running-build.sh &

# Claude Code に監視を依頼
claude "ビルドプロセスを監視して、エラーが発生したら教えてください"

Claude は Monitor ツールを使ってプロセスの stdout/stderr をストリーミングし、リアルタイムで内容を解析します。

実践例

ビルドプロセスの監視

bash
# 大規模なビルドをバックグラウンドで開始
make build > /tmp/build.log 2>&1 &
BUILD_PID=$!

# Claude Code に監視を依頼
claude "PID $BUILD_PID のビルドプロセスを監視して、完了またはエラーを報告してください"

# Claude は Monitor ツールでログをストリーミングし、
# エラーパターンを検出したら即座に通知

テスト実行の継続監視

bash
# テストスイートをバックグラウンドで実行
npm test -- --watchAll > /tmp/test-output.log 2>&1 &

# Claude Code でテスト結果を監視
claude "テスト実行を監視して、失敗したテストがあれば原因を分析してください"

デプロイメントの進捗追跡

bash
# デプロイスクリプトをバックグラウンドで起動
./deploy.sh production > /tmp/deploy.log 2>&1 &

# Claude Code に監視と報告を依頼
claude "デプロイプロセスを監視して、各ステップの完了を報告し、問題があれば対処法を提案してください"

CI パイプラインのリアルタイム解析

bash
# CI の出力をファイルにリダイレクトしつつ監視
ci-runner --pipeline main.yml 2>&1 | tee /tmp/ci-output.log &

# Monitor ツールで CI の出力をストリーミング解析
claude "CI パイプラインの出力をリアルタイムで解析して、失敗の原因と修正方法を提案してください"

注意点

  • Monitor ツールは Claude Code v2.1.98 で新たに追加された内部ツールです
  • バックグラウンドプロセスからのイベントをリアルタイムでストリーミングするため、長時間実行されるプロセスの監視に適しています
  • ストリーミング中はネットワーク接続が継続して必要です
  • 大量のログを生成するプロセスを監視する場合、トークン消費量が増加する可能性があります
  • バックグラウンドスクリプトが標準出力または標準エラーに出力する形式である必要があります
  • run_in_background パラメータを持つ Bash ツールと組み合わせて使うことで、より効果的な非同期ワークフローが構築できます

関連情報