2026 年 4 月 8 日、Anthropic は Claude Platform にて Claude Managed Agents のパブリックベータ版を正式に公開しました。この新しいフルマネージド型エージェントフレームワーク（Managed Agent Harness）は、「エージェントループ + ツール実行 + サンドボックス環境 + 状態の永続化」をひとまとめにして REST API として提供します。開発者は、エージェントループやツール呼び出し層、ランタイムを自分で構築する必要はもうありません。/v1/agents、/v1/environments、/v1/sessions という 3 つのエンドポイントを呼び出すだけで、Claude が自律的なエージェントとして、安全なサンドボックス環境内で時間のかかるタスクを完遂できるようになります。
今回のパブリックベータでは、managed-agents-2026-04-01 ベータリクエストヘッダー、新しい agent_toolset_20260401 ツールセット、そして Server-Sent Events（SSE）ベースのイベントストリームプロトコルが同時にリリースされました。本記事では、公式ドキュメントと最新のリリースノートに基づき、Claude Managed Agents の核心的な概念、API への接続方法、イベントモデル、および課金ルールを体系的に整理します。さらに、すぐに使える Python / curl のクイックスタートコードも提供し、5 分以内に実際のエージェントセッションを体験できるようサポートします。
Claude Managed Agents とは：マネージドエージェントの核心的な役割
Managed Agents を理解するには、まず従来の Messages API との関係を明確にする必要があります。Anthropic は現在、構築のための 2 つのパスを提供しています。Messages API はモデルを直接呼び出すためのものであり、エージェントループを完全に制御したいユースケースに適しています。一方、Managed Agents は事前構築され、構成可能なエージェント実行環境を提供し、長時間実行される非同期のタスクや、サンドボックス隔離が必要なワークロードに適しています。
Messages API との機能的な違い
| 項目 | Messages API | Claude Managed Agents |
|---|---|---|
| 形態 | シングル/マルチターンメッセージインターフェース | フルマネージド型エージェント環境 |
| 制御の粒度 | エージェントループとツール実行層を自前で実装 | すぐに使用可能（組み込みループとツール呼び出し） |
| セッション状態 | クライアント側で管理 | サーバー側でファイルシステムと履歴を永続化 |
| ツール実行 | クライアント側の tool_use → tool_result を書き戻す |
サンドボックスコンテナ内で自動実行 |
| 適したシナリオ | リアルタイム対話、細かい制御 | 長時間かかるタスク、自律エージェント、バッチ処理 |
| ベータヘッダー | 機能ごとに個別に有効化 | managed-agents-2026-04-01 で一括有効化 |
🎯 導入のアドバイス：もし「AI が自律的にコードを書き、スクリプトを実行し、ウェブをブラウジングして結果をまとめる」ようなバックグラウンドタスクを構築している場合、Managed Agents を使うほうが、Messages API をつなぎ合わせて自分でサンドボックスを構築するよりも手間が省けます。APIYI（apiyi.com）プラットフォーム上で両方の比較テストを行い、自身のビジネスにどちらが適しているかを迅速に判断することをおすすめします。
4 つの核心概念
Claude Managed Agents は、次の 4 つの基礎概念に基づいて構築されています。
- Agent（エージェント）：モデル、システムプロンプト、ツール、MCP サーバー、スキルの静的な定義。一度作成すれば複数のセッションで再利用可能で、バージョン管理もサポートしています。
- Environment（環境）：クラウド上のコンテナテンプレート。インストール済みのパッケージ、ネットワークアクセスポリシー、マウントされるファイルなどを定義します。
- Session（セッション）：Agent と Environment を指定した具体的な実行インスタンス。単発または長時間のタスクを実行します。
- Events（イベント）：セッションとクライアント間でやり取りされるメッセージ。ユーザーメッセージ、ツール呼び出し、ツール結果、状態変化などが含まれます。
Managed Agents 核心能力の確認：サンドボックス、ツールセット、SSE ストリーム
4つの主要概念を理解したところで、Beta版で提供されている具体的な機能を見ていきましょう。
セキュリティサンドボックスとコンテナ設定
各セッションは隔離されたクラウドコンテナ内で実行され、以下の特性を備えています。
- ランタイムのプリインストール：Python、Node.js、Goなど、主要な言語環境がすぐに利用可能です。
- ネットワークポリシー：
unrestricted（制限なし）および、より厳格な制限付きネットワークモードをサポートしており、サンドボックスがデータ流出の経路になることを防ぎます。 - ファイルシステム：コンテナ内のファイルはセッションのライフサイクルを通じて永続化され、エージェントはラウンドをまたいで読み書きが可能です。
- リソースのマウント：Environment（環境）内でデータファイルやスクリプトを事前にマウントできます。
内蔵ツールセット agent_toolset_20260401
パブリックベータ版では、すべてのプリビルドツールを一度に有効化できる統一ツールセット識別子 agent_toolset_20260401 が提供されています。
| ツールカテゴリ | 機能説明 |
|---|---|
| Bash | コンテナ内でシェルコマンドを実行（長時間実行プロセスをサポート） |
| File 操作 | ファイルの読み取り、書き込み、編集、glob、grep |
| Web Search | 検索エンジンレベルのWeb検索、構造化された結果を返却 |
| Web Fetch | 指定URLの完全なコンテンツ（HTML/PDF）を取得 |
| MCP Servers | Model Context Protocol を介して外部ツールプロバイダーと接続 |
🎯 開発者ヒント：
agent_toolset_20260401は「一括スイッチ」であり、プロトタイプの迅速な検証に便利です。本番環境では、最小権限の原則に基づき、必要なサブセットのみを有効にすることを推奨します。APIYI (apiyi.com) でツールサブセットごとのトークンコストを比較したい場合は、base_urlを切り替えるだけで同じコードを再利用可能です。
Server-Sent Events（SSE）ストリーミングモデル
従来の Messages API の「1リクエスト → 1レスポンス」とは異なり、Managed Agents はイベント駆動型 + SSE プッシュモデルを採用しています。主なイベントタイプは以下の通りです。
| イベントタイプ | トリガータイミング | クライアント側の処理推奨 |
|---|---|---|
user.message |
クライアントがユーザーメッセージを送信 | /events エンドポイントを呼び出して書き込み |
agent.message |
エージェントがテキスト回答を生成 | UIへ逐次レンダリング |
agent.tool_use |
エージェントがツールを呼び出し | ツール名、パラメータの概要を表示 |
agent.tool_result |
ツール実行結果が返却 | 必要に応じて表示（デバッグ時に有用） |
session.status_idle |
エージェントが全作業を完了し、アイドル状態へ | ストリームを閉じ、次のインタラクションへ |
session.status_running |
エージェントが実行中 | ローディング表示 |
Claude Managed Agents：API 接続の完全な流れ
最短のコードで Managed Agent セッションを実行する方法を解説します。主な手順は、エージェント作成 → 環境作成 → セッション作成 → メッセージ送信と SSE ストリームの購読です。
前提条件
- Claude APIキー（または APIYI apiyi.com の互換キー）。
- リクエストごとに
anthropic-beta: managed-agents-2026-04-01ヘッダーが必要。公式SDKは自動付与しますが、手動curlの場合は明示が必要です。 - Python SDK を最新バージョンにアップデート：
pip install -U anthropic。
シンプルな Python サンプル
from anthropic import Anthropic
client = Anthropic(
# APIYIの中継を利用すれば既存コードをそのまま利用可能、SDKの変更は不要
base_url="https://api.apiyi.com",
api_key="YOUR_API_KEY",
)
# 1. エージェントの作成
agent = client.beta.agents.create(
name="Coding Assistant",
model="claude-sonnet-4-6",
system="You are a helpful coding assistant.",
tools=[{"type": "agent_toolset_20260401"}],
)
# 2. 環境の作成（ネットワーク制限なし）
env = client.beta.environments.create(
name="quickstart-env",
config={"type": "cloud", "networking": {"type": "unrestricted"}},
)
# 3. セッションの作成
session = client.beta.sessions.create(
agent=agent.id,
environment_id=env.id,
title="Quickstart session",
)
# 4. SSE ストリームを開き、ユーザーメッセージを送信
with client.beta.sessions.events.stream(session.id) as stream:
client.beta.sessions.events.send(
session.id,
events=[{
"type": "user.message",
"content": [{
"type": "text",
"text": "フィボナッチ数列の最初の20個を生成して fibonacci.txt に保存してください",
}],
}],
)
for event in stream:
if event.type == "agent.message":
for block in event.content:
print(block.text, end="")
elif event.type == "agent.tool_use":
print(f"\n[Using tool: {event.name}]")
elif event.type == "session.status_idle":
print("\n\nAgent finished.")
break
📎 curl バージョンを表示
# Betaヘッダーを付与してエージェントを作成
curl -sS https://api.apiyi.com/v1/agents \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01" \
-H "content-type: application/json" \
-d '{
"name": "Coding Assistant",
"model": "claude-sonnet-4-6",
"system": "You are a helpful coding assistant.",
"tools": [{"type": "agent_toolset_20260401"}]
}'
# 環境、セッション作成のリクエスト構造は同様です。公式のクイックスタートドキュメントを参照してください。
# SSE ストリームの購読には以下を使用：
# curl -N -H "Accept: text/event-stream" \
# https://api.apiyi.com/v1/sessions/$SESSION_ID/stream
🎯 コード再利用の推奨：上記の
base_urlを APIYI apiyi.com に向けるだけで、中国本土から低遅延で Managed Agents のパブリックベータインターフェースにアクセスできます。公式SDKのすべてのパラメータ、Betaヘッダー、イベントタイプと完全互換性があるため、追加のラップは不要です。
5ステップのフロー図
[Client] ──1. create agent──────────▶ [API]
[Client] ──2. create environment────▶ [API]
[Client] ──3. create session────────▶ [API]
[Client] ──4. open SSE stream───────▶ [API]
[Client] ──5. send user.message─────▶ [API]
◀─ agent.message / tool_use / tool_result / status_idle ──
このプロセスの核心は、イベントを先行させ、ストリームで受信することです。公式では、userイベントを送信する前にSSEストリームを開くことを推奨しています。これにより、中間状態を取りこぼすことがありません。
title: "Claude Managed Agents 開発の重要ルール：レート制限、料金体系、ブランドコンプライアンス"
description: "Claude Managed Agentsのパブリックベータ版における重要なルールを解説。レート制限、料金モデル、ブランド使用のガイドライン、およびManaged Agentsへの移行が推奨されるユースケースをまとめました。"
Claude Managed Agents 開発の重要ルール：レート制限、料金体系、ブランドコンプライアンス
パブリックベータ版において、本番環境向けのパラメータが明確化されました。開発者が特に留意すべき3つのルールを解説します。
レート制限（レートリミット）
レート制限は**組織（Organization）**単位でカウントされ、アカウントごとのTierとは独立しています。
| カテゴリ | エンドポイント範囲 | 制限 |
|---|---|---|
| Create系 | agents / environments / sessions 等の作成インターフェース | 60回 / 分 |
| Read系 | retrieve / list / stream 等のクエリおよびサブスクリプション | 600回 / 分 |
これらに加え、組織レベルの消費上限およびTierごとのレート上限も引き続き有効です。高並列のバッチ処理を行うエージェントタスクについては、事前のレート制限設計が必要です。または、APIYI (apiyi.com) を活用して、複数のアカウントリソースプールに負荷を分散させることも可能です。
料金モデル
Managed Agentsの料金は、以下の2つの要素で構成されます。
- セッション実行時間料金：$0.08 / セッション時間（1時間あたり）。
- モデルトークン料金：選択したClaudeモデル（例：Sonnet 3.5 / Opus 3.5など）の標準単価に基づき課金。
追加のサブスクリプションや固定のインフラコストは発生しません。ただし、セッションがアクティブなまま放置されると、使用していなくても時間単位で課金され続けるため、タスク終了後は必ずセッション終了インターフェースを呼び出すようにしてください。
ブランドコンプライアンスの要点
Anthropicは、パートナーによるClaudeブランドの使用について明確なガイドラインを設けています。
- ✅ 許可：
Claude Agent、Claude（メニュー等のコンテキスト内）、{YourAgentName} Powered by Claude。 - ❌ 禁止：
Claude Code、Claude Code Agent、Claude Coworkなどの名称。また、Claude CodeのASCIIアートや視覚要素を模倣することも禁止されています。
🎯 コンプライアンスのアドバイス：企業向けに提供するマネージドエージェント製品では、自社ブランドを主体とし、技術仕様の説明において「Powered by Claude」と謝辞を述べる形が推奨されます。正式なブランドライセンスやテンプレート化されたUIが必要な場合は、APIYI (apiyi.com) を通じて提携チャネルの接続ガイドラインをご確認ください。
Claude Managed Agents の典型的な活用シーン：移行すべき業務とは
パブリックベータ版では、一部の機能（outcomes、multiagent、memory）がまだリサーチプレビュー段階ですが、以下の4つのシナリオについては即座に導入可能です。
今すぐ移行すべき4つのワークロード
| シナリオ | Managed Agentsが適している理由 | タスクの例 |
|---|---|---|
| 自動コード生成 | Bash + Fileツールが内蔵されており、サンドボックスでテスト実行が可能 | Issueに基づくPR自動作成、スケルトンコード生成 |
| データ収集とレポート | Web Search + Web Fetchの一体化 | 世論モニタリング、競合調査の週報作成 |
| 長時間データ処理 | コンテナの永続化 + 非同期イベント | CSVクリーニング、ログ分析、一括データ変換 |
| 多ツール連携ワークフロー | MCP接続 + 統一イベントフロー | Jira / Slack / 社内APIを統合したSOPエージェント |
利用を推奨しないシナリオ
- 超低遅延が求められるリアルタイム対話：セッション起動とSSEのオーバーヘッドがあるため、ミリ秒単位のレスポンスが求められるUIには不向きです。
- 厳格なコンプライアンスが必要なローカル環境：Managed Agentsはクラウドサービスであり、オンプレミス環境には対応していません。
- エージェントループを完全にカスタマイズしたい研究プロジェクト：引き続きMessages APIを使用して自前でループを構築することをお勧めします。
🎯 移行パスのアドバイス：既存の「Messages API + 自作ツールスケジューラ」によるエージェント業務を、まずはManaged Agentsで試験的に実装してみてください。同じプロンプトを使用して両方のバージョンを動かし、トークンコストとタスク完了率を比較することをお勧めします。APIYI (apiyi.com) を利用すれば、同じAPIキーで両方のインターフェースにアクセスできるため、並行評価時にキーを切り替える手間を省くことができます。
title: "FAQ：Managed Agents（マネージド・エージェント）導入時の注意点"
description: "ClaudeのManaged Agentsを導入する際に知っておくべきFAQをまとめました。SDKの利用からセッション管理、コスト削減のコツまで、APIYIチームが技術的なポイントを解説します。"
FAQ：Managed Agents 上手な導入と落とし穴の回避
Q1：managed-agents-2026-04-01 は手動で付与する必要がありますか？
公式SDK（Python / TypeScript / Go / Java / C# / Ruby / PHP）を使用する場合、手動での付与は不要です。SDKがBetaパスで自動的に注入します。ネイティブのcurlや自作のHTTPクライアントを使用する場合のみ、明示的に anthropic-beta: managed-agents-2026-04-01 を追加する必要があります。APIYI（apiyi.com）のAPI中継サービスを経由する場合も、標準的なパスでリクエストを送ることで最高の互換性が得られます。
Q2：SSEストリームが切断された場合、セッションは失われますか？
いいえ、失われません。セッションのイベント履歴はサーバー側で永続化されているため、切断後に /v1/sessions/{id}/stream エンドポイントへ再接続すれば、後続のイベントを継続して受信できます。APIはバッファから未送信分を補完して送信します。これは「1リクエスト1レスポンス」のMessages APIとは大きく異なる点です。
Q3：実行中のエージェントを中断するにはどうすればよいですか？
Managed Agents は「実行中のステアリング（mid-execution steering）」をサポートしています。同じセッションの /events エンドポイントに対して別の user.message を送信することで、現在のツール呼び出しループを中断し、方向性を変更できます。また、専用の中断エンドポイントを使用してセッションを強制終了することも可能です。
Q4：セッション料金はどのような場合に発生しますか？
セッションが「実行可能」な状態にある限り、エージェントが status_idle（待機中）であっても1時間あたり$0.08の料金が発生します。タスク完了後はセッションを明示的に閉じることを推奨します。APIYI（apiyi.com）の請求明細パネルを活用すれば、異常に放置されたセッションを素早く発見できます。
Q5：Managed Agents はどのClaudeモデルをサポートしていますか？
パブリックベータ版では現在、Claude Sonnet 4.6、Claude Opus 4.6、Claude Haiku 4.5の3つの主要モデルをサポートしています。長大なコンテキスト（1Mトークン）はOpus 4.6 / Sonnet 4.6でデフォルトで利用可能であり、追加のBetaヘッダーは不要です。
Q6：既存のAgent Skills / MCP Serverを移行できますか？
はい、可能です。エージェント定義内でMCP ServersのリストやSkillsの参照を直接宣言できます。Managed Agentsは2025年10月にリリースされたAgent Skills Betaプロトコルを再利用しているため、既存のスキルパッケージを改造なしでそのまま接続できます。
まとめ：Managed Agents がもたらす開発パラダイムの転換
Claude Managed Agentsのパブリックベータ公開は、Anthropicが「エージェント基盤」を正式に公式製品ラインに組み込んだことを意味します。開発者にとって、今回のアップデートの価値は単一の機能にあるのではなく、エージェントシステム自作における5つの課題（ループ実装、ツール実行、サンドボックス分離、状態の永続化、イベントストリームプロトコル）を一度に解消した点にあります。managed-agents-2026-04-01 Betaリクエストヘッダーを付与し、3つのエンドポイントを呼び出すだけで、Claudeを真の「自律実行エージェント」に変えることができます。
最新のClaude Sonnet 4.6 / Opus 4.6モデル、1Mトークンのコンテキスト、Agent Skills、自動キャッシュを組み合わせることで、Managed Agentsは長時間の非同期処理やマルチツールを用いたバックエンドエージェント業務において、初めてエンタープライズレベルでの実用的な導入パスを提供しました。まずは自動レポート作成やコードの雛形生成といった低リスクなシナリオで試験運用し、徐々に主要業務へ移行することをお勧めします。
🎯 アクションプラン：移行を検討中のチームは、
base_urlを APIYI（apiyi.com）に向けることを推奨します。公式SDKのコードをそのまま再利用できるだけでなく、国内からの安定したアクセス速度を確保でき、Messages APIとManaged Agentsの並行評価も可能なため、選定判断に必要なデータを十分に収集できます。
— APIYI Team（APIYI 技術チーム）
