MemoryLake
すべての記事に戻る
Tutorial2026年10月28日·11 分で読了

Claude Code の Agent View とは — バックグラウンドセッションがプロジェクトのコンテキストを共有する方法と、編集の保存先 (2026年版)

Agent view は、複数のセッションを同時に実行するための Claude Code の画面です。タスクを入力するとバックグラウンドで開始され、実行中、入力待ち、完了などのステータスが行ごとに表示されます。バグ修正、レビュー、テストの調査などを次々と投入し、別の作業を続けながら後で結果を確認することができます。

複数のセッションを同時に実行すると、単一のセッションでは発生しない疑問が生じます。各セッションはプロジェクトに関する Claude の知識を共有しているのか?あるセッションで学んだことを別のセッションで参照できるのか?2つのセッションが同じファイルを編集した場合、どちらの変更が優先されるのか?そして、行を削除すると作業内容はどうなるのか?

このガイドでは、Agent view とは何か、各バックグラウンドセッションが何を持って開始されるのか、セッション間で共有されるものとされないもの、ファイルの編集先、そして並行作業でコンテキストを失わないための対策について解説します。Agent view はリサーチプレビュー段階であるため、詳細は変更される可能性があります。

Agent view とは

Anthropic のドキュメントでは次のように説明されています。「claude agents で開く Agent view は、すべてのバックグラウンドセッション(実行中、入力が必要なもの、完了したもの)を表示する一つの画面です。」

各行は独立したセッションです。「各バックグラウンドセッションは、ターミナルに接続されていなくても実行され続ける完全な Claude Code の会話であり、いつでも開いて返信し、離れることができます。」

行の操作には3つの方法があります:

  • Dispatch(投入): 下部のプロンプトに入力して Enter を押します。「ここに入力したすべてのプロンプトは、それぞれ新しいセッションを開始します。」
  • Peek(覗き見): 行の上で Space を押すと、最新のステータス、結果、または待機中の質問を確認でき、リストを離れることなく返信できます。
  • Attach(接続): Enter または右矢印キーを押すと完全な会話が開きます。空のプロンプトで左矢印キーを押すと戻ります。

また、開いているセッションを /bg または左矢印キーで Agent view に送ったり、/fork で新しいバックグラウンドセッションにコピーしたりすることもできます。

Agent view はローカルマシン上でセッションを実行します。ドキュメントによると、Claude がクラウド上で開始・追跡する並行セッションについては Claude Code の Projects を参照してください。

各バックグラウンドセッションの開始状態

投入されたセッションは新しい会話です。他の行で議論された内容は継承されません。

ただし、その場所で開始された他の Claude Code セッションと同様に、プロジェクトの永続的なコンテキストは引き継がれます:

  • ディレクトリ: 「新しいセッションは、Agent view を開いたディレクトリで実行されます。」別のディレクトリを対象にするには、その場所で Agent view を開くか、@<repo> で子リポジトリを指定するか、そのディレクトリから claude --bg を実行します。
  • 指示ファイル: Claude Code は、セッション開始時に作業ディレクトリとその上位ディレクトリから CLAUDE.md ファイルを読み込み、.claude/rules/ 内の paths フィールドのないルールを読み込みます。パス指定のあるルールは、Claude が一致するファイルを操作する際に読み込まれます。
  • リポジトリの自動メモリ: Claude Code のメモリに関するドキュメントには、「同じ git リポジトリ内のすべてのワークツリーとサブディレクトリは、1つの自動メモリディレクトリを共有する」とあります。同じリポジトリ内のバックグラウンドセッションは、同じ場所から読み込みます。
  • Agent view で設定したモデルと設定: Agent view での /model、/effort、/fast は、次に投入するセッションの開始設定となります。また、claude agents に渡した設定フラグは投入されるセッションに引き継がれます。

メモリに関して1点注意すべき例外があります。メモリのドキュメントによると、/memory トグルで自動メモリをオフにすることはできますが、バックグラウンドセッション内で再びオンにすることはできません。そこでオフになっている場合は、ターミナルで直接開始したセッションからオンに戻す必要があります。

バックグラウンドセッションで共有されるもの、されないもの

バックグラウンドセッションはファイルを共有しますが、会話は共有しません。

