Claudeマネージドエージェントの使い方

AIエージェントを本番環境にデプロイしようとしたことがあるなら、難しい部分は通常モデル自体ではないことをご存じでしょう。むしろ、サンドボックス化、状態管理、認証情報の処理、ツール実行、エラーリカバリ、そしてプロトタイプを信頼性のあるものに変えるためのすべてのインフラストラクチャです。AnthropicのClaudeマネージドエージェントは、運用レイヤーを自分で管理することなくエージェントを実行するための完全ホスティングプラットフォームを提供することで、これを容易にします。この記事はビルダー向けの実践ガイドであり、その概念、最新アップデートを解説し、ステップバイステップで動作するエージェントを構築します。

Claudeマネージドエージェントとは？

Claudeマネージドエージェントは、Claudeを自律エージェントとして実行するためのAnthropicのマネージドインフラストラクチャレイヤーです。2026年4月8日にパブリックベータ版としてリリースされ、エージェント開発において、実行の負担の多くを開発者からAnthropicのホスティング環境に移行する大きな変化を示しています。エージェントを定義し、その権限を設定するだけで、Anthropicがランタイムを処理します。Claudeは安全な管理スペースを取得し、ファイルの読み取り、シェルコマンドの実行、Webの閲覧、コードの実行を、サーバーをプロビジョニングしたり分離ロジックを書いたりすることなく行えます。

内部では、全体が4つのコアコンセプトに基づいて構成されています。

• エージェント：モデル、システムプロンプト、ツール、MCPサーバー接続、スキルを含むエージェントの定義。
• 環境：セッションが実行される場所。Anthropic管理のクラウドサンドボックスまたは自己ホスト型サンドボックス。
• セッション：環境内で特定のタスクを実行するエージェントの実行インスタンス。独自のファイルシステム、コンテキストウィンドウ、イベントストリームを持つ。
• イベント：アプリケーションとエージェントの間で流れるメッセージ：ユーザーターン、ツール結果、ステータス更新。

主要機能

Claudeマネージドエージェントは、以下のすぐに使える機能を提供します。

• 安全なサンドボックス化：エージェントは隔離されたサンドボックス環境で実行されます。認証、ツール実行、シークレット管理はすべてAnthropicのインフラストラクチャが処理します。
• 長時間実行の自律セッション：エージェントは多数のツール呼び出しにわたって数分から数時間実行できます。セッションはネットワーク切断後も持続します。
• ステートフル設計：セッションは一時停止後にクリーンに再開し、会話履歴、サンドボックス状態、出力をサーバーサイドに保存します。
• 組み込みツール：すべてのエージェントはbash（シェルコマンド）、ファイル操作（読み取り、書き込み、編集、glob、grep）、Web検索と取得、およびMCPサーバーにアクセスできます。
• ガバナンスとトレーシング：スコープ権限により、エージェントがアクセスできるツールとデータソースを正確に定義できます。ID管理と完全な実行トレーシングも提供されます。

最新アップデート：ドリーミング、アウトカムズ、マルチエージェントオーケストレーション

Anthropicは、エージェントを実行するだけでなく、学習して作業を検証するエージェントへと進化させる3つの注目機能をリリースしました。

• ドリーミング：エージェントセッション間でスケジュールされたプロセスで、過去の作業をレビューし、パターンを特定し、記憶をキュレーションして、エージェントが時間とともに改善されるようにします。
• アウトカムズ：「良い」状態のルーブリックを定義し、エージェントはそれに向けて作業します。別の採点者が独自のコンテキストウィンドウで出力を評価し、問題をフラグし、エージェントに修正を促します。
• マルチエージェントオーケストレーション：1つのエージェントでは不十分な場合、リードエージェントがタスクを小さな部分に分割し、独自のモデル、プロンプト、ツールを持つ専門サブエージェントに委任します。これらのエージェントは並行して作業し、ファイルを共有し、リードに報告し、コンソールにトレーサブルなワークフローを残します。

例えば、Netflixのプラットフォームチームはこれを使用して、数百のパイプラインからのビルドログを並行して分析し、対処する価値のあるパターンのみを表面化しています。

実践：最初のエージェントを構築する

ここでは、エージェントを作成し、環境を与え、セッションを開始し、動作を確認する手順を示します。

前提条件：AnthropicコンソールアカウントとAPIキー。環境変数ANTHROPIC_API_KEYを設定し、CLIとSDKをインストールします。

ステップ1：エージェントの作成

ant beta:agents create \
--name "Coding Assistant" \
--model '{"id":"claude-haiku-4-5"}' \
--system "You are a helpful coding assistant. Write clean, well-documented code." \
--tool '{"type":"agent_toolset_20260401"}'

返されたagent.idを保存します。

ステップ2：環境の作成

ant beta:environments create \
--name "quickstart-env" \
--config '{"type":"cloud","networking":{"type":"unrestricted"}}'

ステップ3：セッションの実行 以下のPythonスクリプトはセッションを作成し、タスクを割り当て、イベントをストリーミングします。

import os
from anthropic import Anthropic

client = Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"].strip())
AGENT_ID = "YOUR_AGENT_ID"
ENVIRONMENT_ID = "YOUR_ENV_ID"

session = client.beta.sessions.create(
    agent=AGENT_ID,
    environment_id=ENVIRONMENT_ID,
    title="Quickstart session",
)

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": "Pythonスクリプトを作成して最初の50個の素数を見つけ..."}]}]
    )
    for event in stream:
        # イベント処理

エージェントはスクリプトを作成、実行し、出力を検証します。

いつClaudeマネージドエージェントを使用すべきか？

マネージドエージェントはすべてのジョブに適しているわけではありません。長時間の実行、最小限のインフラ、ステートフルセッション、ガバナンスと監査可能性、コンプライアンスに敏感な実行が必要な場合に有効です。単純なモデルプロンプトや完全なランタイム制御が必要な場合は、他のオプションを検討してください。

結論として、Claudeマネージドエージェントは、エージェントを大規模に実行する際のインフラ負担が、出荷を妨げる要因である場合に特に価値を発揮します。