Shareuhack | Claude Managed Agents 完全ガイド:SDK・Managed・Raw API、どれを選ぶべき?
Claude Managed Agents 完全ガイド:SDK・Managed・Raw API、どれを選ぶべき?

Claude Managed Agents 完全ガイド:SDK・Managed・Raw API、どれを選ぶべき?

April 14, 2026
LunaMiaEno
著者Luna·調査Mia·レビューEno·継続更新中·12 分で読了

Claude Managed Agents 完全ガイド:どのパスを選ぶべきか?

2026年4月8日、AnthropicはClaude Managed Agentsパブリックベータ、Claude Agent SDKのアップデート、ant CLIのリリースを一挙に発表しました。開発者コミュニティは即座に盛り上がりましたが、気になる点がひとつ。ほとんどの報道がこの3つの製品をひとまとめにして紹介しており、記事を読み終わっても「結局どれを使えばいいの?」という根本的な疑問が解決しません。

この記事では、3製品の違いを整理し、実際のコスト計算を行い、ロックインリスクを評価し、実践的なセットアップ手順までカバーします。

TL;DR

  • Anthropicは3つの別製品(SDK、Managed Agents、ant CLI)を同時リリース。違いを理解してから選択を
  • ほとんどのインディーメーカーにはClaude Agent SDKが最適。Managed Agentsではない
  • $0.08/session-hourはランタイム料金のみ。トークン料金がコストの大部分を占める
  • フレームワークロックインは現実の問題だが、ツールコールの抽象化で緩和可能

Managed Agents、Agent SDK、ant CLIは別の製品

まず最も基本的な認識を正しましょう。見出しレベルの報道だけを読んだ方は、「Claude Managed Agents」がひとつの新製品名だと思っているかもしれません。違います。Anthropicは3つの独立した製品をリリースしました。それぞれ専用のドキュメント、異なるインストール方法、異なる課金モデルを持っています。

Claude Agent SDK:ローカルSDK。pip install claude-agent-sdkでインストール。エージェントループを自分のコードで制御し、すべての計算はローカルまたは自分のサーバーで実行。支払いはAPIトークン料金のみ、ランタイム料金はゼロ。

Claude Managed Agents:Anthropicのクラウドホスティングサービス。APIを呼び出すと、ClaudeがAnthropicのサンドボックス内でタスクを実行。標準のトークン料金に加え、$0.08/session-hourのランタイム料金が発生。

ant CLI:Anthropic APIの汎用コマンドラインクライアント。GitHubに対するghのような存在。ターミナルからAPIを操作しエージェントやセッションを管理できますが、エージェントフレームワークではありません。

3つを混同すると実害があります。ローカルのSDKで十分なタスクにManaged Agentsを使ってしまい、不要な$0.08/hrのランタイム料金を払う。あるいは「Managed Agents」という名前に複雑さを感じてスキップし、軽量なSDKオプションの存在に気づかない、というケースです。

意思決定フレームワーク:あなたのシナリオに合うパスは?

必要な判断変数は3つだけ。タスク実行時間サンドボックス隔離の必要性月間予算

Raw API(Anthropic APIの直接呼び出し)

クイックスクリプトやミニマルなタスクに最適。プロンプトとツールコールを完全制御でき、コスト最低。ただしエージェントループのロジック(リトライ、エラーハンドリング、状態管理)は自分で実装する必要があります。

Claude Agent SDK

ほとんどのインディーメーカーのスイートスポット。十数行のコードでツール付きエージェントが動き、ローカル実行のためランタイム料金ゼロ、トークン料金のみ。SDK組み込みツールにはBash実行、ファイルI/O、WebSearchがあり、MCP(Model Context Protocol)で外部サービス連携も可能。

適したシナリオ:コンテンツ自動化、コーディングアシスタント、リサーチエージェント、データ処理。日常の5〜30分のAIタスクならSDKで対応可能。

Claude Managed Agents

真のターゲットユーザーはエンタープライズ。現在の顧客にはNotion、Rakuten、GitLabが含まれ、いずれもインディー規模ではありません。Managed Agentsのコアバリューはサンドボックス隔離(コードはAnthropicのコンテナ内で実行、あなたのマシンには触れない)と4〜8時間の非同期ロングタスク(中断からの復旧可能)。

サンドボックスも長時間タスクも不要なら、Managed Agentsはおそらく必要ありません。

クイック判断マトリクス:

シナリオ推奨パス理由
クイックスクリプト、5分未満Raw API最もシンプル、最安
自動化タスク、5〜30分Agent SDKランタイム料金ゼロ、柔軟
長時間タスク2時間超 + サンドボックス必要Managed Agents中断復旧可能、隔離環境
非技術者、コーディング不要n8n / Makeノーコードツールがより実用的

