agent-usage-guardは、支出が発生する前に動作するClaude Codeのmodです。プランのライブ使用量を読み取り、エージェントが起動する前、プロンプトが送信される前、ツール呼び出しが実行される前に、サブエージェントの並列実行、大きなコンテキストのプロンプト、リトライループを保留します。エージェントの上限はマシン上のすべてのClaude Codeセッションに適用され、並列実行と大きなコンテキストは上限付近だけでなく、どの使用量レベルでも制限されます。
キーボードの前にいるときは、ガードがClaude Code自身の質問ダイアログで確認を求めます。誰も回答できない場合は、要求を拒否してその理由をClaudeに伝えるため、モデルは待機したり、作業をまとめたり、停止したりできます。Claude Codeが報告する5時間および週間の割合がプランに応じた上限を決めており、承認はウィンドウがリセットされるかタイムアウトするまで条件を解除するため、同じ質問が呼び出しごとに繰り返されることはありません。
このプロジェクトは、最大の労力で実行された1つの調査プロンプトがきっかけで作られました。そのプロンプトは394件のサブエージェント呼び出しを生成し、そのうち341件が同時に実行され、10分間で8,400万コンテキストトークンをAPIに送信し、ロックアウトを引き起こしました。作者自身のログには、60日間で12回のロックアウトが記録されていました。各保護機能は、この障害パターンの要因を1つずつ取り除きます。
ガードはローカルで動作し、プライバシーへの影響を最小限に抑えます。ネットワーク通信は行わず、件数と大まかな区分のみを保存し、プロンプトのテキスト、ツールの入力、モデルの出力は一切保持しません。障害時はフェイルオープンするため、壊れたフックがセッションを止めることはありません。唯一の例外は、時間内に判定できなかったエージェントで、Claudeが再開できるように拒否されます。Claude Code v2.1.287以降にインストールしてから、/agent-guardを実行すると、ガードが何を検知しているかを確認できます。
出典: Hacker News · 要約：HeadlinesBriefing