Claude Codeのagent view|claude agentsで全セッションを1画面管理する方法

  • 2026年8月3日
  • 最終更新: 2026年8月3日
  • AI
この記事の結論

セッションを何本立ち上げても、状態が見えなければ管理できません。claude agentsの一覧、バックグラウンド起動の3経路、worktree隔離の挙動を整理しました。

ブログ目次

記事の内容を、そのまま実務に落とし込みたい方向け

HubSpotゴールドパートナーのStartLinkが、HubSpot導入・AI活用・CRM整備・業務効率化までをまとめて支援しています。記事で気になったテーマを、そのまま相談ベースで整理できます。


「3本走らせたはずのClaude Codeのうち、どれが止まっていてどれが確認を待っているのか分からない」

「ターミナルのタブを行ったり来たりしているうちに、1本が権限確認で30分放置されていた」

——AIコーディングエージェントを複数走らせ始めると、作業そのものより「どれがどうなっているか」の把握にコストがかかり始めます。

Claude Codeのagent viewは、この把握コストをゼロに近づけるための画面です。シェルでclaude agentsと打つと、走っている全セッションが状態ごとにまとまった一覧で表示され、任意の行に入って会話を続けられます。セッションを増やすことではなく、増えたセッションを見失わないことが目的の機能です。

本記事の内容は、Claude Code公式ドキュメント「Agent view」(2026年8月時点で確認)に基づいて整理しています。



この記事でわかること

agent viewの構造から実務での運用判断まで、開発者・開発リーダーが判断に使える範囲を整理します。

  • agent viewが何を見せてくれるのか — 走っている全セッションを「実行中・入力待ち・その他」の状態でグループ分けし、どれに手を入れるべきかが一目で分かる画面です
  • バックグラウンドセッションを起こす3つの経路 — シェルから、会話の途中から、agent viewの入力欄から。それぞれ向いている場面が違います
  • ファイル編集がworktreeに隔離される仕組み — 並行して走るセッション同士がファイルを取り合わないための土台であり、消すときの注意点もここにあります
  • ターミナルを閉じてもセッションが生き続ける理由 — 別プロセスのスーパーバイザーが面倒を見ています。何が引き継がれ、何が止まるのかを押さえておくと事故が減ります
  • サブエージェント・Agent Teamsとの棲み分け — 似た機能に見えて、解いている問題が違います

対象読者: Claude Codeを日常的に使っていて、2本以上を並行させることがある開発者・開発リーダー。読み終える頃には、「どの作業を裏に回し、どこで人が見に行くか」の運用ルールを自分のチーム向けに設計できる状態になります。ぜひ最後までご確認ください。


agent viewとは何か

まずはこの画面が解こうとしている問題と、そこに表示される情報の意味を押さえます。

「セッションが散らばる」問題を1画面に集約する

agent viewは、シェルからclaude agentsと実行して開くセッション管理ダッシュボードです。ターミナルのタブやウィンドウに散らばっていたセッションが、1枚のリストにまとまります。

claude agents

対象を絞りたい場合はディレクトリを指定でき、スクリプトから扱いたい場合はJSONでも取得できます。

claude agents --cwd ~/work/api-server   # 指定パス配下のセッションだけ
claude agents --json                    # JSON配列で出力
claude agents --json --all              # 完了済みセッションも含める

利用にはClaude Code v2.1.139以降が必要です。それより前のバージョンでclaude agentsを実行すると、サブエージェントの一覧が表示されるだけでこの画面は開きません。意図した画面が出ない場合は、まずclaude --versionでバージョンを確認してください。なお、agent viewはリサーチプレビューとして提供されている機能です。

6つの状態が「次に手を入れる先」を教えてくれる

一覧の価値は、単に並んでいることではなく、状態でグループ分けされていることにあります。各行の先頭にはアイコンが付き、そのセッションがいまどうなっているかを示します。

Claude Codeのagent view(claude agents)の画面構成を示した図。WORKING・NEEDS INPUT・OTHERの3グループに分かれ、実行中・入力待ち・完了・アイドル・失敗・停止・スリープ中の各状態がアイコン付きで一覧表示される様子と、キー操作・シェルコマンド・必要バージョンの補足を示した図解