ディスク上の情報は共有されます。 CLAUDE.md ファイル、ルール、および自動メモリディレクトリは、リポジトリ内のすべてのセッションで共通です。あるセッションが自動メモリにノートを保存すると、そのリポジトリの他のセッションが使用する共有ディレクトリに保存されます。Claude Code セッション間でコンテキストを共有するためのガイドでは、コンテキストを引き継ぐ他の方法についても説明しています。

会話は共有されません。 各行は独自の会話です。あるセッションへの返信で伝えたことや、そのセッションが導き出した結論は、どこかに書き込まれない限り、そのセッション内に留まります。

フォークはコピーから始まり、その後は独立します。 /fork は、現在の会話をモデル、権限モード、エフォートレベル、追加した権限付与とともに新しいバックグラウンドセッションにコピーします。その後、「2つの会話は独立しており、コピー側が行ったことが元の会話に自動的に反映されることはありません」。ドキュメントには1つの例外が記されています。セッション間メッセージングが有効な場合、どちらかのセッションの Claude が明示的に他方にメッセージを送ることができます。Claude アプリからリモートセッションをフォークするためのガイドでも、クラウドでの同様のパターンを解説しています。

セッションをバックグラウンドに送る際に引き継がれるもの。 すでに開いているセッションをバックグラウンドに移動しても、その会話は維持されます。実行中のバックグラウンドコマンド、バックグラウンド化されたサブエージェント、/loop タスクは引き継がれますが、実行中のモニターは停止し、Claude Code が事前に確認を求めます。

各セッションの編集の保存先

これは並行セッションの衝突を防ぐための重要な部分です。ドキュメントには次のように説明されています。「ファイルを編集する前に、Claude はセッションを .claude/worktrees/ 下の隔離された git ワークツリーに移動します。これにより、並行セッションは同じチェックアウトを読み取ることができますが、書き込みはそれぞれ独自の場所に行われます。」

つまり、投入されたセッションはまず作業ディレクトリを読み取り、何かを変更する前に独自のワークツリーに移動します。そのセッションが生成したサブエージェントはその作業ディレクトリを継承するため、それらの編集も同じワークツリーに保存されます。

新しいワークツリーに含まれるもの

Claude Code のワークツリーに関するドキュメントでは、作成されるワークツリーのデフォルトについて次のように説明されています。「リポジトリのデフォルトブランチから分岐し、追跡されているファイルのみをチェックアウトします。」さらに、「ワークツリーは新しいチェックアウトであるため、そこで開発環境を初期化してください」と付け加えられています。

コンテキストの観点からは、これは2つの意味で重要です:

  • 指示ファイルへの未コミットの変更は含まれません。 CLAUDE.md やルールを編集してまだコミットしていない場合、デフォルトブランチからチェックアウトされたワークツリーにはコミット済みのバージョンが含まれます。
  • Gitignore されたファイルも含まれません。 これには .env などのローカルファイルが含まれます。ワークツリーのドキュメントでは、gitignore されたファイルを新しいワークツリーに持ち込むための .worktreeinclude ファイルについて説明されています。

worktree.baseRef 設定で開始点を変更できます。デフォルトの "fresh" はリモートのデフォルトブランチから分岐します。"head" は現在のローカルの HEAD から分岐します。Claude Code のワークツリーがメモリを共有するかどうかのガイドでは、ワークツリーセッションが読み込む内容の詳細を解説しています。

Claude がワークツリーをスキップする場合

ドキュメントには、セッションがその場で編集を行うケースがリストされています。これには、開いているターミナルからバックグラウンドに移動したセッション、すでにリンクされたワークツリー内にあるセッション、git リポジトリではなくワークツリーフックがないディレクトリなどが含まれます。また、worktree.bgIsolation を "none" に設定することで、リポジトリの隔離をオフにすることもできます。

作業の保存方法

バックグラウンドセッションが独自のワークツリーでコードを変更した場合、Claude Code は終了前に作業を保存するよう Claude に指示します。リモートがある場合はブランチをコミットしてプッシュし、タスクで必要な場合はドラフトのプルリクエストを作成します。これらの指示により、main や master への直接プッシュ、フォースプッシュ、マージは除外されます。また、「タスク、CLAUDE.md、またはメモリでコミットやプッシュを自分で行うよう指定されている場合、Claude は git 操作をユーザーに任せます。」

各セッションは、何を行ったか、作業がどこにあるかのレポートで終了します。

行を削除すると何が削除されるか

