---
title: セルフホスト型Claude Managed Agents
url: https://platform.claude.com/docs/ja/managed-agents/self-hosted
description: Claude Managed Agentsサービスとそのサンドボックスを独自のインフラストラクチャ上でホストします。各部分を誰がホストするか、このオプションを選択すべき場面、そしてどこから始めればよいかを説明します。
---
セルフホスト型Claude Managed Agentsへのアクセスをリクエストするには、Anthropicのアカウントチームにお問い合わせください。
セルフホスト型Claude Managed Agentsは、独自のインフラストラクチャ上で実行するManaged Agentsです。このインフラストラクチャは、クラウドアカウントでも、オンプレミスのデータセンターでもかまいません。サービスとサンドボックスは、お客様がホストします。モデルは、Anthropicまたはお客様が選択したプロバイダーで実行されます。
Managed Agentsには、お客様がホストできる部分が2つあります。
* **サンドボックス：** コンテナ、VM、またはその他の分離されたワークスペースで、エージェントのツールがコマンドを実行し、ファイルを操作する場所です。[セルフホスト型サンドボックス](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes)を参照してください。
* **サービス：** API、エージェントループ、そしてエージェント、セッション、セッション履歴のストレージです。
セルフホスト型サンドボックスでは、1つ目の部分がお客様側に移ります。セルフホスト型Managed Agentsはこれを拡張したもので、お客様がサービスもホストします。各オプションの名前は、お客様がホストするものを示しています。
| オプション | サンドボックス | サービス | モデル |
| ------------------------------------------------------------------------------------------ | --------- | --------- | --------------------------- |
| クラウドサンドボックス（デフォルト） | Anthropic | Anthropic | Anthropic |
| [セルフホスト型サンドボックス](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes) | お客様 | Anthropic | Anthropic |
| セルフホスト型Managed Agents | お客様 | お客様 | Anthropic、またはお客様が選択したプロバイダー |
これらのページでは、ホスト型サービスとはAnthropicが運用するサービスを指し、サーバーとは独自のデータベースを備え、お客様が運用するサービスを指します。どちらも同じAPIを備えているため、SDKと`ant` CLIを使ってサーバーを呼び出すことができ、Managed Agentsのその他のドキュメントもそのまま適用されます。例外については[ホスト型サービスとの違い](https://platform.claude.com/docs/ja/managed-agents/self-hosted/differences)に記載されています。
Claude Managed Agentsは、Claudeを自律型エージェントとして実行します。エージェントを定義し、セッションを開始し、エージェントが作業している間にエージェントとイベントをやり取りします。[コアコンセプト](https://platform.claude.com/docs/ja/managed-agents/overview#core-concepts)では、エージェント、環境、セッション、イベントについて説明しています。先にホスト型サービスを使用する必要はありません。
## セルフホスト型Managed Agentsを選択する場面
次のいずれかが必要な場合は、セルフホスト型Managed Agentsを選択してください。
* **独自のインフラストラクチャ上のストレージ：** エージェント、セッション、セッション履歴を自社で保存する必要がある場合。
* **推論プロバイダーの選択：** モデル呼び出しをAmazon Bedrock、Claude Models on Google Cloud (Google managed)、Microsoft Foundry、または独自のモデルゲートウェイに送る必要がある場合。[推論プロバイダー](https://platform.claude.com/docs/ja/managed-agents/self-hosted/inference-provider)を参照してください。
ツールを独自のインフラストラクチャ上で実行するだけでよい場合は、Anthropicがサービスを運用するセルフホスト型サンドボックスを使用してください。[エージェント環境の選択](https://platform.claude.com/docs/ja/managed-agents/choosing-an-environment)を参照してください。
セルフホスト型Managed Agentsでは、サーバー、そのデータベース、サンドボックスをお客様が運用して保護し、各リリースはお客様自身でインストールします。一部の機能はホスト型サービスにしかないため、決定する前に[ホスト型サービスとの違い](https://platform.claude.com/docs/ja/managed-agents/self-hosted/differences)を確認してください。
## どこで何が実行されるか
1つ以上のサーバー、そのデータベース、サンドボックスで1つのデプロイメントを構成します。
```mermaid
flowchart LR
accTitle: Components of self-hosted Managed Agents
accDescr: Your applications, the server, its database, and your workers run inside your network. Applications call the server. Workers poll the server for work. The server stores its data in the database. The server sends each model call to the inference provider you configure, which is the Claude API by default.
subgraph network [Your network]
apps[Your applications] -->|Managed Agents API| server[Server]
workers[Your workers] -->|poll for work| server
server --> db[(Database)]
end
server -->|model calls| inference[Inference provider]
```
* **サーバー（`cma-server`）：** APIを提供し、エージェントループを実行し、エージェント、セッション、各セッションの履歴を保存します。エージェントがモデルを必要とするたびに推論プロバイダーを呼び出します。サーバーがエージェントのシェルツールやファイルツールを実行することはありません。
* **データベース：** PostgreSQL 16以降。データベースがない場合、サーバーはデータをメモリに保持し、再起動するとデータは消去されます。
* **ワーカー：** サーバーから作業を取得し、お客様のサンドボックスでエージェントのシェルツールとファイルツールを実行するプログラムです。ワーカーは`ant beta:worker`コマンドまたはSDKワーカーです。
* **お客様のアプリケーション：** SDKまたは`ant` CLIを使ってサーバーにアクセスする、お客様独自のコードやスクリプトです。
* **サーバー上のコンソール：** サーバーのアドレスにあるWebページです。ユーザーはお客様のIDプロバイダーを通じてサインインし、エージェントを作成してセッションを実行します。[サーバー上のコンソールを使用する](https://platform.claude.com/docs/ja/managed-agents/self-hosted/console)を参照してください。
* **管理CLI（`cma-server-admin`）：** 環境とその環境キーを作成します。Linux（x86-64およびArm）とApple silicon搭載のmacOSで動作します。
## お客様のセキュリティ上の責任
エージェントの`bash`ツールは、ワーカープロセスの権限とネットワークアクセスを持つ実際のシェルです。ワーカーは、このシェルを分離しません。分離は、ワーカーを実行する環境によって実現されます。Docker Composeスタックと`cma-sandboxes` Helmチャートは、各セッションのワーカーを専用のコンテナまたはポッドで起動します。ワーカーを自分で起動する場合は、保護が必要なものを何も保持しない使い捨てのコンテナまたはVMで実行してください。
セルフホスト型サンドボックスの[セキュリティモデル](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-security)はここに適用されますが、2つの違いがあります。そのページでAnthropicが担うとされている事項は、サーバーの保護、メモリストアのホスト、異常な使用の検出を含め、お客様の責任となります。また、そのページでは信頼境界ごとに個別のワークスペースと環境を用意することを提案しています。ここでは、[マルチテナンシー](https://platform.claude.com/docs/ja/managed-agents/self-hosted-data-and-access#multitenancy)で説明しているとおり、信頼レベルごとに個別のデプロイメントが必要です。
## 3つの認証情報
| 認証情報 | 保持する主体 | 認証する対象 |
| ------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **サーバーAPIキー** | お客様のアプリケーション、`ant` CLI、管理CLI | サーバーへのリクエスト。このキーはセットアップ時に生成されます。ホスト型サービスにおけるClaude APIキーと同じ役割を果たします。 |
| **推論の認証情報** | サーバー | サーバーから推論プロバイダーへのモデル呼び出し。たとえば、Claude APIキー、クラウドプロバイダーの認証情報、またはモデルゲートウェイが受け付けるトークンを使用できます。アプリケーションやワーカーにこれは必要ありません。 |
| **環境キー** | サーバーをポーリングするお客様のワーカー | 1つの環境の作業キューと、その環境のセッション。 |
## ネットワークの外に出るもの
モデル呼び出しのたびに、サーバーはツールの入力とツールの結果を含むそれまでの会話を推論プロバイダーに送信します。デフォルトでは、これはClaude APIです。Claude APIへの呼び出しには、そのセッションのIDと、そのセッションのエージェントおよび環境のIDも含まれます。[セルフホスト型Claude Managed Agentsにおけるデータとアクセス](https://platform.claude.com/docs/ja/managed-agents/self-hosted-data-and-access)には、サーバーが行うすべての接続が記載されています。また、ログの送信先と、誰がサーバーにアクセスできるかについても説明しています。
## どこから始めるか
ダウンロードへのアクセスをリクエストするには、Anthropicのアカウントチームにお問い合わせください。次に[セルフホスト型Claude Managed Agentsを始める](https://platform.claude.com/docs/ja/managed-agents/self-hosted/quickstart)に従って、サーバーを起動し、最初のセッションを実行します。
各リリースのアーカイブには、そのバージョンのオペレーターガイド`operator-guide.md`が含まれています。このファイルをClaudeに読ませると、Claudeがサーバーの設定や実行、サーバーに接続するコードの作成を支援できるようになります。