状態 意味 実務上の読み方
実行中(Working) ツールを動かして応答を生成している最中 触らなくてよい行
入力待ち(Needs input) 質問・権限確認・MCPの認証などで止まっている 最優先で見に行く行
アイドル(Idle) 次の指示を受け付けられる状態 仕事を追加できる行
完了(Completed) タスクが正常に終わった 結果を取り込む行
失敗(Failed) エラーで終了した 原因を確認する行
停止(Stopped) 手動または外部から止められた 判断済みの行

このうち実務でいちばん重要なのが入力待ちです。並列で走らせているときに全体のスループットを落とす原因は、たいてい「1本が確認待ちのまま誰にも気づかれずに置かれている」ことだからです。agent viewはこの行を専用のグループにまとめるので、開いた瞬間に対処すべき対象が分かります。入力待ちだけを抜き出したい場合は、入力欄にs:blockedと打つと絞り込めます。

なお、状態とは別にプロセスが生きているかどうかも示されます。プロセスが終了している行にも返信でき、その時点でClaudeが再起動します。のアイコンは、/loopで設定した定期タスクが次の実行までの待機に入っていることを意味します。定期実行の設計そのものはClaude Codeの/loopコマンドの解説記事にまとめています。


バックグラウンドセッションを起こす3つの経路

agent viewに並ぶのは、主にバックグラウンドで走っているセッションです。裏に回す方法は3つあり、それぞれ適した場面が異なります。

Claude Codeでバックグラウンドセッションを起こす3つの方法を示した図。シェルから直接(claude --bg)、セッションの中から(/background・/fork)、Agent Viewの入力欄から、の3経路と、ファイル編集がgit worktreeに隔離される仕組み、スーパーバイザーがセッションを保持する仕組みを説明した図解

経路1: シェルから直接立ち上げる

いちばん素直なのが--bgです。プロンプトを渡すとセッションが1本立ち上がり、すぐにシェルへ戻ってきます。

claude --bg "APIのレスポンス型定義をv2スキーマに合わせて更新して"
claude --bg --name api-types "同上"          # 名前を付ける
claude --bg --agent reviewer "差分をレビューして"  # サブエージェントを指定

--model(モデル指定)、--effort(思考量)、--permission-mode(権限モード)、--add-dir(アクセスを許可するディレクトリ)、--settings--mcp-config--plugin-dirなども同様に渡せます。「今の作業を止めずに、別の仕事を1本足す」用途にはこれが最短です。

経路2: いま話している会話を裏に回す

すでに対話中のセッションを、そのまま裏へ送ることもできます。

/background        # 現在のセッションをバックグラウンドへ(別名 /bg)
/bg 続けてテストも通しておいて   # 追加の指示を添えて裏へ
/fork 別案としてキャッシュ層を挟む方向も試して   # 会話を複製して別方向を走らせる

/backgroundいま走らせている作業ごと退避させる動きで、/fork同じ文脈から枝分かれさせて別方向を試す動きです。「ここまでの調査結果は共有したまま、2案を並行で検証したい」という場面では/forkが効きます。

裏に回すとき、その会話で有効になっていた設定はおおむね引き継がれます。権限モード、/model/effortで途中変更した設定、--add-dirで追加したディレクトリ、MCP設定、プラグイン設定などが該当します。「フォアグラウンドで整えた環境が、裏に回した瞬間にリセットされる」心配は不要です。

経路3: agent viewの入力欄から投げる

agent viewを開いたまま、その入力欄に指示を打てば新しいセッションが立ち上がります。一覧を見て空き状況を確認しながら次の仕事を割り振れるので、同時に複数本を回しているときはこれがいちばん速いです。

  • プロンプトを打って Enter — 裏で開始し、一覧に行が増えます
  • Shift+Enter — 開始と同時にそのセッションへ入ります
  • @<エージェント名> — 使うサブエージェントを明示します
  • @<リポジトリ> — 別リポジトリに対して投げます
  • ! で始める — シェルコマンドをバックグラウンドジョブとして走らせます

