---
title: セルフホスト型サンドボックスでのメモリストア
url: https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-memory
description: セルフホスト型サンドボックスで実行されるClaude Managed Agentsのセッションにメモリストアをアタッチします。ホストの準備、同期の設定、読み取り専用ストアと競合の処理について説明します。
featureMetadata:
  topic:
    title: Managed Agents
    url: https://platform.claude.com/docs/en/managed-agents/overview
  status: beta
  betaHeader: managed-agents-2026-04-01
  zdr:
    eligibility: not-eligible
    note: セルフホスト型Managed Agentsを除き、ZDRの適格対象ではありません。セッションはステートフルなリソースであり、トランスクリプトは削除するまで保持されます。
  supportedModels:
    - claude-fable-5-2
    - claude-mythos-5-2
    - claude-fable-5-1
    - claude-mythos-5-1
    - claude-fable-5
    - claude-mythos-5
    - claude-mythos-preview
    - claude-opus-5-5
    - claude-opus-5
    - claude-sonnet-5-5
    - claude-sonnet-5
    - claude-haiku-5-5
    - claude-haiku-4-5-20251001
    - claude-opus-4-8
    - claude-opus-4-7
    - claude-opus-4-6
    - claude-sonnet-4-6
    - claude-opus-4-5-20251101
    - claude-sonnet-4-5-20250929
  supportedPlatforms:
    Claude API: beta
---

セルフホスト環境上のセッションは、クラウド環境上のセッションとまったく同じ方法で[メモリストア](https://platform.claude.com/docs/ja/managed-agents/memory)をアタッチします。[セッションにメモリストアをアタッチする](https://platform.claude.com/docs/ja/managed-agents/memory#attach-a-memory-store-to-a-session)に示すように、セッションを作成する際に`resources` (csharp, go: `Resources`)にそれらを列挙します。1つのセッションには最大8個のメモリストアをアタッチできます。

違いは、誰がストアを実体化するかです。セルフホスト環境では、Anthropicのインフラストラクチャではなくお使いのワーカーが、各ストアをサンドボックスにダウンロードし、エージェントによる変更を同期して戻します。

## 要件

* **メモリストアをマウントするワーカー：** `ant` CLI 1.33.0以降、またはPython、TypeScript、Go SDKの`EnvironmentWorker`を使用してください。
* **POSIXファイルシステム：** ワーカーはメモリファイルを開く際に`O_NOFOLLOW`を必要とするため、Windowsホストはサポートされていません。大文字と小文字の違いのみで異なるメモリパスが衝突しないように、Anthropicは大文字と小文字を区別するファイルシステムを推奨します。macOSのボリュームはデフォルトで大文字と小文字を区別しないため、そのようなパスはmacOS上では衝突します。
* **書き込み可能な`/mnt/memory`ディレクトリ：** [ホストを準備する](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-memory#prepare-the-host)を参照してください。macOSの場合は、[macOSホストを準備する](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-memory#prepare-a-macos-host)を参照してください。
* **ワークアイテムのシークレット：** 独自のコードでワーカーを起動する場合は、[ワークアイテムのシークレットを転送](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-per-session#forward-the-work-items-secret)してください。

## ホストを準備する

macOSでは、次のコマンドをスキップし、代わりに[macOSホストを準備する](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-memory#prepare-a-macos-host)の手順に従ってください。

ワーカーを起動する前に、親ディレクトリを作成し、ワーカーを実行するユーザーが書き込めるようにします：

```bash
sudo mkdir -p /mnt/memory && sudo chown "$USER" /mnt/memory
```

ストアのディレクトリは自分で作成しないでください。ワーカーは、セッションを取得した時点で各ストアの`mount_path` (java, php: `mountPath`; csharp, go: `MountPath`)ディレクトリ（例：`/mnt/memory/user-preferences`）を作成し、そのセッションの処理を終えた時点で削除します。そのパスにすでに何かが存在する場合は、空のディレクトリであっても、ワーカーはワークアイテムを失敗させます。

[セッションごとのサンドボックスパターン](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-per-session)では、サンドボックスイメージに書き込み可能な`/mnt/memory`が必要です。ストアがすべてのメモリの永続的なコピーを保持するため、メモリディレクトリをホストにバインドマウントする必要はありません。

### macOSホストを準備する

macOSではルートボリュームが読み取り専用であるため、`mkdir`で`/mnt`を作成することはできません。代わりに、書き込み可能なデータボリューム上に`/System/Volumes/Data/mnt/memory`を作成します。次に、`/etc/synthetic.conf`に1行を追加して、macOSが`/mnt`を`/System/Volumes/Data/mnt`へのシンボリックリンクとして作成するようにします。これらの手順には管理者権限が必要です。

このセットアップを行わないと、ワーカーはストアのディレクトリを作成できないため、ワークアイテムを失敗させます。その場合、セッションはエラーイベントなしでアイドル状態のままになります。[メモリストアのマウントまたは同期に失敗する](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-operations#memory-stores-fail-to-mount)を参照してください。

<Steps>
  <Step title="データボリューム上にディレクトリを作成する">
    `memory`ディレクトリを作成し、ワーカーのユーザーをその所有者にします。`$USER`はご自身のユーザー名です。ワーカーが別のユーザーとして実行される場合は、`"$USER"`をそのユーザーの名前に置き換えてください。

    ```bash
    sudo mkdir -p /System/Volumes/Data/mnt/memory && sudo chown "$USER" /System/Volumes/Data/mnt/memory
    ```

    この場所は選択肢の1つにすぎません。別の場所を使用する場合は、`synthetic.conf`の行のパスをそれに合わせて変更してください。Anthropicがテストしたのは`/System/Volumes/Data/mnt`のみです。
  </Step>

  <Step title="synthetic.confに1行を追加する">
    `cat -et /etc/synthetic.conf`を実行します。これにより、各タブが`^I`として、各行末が`$`として表示されます。

    * `mnt^ISystem/Volumes/Data/mnt$`という行がある場合、この手順はすでに完了しています。次の手順に進んでください。
    * `mnt`で始まる別の行がある場合は、中止してください。このMac上の別の何かがすでに`/mnt`を定義しています。
    * 最後の行が`$`で終わっていない場合は、`echo | sudo tee -a /etc/synthetic.conf`を実行して行を終端させてください。その後、行を追加します。
    * 何も出力されない場合、または`No such file or directory`と報告される場合は、行を追加します。次のコマンドは、ファイルが存在しない場合に作成します。
    * それ以外の場合は、行を追加します。

    行を追加するには、このコマンドを実行します。このコマンドは実行するたびに行が追加されるため、1回だけ実行してください。

    ```bash
    printf 'mnt\tSystem/Volumes/Data/mnt\n' | sudo tee -a /etc/synthetic.conf
    ```

    このコマンドは追加した行を出力します。この行は、名前`mnt`を`memory`を含むディレクトリにマッピングします。ファイルには2つの列の間にタブが必要であり、それを`\t`が書き込みます。
  </Step>

  <Step title="リンクを作成する">
    `-t`オプションを付けて`apfs.util`を実行します。これにより、追加した行からリンクが再起動なしで作成されます。

    ```bash
    sudo /System/Library/Filesystems/apfs.fs/Contents/Resources/apfs.util -t
    ```
  </Step>

  <Step title="結果を確認する">
    `/mnt`と`/mnt/memory`を一覧表示します。

    ```bash
    ls -ld /mnt /mnt/memory
    ```

    1行目は`/mnt -> System/Volumes/Data/mnt`で終わります。2行目には、ワーカーのユーザーが`/mnt/memory`の所有者として表示されます。これでワーカーを起動できます。
  </Step>
</Steps>

Anthropicは、このセットアップを`ant` CLIワーカーを使用してmacOS 26.7.1でテストしています。

### ストアを共有するセッションを分離する

2つのセッションは同じパスを必要とするため、1つのファイルシステム上で同じストアを同時にマウントすることはできません。ストアを共有するセッションを並行して実行するには、各セッションに専用のファイルシステムを割り当ててください。セッションごとにサンドボックスを使用すると、各セッションに専用のファイルシステムが自動的に割り当てられます。[セッションごとに1つのサンドボックスを実行する](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-per-session)を参照してください。1つのホストでこのようなサンドボックスを多数実行できます。

## ワーカーによるメモリの処理方法

メモリストアがアタッチされたセッションのワークアイテムを取得すると、ワーカーは次の処理を行います：

1. **各ストアを`mount_path` (java, php: `mountPath`; csharp, go: `MountPath`)にダウンロードします。** これはクラウドセッションが使用するのと同じ`/mnt/memory/`配下のディレクトリであり、セッションのシステムプロンプトがエージェントにそれを説明します。たとえば、「User Preferences」という名前のストアは`/mnt/memory/user-preferences/`に配置されます。
2. **それらのディレクトリをファイルツールに公開します。** エージェントは、作業ディレクトリで使用するのと同じファイルツールでメモリを操作します。
3. **ツール呼び出しの後に同期します。** 前回の同期から[同期間隔](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-memory#sync-interval)（デフォルトでは15秒）が経過している場合、ワーカーはツール呼び出しの後に同期します。各同期では、変更されたメモリをストアからディスクに書き込み、エージェントが変更したファイルをアップロードします。
4. **セッションが終了したとき、またはセッションがワーカーのアイドル制限の間アイドル状態のままだったときに、最終同期を実行します。** 最終同期には最大60秒かかる場合があります。それまでにアップロードされなかった変更は失われます。その後、ワーカーは作成したディレクトリを削除します。

アイドル制限はデフォルトで60秒です。制限の対象と変更方法については、[ワーカーがセッションの処理を終えるタイミング](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-reference#when-the-worker-finishes-with-a-session)で説明しています。

エージェントの`write`ツールと`edit`ツールはローカルコピーのみを変更し、ワーカーはそれらの変更を次の同期時にアップロードします。`/mnt/memory/`配下のストアディレクトリ以外のパスは、「scratch space」（一時的な作業領域）ではありません。ワーカーのファイルツールはそれらへの書き込みを拒否し、シェルコマンドがそこに書き込んだものがストアに同期されることはありません。

[メモリのバージョン](https://platform.claude.com/docs/ja/managed-agents/memory#audit-memory-changes)、墨消し、Claude Console でのメモリの表示や編集は、クラウドセッションの場合と同じように機能します。エージェントによるメモリの読み書きは、通常のツールイベントとして[イベントストリーム](https://platform.claude.com/docs/ja/managed-agents/events-and-streaming)に表示されます。

各ストアディレクトリには、ディレクトリをそのストアに結び付ける`.anthropic-memory-store`という名前のマーカーファイルが含まれています。これはそのままにしておいてください。マーカーが欠落しているか改変されており、かつディレクトリにまだファイルが残っている場合、ワーカーはそのディレクトリを同期しません。また、セッションの処理を終えたときにそのディレクトリを削除することもありません。

<Warning>
  セッション中にワーカーを正常に停止した場合、または[セッションのワークアイテムを停止した](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-operations#stop-a-session-gracefully)場合、それでもワーカーは新規および変更されたファイルをアップロードします。また、ストアディレクトリも削除します。削除は送信しないため、エージェントが削除したメモリは、それ以前の同期ですでにストアから削除されていない限り、ストアに残ります。停止されるのではなく強制終了されたワーカーはティアダウンを実行しないため、同期されていない編集は失われ、ストアディレクトリは残ったままになります。[ワーカーを正常に停止する](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-operations#stop-workers-gracefully)を参照してください。
</Warning>

## 同期を設定する

2つの`EnvironmentWorker`オプションがメモリの動作を制御します。Webhookハンドラー内を含め、ワーカーを構築する場所でこれらを設定してください。`ant` CLIワーカーは常にデフォルト値を使用します。

### 同期間隔

`memory_sync_interval` (typescript: `memorySyncIntervalMs`; go: `MemorySyncInterval`)は、セッションの実行中に2回の同期の間に置く最短の時間を設定します。

| 設定 | 値 |
| ----- | ----- |
| デフォルト | 15秒 |
| 最小値 | 5秒 |
| 例（10秒） | `10` (typescript: `10_000`; go: `10 * time.Second`) |
| メモリサポートを無効化 | `None` (typescript: `null`; go: `-1`) |

ワーカーはタイマーで同期するわけではありません。`bash`、`read`、カスタムツールなど、サンドボックス内で実行されるツールが呼び出されるたびに、その後で間隔を確認します。その呼び出しがメモリに触れる必要はありません。ツール呼び出しがなければ、[最終同期](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-memory#how-the-worker-handles-memory)まで何も同期されません。あるセッションでの変更は、両方のセッションが同期した後にのみ実行中の別のセッションに反映されるため、待ち時間は一定ではありません。

間隔を短くすると、別のセッションが古いメモリを参照する時間枠が狭まりますが、その代わりにメモリストアへのリクエストが増えます。

メモリサポートを無効にするのは、セッションがメモリストアをアタッチしないワーカーに限ってください。無効化されたワーカーはストアのダウンロードも同期も行わないため、ストアがアタッチされたセッションは、システムプロンプトがそれらを説明しているにもかかわらず、ストアなしで実行されます。

メモリサポートが有効な間、ストアがアタッチされたセッションのワークアイテムが`secret` (csharp, go: `Secret`)なしで届いた場合、メモリなしで実行されるのではなく失敗します。[メモリストアのマウントまたは同期に失敗する](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-operations#memory-stores-fail-to-mount)を参照してください。

### 削除

`memory_sync_deletions` (typescript: `memorySyncDeletions`; go: `MemorySyncDeletions`)は、エージェントがローカルで削除したファイルをストアからも削除するかどうかを設定します。アップロードとダウンロードには影響しません。

| 値 | 動作 |
| ----- | ----- |
| `"enabled"` (go: `environments.MemorySyncDeletionsEnabled`)（デフォルト） | 後続の同期でファイルが引き続き存在しないことが確認された時点で、ストアからメモリを削除します。 |
| `"log_only"` (go: `environments.MemorySyncDeletionsLogOnly`) | 同じチェックを実行しますが、削除したであろう内容をログに記録するだけです。有効モードを信頼する前に、ワーカーが何を削除するかを確認するために使用してください。 |
| `"disabled"` (go: `environments.MemorySyncDeletionsDisabled`) | ストアから削除することはありません。 |

たとえば、最大でも10秒に1回同期し、ワーカーが行ったであろう削除をログに記録するだけにするには、次のサンプルを使用します。このサンプルでは作業ディレクトリとして`/workspace`を使用しており、このディレクトリはワーカーの起動前に存在している必要があります。ディレクトリの作成方法とmacOSで使用するものについては、[常時稼働ワーカーを実行する](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-workers#run-an-always-on-worker)を参照してください。

<CodeGroup exclude="shell, csharp, java, php, ruby">
  <CodeGroupItem language="cURL">
    ワーカーは単一のHTTPリクエストではなく、長時間実行されるプロセスです。同期設定を変更するには、Python、TypeScript、またはGo SDKの`EnvironmentWorker`を使用してください。
  </CodeGroupItem>

  <CodeGroupItem language="CLI">
    `ant` CLIワーカーは常にデフォルトの同期設定を使用します。変更するには、Python、TypeScript、またはGo SDKの`EnvironmentWorker`を使用してください。
  </CodeGroupItem>

  ```python Python
  import asyncio
  import contextlib
  import os
  import signal
  from anthropic import AsyncAnthropic
  from anthropic.lib.environments import EnvironmentWorker


  async def main() -> None:
      environment_key = os.environ["ANTHROPIC_ENVIRONMENT_KEY"]
      environment_id = os.environ["ANTHROPIC_ENVIRONMENT_ID"]
      async with AsyncAnthropic(auth_token=environment_key) as client:
          worker = EnvironmentWorker(
              client,
              environment_id=environment_id,
              environment_key=environment_key,
              workdir="/workspace",
              memory_sync_interval=10,  # seconds
              memory_sync_deletions="log_only",
          )
          task = asyncio.create_task(worker.run())
          loop = asyncio.get_running_loop()
          for signum in (signal.SIGINT, signal.SIGTERM):
              loop.add_signal_handler(signum, task.cancel)
          with contextlib.suppress(asyncio.CancelledError):
              await task


  asyncio.run(main())
  ```

  ```typescript TypeScript
  import Anthropic from "@anthropic-ai/sdk";
  import { EnvironmentWorker } from "@anthropic-ai/sdk/helpers/beta/environments";

  const environmentKey = process.env.ANTHROPIC_ENVIRONMENT_KEY!;
  const environmentId = process.env.ANTHROPIC_ENVIRONMENT_ID!;
  const client = new Anthropic({ authToken: environmentKey });
  const controller = new AbortController();
  process.once("SIGINT", () => controller.abort());
  process.once("SIGTERM", () => controller.abort());

  const worker = new EnvironmentWorker({
    client,
    environmentId,
    environmentKey,
    workdir: "/workspace",
    signal: controller.signal,
    memorySyncIntervalMs: 10_000,
    memorySyncDeletions: "log_only"
  });
  await worker.run();
  ```

  <CodeGroupItem language="C#">
    C# SDKには`EnvironmentWorker`がありません。
  </CodeGroupItem>

  ```go Go
  package main

  import (
  	"context"
  	"log"
  	"os"
  	"os/signal"
  	"syscall"
  	"time"

  	"github.com/anthropics/anthropic-sdk-go/v2"
  	"github.com/anthropics/anthropic-sdk-go/v2/lib/environments"
  	"github.com/anthropics/anthropic-sdk-go/v2/option"
  )

  func main() {
  	environmentKey := os.Getenv("ANTHROPIC_ENVIRONMENT_KEY")
  	environmentID := os.Getenv("ANTHROPIC_ENVIRONMENT_ID")

  	ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
  	defer stop()

  	client := anthropic.NewClient(option.WithAuthToken(environmentKey))

  	worker := environments.NewEnvironmentWorker(client, environments.EnvironmentWorkerOptions{
  		EnvironmentID:       environmentID,
  		EnvironmentKey:      environmentKey,
  		Workdir:             "/workspace",
  		MemorySyncInterval:  10 * time.Second,
  		MemorySyncDeletions: environments.MemorySyncDeletionsLogOnly,
  	})
  	if err := worker.Run(ctx); err != nil {
  		log.Fatalf("worker: %v", err)
  	}
  }
  ```

  <CodeGroupItem language="Java">
    Java SDKには`EnvironmentWorker`がありません。
  </CodeGroupItem>

  <CodeGroupItem language="PHP">
    PHP SDKには`EnvironmentWorker`がありません。
  </CodeGroupItem>

  <CodeGroupItem language="Ruby">
    Ruby SDKには`EnvironmentWorker`がありません。
  </CodeGroupItem>
</CodeGroup>

## 読み取り専用ストアと競合

### 読み取り専用ストア

`access: "read_only"`でアタッチされたストアの場合、`write`ツールと`edit`ツールはそのディレクトリ内のファイルの変更を拒否します。ワーカーはそこから何もアップロードしません。

`bash`、またはサンドボックスから提供するカスタムツールやMCPサーバーを通じて行われた変更は、ローカルではブロックされません。それらがストアに届くことはありません。変更されたファイルは、次のいずれかが起こるまで変更されたままになります：

* **そのメモリにストア内で新しいバージョンが作成される。** ワーカーの次の同期で、そのバージョンによってファイルが上書きされます。
* **ワーカーがセッションの処理を終える。** ワーカーはディレクトリを削除します。

ローカルコピーも変更されないようにするには、そのエージェントの`bash`ツールを無効にしてください。また、サンドボックスのファイルシステムに書き込むカスタムツールやMCPサーバーを与えないでください。ストアのパスに読み取り専用ボリュームをマウントしないでください。マウントによってそのパスにディレクトリが作成され、そこにすでに何かが存在するとワーカーはワークアイテムを失敗させます。

### 競合

競合とは、前回の同期以降にストアとサンドボックスの両方で変更されたメモリのことです。削除も変更として扱われます。`access: "read_write"`でアタッチされたストアの場合、ワーカーは次の同期時に競合を解決します：

| ストア側 | サンドボックス側 | 結果 |
| ----- | ----- | ----- |
| 変更 | 変更 | ストアのバージョンがファイルを上書きします。 |
| 変更 | 削除 | ワーカーはストアのバージョンをサンドボックスに書き戻します。 |
| 削除 | 変更 | ワーカーはファイルからメモリを再作成します。 |

最初の2行では、ツール呼び出しが成功したにもかかわらず、エージェントによる変更または削除は失われます。エージェントには何も通知されず、失われたことを示す唯一の手がかりはワーカーのログに記録される警告です。最後の行では、ストア内での削除が取り消されます。

## トラブルシューティング

ワーカーのログメッセージとその修正方法については、[メモリストアのマウントまたは同期に失敗する](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-operations#memory-stores-fail-to-mount)を参照してください。

## 利用可能状況

セルフホスト型サンドボックスでのメモリストアはすべてのモデルでベータ版です。

### APIサポート

#### [Managed Agents](https://platform.claude.com/docs/ja/managed-agents/overview)

* 利用可能状況：利用可能

| ステータス | クラウドプラットフォーム |
| ----- | ----- |
| ベータ | Claude API |

### 必須のベータヘッダー

[ベータヘッダーの概要](https://platform.claude.com/docs/ja/api/beta-headers)

ベータヘッダーを使用すると、実験的な機能や新しいモデル機能が標準APIに組み込まれる前にアクセスできます。

* `managed-agents-2026-04-01`

### データの取り扱い

[データの取り扱いの概要](https://platform.claude.com/docs/ja/manage-claude/api-and-data-retention#feature-eligibility)

| 項目 | ゼロデータ保持 | HIPAA |
| ----- | ----- | ----- |
| ステータス | 対象外 | 対象外 |
| 詳細 | セルフホスト型Managed Agentsを除き、ZDRの適格対象ではありません。セッションはステートフルなリソースであり、トランスクリプトは削除するまで保持されます。 [詳細はこちら](https://platform.claude.com/docs/ja/managed-agents/self-hosted-data-and-access#how-long-data-is-kept) | HIPAAの適格対象ではありません。すべてのManaged Agentsのサブ機能に適用されます。 |

対象エンドポイント：

* `/v1/agents`
* `/v1/sessions`
* `/v1/environments`