$0.08/session-hourは本当に安いのか?計算してみよう

発表後、多くの開発者の第一印象は「1時間8セント、激安」。しかしこの数字はやや誤解を招きます。$0.08はランタイム料金のみで、実際のコスト大部分はトークン料金です。

具体的なシナリオで計算:

2時間のリサーチエージェント

  • ランタイム:2時間 × $0.08 = $0.16
  • トークン(Sonnet 4.6、中程度約50万トークン):入力 $3/百万 × 0.3M + 出力 $15/百万 × 0.2M = $0.90 + $3.00 = $3.90
  • 1回あたり合計:約$4

妥当に聞こえますか?しかし毎日10回実行すると、$4 × 10 × 30 = 月額$1,200

逆に短いタスクではランタイム料金はほぼ無視可能。5分のタスクでランタイム$0.007、トークン$0.30-0.50、合計1ドル未満。

ポイント:同じタスクをAgent SDKでローカル実行すれば、ランタイム料金は常にゼロ。短いタスクなら差は小さいですが、長時間または高頻度のワークロードでは差が拡大します。

注目点:Managed Agentsのランタイム課金はミリ秒単位で、セッションステータスが「running」の間のみ計上。ユーザーの応答待ち、ツール確認待ち、タスク間のアイドルは課金されません。実際の料金は「総時間 × $0.08」より低くなるのが一般的です。

なぜ4〜8時間のロングタスクが「今になって」信頼性を得たのか

ほぼすべての報道がスキップしたポイントですが、これがManaged Agentsの本当の技術的優位性です。

Anthropic Engineeringブログが明かす3コンポーネントアーキテクチャ:

  • Session:Harnessの外部に保存されるappend-onlyイベントログ。エージェント実行の完全な履歴を記録
  • Harness:ステートレスな制御ループ。Claudeの呼び出しとツールコールのディスパッチを担当。キーワードは「ステートレス」。Harnessがクラッシュしても何も失われない
  • Sandbox:隔離された実行環境。Claudeがコードを実行しファイルを操作する場所

Harnessがステートレスであるため、障害時にシステムは新しいHarnessを起動し、wake(sessionId)でSessionログの最後のイベントから実行を再開。4時間のタスクが3時間目に中断?最初からやり直す必要はなく、中断箇所から続行します。

このアーキテクチャはパフォーマンス向上ももたらします。p50 TTFT(Time to First Token)が約60%低下、p95は90%以上改善。これはlazy container provisioningにより、コンテナの起動完了を待たずに推論を開始する仕組みによるものです。

率直に言えば、これらのパフォーマンス数値はAnthropic自身の測定によるもので、第三者の独立検証はありません。ただしアーキテクチャ設計自体は理解可能で、状態と計算の分離は分散システムでは確立されたパターンです。

これが意味すること:4〜8時間中断不可のエージェントタスク(大規模コード移行、長時間データ処理など)がある場合、Managed Agentsの信頼性はDIYエージェントループでは再現困難。30分以内に完了するタスクなら、この優位性はあまり関係ありません。

フレームワークロックイン:Claude SDK vs LangChain vs CrewAI vs OpenAI SDK

フレームワーク選びは機能比較だけではなく、ロックインリスクが長期的な検討事項です。HNのトップコメント(169ポイント)が端的に指摘:Claudeエコシステムを選ぶということは、エージェントロジックがAnthropicに深く結合するということ。

ロックインには2つのレイヤーがあります:

  • モデルロックイン:エージェントはClaudeモデルのみ使用可能。Agent SDKには緩和策あり。Amazon BedrockやGoogle Vertex AIをバックエンドとしてサポートしますが、エージェントの構造とツールインターフェースはAnthropicのまま
  • インフラロックイン:Managed Agentsのみに存在。計算がAnthropicのクラウドで実行され、プラットフォーム移行は再構築を意味する
フレームワーク最適なシナリオロックインレベル学習曲線
Claude Agent SDKファイル操作、ターミナル制御、MCP連携中(モデル+構造)
Claude Managed Agents長時間タスク、サンドボックス隔離高(モデル+インフラ)
LangChain / LangGraphマルチモデル、複雑ワークフロー
CrewAI高速プロトタイピング(半日で出荷可能)
OpenAI Agents SDK音声/リアルタイムエージェント

実践的アドバイス:エージェント開発の初心者なら、まずClaude Agent SDKで始めましょう。十数行のコードで成果が出ます。スケールが必要になったらLangGraphの柔軟性を評価。マルチモデル戦略が核心的要件なら(Claude + Gemini + ローカルモデルの併用)、最初からLangGraphを選び、将来の移行コストを回避しましょう。

