claude agents (エージェントビュー)

すべてのバックグラウンドセッションについて、実行中のもの、入力を待っているもの、完了したものを 1 つの画面にまとめて表示します。各バックグラウンドセッションは、ターミナルを接続していなくても動き続ける完全な Claude Code の会話です。そのため、必要なときに開いて返信し、また離れる使い方ができます。

エージェントビューはターミナル全体を使って、セッションを状態ごとに一覧表示します。各行の経過時間はセッションの作成時から数えます。完了したセッションでは、実行にかかった時間で止まります。

• 既定では、すべてのプロジェクトで開始したバックグラウンドセッションを表示します。--cwd を渡すと、1 つのディレクトリ配下で開始したセッションに絞り込めます。
• 各行の 1 行要約は Haiku クラスのモデルが生成します。トランスクリプトを開かなくても、セッションが何をしているか、何を必要としているか、何を生み出したかを行の上で確認できます。
• セッションがプルリクエストを開くと、行の右端にラベルが付きます。ラベルはそのプルリクエストへのリンクで、状態に応じて色が変わります。GitLab のマージリクエスト URL にも対応しており、MR は !N の形で表示されます。
• バックグラウンドセッションは独立した supervisor process (監督プロセス) が実行します。エージェントビューやシェルを閉じても、新しい対話セッションを始めても、ディスパッチした作業は続きます。

エージェントビューの一覧から起動する方法のほかにも、セッションを始める方法や操作の手段があります。

• シェルから直接起動: claude --bg "<prompt>" のように、--bg (長い形は --background) とプロンプトを渡すと、最初からバックグラウンドで動くセッションを開始できます。
• 開いているセッションを移す: セッション内で /bg を実行すると、エージェントビューに移せます。空のプロンプトで ← を押すと、バックグラウンドへの移動とエージェントビューの表示を一度に行えます。
• 会話のコピー: /fork を実行すると、現在の会話を新しいバックグラウンドセッションにコピーします。元の会話はそのまま動き続け、コピーはエージェントビューに独自の行として表示されます。
• シェルコマンドの実行: エージェントビューで ! <command> と入力するか、claude --bg --exec '<command>' を使うと、Claude のセッションではなくシェルコマンドをバックグラウンドジョブとして実行できます。このジョブにはアタッチ・デタッチできます。
• 絞り込みと検索: ディスパッチ用の入力欄の先頭に a:<name>、s:<state>、n:<text>、o:<text> などのフィルターを入れると、一覧を絞り込めます。Ctrl+F でセッション名を検索でき、Alt+↑/↓ でグループ間を移動できます。
• ピン留め: Ctrl+T でピン留めしたバックグラウンドセッションは、アイドル状態でも維持されます。
• 過去のセッションの再開: エージェントビューで /resume と入力すると、過去のセッションのピッカーが開きます。一覧から削除したセッションも対象で、選んだセッションはバックグラウンドセッションとして再開します。通常の /resume でも、claude --bg やエージェントビューで始めたセッションが bg の印付きで表示されます。
• 名前での指定: claude attach <name> と claude logs <name> では、ID の代わりにセッション名の一部を指定できます。
• 新しいセッションの開始設定: エージェントビューで /effort と /fast を使うと、新しいセッションの開始時の設定を指定できます。

通知とスクリプト連携

• エージェントビューを開いている間、ローカルのバックグラウンドセッションが入力を必要としたとき、完了したとき、失敗したときに、設定済みのターミナル通知の経路で通知が届きます。
• 入力が必要になったセッションや完了したセッションは、Notification フック (agent_needs_input / agent_completed) を発火します。
• claude agents --json は、稼働中のセッションを JSON で一覧します。Claude Code の外からセッションの状態を読み取る方法として、公式にサポートされています。

エージェントビューはリサーチプレビューとして追加された機能です。Bedrock、Vertex、Foundry 上やテレメトリを無効にした環境でも、キー操作でエージェントビューを開けます。対象プランについては、公式のリリースノートには記載がありません。

• 無効化: disableAgentView を true に設定するか、環境変数 CLAUDE_CODE_DISABLE_AGENT_VIEW を設定すると、バックグラウンドエージェントとエージェントビューを完全にオフにできます。管理者は managed settings (管理設定) でこの設定を強制できます。
• コードの扱い: claude agents から起動したバックグラウンドエージェントは、worktree でのコード作業を終えると、確認のために止まらず、コミット・プッシュしてドラフト PR を開きます。リポジトリの運用ルールと照らし合わせて確認してください。
• 権限まわりのフラグ: claude agents には、ディスパッチするバックグラウンドセッションを設定する --add-dir、--settings、--mcp-config、--plugin-dir、--permission-mode、--model、--effort、--dangerously-skip-permissions のフラグがあります。
• ワークスペースの信頼: 信頼されていないディレクトリでは、claude と同じくワークスペース信頼のプロンプトが表示されます。
• 既定で開く設定: 通常の claude セッションで /config を実行し、Open agents view by default (エージェントビューを既定で開く) をオンにします。その後、引数なしで claude を実行すると、新しい会話の代わりにエージェントビューが開きます。この既定の動作を止める方法は、エージェントビューの /config に表示されます。

1. シェルで claude agents を実行し、エージェントビューを開きます。
2. タスクを説明するプロンプトを入力して Enter を押すと、新しいバックグラウンドセッションが始まります。
3. 矢印キーで行を選び、Space を押して peek panel (プレビュー欄) を開きます。
4. 返信を入力して Enter を押すと、エージェントビューを離れずに送信できます。
5. 会話全体を見たいときは、行の上で Enter または → を押してアタッチします。
6. 空のプロンプトで ← を押すと、デタッチして一覧に戻ります。