走っているセッションに手を入れる

一覧から先の操作は、画面内のキー操作とシェルコマンドの2系統があります。

ピークパネルで「入る前に覗く」

行を選んでSpaceを押すと、ピークパネルが開きます。ここが実務でいちばん使う機能です。

セッションの状態 ピークパネルに出るもの
入力待ち いま聞かれている質問そのもの。waiting 3m のように待ち時間も表示されます
完了 結果・出力
実行中 現在の作業内容を示すステータス文

そしてパネルを開いたまま返信できます。テキストを打ってEnter、選択肢が提示されていれば数字キー、提案された返信を使いたければTab、シェルコマンドを走らせたければ!を先頭に付けます。アタッチせずに詰まりを解消できるため、5本走っていても順番にSpaceで覗いてEnterで返す、という回し方ができます。

押さえておくと効くキー操作

キー 動作
/ 行を移動します
Enter セッションにアタッチします(入力欄に文字があれば新規ディスパッチ)
Space ピークパネルを開閉します
Ctrl+T セッションをピン留めします(アイドルでもプロセスを保持)
Ctrl+X セッションを停止します(2秒以内にもう一度押すと削除)
Ctrl+S グループ分けを「状態別」と「ディレクトリ別」で切り替えます
Ctrl+R セッション名を変更します
Ctrl+Z アタッチ中のセッションからデタッチして元の画面へ戻ります
? ショートカットの一覧を表示します

Ctrl+Xは2秒以内の2度押しで削除まで進む点に注意してください。後述しますが、削除はworktreeごと消える操作です。

シェルから直接操作する

agent viewを開かずに、シェルから個別のセッションを扱うこともできます。CI連携や別のスクリプトから叩く場合はこちらです。

claude attach <id>       # セッションに入る
claude logs <id>         # 直近の出力を表示する
claude stop <id>         # 停止する
claude rm <id>           # 一覧から外す(トランスクリプトは残る)
claude respawn <id>      # 会話を保ったまま再起動する
claude respawn --all     # 走っている全セッションを再起動する

ファイル編集はworktreeに隔離される

並列実行で最も怖いのは、複数のセッションが同じファイルを同時に書き換えることです。agent viewのバックグラウンドセッションは、この問題を構造で解いています。

編集の直前にworktreeへ移る

バックグラウンドセッションは、起動時点ではディスパッチした作業ディレクトリで動きます。そしてファイルを書き換える直前に、.claude/worktrees/配下の専用のgit worktreeへ移ってから編集します。セッションごとに別のworktreeが割り当てられるため、並行して走る別セッションとファイルを取り合いません。

ただし、次の場合は隔離が行われません。

  • すでにリンク済みのgit worktreeの中で動いている場合
  • 作業ディレクトリがgitリポジトリではなく、WorktreeCreateフックも設定されていない場合
  • 書き込み先が作業ディレクトリの外である場合
  • 設定で無効化している場合

無効化は設定ファイルで行います。既定値は"auto"で、"none"にすると作業コピーを直接編集するようになります。

{
  "worktree": {
    "bgIsolation": "none"
  }
}

git worktreeそのものの考え方や、手動でブランチを分けて並行開発する方法についてはClaude Code × Git Worktreeの記事で扱っています。

削除の挙動が経路によって違う

ここは実務で最も事故につながりやすいポイントです。セッションを消す操作が、worktreeごと消す操作になる場合があります。

操作 worktreeの扱い
agent viewでCtrl+Xの2度押し(削除) worktreeとコミットされていない変更ごと削除されます
シェルのclaude rm 未コミットの変更が残っていればworktreeは保持されます
未pushのコミットがある場合 セッションとともに保持され、パスと理由が表示されます

ポイント: agent view上で行を消す前に、そのセッションが何をどこまで書いたかをピークパネルで確認してください。未コミットの変更はCtrl+Xの2度押しで戻せなくなります。取り込みたい変更があるなら、先にコミットさせるのが安全です。残ってしまったworktreeはgit worktree listで確認し、git worktree remove <パス>で片付けられます。

