Claude Managed Agents

エージェントループ、ツール実行、ランタイムを自前で作らずに、Claude がファイルの読み取り、コマンドの実行、Web の閲覧、コードの実行を安全に行える管理環境を使えます。エージェントの作成、コンテナの設定、セッションの実行は API を通じて行います。

Claude Managed Agents は、エージェント・環境・セッション・イベントを組み合わせて使います。

• エージェント: モデル、システムプロンプト、ツール、MCP サーバー、スキルの定義です。
• 環境 (Environment): セッションを実行する場所の設定です。Anthropic が管理するクラウドサンドボックスか、自社インフラ上のセルフホストサンドボックスを指定します。
• セッション: エージェントと環境を参照して実行する単位です。一時停止の後も再開でき、会話履歴、サンドボックスの状態、出力をサーバー側に保存します。
• イベント: ユーザーメッセージの送信や結果の受け取りに使います。イベント履歴はサーバー側に保存され、すべて取得できます。

ハーネスは prompt caching や compaction などの性能最適化を組み込みで備えています。

Claude Managed Agents は 2026 年 4 月 8 日にベータとして提供を開始しました。Multiagent orchestration、Outcomes、dynamic workflows も、managed-agents-2026-04-01 ベータヘッダーのもとでベータ提供です。Dreams はリサーチプレビューで、利用にはアクセス申請が必要です。

Webhook、Multiagent orchestration、セルフホストサンドボックス、scheduled deployments は Claude Platform on AWS でも利用できます。対象プランについては、公式のリリースノートには記載がありません。

• データの削除: セッションと、アップロードしたファイルは、API を通じていつでもそれぞれ削除できます。
• 推論の実行場所: inference_geo で、エージェントのモデル推論を実行する場所を制御できます。
• 認証情報: ボールトで環境変数の認証情報を扱い、エージェントのサンドボックスにシークレットを安全に注入できます。injection_location で、値を送信リクエストのヘッダー、本文、または両方のどこに差し込むかを制御します。
• ツール実行の権限: 権限ポリシーの auto では、サーバーが各ツール呼び出しを評価し、実行・拒否・承認待ちを判断します。
• Web アクセスの制限: web_search と web_fetch がアクセスできるサイトを制限できます。ネットワークが制限されたクラウド環境では allowed_hosts がこの 2 つのツールにも適用され、web_fetch はセッション内ですでに現れた URL だけを取得します。
• 支出の上限: セッションに予算を設定でき、公開の定価で計算した支出が上限に達すると、セッションは budget_reached の停止理由で一時停止します。
• 観測: OpenTelemetry エクスポート (ベータ) で、セッションを観測基盤でトレースできます。

すべての Managed Agents のエンドポイントで managed-agents-2026-04-01 ベータヘッダーが必要で、SDK はこのヘッダーを自動で付けます。

1. モデル、システムプロンプト、ツール、MCP サーバー、スキルを定義してエージェントを作成します。エージェントは一度作成すれば、ID で参照して複数のセッションで使えます。
2. エージェントを実行する場所を設定する環境 (environment) を作成します。クラウドサンドボックスか、自社インフラ上のセルフホストサンドボックスを選びます。
3. 作成したエージェントと環境の設定を参照するセッションを開始します。
4. ユーザーメッセージをイベントとして送ります。Claude は自律的にツールを実行し、結果を server-sent events (SSE) でストリーミングして返します。
5. 実行中に追加のユーザーイベントを送ってエージェントを導くか、中断して進め方を変えます。