Agent view からセッションを削除するとリストからは消えますが、「そのトランスクリプトは claude --resume を通じてマシン上に残ります」。Claude が作成したワークツリーについては別です。Agent view はそれを削除します。「未コミットの変更も含まれるため、残したいものは先にコミットしてください。」Claude Code は、ワークツリーに他で保存されているか確認できないコミットがある場合、削除を拒否し、進め方を指示します。

削除したセッションは、Agent view で /resume を使用してバックグラウンドの行として戻すことができます。これには削除したものを含むリポジトリの過去のセッションがリストされます。Claude Code のセッション履歴を見つけて削除するためのガイドでは、トランスクリプト自体について解説しています。

よくある間違い

各行がお互いのことを知っていると思い込む。 各セッションは独立した会話です。ディスク上のファイルは共有しますが、話された内容は共有しません。

あるセッションに決定事項を伝え、他のセッションもそれに従うと期待する。 その決定は、CLAUDE.md、ルール、またはメモリに書き込まれない限り、その会話内に留まります。

CLAUDE.md を編集してすぐにセッションを投入する。 デフォルトブランチからのワークツリーには、編集内容ではなくコミット済みのバージョンが含まれます。

コミット前に行を削除する。 Agent view は作成したワークツリーを削除し、未コミットの変更も失われます。

コンピュータがオフの間もセッションが走り続けると仮定する。 ドキュメントには制限事項として記載されています。セッションはローカルであり、マシンがシャットダウンすると停止します。スリープ状態では維持されます。

解決策:共有コンテキストをディスクに書き込み、コミットし、各セッションに報告させる

ステップ 1:すべてのセッションが必要とするコンテキストを、すべてのセッションが読み取る場所に書く

すべての並行作業に適用される規約や制約は、プロジェクトルートの CLAUDE.md または .claude/rules/ 内のスコープ指定のないルールに記述します。各行に繰り返し伝えるような決定事項もそこに記述すべきです。Claude に覚えさせたい場合は、リポジトリ内のすべてのセッションが共有する自動メモリにそのポイントを保存するよう依頼してください。

ステップ 2:投入前に指示の変更をコミットする

ワークツリーはデフォルトでデフォルトブランチから開始されるため、CLAUDE.md やルールへの変更は、それらに依存するセッションを投入する前にコミットしてプッシュしてください。セッションに進行中のブランチが必要な場合は、worktree.baseRef を "head" に設定し、作業に必要なローカルファイル用に .worktreeinclude を追加します。

ステップ 3:各セッションに学んだことを報告させる

プロンプトに、セッションが何を残すべきかを含めます。ブランチ名、見つかったことの短い要約、他のセッションが必要とする決定事項などです。行が完了したらレポートを読み、他のセッションが知るべき内容を CLAUDE.md やメモリに移動します。行を削除する前にコミットしてください。

スケジュールされた作業も実行している場合は、Claude Code のルーチンがある実行から次の実行へ何かを引き継ぐかどうかのガイドで、自動的に開始される実行に関する同様の疑問を解説しています。

MemoryLake でのセットアップ

Agent view を使うと多くのセッションを簡単に実行でき、それぞれが他のセッションにも知らせたい何かを学習します。リポジトリ内では、CLAUDE.md、ルール、自動メモリがマシン上でそれを担います。同じ決定事項が別のコンピュータや別のツールでも重要な場合、一つのチェックアウトに縛られない場所が必要になります。

MemoryLake は、そのようなコンテキストを一つのリストとして維持し、Claude Code や、接続した Codex、ChatGPT などの他のアシスタントで利用できるようにするためのメモリレイヤーです。

エントリーは自分の言葉で自分で書き込みます。バックグラウンドセッション、ワークツリー、CLAUDE.md ファイル、自動メモリ、またはベンダーのストアから何かが読み取られたり、書き込まれたり、削除されたりすることはありません。Agent view は Anthropic が説明している通りの動作を維持します。

ステップ 1:API キーを作成する

サインインしてダッシュボードからキーを生成します。このキーは MemoryLake ワークスペースに属し、Claude アカウントとは別物です。

新しいキーが作成され、エージェントで使用するためにコピーされる API キー画面を表示する MemoryLake コンソール
新しいキーが作成され、エージェントで使用するためにコピーされる API キー画面を表示する MemoryLake コンソール

ステップ 2:最初のメモリをアップロードする