プルリクエストまで作られる場合がある

worktreeに隔離されたセッションは、作業内容を自動でコミットし、ブランチをpushしてドラフトのプルリクエストを開くことがあります。行の右側に#123のようなラベルが出ていれば、それが紐づいたPRです。

安全側の制約も公式に明記されています。mainmasterへは決してpushせず、強制pushもマージも行いません。リモートがないリポジトリや、そうしないよう指示した場合はPRを作りません。


セッションを生かし続けるスーパーバイザー

「ターミナルを閉じたら止まるのでは」という疑問が出るところですが、そうはなりません。

別プロセスがセッションを保持する

ユーザーごとに別のプロセス(スーパーバイザー)が動いていて、バックグラウンドセッションを保持しています。状態は~/.claude/jobs//state.jsonに、セッションの名簿は~/.claude/daemon/roster.jsonに保存され、スーパーバイザーの再起動を跨いで残ります。状態は次のコマンドで確認できます。

claude daemon status                      # スーパーバイザーの状態を表示
claude daemon stop --any --keep-workers   # セッションは残したまま再起動する

マシンがスリープから復帰した場合も、保存された状態からセッションが再開されます。応答の途中でプロセスが再起動した場合も、同じ地点から続きが処理されます。

アイドル1時間で落ちる、ピン留めで防げる

リソースを空けるため、何もしていないセッションのプロセスは約1時間で停止します。「しばらく放置していたセッションに戻ったら反応が遅い」のはこれが理由で、アタッチすれば再起動して続きから動きます。常に即応してほしいセッションはCtrl+Tでピン留めしておけば、この停止の対象から外れます。

引き継がれる仕事・止まる仕事

プロセスの停止や再起動をまたぐとき、すべてが引き継がれるわけではありません。ここを誤解していると「動いているはずの監視が止まっていた」という事故になります。

引き継がれるもの 停止するもの
バックグラウンドで走らせたシェルコマンド 実行中のMonitor(監視)
バックグラウンド化したサブエージェント サブエージェントが起動したシェルコマンド
Dynamic workflows
/loopで設定した定期タスク

Monitorが引き継がれない点は特に重要です。ログやビルドを継続監視させている場合、セッションを裏に回したりプロセスが再起動したりすると監視が切れます。Monitorの設計と使いどころはClaude CodeのMonitorツールの記事で解説しています。この引き継ぎ自体を無効化したい場合は、環境変数CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1を設定します。

通知で「入力待ち」を拾う

セッションが入力待ちになったとき、完了したとき、失敗したときには通知が発火します。通知の経路は設定のpreferredNotifChannelで選べ、Notificationフックもagent_needs_inputagent_completedという種別付きで発火します。フックを書いておけば、入力待ちをSlackに流すといった運用も組めます。フックの設計はClaude Code Hooksの記事にまとめています。


サブエージェント・Agent Teamsとの棲み分け

「並列で動かす仕組み」がClaude Codeには複数あり、ここが最も混乱しやすいところです。解いている問題で分けると整理できます。

仕組み 解いている問題 主な操作
サブエージェント 1つのセッションの中で、下請けの作業を切り出したい 会話の中でClaudeに依頼する
Agent Teams 複数のセッションを互いに会話させながら協調させたい 実験的機能として環境変数で有効化する
agent view 走っているセッションそのものを見失わずに管理したい claude agents

agent viewは「協調」の機能ではなく「可視化と操作」の機能です。teammate同士がメッセージをやり取りする仕組みや、tmuxで並べる方法についてはClaude Codeで複数AIエージェントを並列実行する方法で詳しく扱っているので、そちらとあわせて読むと全体像がつかめます。

なお2026年の変更として、サブエージェントは既定でバックグラウンド実行になりました。Claudeはサブエージェントの完了を待たずに自分の作業を続けます。この変更により、1セッションの中でも並行度が上がっており、agent viewで全体を俯瞰する価値はその分だけ大きくなっています。


使う前に押さえておきたい制約

便利さの裏にある制約を、公式ドキュメントが明示している範囲で整理します。

