セッションを何本立ち上げても、状態が見えなければ管理できません。claude agentsの一覧、バックグラウンド起動の3経路、worktree隔離の挙動を整理しました。
セッションを何本立ち上げても、状態が見えなければ管理できません。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の構造から実務での運用判断まで、開発者・開発リーダーが判断に使える範囲を整理します。
対象読者: Claude Codeを日常的に使っていて、2本以上を並行させることがある開発者・開発リーダー。読み終える頃には、「どの作業を裏に回し、どこで人が見に行くか」の運用ルールを自分のチーム向けに設計できる状態になります。ぜひ最後までご確認ください。
まずはこの画面が解こうとしている問題と、そこに表示される情報の意味を押さえます。
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はリサーチプレビューとして提供されている機能です。
一覧の価値は、単に並んでいることではなく、状態でグループ分けされていることにあります。各行の先頭にはアイコンが付き、そのセッションがいまどうなっているかを示します。

| 状態 | 意味 | 実務上の読み方 |
|---|---|---|
| 実行中(Working) | ツールを動かして応答を生成している最中 | 触らなくてよい行 |
| 入力待ち(Needs input) | 質問・権限確認・MCPの認証などで止まっている | 最優先で見に行く行 |
| アイドル(Idle) | 次の指示を受け付けられる状態 | 仕事を追加できる行 |
| 完了(Completed) | タスクが正常に終わった | 結果を取り込む行 |
| 失敗(Failed) | エラーで終了した | 原因を確認する行 |
| 停止(Stopped) | 手動または外部から止められた | 判断済みの行 |
このうち実務でいちばん重要なのが入力待ちです。並列で走らせているときに全体のスループットを落とす原因は、たいてい「1本が確認待ちのまま誰にも気づかれずに置かれている」ことだからです。agent viewはこの行を専用のグループにまとめるので、開いた瞬間に対処すべき対象が分かります。入力待ちだけを抜き出したい場合は、入力欄にs:blockedと打つと絞り込めます。
なお、状態とは別にプロセスが生きているかどうかも示されます。プロセスが終了している行にも返信でき、その時点でClaudeが再起動します。✢のアイコンは、/loopで設定した定期タスクが次の実行までの待機に入っていることを意味します。定期実行の設計そのものはClaude Codeの/loopコマンドの解説記事にまとめています。
agent viewに並ぶのは、主にバックグラウンドで走っているセッションです。裏に回す方法は3つあり、それぞれ適した場面が異なります。

いちばん素直なのが--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本足す」用途にはこれが最短です。
すでに対話中のセッションを、そのまま裏へ送ることもできます。
/background # 現在のセッションをバックグラウンドへ(別名 /bg)
/bg 続けてテストも通しておいて # 追加の指示を添えて裏へ
/fork 別案としてキャッシュ層を挟む方向も試して # 会話を複製して別方向を走らせる
/backgroundはいま走らせている作業ごと退避させる動きで、/forkは同じ文脈から枝分かれさせて別方向を試す動きです。「ここまでの調査結果は共有したまま、2案を並行で検証したい」という場面では/forkが効きます。
裏に回すとき、その会話で有効になっていた設定はおおむね引き継がれます。権限モード、/modelや/effortで途中変更した設定、--add-dirで追加したディレクトリ、MCP設定、プラグイン設定などが該当します。「フォアグラウンドで整えた環境が、裏に回した瞬間にリセットされる」心配は不要です。
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 # 走っている全セッションを再起動する
並列実行で最も怖いのは、複数のセッションが同じファイルを同時に書き換えることです。agent viewのバックグラウンドセッションは、この問題を構造で解いています。
バックグラウンドセッションは、起動時点ではディスパッチした作業ディレクトリで動きます。そしてファイルを書き換える直前に、.claude/worktrees/配下の専用のgit worktreeへ移ってから編集します。セッションごとに別のworktreeが割り当てられるため、並行して走る別セッションとファイルを取り合いません。
ただし、次の場合は隔離が行われません。
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です。
安全側の制約も公式に明記されています。mainやmasterへは決してpushせず、強制pushもマージも行いません。リモートがないリポジトリや、そうしないよう指示した場合はPRを作りません。
「ターミナルを閉じたら止まるのでは」という疑問が出るところですが、そうはなりません。
ユーザーごとに別のプロセス(スーパーバイザー)が動いていて、バックグラウンドセッションを保持しています。状態は~/.claude/jobs/に、セッションの名簿は~/.claude/daemon/roster.jsonに保存され、スーパーバイザーの再起動を跨いで残ります。状態は次のコマンドで確認できます。
claude daemon status # スーパーバイザーの状態を表示
claude daemon stop --any --keep-workers # セッションは残したまま再起動する
マシンがスリープから復帰した場合も、保存された状態からセッションが再開されます。応答の途中でプロセスが再起動した場合も、同じ地点から続きが処理されます。
リソースを空けるため、何もしていないセッションのプロセスは約1時間で停止します。「しばらく放置していたセッションに戻ったら反応が遅い」のはこれが理由で、アタッチすれば再起動して続きから動きます。常に即応してほしいセッションはCtrl+Tでピン留めしておけば、この停止の対象から外れます。
プロセスの停止や再起動をまたぐとき、すべてが引き継がれるわけではありません。ここを誤解していると「動いているはずの監視が止まっていた」という事故になります。
| 引き継がれるもの | 停止するもの |
|---|---|
| バックグラウンドで走らせたシェルコマンド | 実行中のMonitor(監視) |
| バックグラウンド化したサブエージェント | サブエージェントが起動したシェルコマンド |
| Dynamic workflows | — |
/loopで設定した定期タスク |
— |
Monitorが引き継がれない点は特に重要です。ログやビルドを継続監視させている場合、セッションを裏に回したりプロセスが再起動したりすると監視が切れます。Monitorの設計と使いどころはClaude CodeのMonitorツールの記事で解説しています。この引き継ぎ自体を無効化したい場合は、環境変数CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1を設定します。
セッションが入力待ちになったとき、完了したとき、失敗したときには通知が発火します。通知の経路は設定のpreferredNotifChannelで選べ、Notificationフックもagent_needs_input/agent_completedという種別付きで発火します。フックを書いておけば、入力待ちをSlackに流すといった運用も組めます。フックの設計はClaude Code Hooksの記事にまとめています。
「並列で動かす仕組み」が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.jsonのenvブロックに書くのが確実です。
機能として使えることと、業務に組み込んで効果が出ることは別の話です。
agent viewが効くのは、「待ち時間が長く、途中で人の判断が数回だけ必要な作業」を複数抱えているときです。
| 場面 | 使い方 |
|---|---|
| 大きめの改修を回しながら別の調査もしたい | 改修を--bgで裏に回し、手元では調査を続けます |
| 同じ問題に2つの方針を試したい | /forkで会話ごと複製し、両方を走らせて結果を比べます |
| 定型的な後片付けを溜めておきたい | agent viewの入力欄から順に投げ、完了した行から取り込みます |
| レビュー待ちのPRが複数ある | PR番号のラベルで紐づいたセッションを追えます |
少数精鋭のチームでAIエージェントを使う場合、ボトルネックになるのはたいてい生成速度ではなく、人が確認に戻るまでの待ち時間です。入力待ちの行が一覧の上に集まる構造は、この待ち時間を短くするために効きます。確認に費やしていた時間は、そのまま設計や意思決定に回せるはずの時間です。
StartLinkでも社内の作業をAIエージェントに任せる範囲を広げていますが、増やすべきは同時に走る本数ではなく、人が判断すべき地点の見通しだと考えています。何本走らせても、詰まりに気づくのが遅ければ全体は速くなりません。agent viewは本数を増やす機能というより、増やしても破綻しない土台を用意する機能だと捉えると位置づけがはっきりします。
まずは2本から始めて、Spaceで覗いてEnterで返す回し方が体に馴染んでから増やすのが、結局は早道になります。
agent viewを使い始めるにあたって、疑問になりやすい5点にお答えします。
claude agentsを実行してもサブエージェントの一覧しか出ません。お使いのバージョンが古い可能性が高いです。agent viewにはv2.1.139以降が必要で、それより前のバージョンではclaude agentsはサブエージェントの一覧を表示するだけです。claude updateでアップデートしてから再度お試しください。設定でdisableAgentView: trueになっている場合や、環境変数CLAUDE_CODE_DISABLE_AGENT_VIEW=1が設定されている場合も画面は開きません。
動き続けます。ユーザーごとのスーパーバイザープロセスがセッションを保持しているためです。スリープからの復帰も跨げます。ただしマシンをシャットダウンすると停止します。また、何もしていないセッションのプロセスは約1時間で停止し、アタッチすると再起動します。常時即応させたい場合はCtrl+Tでピン留めしてください。
バックグラウンドセッションは、ファイルを編集する直前に.claude/worktrees/配下の専用worktreeへ移ります。セッションごとに別のworktreeが割り当てられるため、通常は衝突しません。すでにworktree内で動いている場合、gitリポジトリでない場合、書き込み先が作業ディレクトリの外である場合は隔離されません。無効化したい場合は設定に"worktree": {"bgIsolation": "none"}を指定します。
対話セッションと同じ扱いです。割引も割増もありません。10本並列で走らせれば、利用枠の消費もおよそ10倍の速さになります。並列数を決めるときは、処理の速さだけでなく利用枠の消費速度も含めて判断してください。
解いている問題が違います。agent viewは走っているセッションを一覧して操作するための画面で、セッション同士を協調させる機能ではありません。teammate同士が直接メッセージをやり取りしながら協調するのがAgent Teamsで、こちらは実験的機能として環境変数で有効化して使います。「見失わないための画面」がagent view、「協調させるための仕組み」がAgent Teamsという関係です。
Claude Codeのagent viewについて、実務で押さえておきたい点を整理します。
claude agentsで開き、v2.1.139以降で利用できます。最優先で見るべきは「入力待ち」のグループですclaude --bg、会話中の/background・/fork、agent viewの入力欄。フォアグラウンドで整えた権限やモデルの設定は裏に回しても引き継がれます.claude/worktrees/のworktreeに自動で隔離されます。並列実行の安全性はここで担保されており、逆に削除操作は未コミットの変更ごと消える点に注意が必要ですまずは2本を裏に回し、SpaceでピークしてEnterで返す運用を試してみてください。詰まっている行が一覧の上に集まる感覚がつかめれば、本数を増やしても管理が破綻しなくなります。
AI活用とCRM運用をどう組み合わせるかについてご興味がある方は、お気軽にご相談ください。StartLinkでは、HubSpotゴールドパートナーとして、AIを前提とした業務設計から運用定着まで一貫して支援しています。無料相談はこちら
株式会社StartLinkは、事業推進に関わる「販売促進」「DXによる業務効率化(ERP/CRM/SFA/MAの導入)」などのご相談を受け付けております。 サービスのプランについてのご相談/お見積もり依頼や、ノウハウのお問い合わせについては、無料のお問い合わせページより、お気軽にご連絡くださいませ。
株式会社StartLink 代表取締役。累計150社以上のHubSpotプロジェクト支援実績を持ち、Claude CodeやHubSpotを軸にしたAI活用支援・経営基盤AXのコンサルティング事業を展開。
HubSpotのトップパートナー企業や大手人材グループにて、エンタープライズCRM戦略策定・AI戦略ディレクションを経験した後、StartLinkを創業。現在はCRM×AIエージェントによる経営管理支援を専門とする。