解決策のステップ 3 でセッションレポートから抽出した内容(複数のセッションが必要とした決定事項、制約、発見事項)から始めましょう。1エントリーにつき1ポイントとし、日付とリポジトリのラベルを付けます。

最初のドキュメントがアップロードされ、各ファイルが検索可能なメモリとしてリストされている MemoryLake ワークスペース
最初のドキュメントがアップロードされ、各ファイルが検索可能なメモリとしてリストされている MemoryLake ワークスペース

ステップ 3:AI とエージェントを接続する

Claude Code や使用している他のアシスタントを接続します。すべてのセッションが、どこで実行されていても同じ決定事項から開始できるようになります。

メモリレイヤーに接続可能な AI クライアントとエージェントフレームワークをリストした MemoryLake の統合画面
メモリレイヤーに接続可能な AI クライアントとエージェントフレームワークをリストした MemoryLake の統合画面

実践で何が変わるか

第一の違いは、並行セッションの挙動に驚かなくなることです。セッション間では会話ではなく、ディスク上のファイルとメモリを共有していることがわかっているからです。

第二に、編集が衝突しなくなります。投入された各セッションは、設定を変更しない限りデフォルトブランチから開始される独自のワークツリーに書き込みます。

第三に、有用な情報が行とともに消えることがなくなります。作業はコミットされ、発見事項は書き留められ、トランスクリプトは再開のために残ります。コンピュータを切り替える場合は、別のマシンでの Claude Code に関するガイドで、自動メモリが引き継がない内容について解説しています。

Agent view のベストプラクティス

各行を独立した会話として扱う。 プロンプトとディスク上で必要な情報を与えてください。

共有ルールは CLAUDE.md またはスコープなしのルールに置く。 すべてのセッションがそれらを読み取ります。

投入前に指示の変更をコミットする。 ワークツリーはデフォルトでコミット済みのバージョンから開始されます。

ローカルファイルには .worktreeinclude を使用する。 Gitignore されたファイルは新しいワークツリーには含まれません。

レポートを求める。 ブランチ、結果、および他のセッションが知るべきことを報告させます。

行を削除する前にコミットする。 Agent view は Claude が作成したワークツリーを削除します。

セッションはローカルであることを忘れない。 マシンがシャットダウンすると停止します。

結論

Agent view は、多くのバックグラウンド Claude Code セッションを管理するための一つの画面です。各行は完全かつ独立した会話であり、作業ディレクトリにあるプロジェクトの CLAUDE.md、ルール、共有自動メモリを持って開始され、ファイルを編集する前に独自のワークツリーに移動します。セッションはディスク上の情報を共有しますが、各会話で話された内容は共有されず、フォークされた後はそれぞれが独立したものとなります。

すべてのセッションが必要とするコンテキストは CLAUDE.md、ルール、またはメモリに置き、投入前にコミットし、各セッションに学んだことを報告させ、行を削除する前にコミットするようにしましょう。

よくある質問

Claude Code の Agent view とは何ですか?

これは claude agents で開く画面で、すべてのバックグラウンドセッションを状態別にリスト表示します。新しいセッションの投入、進捗の確認、返信、および任意のセッションへの接続が可能です。現在はリサーチプレビュー版です。

Agent view のセッションはコンテキストを共有しますか?

ディスク上のファイル(CLAUDE.md、ルール、リポジトリの自動メモリディレクトリ)は共有します。会話の内容は共有しません。各セッションは独立した会話です。

バックグラウンドセッションはどこに変更を加えますか?

.claude/worktrees/ 下の独自の git ワークツリー内です。投入されたセッションは、ファイルを編集する前にそこへ移動するため、並行セッション同士で上書きし合うことはありません。

バックグラウンドセッションが最新の CLAUDE.md の編集を反映しないのはなぜですか?

新しいワークツリーはデフォルトでリポジトリのデフォルトブランチから分岐し、追跡されているファイルのみをチェックアウトするため、未コミットの編集は含まれません。コミットするか、worktree.baseRef を "head" に設定してください。

Agent view でセッションを削除するとどうなりますか?

セッションはリストから消えますが、トランスクリプトは claude --resume で引き続き利用可能です。Agent view は Claude が作成したワークツリーを削除し、これには未コミットの変更も含まれます。

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

はい。ターミナルが接続されていなくても実行され続けます。スリープ状態でも維持されますが、マシンがシャットダウンすると停止します。