レート上限は普通に消費される

バックグラウンドセッションも、対話セッションとまったく同じようにプランの利用枠を消費します。10本並列で走らせれば、利用枠の消費もおよそ10倍の速さになります。「裏で走っているから軽い」ということはありません。並列数を決めるときは、処理速度だけでなく利用枠の消費速度も含めて判断してください。コスト側の考え方はClaude Codeのコスト最適化の記事が参考になります。

セッションはローカルで動く

セッションは自分のマシンで動きます。スリープは跨げますが、シャットダウンすると停止します。クラウドで走り続けるものではない、という前提は共有しておいた方がよいでしょう。

機能自体を無効化することもできる

チームの方針としてagent viewを使わせない場合は、設定または環境変数で無効化できます。

{
  "disableAgentView": true
}
export CLAUDE_CODE_DISABLE_AGENT_VIEW=1

認証情報はディスパッチしたシェルから引き継がれる

スーパーバイザーは、セッションを起動したシェルの認証情報とPATHを使います。バックグラウンドで認証エラーになる場合は、/loginが済んでいるか、ANTHROPIC_API_KEYがそのシェルでexportされているかを確認してください。なお、LLMゲートウェイ用の環境変数(ANTHROPIC_BASE_URL等)はスーパーバイザーを起動したシェルからは引き継がれないため、プロジェクトの.claude/settings.jsonenvブロックに書くのが確実です。


実務でどう使うか

機能として使えることと、業務に組み込んで効果が出ることは別の話です。

向いている使い方

agent viewが効くのは、「待ち時間が長く、途中で人の判断が数回だけ必要な作業」を複数抱えているときです。

場面 使い方
大きめの改修を回しながら別の調査もしたい 改修を--bgで裏に回し、手元では調査を続けます
同じ問題に2つの方針を試したい /forkで会話ごと複製し、両方を走らせて結果を比べます
定型的な後片付けを溜めておきたい agent viewの入力欄から順に投げ、完了した行から取り込みます
レビュー待ちのPRが複数ある PR番号のラベルで紐づいたセッションを追えます

少数精鋭のチームでAIエージェントを使う場合、ボトルネックになるのはたいてい生成速度ではなく、人が確認に戻るまでの待ち時間です。入力待ちの行が一覧の上に集まる構造は、この待ち時間を短くするために効きます。確認に費やしていた時間は、そのまま設計や意思決定に回せるはずの時間です。

向いていない使い方も正直に

  • 本番環境に触る作業 — 裏で走らせて後から確認する形式は、取り返しのつかない操作とは相性が悪いです。権限モードの設計とセットで考えるべき領域で、パーミッションモードの記事の整理が参考になります
  • 並列数を先に決めてしまう運用 — 利用枠は並列数に比例して減ります。「何本まで」を固定するより、詰まっている行を減らす方が結果的に速くなります
  • 未コミットの変更を長く抱えたままの運用 — worktreeの削除で失われる可能性があります。区切りごとにコミットさせる運用にしておくのが安全です

StartLinkでも社内の作業をAIエージェントに任せる範囲を広げていますが、増やすべきは同時に走る本数ではなく、人が判断すべき地点の見通しだと考えています。何本走らせても、詰まりに気づくのが遅ければ全体は速くなりません。agent viewは本数を増やす機能というより、増やしても破綻しない土台を用意する機能だと捉えると位置づけがはっきりします。

まずは2本から始めて、Spaceで覗いてEnterで返す回し方が体に馴染んでから増やすのが、結局は早道になります。


よくある質問

agent viewを使い始めるにあたって、疑問になりやすい5点にお答えします。

Q1. claude agentsを実行してもサブエージェントの一覧しか出ません。

お使いのバージョンが古い可能性が高いです。agent viewにはv2.1.139以降が必要で、それより前のバージョンではclaude agentsはサブエージェントの一覧を表示するだけです。claude updateでアップデートしてから再度お試しください。設定でdisableAgentView: trueになっている場合や、環境変数CLAUDE_CODE_DISABLE_AGENT_VIEW=1が設定されている場合も画面は開きません。

