Repolode
投稿する
rbartoli

rbartoli/agent-usage-guard

プランの利用枠を使い切る前に、Claude Codeのサブエージェントの大量起動、大きなコンテキストを伴うプロンプト、リトライループを抑制するmodです。

GitHub で見る
スター
94
フォーク
5
未解決の Issue
0
最終コミット
一昨日

これは何？

agent-usage-guardは、エージェントの起動、プロンプト、ツール呼び出しを実行前にチェックするClaude Code用のmodです。プランに表示される5時間枠と週次枠の使用率を読み取り、マシン上のすべてのClaude Codeセッションにまたがって、実行中および直近のエージェント数を数えます。上限に達すると、Claude Code標準の質問ダイアログで確認を求めます。claude -pやAgent SDKのように応答できる人がいない場合は、理由を説明して実行を拒否します。

デフォルトのルールでは、同時に実行できるエージェントを4つ、10分あたりの起動数を12回、1ウィンドウあたりのサブエージェントのトークン数を1,000万に制限します。また、50万トークンを再読み込みするプロンプトや、コンテキストが大きい状態でのツール呼び出しの集中など、大きなコンテキストも検知します。承認は条件が解消されるかタイムアウトするまで有効なので、呼び出しのたびに同じ質問が繰り返されることはありません。ガードはフェイルオープンで、フックのいずれかでエラーが発生した場合は処理を続行します。

ネットワークアクセスやバックグラウンドプロセスを使わず、ローカルで動作します。プロンプトのテキスト、ツールの入力、モデルの出力は保存せず、カウントと大まかな区分のみを記録します。/agent-guard reportコマンドで、介入した内容を要約できます。

主な機能

  • 01プランの5時間枠または週次枠の使用率が設定したしきい値を超えると、新しいエージェントの起動前に確認を求めます。
  • 02マシン上のすべてのセッションを対象に、同時実行エージェント数、エージェントの起動数、サブエージェントのトークン数を制限します。
  • 03大きなコンテキストを再読み込みするプロンプトの前に確認を求め、コンテキストが大きい状態でのツール呼び出しの集中を制限します。
  • 04繰り返し失敗した後、同一のツール呼び出しのリトライを拒否します。
  • 05ネットワークアクセスなしでローカルに動作し、プロンプトやツールの内容を保存しません。
  • 06/agent-guard reportで介入内容を要約できます。

ユースケース

  • Claude Codeで並行調査やマルチエージェントのワークフローを実行し、5時間の利用枠を使い切らないようにする。
  • ロックアウトに至る前に、大量のエージェント起動を拒否するclaude -pやAgent SDKのジョブをスクリプトで実行する。
  • 長時間のセッションで、リトライループによるコンテキストの浪費を防ぐ。

クイックスタート

  1. 1

    Claude Code にマーケットプレイスを追加する

    /plugin marketplace add rbartoli/agent-usage-guard
  2. 2

    プラグインをインストールする

    /plugin install agent-usage-guard@agent-usage-guard
  3. 3

    プラグインを再読み込みする

    /reload-plugins
  4. 4

    status コマンドを実行して、guard が何を検知しているか確認する

    /agent-guard

使う前に知っておきたいこと

  • Claude Code v2.1.287 以降が必要です。
  • /subtask のフォークや、各自のターミナルペインで実行しているチームメイトなど、一部のパスは対象外です。
  • API キーを使ったセッションでは、Plan ウィンドウの読み取りを利用できません。
  • Desktop アプリの WSL セッションでは実行されません。

収録されている特集

Claude Code のツール・スキル・プラグインオープンソースの AI エージェント・フレームワークとアプリ

トピック

#ai-agents#claude-code#rate-limiting#guardrails#subagents#developer-tools#claude-code-mod#claude-code-plugin#typescript#usage-limits

よくある質問

agent-usage-guard とは？
プランの利用枠を使い切る前に、Claude Codeのサブエージェントの大量起動、大きなコンテキストを伴うプロンプト、リトライループを抑制するmodです。 agent-usage-guardは、エージェントの起動、プロンプト、ツール呼び出しを実行前にチェックするClaude Code用のmodです。プランに表示される5時間枠と週次枠の使用率を読み取り、マシン上のすべてのClaude Codeセッションにまたがって、実行中および直近のエージェント数を数えます。上限に達すると、Claude Code標準の質問ダイアログで確認を求めます。claude -pやAgent SDKのように応答できる人がいない場合は、理由を説明して実行を拒否します。
agent-usage-guard は無料で使えますか？ライセンスは？
agent-usage-guard は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
agent-usage-guard は今もメンテナンスされていますか？
活発にメンテナンス中。agent-usage-guard の最終コミットは 2026年11月6日 です。
agent-usage-guard は何に使えますか？
Claude Codeで並行調査やマルチエージェントのワークフローを実行し、5時間の利用枠を使い切らないようにする。 ロックアウトに至る前に、大量のエージェント起動を拒否するclaude -pやAgent SDKのジョブをスクリプトで実行する。 長時間のセッションで、リトライループによるコンテキストの浪費を防ぐ。
agent-usage-guard のインストール方法は？
Claude Code にマーケットプレイスを追加する: /plugin marketplace add rbartoli/agent-usage-guard プラグインをインストールする: /plugin install agent-usage-guard@agent-usage-guard プラグインを再読み込みする: /reload-plugins status コマンドを実行して、guard が何を検知しているか確認する: /agent-guard
agent-usage-guard はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/rbartoli/agent-usage-guard

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト