---
title: セルフホストワーカーリファレンス
url: https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-reference
description: セルフホスト型サンドボックスワーカーのリファレンス：ant CLIフラグ、環境変数、ホスト要件、ファイルシステムパス、SDKヘルパーオプション。
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
    Claude Platform on AWS: beta
---

このページでは、`self_hosted`環境を処理する事前構築済みのワーカーについて説明します。タスク指向のガイドについては、まず[セルフホスト型サンドボックス](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes)と[セルフホストワーカーをデプロイする](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-workers)を参照してください。

## CLIコマンドとフラグ

| コマンド | 説明 |
| ----- | ----- |
| `ant beta:worker poll` | 環境のキューからワークアイテムを取得し、各セッションをプロセス内で実行します。`--on-work`を指定すると、代わりにワークアイテムごとにスクリプトを呼び出します。 |
| `ant beta:worker run` | 取得済みの1つのセッションを処理して終了します。セッションごとのサンドボックスのエントリポイントとして使用します。 |

| フラグ | 説明 |
| ----- | ----- |
| `--environment-id` | ワークをポーリングする環境。`ANTHROPIC_ENVIRONMENT_ID`からも読み取ります。 |
| `--environment-key` | この環境に対してワーカーを認証します。`ANTHROPIC_ENVIRONMENT_KEY`からも読み取ります。 |
| `--workdir` | ワーカーがスキルをダウンロードし、ツールがファイルを読み書きするディレクトリ。デフォルトは`.`（カレントディレクトリ）です。ワーカーの起動前にこのディレクトリが存在している必要があります。 |
| `--on-work` | ツールをプロセス内で実行する代わりに、取得したワークアイテムごとに呼び出すスクリプト。セッションの詳細を環境変数として、ワークアイテムをJSONとして標準入力で受け取ります。 |
| `--max-idle` | セッションがアイドル状態の間、`ant beta:worker run`が終了する、または`ant beta:worker poll`が次のワークアイテムに移るまでワーカーが待機する時間。[`requires_action`の停止理由](https://platform.claude.com/docs/ja/managed-agents/events-and-streaming#respond-when-the-session-goes-idle)によるアイドル時間はカウントされません。デフォルトは`60s`です。タイムアウトを無効にするには`0`に設定します。`--on-work`スクリプトを使用する場合、`ant beta:worker poll`はこのフラグを無視します。代わりに、スクリプトが起動する`ant beta:worker run`コマンドにこのフラグを渡してください。 |
| `--log-format` | ログの出力形式。構造化ログの取り込みには`json`を使用します。デフォルトは`text`です。 |

## 環境変数

| 変数 | 説明 | 設定者 |
| ----- | ----- | ----- |
| `ANTHROPIC_ENVIRONMENT_ID` | ワーカーが処理するキューを持つ環境。 | お客様がワーカーホスト上で設定します。ポーラーはこれを`--on-work`スクリプトに渡します。 |
| `ANTHROPIC_ENVIRONMENT_KEY` | ワーカーをそのキューに対して認証します。 | お客様がワーカーホスト上で設定します。ポーラーはこれを`--on-work`スクリプトに渡します。 |
| `ANTHROPIC_SESSION_ID` | 取得したワークアイテムが表すセッション。 | ポーラーが`--on-work`スクリプト用に設定します。 |
| `ANTHROPIC_WORK_ID` | 取得したワークアイテム。 | ポーラーが`--on-work`スクリプト用に設定します。 |
| `ANTHROPIC_WORK_SECRET` | ワークアイテムの、そのセッション用のシークレット。 | お客様が設定します。ポーラーは設定しません。[ワークアイテムのシークレットを転送する](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-per-session#forward-the-work-items-secret)を参照してください。 |
| `ANTHROPIC_BASE_URL` | デフォルトのAPIエンドポイントを上書きします。省略可能です。 | お客様がワーカーホスト上で設定します。 |
| `ANTHROPIC_WEBHOOK_SIGNING_KEY` | 受信したWebhookペイロードを検証します。 | お客様がWebhookハンドラーホスト上で設定します。 |

## ホスト要件

| ワーカー | 要件 |
| ----- | ----- |
| すべてのワーカー | `/bin/bash` がまさにそのパスに存在するLinuxまたはmacOSホスト。ワーカーの`bash`ツールは `PATH` を参照せずに直接これを実行します。macOSでは、これはシステムのBash 3.2です。 |
| TypeScript SDK | `PATH`上の`unzip`と`tar`、およびNode.js 22以降。 |
| PythonおよびGo SDK | 追加のバイナリは不要です。これらのSDKはアーカイブの展開に標準ライブラリを使用します。 |

[メモリストア](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-memory#requirements)には独自の要件が追加されます。

macOSではルートボリュームが読み取り専用であるため、`mkdir` で `/workspace` を作成できません。ワーカーの作業ディレクトリを、ホームディレクトリ内の `workspace` ディレクトリなど、書き込み可能なディレクトリに設定してください。macOSでメモリストアを使用するには、まず[macOSホストを準備](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-memory#prepare-a-macos-host)してください。

## サンドボックスのファイルシステム

| パス | 内容 |
| ----- | ----- |
| `/workspace` | セルフホスト型サンドボックスの各ページのサンプルで使用している作業ディレクトリ。これはワーカーのデフォルトではありません。`--workdir`または`workdir` (go: `Workdir`)を設定しない限り、ワーカーはカレントディレクトリを使用します。Anthropicのクラウドサンドボックスでは、スキルとリポジトリを`/workspace`に保持します。別の作業ディレクトリを使用する場合は、Claudeがスキルファイルを見つけられるようにエージェントのシステムプロンプトを更新してください。 |
| `<workdir>/skills/<name>/` | エージェントのダウンロード済みスキル。 |
| `/mnt/memory/<store>/` | アタッチされた各メモリストアのローカルコピーで、ストアごとに1つのディレクトリ。APIは、セッションのメモリストアリソースの`mount_path` (java, php: `mountPath`; csharp, go: `MountPath`)フィールドで各ディレクトリのフルパスを返します（例：`/mnt/memory/user-preferences/`）。 |

ワーカーはセッションを取得したときにメモリストアのディレクトリを作成します。そのセッションの処理を終えたとき、または[ワーカーを正常に停止](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-operations#stop-workers-gracefully)したときに、これらのディレクトリを削除します。削除されるのはローカルコピーのみで、メモリはストアに残ります。

スキルには、エージェントが直接実行できる実行可能ファイルを含めることができます。CLIおよびSDKのワーカーは、スキルバンドルを展開する際に、バンドルに記録された実行権限を保持します。スキルを自分でダウンロードする場合は、実行権限も自分で設定してください。

### ワーカーがセッションの処理を終えるタイミング

ワーカーは、次のいずれかの場合にセッションの処理を終えます：

* セッションが終了した場合。
* [セッションのワークアイテムを停止](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-operations#stop-a-session-gracefully)した場合。
* セッションがワーカーのアイドル制限の間アイドル状態のままだった場合。セッション自体は開いたままです。その後、ユーザーメッセージなどの新しいイベントを送信すると、同じワーカーまたは別のワーカーがセッションを取得します。そのワーカーはストアを再度ダウンロードします。

アイドル制限はデフォルトで60秒です。変更するには、`ant` CLIワーカーの場合は[`--max-idle`](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-reference#cli-commands-and-flags)を、`EnvironmentWorker`の場合は[`max_idle` (typescript: `maxIdleMs`; go: `MaxIdle`)](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-reference#environment-worker)を使用します。[`cma-sandboxes` Helmチャート](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-per-session#run-sandboxes-on-kubernetes)は、代わりに30分の制限でワーカーを起動します。この制限を変更するには、チャートの`sandbox.idleTimeout`設定を変更してください。

### 最終成果物

セルフホスト型サンドボックスには`/mnt/session/outputs`ディレクトリがありません。Anthropicのクラウドサンドボックスでは、セッションのシステムプロンプトがエージェントに最終成果物をそこへコピーするよう指示します。セルフホスト環境では、システムプロンプトからその指示が省略されます。最終成果物はエージェントが書き込んだ場所（通常は作業ディレクトリ配下）に残り、ワーカーはそれらをアップロードしません。

最終成果物を1か所に集めるには、エージェントのシステムプロンプトでディレクトリのフルパスを指定してください。ワーカーのファイルツールが書き込めるディレクトリを選択してください：

* **作業ディレクトリ内：** たとえば、作業ディレクトリが`/workspace`の場合は`/workspace/outputs`。
* **その他の場所（SDKワーカーのみ）：** ディレクトリを`allowed_roots` (typescript: `allowedRoots`; go: `AllowedRoots`)に追加します。[AgentToolContextとエージェントツールセット](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-reference#agent-tool-context-and-the-agent-toolset)を参照してください。

## SDKヘルパー

Python、TypeScript、Go SDKは、制御レベルの異なる3つのヘルパーを提供します：

| ヘルパー | 機能 | 使用する場面 |
| ----- | ----- | ----- |
| [`EnvironmentWorker`](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-reference#environment-worker) | ポーリング、セットアップ、ツールの実行をエンドツーエンドで処理します。 | ほとんどの場合。 |
| [`work.poller()` (typescript: `new WorkPoller()`; go: `environments.NewWorkPoller()`)](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-reference#work-poller) | ワークキューをポーリングし、取得した各セッションを渡します。 | 各セッションの処理方法を自分で決定する場合。たとえば、ツールをプロセス内で実行する代わりにサンドボックスを起動する場合など。 |
| [`client.beta.sessions.events.tool_runner()` (typescript: `client.beta.sessions.events.toolRunner()`; go: `client.Beta.Sessions.Events.NewToolRunner()`)](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-reference#session-tool-runner) | セッションIDとツールリストを受け取り、単一セッションのツール呼び出しを実行します。 | すでにワークを取得済みで、ツールの実行のみが必要な場合。 |

### EnvironmentWorker

| メソッド | 説明 |
| ----- | ----- |
| `run()` (go: `Run()`) | 無期限に実行され、到着したセッションを順次処理します。 |
| `handle_item()` (typescript: `handleItem()`; go: `HandleItem()`) | ポーラーによってすでに取得された単一のワークアイテムを処理します。ポーラーは`ant beta:worker poll --on-work`でも独自のコードでもかまいません。このメソッドは、ワーカーがそのアイテムのセッションの処理を終えたときに戻ります。`work_id` (typescript: `workId`; go: `WorkID`)、`session_id` (typescript: `sessionId`; go: `SessionID`)、`environment_id` (typescript: `environmentId`; go: `EnvironmentID`)、`work_secret` (typescript: `workSecret`; go: `WorkSecret`)を渡すことができます。省略したものについては、メソッドが対応する[`ANTHROPIC_*`変数](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-reference#environment-variables)を読み取ります。 |

| オプション | 説明 |
| ----- | ----- |
| `tools` (go: `ToolsFunc`) | セッションの`AgentToolContext`を受け取り、ツールリストを返すファクトリ。デフォルトは標準のエージェントツールセットです。 |
| `max_idle` (typescript: `maxIdleMs`; go: `MaxIdle`) | セッションの処理を終えるまでに、セッションがアイドル状態の間ワーカーが待機する時間。[`requires_action`の停止理由](https://platform.claude.com/docs/ja/managed-agents/events-and-streaming#respond-when-the-session-goes-idle)によるアイドル時間はカウントされません。デフォルトは60秒です。5分間待機するには、`300` (typescript: `300_000`; go: `anthropic.Ptr(5 * time.Minute)`)に設定します。制限を無効にするには、`None` (typescript: `0`; go: `new(time.Duration)`)に設定します。 |
| `memory_sync_interval` (typescript: `memorySyncIntervalMs`; go: `MemorySyncInterval`) | セッション実行中に、アタッチされたメモリストアを同期する間隔の最短時間。ワーカーはタイマーではなく、サンドボックス内で実行されるツールの呼び出しのたびに間隔を確認します。デフォルトは15秒です。[同期間隔](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-memory#sync-interval)を参照してください。 |
| `memory_sync_deletions` (typescript: `memorySyncDeletions`; go: `MemorySyncDeletions`) | エージェントがローカルで削除したファイルをストアからも削除するかどうか。[削除](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-memory#deletions)を参照してください。 |

`EnvironmentWorker`は`AgentToolContext`とツールセットを自動的に管理します。ツールリストをカスタマイズするには、`tools` (go: `ToolsFunc`)ファクトリを渡します：

<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, beta_async_tool
  from anthropic.lib.environments import EnvironmentWorker
  from anthropic.lib.tools.agent_toolset import beta_bash_tool


  @beta_async_tool
  async def get_order_status(order_id: str) -> str:
      """Look up an order in the internal fulfillment system by order ID."""
      return f"Order {order_id}: shipped"


  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,
              # エージェントが呼び出せるすべてのツールを列挙します。ワーカーはそれ以外のツールには応答しません。
              tools=lambda env: [beta_bash_tool(env), get_order_status],
          )
          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";
  import { betaTool } from "@anthropic-ai/sdk/helpers/beta/json-schema";
  import { betaBashTool } from "@anthropic-ai/sdk/tools/agent-toolset/node";

  const getOrderStatus = betaTool({
    name: "get_order_status",
    description: "Look up an order in the internal fulfillment system by order ID.",
    inputSchema: {
      type: "object",
      properties: { order_id: { type: "string", description: "The order ID" } },
      required: ["order_id"]
    },
    run: async ({ order_id }) => `Order ${order_id}: shipped`
  });

  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());

  await new EnvironmentWorker({
    client,
    environmentId,
    environmentKey,
    signal: controller.signal,
    // エージェントが呼び出せるツールをすべて列挙します。ワーカーはそれ以外のツールには応答しません。
    tools: (ctx) => [betaBashTool(ctx), getOrderStatus]
  }).run();
  ```

  <CodeGroupItem language="C#">
    C# SDKには`EnvironmentWorker`がありません。独自のコードからカスタムツール呼び出しに応答するには、[カスタムツールの結果を返す](https://platform.claude.com/docs/ja/managed-agents/events-and-streaming#return-a-custom-tool-result)のように、各結果をセッションのイベントストリームで送信してください。
  </CodeGroupItem>

  ```go Go
  package main

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

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

  type orderStatusInput struct {
  	OrderID string `json:"order_id"`
  }

  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()

  	getOrderStatus := toolrunner.NewBetaTool(
  		"get_order_status",
  		"Look up an order in the internal fulfillment system by order ID.",
  		anthropic.BetaToolInputSchemaParam{
  			Properties: map[string]any{
  				"order_id": map[string]any{"type": "string", "description": "The order ID"},
  			},
  			Required: []string{"order_id"},
  		},
  		func(ctx context.Context, input orderStatusInput) (anthropic.BetaToolResultBlockParamContentUnion, error) {
  			return anthropic.BetaToolResultBlockParamContentUnion{
  				OfText: &anthropic.BetaTextBlockParam{Text: "Order " + input.OrderID + ": shipped"},
  			}, nil
  		},
  	)

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

  	worker := environments.NewEnvironmentWorker(client, environments.EnvironmentWorkerOptions{
  		EnvironmentID:  environmentID,
  		EnvironmentKey: environmentKey,
  		// エージェントが呼び出せるすべてのツールを列挙します。ワーカーはそれ以外のツールには応答しません。
  		ToolsFunc: func(env *agenttoolset.AgentToolContext) []anthropic.BetaTool {
  			return []anthropic.BetaTool{agenttoolset.BetaBashTool(env), getOrderStatus}
  		},
  	})
  	if err := worker.Run(ctx); err != nil {
  		log.Fatalf("worker: %v", err)
  	}
  }
  ```

  <CodeGroupItem language="Java">
    Java SDKには`EnvironmentWorker`がありません。独自のコードからカスタムツール呼び出しに応答するには、[カスタムツールの結果を返す](https://platform.claude.com/docs/ja/managed-agents/events-and-streaming#return-a-custom-tool-result)のように、各結果をセッションのイベントストリームで送信してください。
  </CodeGroupItem>

  <CodeGroupItem language="PHP">
    PHP SDKには`EnvironmentWorker`がありません。独自のコードからカスタムツール呼び出しに応答するには、[カスタムツールの結果を返す](https://platform.claude.com/docs/ja/managed-agents/events-and-streaming#return-a-custom-tool-result)のように、各結果をセッションのイベントストリームで送信してください。
  </CodeGroupItem>

  <CodeGroupItem language="Ruby">
    Ruby SDKには`EnvironmentWorker`がありません。独自のコードからカスタムツール呼び出しに応答するには、[カスタムツールの結果を返す](https://platform.claude.com/docs/ja/managed-agents/events-and-streaming#return-a-custom-tool-result)のように、各結果をセッションのイベントストリームで送信してください。
  </CodeGroupItem>
</CodeGroup>

### ワークポーラー

| オプション | 説明 |
| ----- | ----- |
| `drain` (go: `Drain`) | 新しいワークを待たずに、キューが空になった時点でポーリングを停止するかどうか。 |
| `block_ms` (typescript: `blockMs`; go: `BlockMs`) | 各ポーリングが戻るまでにワークの到着を待機する時間（ミリ秒単位）。1から999の間である必要があります。ヘルパーは自動的に再ポーリングします。非ブロッキングのチェックを行うには `null` (python: `None`; go: `param.Null[int64]()`) を渡します。デフォルトは999msのロングポーリングです。 |
| `reclaim_older_than_ms` (typescript: `reclaimOlderThanMs`; go: `ReclaimOlderThanMs`) | 取得されたものの、このミリ秒数以内に確認応答されなかったワークアイテムを再取得します。 |
| `auto_stop` (typescript: `autoStop`; go: `AutoStop`) | ループ本体が各ワークアイテムの処理を終えた時点で、ポーラーがそのワークアイテムの停止シグナルを送信するかどうか。デフォルトは`true` (python: `True`)です。この表の後に示す2つの場合は`false` (python: `False`; go: `param.NewOpt(false)`)に設定します。 |

次の2つの場合は、`auto_stop` (typescript: `autoStop`; go: `AutoStop`)を`false` (python: `False`; go: `param.NewOpt(false)`)に設定します：

1. ループが`handle_item()` (typescript: `handleItem()`; go: `HandleItem()`)を呼び出す場合。このメソッドは自ら停止を送信します。
2. ループがアイテム用にサンドボックスを起動して次に進む場合。そのサンドボックス内のワーカーは、`ant beta:worker run`や`handle_item()` (typescript: `handleItem()`; go: `HandleItem()`)と同様に、セッションのワークが終了したときに停止を送信する必要があります。

完全な例については、[SDKポーラーからサンドボックスを起動する](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-per-session#launch-sandboxes-from-the-sdk-poller)を参照してください。

### セッションツールランナー

`client.beta.sessions.events.tool_runner()` (typescript: `client.beta.sessions.events.toolRunner()`; go: `client.Beta.Sessions.Events.NewToolRunner()`)は、ツールリストを`tools` (go: `Tools`)として受け取ります。そのリストを構築するには、`AgentToolContext`を自分でセットアップし、`beta_agent_toolset_20260401(env)` (typescript: `betaAgentToolset20260401(ctx)`; go: `agenttoolset.BetaAgentToolset20260401(env)`)を呼び出します：

<CodeGroup exclude="shell, csharp, java, php, ruby">
  <CodeGroupItem language="cURL">
    `AgentToolContext`はPython、TypeScript、Go SDKのヘルパーです。cURLには同等の機能がありません。これらのSDKのいずれかを使用してください。
  </CodeGroupItem>

  <CodeGroupItem language="CLI">
    `AgentToolContext`はPython、TypeScript、Go SDKのヘルパーです。`ant` CLIには同等の機能がありません。これらのSDKのいずれかを使用してください。
  </CodeGroupItem>

  ```python Python
  from anthropic.lib.tools.agent_toolset import (
      AgentToolContext,
      beta_agent_toolset_20260401,
  )

  async with AgentToolContext(
      workdir="/workspace", client=client, session_id=work.data.id
  ) as env:
      # スキルは /workspace/skills/<name>/ にダウンロードされます
      tools = beta_agent_toolset_20260401(env)
  ```

  ```typescript TypeScript
  import {
    setupSkills,
    betaAgentToolset20260401
  } from "@anthropic-ai/sdk/tools/agent-toolset/node";

  const ctx = { workdir: "/workspace", client, sessionId: work.data.id };
  await setupSkills(ctx);
  const tools = betaAgentToolset20260401(ctx);
  ```

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

  ```go Go
  env := &agenttoolset.AgentToolContext{Workdir: "/workspace"}
  if err := env.SetupSkills(ctx, client, work.Data.ID); err != nil {
  	panic(err)
  }
  // スキルは /workspace/skills/<name>/ にダウンロードされます
  tools := agenttoolset.BetaAgentToolset20260401(env)
  ```

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

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

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

### AgentToolContextとエージェントツールセット

`AgentToolContext`はツール呼び出しの実行コンテキストです。作業ディレクトリとパスポリシーを定義し、セッションのスキルをダウンロードできます。

| オプション | 説明 |
| ----- | ----- |
| `allowed_roots` (typescript: `allowedRoots`; go: `AllowedRoots`) | 作業ディレクトリに加えて、ファイルツール（`read`、`write`、`edit`、`glob`、`grep`）がアクセスできるディレクトリ。 |
| `read_only_roots` (typescript: `readOnlyRoots`; go: `ReadOnlyRoots`) | `write`と`edit`がパスを拒否するディレクトリ。 |

`EnvironmentWorker`は、セッションのメモリストアのディレクトリを自動的に`allowed_roots` (typescript: `allowedRoots`; go: `AllowedRoots`)に追加し、`access: "read_only"`でアタッチされたストアのディレクトリを`read_only_roots` (typescript: `readOnlyRoots`; go: `ReadOnlyRoots`)に追加します。

この制限はファイルツールのみに対するガードレールであり、サンドボックスではありません。`bash`は制限されません。

`beta_agent_toolset_20260401(env)` (typescript: `betaAgentToolset20260401(ctx)`; go: `agenttoolset.BetaAgentToolset20260401(env)`)は`AgentToolContext`を受け取り、標準のツール実装（`bash`、`read`、`write`、`edit`、`glob`、`grep`）を返します。