フレームワークに関わらず、ツールコールを標準化されたexecute(name, input)インターフェースで抽象化しておくことは価値があります。バックエンドを変更する際、少なくともツール層の書き直しが不要になります。

クイックスタート:ant CLI + 初めてのAgent SDKスクリプト

Agent SDKを選んだ場合(ほとんどのインディーメーカーへの推奨パス)、最速のスタート方法はこちら。

ant CLIのインストール

# macOS (Homebrew)
brew install anthropics/tap/ant

# またはGo経由(Go 1.22+が必要)
go install 'github.com/anthropics/anthropic-cli/cmd/ant@latest'

ant CLIはAnthropic APIの汎用クライアント。会話の作成、セッション管理、YAMLでのAPI設定バージョン管理が可能。MITライセンスのオープンソース。

Claude Agent SDK(Python)のインストール

pip install claude-agent-sdk
export ANTHROPIC_API_KEY="your-key-here"

Python 3.10以上が必要。Claude Code CLIは自動的にバンドルされ、別途インストールは不要。

組み込みツールにはBash実行、ファイルI/O(Read/Write/Edit)、Glob、Grep、WebSearch、WebFetchが含まれ、MCPで外部サービス連携も可能。公式claude-agent-sdk-demosのサンプルエージェントを先に動かしてから、自分のものを構築するのがおすすめです。

Managed Agentsが間違った選択になるケース

曖昧な推奨ではなく、Managed Agentsが適さないケースを明確にしましょう。

タスクが10分以内に完了する。 ランタイム料金は無視可能($0.013/回)だが、不要なクラウドの複雑さが増える。SDKでローカル実行がシンプル。

予算に制約がある。 Managed Agents = トークン料金 + ランタイム料金。SDK = トークン料金のみ。差は時間とともに蓄積。

マルチモデルの併用が必要。 Claude + Gemini + LlamaのワークフローはManaged Agentsでは不可能。Agent SDKもClaudeモデルのみ(Bedrock/Vertexはデプロイ方法の変更であり、モデルの変更ではない)。LangGraphを使用。

コードを書きたくない。 Agent SDKはPythonが必要、Managed AgentsはAPI呼び出しが必要。非技術系のファウンダーにはn8nやMakeなどのノーコード自動化ツールがより実用的。

Claudeの基本的なチャット機能だけが必要。 必要なのはClaude Proサブスクリプションであり、これら3つの開発者ツールではありません。

まとめ:Agent SDKから始めるのが正解

元の問いに戻りましょう。どのパスを選ぶべきか?

答えは思ったよりシンプルです。Claude Agent SDKから始めましょう。参入障壁が最も低く、コスト構造が最もシンプル(トークン料金のみ)で、ほとんどの自動化タスクに十分な機能を持っています。本当に「4時間以上の非同期タスク」や「サンドボックス隔離」が必要なシナリオに遭遇したとき、そこで初めてManaged Agentsを検討すればよいのです。

フレームワークロックインについては、現時点では過度に心配する必要はありません。AIエージェント分野は変化が速く、半年後の最適解は今日とは全く異なる可能性があります。Agent SDKで動くものを作り、アイデアを検証し、ツールコールの抽象化を維持する。完璧なフレームワークの調査に3ヶ月費やして何もリリースしないより、はるかに実践的です。

AI開発ツールの選定に興味がある方は、AI コーディングIDE比較ガイドもご覧ください。LovableからClaude Codeまでのアップグレードパスを解説しています。

FAQ

Claude Managed Agents、Claude Agent SDK、ant CLI の違いは?

3つの全く異なる製品です。Claude Agent SDKはローカルSDK(pip install claude-agent-sdk)で、自分のマシンでエージェントを実行でき、ランタイム料金は不要。Managed AgentsはAnthropicのクラウドホスティングサービスで、Anthropicのサンドボックスでタスクを実行し、$0.08/session-hourの追加料金が発生。ant CLI(brew install anthropics/tap/ant)はAnthropic APIのコマンドラインクライアントで、GitHubに対するghのようなもの。エージェントフレームワークではありません。

ant CLI のインストール方法と機能は?

macOSではbrew install anthropics/tap/ant、またはGo経由でgo install github.com/anthropics/anthropic-cli/cmd/ant@latestでインストール。antはAnthropic APIの汎用CLIクライアントで、ターミナルから会話の作成、エージェントやセッションの管理、YAMLファイルでのAPIリソースのバージョン管理が可能です。

PythonでClaude Agent SDKを始めるには?

pip install claude-agent-sdkを実行し、ANTHROPIC_API_KEY環境変数を設定するだけ。SDKにはBash、ファイル読み書き、WebSearchなどの組み込みツールがあり、MCPで外部ツール接続も可能。公式デモはgithub.com/anthropics/claude-agent-sdk-demosにあります。

この記事は役に立ちましたか?