Claude Managed Agents — Anthropicが「エージェント基盤」を丸ごと提供する新アーキテクチャ

2026年4月19日

はじめに：これまでのエージェント開発は「DIY」だった

Claudeでエージェントを作る場合、これまではどうしていたか？

1. Messages APIを呼ぶ
2. レスポンスに tool_use が含まれていたら、自分でツールを実行する
3. 結果をまたMessages APIに投げる
4. これを stop_reason === "end_turn" になるまでループで回す

いわゆる「エージェントループ」を自分で実装する必要があった。ツールの実行環境も自前で用意する。ファイルの読み書き、シェルコマンドの実行、Web検索……全部自分でハンドラを書く。

これが Claude Managed Agents で根本的に変わった。

何が変わったか

一言で言えば：

自前のループも不要。ツールのハンドラも不要。コンテナも不要。
セッションを作って、イベントを送る。それだけ。

4つのコア概念

Managed Agentsは4つの概念で構成されている：

🤖 Agent — エージェントの定義

「どのモデルを使うか」「どんなプロンプトか」「どのツールを使えるか」「MCPサーバーに接続するか」をまとめた設定。エージェントの設計図のようなもの。バージョン管理も可能で、特定バージョンにピン留めできる。

📦 Environment — 実行環境

エージェントが動くコンテナのテンプレート。Anthropic側が管理するので、開発者はインフラを気にしなくていい。ツールはすべてこのコンテナ内で実行される。

⚡ Session — 実行インスタンス

Agentの定義に基づいて作られる実際の実行単位。セッションを作ると、Claudeが自律的にツールを選択して実行。分〜時間単位の長時間タスクにも対応する。

📡 Events — リアルタイム通信

SSE（Server-Sent Events）でエージェントの進捗がリアルタイムにストリーミングされる。実行中にユーザー側からイベントを送ってステアリング（方向変更）も可能。

内蔵ツール — すぐに使える8つの道具

Managed Agentsには、コンテナ内で即座に使えるツールが用意されている：

さらにMCPサーバー接続にも対応しているので、外部のツールプロバイダーにも接続可能。

コード例で見る違い

従来のMessages API（自前ループ）— TypeScript

// 自分でエージェントループを組む必要がある
async function runAgent(prompt: string) {
  const messages = [{ role: "user", content: prompt }];

  while (true) {
    const response = await client.messages.create({
      model: "claude-sonnet-4-20250514",
      max_tokens: 1024,
      tools: myTools,
      messages,
    });
    messages.push({ role: "assistant", content: response.content });

    if (response.stop_reason === "end_turn") break;

    // tool_use をパースして自分でツールを実行...
    const toolResults = await executeTools(response.content);
    messages.push({ role: "user", content: toolResults });
  }
}

Managed Agents — TypeScript

// エージェントを作成
const agent = await client.beta.agents.create({
  name: "code-assistant",
  model: "claude-sonnet-4-20250514",
  instructions: "あなたは優秀なコードアシスタントです。",
});

// セッションを作成して実行
const session = await client.beta.agents.sessions.create({
  agentId: agent.id,
});

// ユーザーメッセージを送信
await client.beta.agents.sessions.events.create({
  sessionId: session.id,
  event: { type: "user_message", content: "src/のバグを見つけて修正して" },
});

// SSEでリアルタイムに結果を受け取る
const stream = client.beta.agents.sessions.events.stream({
  sessionId: session.id,
});
for await (const event of stream) {
  console.log(event);
}

コード量が激減しているのがわかる。ツール実行ループが完全にAnthropic側に移譲されている。

従来のMessages API vs Managed Agents 比較表

ユースケース — 何に使えるか

🔧 コード修正エージェント

「このリポジトリのバグを修正して」と投げるだけで、Claudeが自律的にコードを読み、バグを特定し、修正を書き込む。bashでテストも実行できる。

📊 リサーチエージェント

web_searchとweb_fetchを使って情報を収集・整理。数十分かかる調査タスクも投げっぱなしで完了。進捗はSSEでリアルタイム確認。

📝 ドキュメント生成エージェント

コードベースを読み込んでドキュメントを自動生成。glob, grep, readで対象を特定し、writeで出力。長時間かかる大規模プロジェクトにも。

🚀 CI/CDパイプライン統合

長時間実行対応とステアリング機能を活かし、デプロイパイプラインに組み込んで異常時に人間が介入、というフローも構築可能。

Beta版の注意点

• APIヘッダーに "anthropic-beta": "managed-agents-2026-04-01" が必須
• 全APIユーザーにデフォルトで有効化されている
• 仕様変更の可能性があるため、本番利用時はバージョンピン留めを推奨

まとめ：エージェント開発のパラダイムシフト

Claude Managed Agentsは、「エージェントを作る」から「エージェントに指示を出す」への転換点だ。

従来は開発者が「ループを書く」「ツールを実装する」「実行環境を用意する」というインフラ作業に時間を費やしていた。Managed Agentsでは、そのすべてがAnthropic側に移譲される。開発者は「何をさせるか」に集中できる。

IaaSがインフラを抽象化し、SaaSがソフトウェアを抽象化したように、Managed Agentsはエージェント基盤を抽象化している。

もちろん、低レベルの制御が必要なケースでは従来のMessages APIも引き続き利用可能。両者は排他ではなく、用途に応じた選択肢として並存する。