結論: Claude Code Monitorはバックグラウンドプロセスの標準出力をリアルタイムで監視し、イベント発生時のみClaudeが反応するイベント駆動型ツールです。Auto Mode（Maxプラン）との組み合わせで、企業の常時稼働AIワークフローが実現します。
この記事の要点:
- 要点1: Monitorはポーリング（定期確認）をやめてイベント駆動に切り替えるツール。沈黙中はトークンを消費しない設計
- 要点2: v2.1.111からMaxプランでOpus 4.7のAuto Modeが利用可能。全確認なしで長時間タスクを完遂できる
- 要点3: xhigh effortはhighとmaxの中間の新しい思考レベル。Opus 4.7ではこれがデフォルトになった
対象読者: CI/CDパイプラインの監視・開発サーバーの管理をしているエンジニア、Maxプランで本格的な自動化ワークフローを構築したい開発チーム
読了後にできること: Monitorツールでdev serverのエラーをリアルタイム検知するワークフローを今日から設定できる
「Claude Codeにバックグラウンドで動いているプロセスを見てもらいたいんだけど、どうしたらいい？」
この質問、実は結構難しかったんです。従来のアプローチだと、/loopで定期的にログを確認するプロンプトを設定するか、手動でログをコピーして貼り付けるかしかありませんでした。どちらもリアルタイム性に欠けるか、手間がかかります。
先日、顧問先のWebサービス企業で本番デプロイ後にエラーレートが上昇したケースがありました。エンジニアがログを1分おきに手動確認していて、発見が10分遅れたのです。「これをClaudeに自動で見てもらえたら」という話になりました。
Monitorツールはまさにそのニーズのために設計されています。v2.1.111で追加されたこのツール（正確にはv2.1.98でリリース）は、Claude Codeが「リクエスト-レスポンス型」から「イベント駆動型」に移行する第一歩です。
この記事では、MonitorツールとAuto Modeの仕様から、企業での常時稼働ワークフロー設計まで、実践プロンプト付きで解説します。
まず試したい：Monitor起動の即効パターン3選
研修でMonitorを紹介するとき、まず3つのシンプルなパターンから始めます。実際にターミナルで動かしてみると「あ、これは便利だ」という反応が多いです。
即効パターン1：dev serverのエラー検知
# Next.js dev serverを監視してコンパイルエラーを即検知
# Monitorツールをこの形で呼び出すよう指示
"monitor the Next.js dev server at http://localhost:3000 and react when you see
compilation errors or unhandled exceptions in the console output.
When you detect an error, identify the root cause and suggest a fix.
不足している情報があれば、最初に質問してから作業を開始してください。"
内部的には以下のシェルコマンドが走ります：
npm run dev 2>&1 | grep --line-buffered "ERROR|error|failed|FAILED"
エラーが発生した瞬間にその行がClaudeのセッションに届き、反応が始まります。エラーがない時間帯はトークンを消費しません。
即効パターン2：テスト結果の監視
pytest tests/ > /tmp/test.log 2>&1 &
tail -f /tmp/test.log | grep --line-buffered -m 1 "passed|failed|error"
テストスイートが完了した瞬間に結果が届き、failしたテストがあれば原因特定と修正提案が自動で始まります。
即効パターン3：ログファイルの異常検知
tail -f /var/log/nginx/error.log | grep --line-buffered "crit|alert|emerg"
nginxのクリティカルエラーのみをフィルターしてClaudeに届けます。500エラーが頻発し始めたとき、即座に反応して原因調査を始めます。
Monitorツールの仕様：4つのパラメータを理解する
MonitorツールはClaude Code v2.1.98以降に実装された機能で、4つのパラメータで動作します。AIエージェントの動作原理についてはAIエージェント導入完全ガイドも参考にしてください。
| パラメータ | 役割 | 注意点 |
|---|---|---|
description | 通知に表示されるラベル | 何を監視しているか分かる名前をつける |
command | イベントストリームを生成するシェルスクリプト | stdoutの各行がイベントになる |
timeout_ms | 監視の自動停止時間（デフォルト5分、最大1時間） | 長時間監視はpersistentと組み合わせる |
persistent | セッション全体で実行し続けるか（true/false） | trueにするとセッション終了まで監視継続 |
重要な技術的詳細
200ms以内に到達した複数の行は単一通知にまとめられる自動バッチング機能があります。ログが大量に流れる瞬間でも、Claudeへの通知が無駄に多くならないよう設計されています。
grep --line-bufferedを必ず使うことが推奨されています。通常のgrepはバッファリングの関係で遅延が発生しますが、--line-bufferedオプションで即座にstdoutに流れます。
イベント駆動 vs ポーリング：なぜMonitorが優れているか
従来のポーリングアプローチとMonitorの違いを整理します。
ポーリング（従来の/loop方式）
# 1分ごとにログを確認する例
/loop --interval 60 "tail -n 50 /var/log/app.log を確認してエラーがあれば報告"
問題点: エラーが30秒後に発生しても、次の確認まで30秒待つ。毎分トークンを消費する（エラーがなくても）。1時間で60回のAPI呼び出しが発生。
イベント駆動（Monitor方式）
tail -f /var/log/app.log | grep --line-buffered "ERROR|CRITICAL"
優位点: エラー発生の瞬間（数秒以内）に反応。沈黙中はトークンゼロ。エラー頻度が月1回でも常に最速で検知できる。
| 指標 | ポーリング（1分間隔） | Monitor（イベント駆動） |
|---|---|---|
| 最大検知遅延 | 60秒 | 1〜3秒 |
| 無イベント時のコスト | 毎分トークン消費 | ほぼゼロ |
| 8時間連続稼働コスト目安 | 高（480回呼び出し） | 低（イベント数×回） |
| 適するケース | 定型的な日次/週次タスク | リアルタイム監視・異常検知 |
Auto Mode：Max向けの完全自律ワークフロー
MonitorとセットになるAuto Modeについて解説します。
v2.1.111（2026年4月16日）から、MaxプランでOpus 4.7を使用している場合にAuto Modeが利用可能になりました。さらに、--enable-auto-modeフラグが不要になりました。
Auto Modeとは何か
通常のClaude Codeは、ファイルの編集やコマンドの実行などの操作前に確認を求めます。Auto Modeはこの確認プロセスを安全性クラシファイアに委ねることで、Claudeが自律的に判断して作業を進められます。
正直に言うと、「全部自動」と聞くと怖さを感じる人も多いです。研修先でもそういう反応がよくあります。でも実際には、安全性クラシファイアが「これはやっていいか」を判断していて、明示的に「やらないで」と言った操作は拒否されます。
Auto Modeの設定
# ~/.claude/settings.json での設定例
{
"autoMode": {
"allow": [
"$defaults",
"npm run build",
"pytest tests/"
],
"soft_deny": [
"git push --force",
"rm -rf"
],
"environment": {
"$defaults": true,
"RAILS_ENV": "test"
}
}
}
# $defaults を含めると組み込みのデフォルトルールを保持しながら
# カスタムルールを追加できる（v2.1.118以降）
xhigh effort：highとmaxの中間の思考レベル
Opus 4.7で追加されたxhigh effortは、highとmaxの間の新しいレベルです。
| effortレベル | 推論の深さ | レイテンシ | デフォルト |
|---|---|---|---|
| low | 最小限 | 最速 | |
| medium | 標準 | 普通 | |
| high | 深め | やや遅い | Opus 4.6・Sonnet 4.6 |
| xhigh | より深め | 高め | Opus 4.7 |
| max | 最大 | 最遅 |
xhigh effortのポイントは「高品質な判断が必要だが、maxほどの時間は使いたくない」というケースに最適であることです。Auto Modeで複雑なコードの変更判断をする際、xhigh effortがデフォルトになったのは理にかなっています。
Monitor + Auto Mode の組み合わせパターン
この2つを組み合わせると、完全自律の常時稼働ワークフローが実現します。
パターン1：本番エラーの自動修正ループ
# 本番ログ監視 → エラー検知 → 自動修正 → PRの流れ
"以下の作業をAuto Modeで実行してください:
1. /var/log/app.log を監視してCRITICALエラーを検知する
2. エラーを検知したらスタックトレースを分析して根本原因を特定する
3. 修正コードを作成してテストを実行する
4. テストがパスしたらgit commitしてgit pushする（本番ブランチへのpushは除く）
不足している情報があれば、最初に質問してから作業を開始してください。
仮定した点は必ず"仮定"と明記してください。"
パターン2：CI/CDパイプラインの自己修復
# GitHub Actionsのfailを監視して自動修正
while true; do
gh api repos/owner/repo/actions/runs
--jq '.workflow_runs[] | select(.conclusion=="failure") | .id'
sleep 30
done
# このコマンドをMonitorに設定し、CI failを検知したら：
# - ログを分析
# - 修正を実装
# - /autofix-pr でPRを更新
パターン3：dev環境の常時ヘルスチェック
# 3つのバックグラウンドプロセスを並列監視
# Process 1: Next.js dev server
npm run dev > /tmp/nextjs.log 2>&1 &
# Process 2: データベース接続確認
while true; do pg_isready -h localhost; sleep 10; done > /tmp/db.log 2>&1 &
# Process 3: Redis接続確認
while true; do redis-cli ping; sleep 10; done > /tmp/redis.log 2>&1 &
# Monitorでまとめて監視
tail -f /tmp/nextjs.log /tmp/db.log /tmp/redis.log |
grep --line-buffered "ERROR|FAILED|not running"
企業の常時稼働ワークフロー設計：3段階アーキテクチャ
> 事例区分: 想定シナリオ
> 以下は100社以上のAI研修・コンサル経験をもとに構成した典型的なシナリオです。
企業でMonitor + Auto Modeを本格導入する際の3段階アーキテクチャを提案します。
Stage 1：異常検知（Monitor）
- 本番ログの重篤エラー（CRITICAL・FATAL）の即時検知
- CI/CDパイプラインの失敗検知
- 外部APIのレイテンシ超過検知
Stage 2：自律診断（Auto Mode + xhigh effort）
- スタックトレースの分析
- 関連コードの特定
- 根本原因の推定
Stage 3：修正実行（/autofix-pr）
- 修正コードの作成
- テストの実行・パス確認
- PRの作成・CI/CDの修正
このフローが完成すると、夜間のインシデント対応をClaude Codeが一次対応するワークフローが実現します。人間は朝出社時にPRとインシデントレポートを確認するだけです。
【要注意】Monitor + Auto Mode の失敗パターン
失敗1：grep –line-bufferedを忘れる
❌ tail -f app.log | grep "ERROR"
⭕ tail -f app.log | grep --line-buffered "ERROR"
--line-bufferedなしではgrepがバッファリングして遅延が発生します。数十秒〜数分のラグが生まれ、「なんでリアルタイムじゃないの？」という状況になります。
失敗2：Auto Modeのスコープを広げすぎる
❌ 本番データベースへの書き込みをAutoModeのallowに追加する
⭕ 本番DBへの書き込みは必ずhuman approvalを挟む設計にする
Auto ModeのallowリストはClaude Codeが確認なしで実行できる操作のリストです。本番環境への影響が大きい操作（DB write・本番へのdeploy・メール送信）は必ず除外してください。
失敗3：too many eventsで監視が止まる
❌ エラーが頻発する既知の問題があるログを無加工で監視する
⭕ 既知の問題はフィルタリングしてから監視対象にする
過剰なイベントが発生すると監視が自動停止されることがあります。監視コマンドにgrepフィルターを入れて、本当に重要なイベントだけを流す設計が重要です。
失敗4：timeout_msの設定ミス
❌ 長時間デプロイを監視するのにデフォルト5分（300,000ms）で設定する
⭕ デプロイ時間の見積もりに応じてtimeout_msを最大3,600,000ms（1時間）まで設定する
# 最大1時間の監視設定例
timeout 3600 tail -f /tmp/deploy.log | grep --line-buffered "SUCCESS|FAILED|ERROR"
コスト最適化：MonitorとAuto Modeのトークン消費
企業でAuto Modeを本格活用する前に、トークン消費の見積もりが重要です。
| ケース | 消費パターン | 目安（1日） |
|---|---|---|
| Monitor（無イベント） | ほぼゼロ | 〜0 |
| Monitor（小規模エラー×5回） | エラー検知×5＋応答 | 5,000〜15,000 tokens |
| Auto Mode（複雑なリファクタ） | xhigh effortで多段推論 | 50,000〜200,000 tokens |
| Monitor + Auto Mode（フル自動修正） | 検知→診断→修正の全フロー | 状況依存。上限設定推奨 |
Enterprise向けのTask Budgetがベータ公開されています。長時間タスクでのトークン上限を設定できるため、課金サプライズを防げます。
# Task Budgetの設定例（public beta）
# 最大200,000トークンまでの自律タスク
"最大200,000トークン以内でこのリファクタリングを完了してください。
予算の80%を超えたら進捗を報告して次のステップを確認してください。"
参考・出典
- Changelog — Claude Code Docs（参照日: 2026-04-19）
- What Is the Claude Code Monitor Tool? — MindStudio（参照日: 2026-04-19）
- Claude Code Monitor Tool: Stop Polling, Start Reacting — claudefa.st（参照日: 2026-04-19）
- Claude Code New Feature Launch: Monitor Tool Released — AIBase（参照日: 2026-04-19）
- Introducing Claude Opus 4.7 — Anthropic（参照日: 2026-04-19）
まとめ：今日から始める3つのアクション
- 今日やること: dev serverのログにMonitorを設定してみる。
tail -f app.log | grep --line-buffered "ERROR"から始めると確実 - 今週中: CI/CDパイプラインのfail検知をMonitorで設定し、Auto Modeで一次対応を自動化する
- 今月中: Task Budgetを設定した上でAuto Modeのフル活用スコープを定め、チームのワークフローに組み込む
次回予告: 次の記事では「Claude Code プロンプトキャッシュ1時間TTL」をテーマに、APIコスト最適化と67%高速なセッション再開の設定方法を解説します。
著者: 佐藤傑（さとう・すぐる）
株式会社Uravation代表取締役。X（@SuguruKun_ai）フォロワー約10万人。100社以上の企業向けAI研修・導入支援。著書『AIエージェント仕事術』（SBクリエイティブ）。SoftBank IT連載7回執筆（NewsPicks最大1,125ピックス）。
ご質問・ご相談は お問い合わせフォーム からお気軽にどうぞ。