Q2. ターミナルを閉じてもバックグラウンドセッションは動き続けますか?

動き続けます。ユーザーごとのスーパーバイザープロセスがセッションを保持しているためです。スリープからの復帰も跨げます。ただしマシンをシャットダウンすると停止します。また、何もしていないセッションのプロセスは約1時間で停止し、アタッチすると再起動します。常時即応させたい場合はCtrl+Tでピン留めしてください。

Q3. 並列で走らせると同じファイルを取り合いませんか?

バックグラウンドセッションは、ファイルを編集する直前に.claude/worktrees/配下の専用worktreeへ移ります。セッションごとに別のworktreeが割り当てられるため、通常は衝突しません。すでにworktree内で動いている場合、gitリポジトリでない場合、書き込み先が作業ディレクトリの外である場合は隔離されません。無効化したい場合は設定に"worktree": {"bgIsolation": "none"}を指定します。

Q4. バックグラウンドセッションは利用枠を余計に消費しますか?

対話セッションと同じ扱いです。割引も割増もありません。10本並列で走らせれば、利用枠の消費もおよそ10倍の速さになります。並列数を決めるときは、処理の速さだけでなく利用枠の消費速度も含めて判断してください。

Q5. agent viewとAgent Teamsはどう違いますか?

解いている問題が違います。agent viewは走っているセッションを一覧して操作するための画面で、セッション同士を協調させる機能ではありません。teammate同士が直接メッセージをやり取りしながら協調するのがAgent Teamsで、こちらは実験的機能として環境変数で有効化して使います。「見失わないための画面」がagent view、「協調させるための仕組み」がAgent Teamsという関係です。


あわせて読みたい


まとめ

Claude Codeのagent viewについて、実務で押さえておきたい点を整理します。

  • agent viewは、走っている全セッションを状態別に見せるダッシュボードです。claude agentsで開き、v2.1.139以降で利用できます。最優先で見るべきは「入力待ち」のグループです
  • 裏に回す経路は3つ — シェルのclaude --bg、会話中の/background/fork、agent viewの入力欄。フォアグラウンドで整えた権限やモデルの設定は裏に回しても引き継がれます
  • ファイル編集は.claude/worktrees/のworktreeに自動で隔離されます。並列実行の安全性はここで担保されており、逆に削除操作は未コミットの変更ごと消える点に注意が必要です
  • セッションはスーパーバイザーが保持し、ターミナルを閉じても生き続けます。ただしMonitorは引き継がれず、アイドル約1時間でプロセスは停止します
  • 利用枠は並列数に比例して減ります。「裏だから軽い」ということはないので、並列数は処理速度と消費速度の両面で決めてください

まずは2本を裏に回し、SpaceでピークしてEnterで返す運用を試してみてください。詰まっている行が一覧の上に集まる感覚がつかめれば、本数を増やしても管理が破綻しなくなります。

AI活用とCRM運用をどう組み合わせるかについてご興味がある方は、お気軽にご相談ください。StartLinkでは、HubSpotゴールドパートナーとして、AIを前提とした業務設計から運用定着まで一貫して支援しています。無料相談はこちら


株式会社StartLinkは、事業推進に関わる「販売促進」「DXによる業務効率化(ERP/CRM/SFA/MAの導入)」などのご相談を受け付けております。 サービスのプランについてのご相談/お見積もり依頼や、ノウハウのお問い合わせについては、無料のお問い合わせページより、お気軽にご連絡くださいませ。

関連キーワード:
AI

サービス資料を無料DL

著者情報

7-1

今枝 拓海 / Takumi Imaeda

株式会社StartLink 代表取締役。累計150社以上のHubSpotプロジェクト支援実績を持ち、Claude CodeやHubSpotを軸にしたAI活用支援・経営基盤AXのコンサルティング事業を展開。
HubSpotのトップパートナー企業や大手人材グループにて、エンタープライズCRM戦略策定・AI戦略ディレクションを経験した後、StartLinkを創業。現在はCRM×AIエージェントによる経営管理支援を専門とする。