AI Navigate

同時に5つの Claude Code エージェントを実行してみた。彼らが何をしているのか全く分からなかった。

Dev.to / 2026/3/19

💬 オピニオンDeveloper Stack & InfrastructureTools & Practical Usage

要点

  • Claude Code は多数のエージェントを実行できることを解説しているが、規模が大きくなると、どのエージェントがアクティブか、各タスクのコスト、どのスキルが使用されているかを把握することが困難である。
  • 設定不要のリアルタイム監視ダッシュボード「ur-dashboard」を紹介している。これにより、チームを跨いで全エージェント・全コスト・全スキルを表示し、5秒ごとに Server-Sent Events(SSE)で更新される。
  • ツールは単一コマンドでインストールできる(npm install -g ur-dashboard)と、localhost:3000 で動作し、ローカルの ~/.claude/ ディレクトリから読み取る。SDK、APIキー、追加インフラは不要。
  • 既存の LLM 可観測性ツールは SDK やインフラを必要とするため、ローカルの Claude Code エージェントの可視性にギャップが生じており、ur-dashboard がそのギャップを埋める。
  • Claude Code のエージェントを2つ以上実行している開発者を対象として設計されており、活動状況、セッションごとのコスト、最も頻繁に使われるスキルを把握するのに役立つ。

私は16個のエージェントチームを運用しています。エンジニアリング、研究、デザイン、マーケティング、セキュリティ — 各チームには並行して作業する3-5名の専門エージェントがいます。忙しい日には、私のマシン上で40以上のClaude Code処理が同時に走っています。

問題は実行することではありませんでした。Claude Codeはそれを適切に処理します。問題は何が起きているのかを把握することでした。

どのチームが完了しましたか? どのエージェントが許可プロンプトを待機している状態ですか? 研究チームは、私が2ドルと見積もったタスクで8ドルを費やしましたか? コードレビューチームは実際に実行していますか、それとも20分前に静かにクラッシュしたのでしょうか?

答えは何もなく、ただ端末ウィンドウの壁が立ちはだかっているだけでした。

そこで私は ur-dashboard を作りました。 ur-dashboard は Claude Code 複数エージェントのワークフロー用のゼロ設定、リアルタイム監視ダッシュボードです。1 回の npm install、1 回のコマンドで、すべてのエージェント、すべてのコスト、すべてのスキルを1つの画面に表示します — Server-Sent Events によって5秒ごとに更新されます。

npm install -g ur-dashboard
ur-dashboard

http://localhost:3000 を開く。完了。

\"ur-dashboard

Claude Code のエージェントには組み込みの監視機能がないのはなぜですか?

Claude Code はエージェントを動かすのに長けています。しかし、2〜3エージェントを超えてスケールすると、可視性を失います。組み込みの方法はなく、次の項目を確認する方法はありません:

  • 現在アクティブなエージェントはどれですか
  • セッションごとに各モデルはいくらかかっていますか
  • あなたのチームグルーピングは実際に使われているのですか
  • エージェントが最も頻繁に呼び出すスキルは何ですか

既存のLLM観測ツール(Langfuse、Helicone、LangSmith)は本番APIのためにこれを解決します — ただしいずれもSDK統合、APIキー、インフラ設定が必要です。もしローカルの Claude Code エージェントが今何をしているかを単に見たいだけなら、何もありませんでした。

ur-dashboard はそのギャップを埋めます。~/.claude/ ディレクトリをゼロ設定で読み取ります — コード変更も、APIキーも、インフラも不要です。npm install -g ur-dashboard でインストールし、ur-dashboard を実行し、localhost:3000 を開いてください。

ur-dashboard を誰が使うべきですか?

ur-dashboard は同時に 2 つ以上の Claude Code エージェントを実行する開発者向けに設計されています。具体的には:

  • 複数の Claude Code エージェントを実行しており、何が起きているか把握できなくなる
  • 請求が来る前に AI ワークフローの費用を知りたい
  • エージェントチームを管理しており、誰がアクティブかの視覚的な概要が必要
  • 設定ファイルを手動で編集せずに、エージェントを部門ごとに整理したい

ur-dashboard に何が表示されますか?

リアルタイムのエージェント監視

ダッシュボードは ~/.claude/agents/ からエージェントを自動検出し、それぞれのエージェントの現在のステータス(アクティブ、アイドル、または停止中)を表示します。オーケストレーターを使用している場合は、チームのグルーピングを自動的に検出します。ステータス更新は5秒ごとにページのリフレッシュ不要で届きます。

APIコスト追跡

ur-dashboard は ~/.claude/ から JSONL 使用ログを読み取り、モデルごとのコストをリアルタイムで計算します:

モデル 入力(1Mトークンあたり) 出力(1Mトークンあたり)
gpt-5.4 2.50ドル 15.00ドル
gemini-3.1-pro 2.00ドル 12.00ドル
claude-sonnet-4 3.00ドル 15.00ドル

費用はすべてのプロバイダー(OpenAI、Google、Anthropic)で集計され、単一の総額として表示されます。あなたはセッションあたり各モデルが正確にいくらかかるかを確認できます。

チーム管理

設定タブから直接エージェントをチームにグループ化します。構成を保存します。ダッシュボードは ~/.claude/agents/teams.json にグルーピングを永続化します:

  {
  "teams": {
    "engineering": {
      "description": "Core development",
      "agents": ["code-reviewer", "implementer", "tester"]
    }
  }
}

