AgentValleyでClaude CodeをMacのノッチから監視

AgentValleyは何をするアプリ？やさしく説明

AgentValleyは、Mac上のClaude Codeセッションを画面のノッチ下にまとめる無料のオープンソースアプリです。簡単に言えば、AIの作業を見守る小さな確認窓です。ほかのアプリを使いながら、どのエージェントが作業中で、どれが返答を待っているかを確認できます。セッションが起動したサブエージェントにも専用の行とピクセルキャラクターが付きます。利用にはClaude CodeとmacOS 15以降が必要です。

対応待ちのエージェントを見つける

セッションはプロジェクトごとに整理され、worktreeも元のプロジェクトにまとめられます。カードにはタスク、モデル、直近のステップが表示され、サブエージェントにはステップ数も付きます。メインの実装と委任した調査を区別しやすくなります。

質問や許可要求が出ると、ノッチの横に赤い件数が表示されます。パネルで内容を読んでから該当アプリへ移動できます。「Go to the session’s tab」を有効にするとTerminalとiTerm2で対応するタブを開けます。Ghosttyでは同じフォルダを使うセッションが二つあると特定が曖昧になります。初期状態で有効な音声通知は、無効化や通常のチャイムへの変更が可能です。

使用量と費用の見方

グラフボタンからHistoryを開き、日・週・月を選択して、時間帯やプロジェクト内のセッションを確認できます。金額はAPI価格で計算した推定値です。消費の比較には役立ちますが、サブスクリプションの請求額そのものではありません。全プロジェクトまたは一つのプロジェクトをPDFに出力できます。履歴はMacに保存され、Claude Codeが古いファイルを削除した後も残ります。

直近5時間と当日のトークン、12時間のグラフも表示します。「Plan limits」は初期状態では無効で、有効にすると5時間枠・週間枠とリセットまでの時間を確認できます。2026年10月25日の確認ではアプリは無料で、スポンサー支援は任意です。Claude Codeの利用条件は別途適用されます。

インストールしてセッションを確認する

1. 公式DMGをダウンロードし、AgentValleyをアプリケーションへ移動して起動します。Homebrewなら brew install --cask morsechimwai/tap/agent-valley を使えます。
2. Claude Codeのセッションを開始し、ノッチにポインタを合わせて、プロジェクトと直近の操作を確認します。
3. 別のアプリからControl–Option–Command–Aでパネルを開き、矢印キーで行を選び、Returnでセッションへ戻ります。
4. パネルで許可要求に応答したい場合は「Answer from the notch」を有効にし、設定画面に表示されるプラグイン導入コマンドを実行してClaude Codeを再起動します。要求を読んだうえで「Allow once」または「Deny」を選びます。

ローカルデータと任意設定の範囲

公開説明では、~/.claude/projects と ~/.claude/sessions、プロセス、プロジェクトのGit情報を読みます。アプリ自身のデータは ~/Library/Application Support/AgentValley に保存します。「Plan limits」を有効にした場合だけ、キーチェーンからClaude Codeのログイン情報を読み、api.anthropic.com へ送信します。GitHubへの日次更新確認は無効化できます。

任意のターミナルステータスラインは、~/.claude/settings.json を変更し、フォントを導入し、必要に応じてGhostty設定へ1行追加します。削除コマンドで取り消せます。ローカル中心の動作であっても、すべての設定で通信が発生しないという意味ではありません。

向いている使い方と注意点

複数のローカルセッションを並行して動かし、返答待ちの端末を探すことが多い人に向いています。設定で接続中の外部ディスプレイへパネルを移せます。「quiet」は2分間、書き込み活動が見られない状態であり、停止の確定や完成率ではありません。公式に説明されている対象はMac上のClaude Codeです。アプリのコードはMITライセンスで、Anthropicとは独立したプロジェクトです。

よくある質問

AgentValleyは無料ですか？

はい。アプリは無料のオープンソースで、スポンサー支援は任意です。Claude Codeへのアクセス条件とは別です。

表示される金額は請求額ですか？

いいえ。API価格を使った推定値です。実際の支払いは契約や課金方法によって異なります。

監視するだけでもプラグインが必要ですか？

通常のセッション表示には不要です。ノッチから許可・拒否を返す機能を使う場合に、手動で導入します。

公式ダウンロードとサポート

• 公式リリースとダウンロード
• ソースコードと設定手順
• 不具合・要望をGitHub Issuesへ