No team config? It auto-groups agents by filename prefix.

Dispatch API

Trigger agents programmatically from any script or workflow:

# Start an agent
curl -X POST http://localhost:3000/api/dispatch \\
  -H "Content-Type: application/json" \\
  -d '{"agent": "code-reviewer", "prompt": "Review the auth module"}'

# Stream output in real-time
curl -N http://localhost:3000/api/dispatch/{jobId}/stream

# Cancel if needed
curl -X DELETE http://localhost:3000/api/dispatch/{jobId}

The Dispatch API supports a maximum of 3 concurrent jobs with configurable timeouts. All inputs are validated, and commands use spawn with shell: false to prevent shell injection.

How does ur-dashboard compare to Langfuse, Helicone, and LangSmith?

Feature ur-dashboard Langfuse Helicone LangSmith
Zero config
Claude Code native
Open source (MIT)
npx one-liner install
SDK integration required
Agent dispatch API
Self-hosted

主な違い: Langfuse、Helicone、LangSmith は本番 API のトレーシング用に設計された汎用的な LLM 観測プラットフォームです。SDK統合、APIキー、インフラの設定が必要です。

ur-dashboard は Claude Code ローカル開発向けに特化して作られています。~/.claude/ ディレクトリをゼロインストゥメンテーションで読み取り、コード変更なし、APIキーなし、ホスト済みサービスなし。もしすでに Langfuse を本番追跡に使用している場合、ur-dashboard は代替にはなりません。ローカルのマルチエージェントワークフローのリアルタイム可視性という別の問題を解決します。

How does ur-dashboard stream data to the browser?

The main dashboard endpoint (GET /api/stream) uses Server-Sent Events (SSE) over a persistent HTTP connection:

{
  "usage": [{ "model": "gpt-5.4", "cost": 0.42 }],
  "totalCost": 1.87,
  "teams": [{ "name": "engineering", "agentCount": 3, "status": "active" }],
  "commits": [{ "message": "fix auth bug", "project": "api" }],
  "skills": [{ "skill": "tdd", "count": 12 }],
  "capabilities": { "canDispatch": true, "cliVersion": "2.1.78" }
}

ポーリングはありません。ブラウザーは 5 秒ごとに単一の永続 SSE 接続を介して更新を受け取り、ネットワークのオーバーヘッドを最小限に保ちます。

ur-dashboardは何で作られていますか?

レイヤー 選択肢
フレームワーク Next.js 16(App Router、スタンドアロン)
ユーザーインターフェース React 19 + Tailwind CSS 4(グラスモルフィズム)
チャート Recharts 3
ストリーミング サーバー送信イベント
セキュリティ spawnshell: false、入力検証、パス・トラバーサルの防止

ダッシュボード全体は、事前構築済みの Next.js のスタンドアロンバイナリとして提供されます。npx ur-dashboard を実行すると、サーバーが直接起動します。ユーザーのマシン上でビルド手順はありません。

FAQ

オーケストレーターなしでur-dashboardは動作しますか?

はい。ur-dashboardはオーケストレーターなしで動作します。~/.claude/agents/ をスキャンして、ファイル名でエージェントを自動検出します。オーケストレーターがある場合は、teams.json から自動的にチーム定義を取得します。

ur-dashboardはWindowsで動作しますか?

はい。ur-dashboardは macOS と Windows の両方で動作します。クロスプラットフォームのパス解決には os.homedir() を使用し、Windows ではプロセス管理のために taskkill にフォールバックします。

ur-dashboardはClaude Codeファイルを変更しますか?

いいえ。ur-dashboard は ~/.claude/ からのみ読み取ります。書き込む唯一のファイルは ~/.claude/agents/teams.json、設定タブからチーム設定を明示的に保存した場合にのみ更新されます。エージェントファイルは決して変更または削除されません。

Dispatch APIは安全ですか?

はい。すべての CLI 実行は child_process.spawnshell: false とともに使用します。ユーザーのプロンプトは1つの引数として渡され、シェルコマンドへ挿入されることは絶対にありません。エージェント名はパス・トラバーサルに対して検証されます。権限モードは 3 つの値のみ許可リストに制限されています: defaultacceptEdits、および plan

ur-dashboardの料金はいくらですか?

ur-dashboard は MIT ライセンスの下で無料かつオープンソースです。ホスト型サービスはなく、アカウントは不要で、テレメトリもありません。すべてローカルのマシン上で実行されます。

Claude Code 以外のAIエージェントと一緒にur-dashboardを使えますか?

ur-dashboard は Claude Code 用に特化して作られています。Claude Code の ~/.claude/ ディレクトリ構造と JSONL 使用ログを読み込みます。現在のところ Cursor、Windsurf、GitHub Copilot などの他の AI コード補助ツールには対応していません。

Get started

# Global install (recommended)
npm install -g ur-dashboard
ur-dashboard

# Or try without installing
npx ur-dashboard

macOS と Windows で動作します。MIT ライセンス。アカウントや API キーは不要です。

リンク:

マルチエージェント Claude Code ワークフローを実行しており、セットアップの手間をかけずに可視性を得たい場合は、ぜひお試しください。スター、Issue、PR を歓迎します。