---
title: ホスト型サービスとの違い
url: https://platform.claude.com/docs/ja/managed-agents/self-hosted/differences
description: セルフホスト型Claude Managed Agentsにのみある機能、ホスト型の機能のうちセルフホスト型Claude Managed Agentsにないもの、動作が異なるもの、最初にサーバー設定が必要なものを確認します。
---
セルフホスト型Claude Managed Agentsへのアクセスをリクエストするには、Anthropicのアカウントチームにお問い合わせください。
セルフホスト型Claude Managed Agentsサーバーは、このページで説明する違いを除き、Anthropicがホストする[Managed Agents](https://platform.claude.com/docs/ja/managed-agents/overview)サービスと同じAPIを備えています。以下の表では、それぞれへの対処方法を示します。アプリケーションをお使いのサーバーに移行する前に、これらを確認してください。ホスト型サービスからは、セッション履歴も含めて何もコピーされません。エージェント、スキル、ボールトの認証情報、メモリストアは、お使いのサーバー上で改めて作成してください。
## お使いのサーバーにのみある機能
| 機能 | 内容 | 設定方法 |
| --------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| 推論プロバイダーの選択 | サーバーは、モデル呼び出しをClaude APIではなく、クラウドプロバイダーまたは独自のモデルゲートウェイに送信できます。 | [推論プロバイダー](https://platform.claude.com/docs/ja/managed-agents/self-hosted/inference-provider) |
| シングルサインオン | ユーザーは、OpenID ConnectのIDプロバイダーから取得したトークンを使ってサーバーを呼び出します。サーバーは、トークン内のグループに基づいて各呼び出し元にロールを付与します。サーバーAPIキーは引き続き使用できます。 | [シングルサインオン](https://platform.claude.com/docs/ja/managed-agents/self-hosted/configure#single-sign-on) |
| 独自のシークレットマネージャー | サーバーは、新しいボールトの認証情報のシークレットを、自身のデータベースではなくお使いのシークレットマネージャーに保存できます。 | [シークレットマネージャー](https://platform.claude.com/docs/ja/managed-agents/self-hosted/agent-identity#secret-manager) |
| エージェントの身元証明 | サーバーは、有効期間の短いトークンに署名し、エージェントからMCPサーバーへの呼び出しにそのトークンを付けて送信できます。MCPサーバーまたはゲートウェイは、お客様が公開する公開鍵に照らしてトークンを検証します。 | [エージェントの身元証明](https://platform.claude.com/docs/ja/managed-agents/self-hosted/agent-identity#agent-identity) |
## 利用できない機能
| 機能 | 動作 | 代替手段 |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [クラウド環境](https://platform.claude.com/docs/ja/managed-agents/environments) | `self_hosted`環境のみが存在します。クラウド環境をリクエストすると`400`エラーが返されます。 | すべての環境に[セルフホスト型ワーカーをデプロイ](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-workers)してください。 |
| [Messages API](https://platform.claude.com/docs/ja/build-with-claude/working-with-messages)やModels APIなど、Claude APIのその他の部分 | サーバーはこれらを提供しません。SDKによる`/v1/messages`および`/v1/models`への呼び出しでは`404`エラーが返されます。 | これらのリクエストは、お使いのサーバーを指していないクライアントから、Claude APIまたはお使いのプロバイダーに送信してください。 |
| [ファイル](https://platform.claude.com/docs/ja/managed-agents/files)のセッションリソース、およびFiles API | サーバーは`file`リソースを拒否し、`/v1/files`は存在しません。`memory_store`リソースは動作します。 | ファイルはワーカーの作業ディレクトリに配置してください。[セッションとの間でデータをやり取りする](https://platform.claude.com/docs/ja/managed-agents/self-hosted/call-the-api#move-data-in-and-out-of-a-session)を参照してください。モデルに画像やPDFを見せるには、メッセージ内で`base64`として送信してください。 |
| [`mcp_oauth`のボールトの認証情報](https://platform.claude.com/docs/ja/managed-agents/vaults) | サーバーにはトークンを更新するためのOAuthフローがないため、作成時にこれらを拒否します。 | トークンを`static_bearer`認証情報として保存してください。古いトークンの有効期限が切れる前に、新しいトークンで認証情報を更新してください。 |
| [組み込みの`docx`、`pdf`、`pptx`、`xlsx`スキル](https://platform.claude.com/docs/ja/managed-agents/skills) | サーバーは、これらを宣言したエージェントを拒否します。アップロードしたスキルのみが存在します。 | [スキルリポジトリ](https://github.com/anthropics/skills)からソースをダウンロードし、カスタムスキルとしてアップロードしてください。 |
| [スケジュールされたデプロイメント](https://platform.claude.com/docs/ja/managed-agents/scheduled-deployments)と[ドリーム](https://platform.claude.com/docs/ja/managed-agents/dreams) | サーバーにはこれらのルートがありません。 | cronジョブなど、独自のスケジューラーからセッションを開始してください。ドリームに代わる機能はありません。 |
| [Webhook](https://platform.claude.com/docs/ja/managed-agents/webhooks) | サーバーはWebhookを送信しないため、Webhookをきっかけに起動するワーカーは起動しません。 | セッションの[イベントストリーム](https://platform.claude.com/docs/ja/managed-agents/events-and-streaming)で追跡するか、イベントを一覧表示してください。ワーカーがポーリングできるよう、実行し続けてください。 |
## 動作が異なる機能
| 機能 | 違い | 対処方法 |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude Console | platform.claude.comにあるClaude Consoleには、お使いのサーバー上の内容は表示されません。 | [お使いのサーバー上のコンソール](https://platform.claude.com/docs/ja/managed-agents/self-hosted/console)を使用してください。 |
| ツール呼び出し | セッションのモデルのターンは、その環境をポーリングしているワーカーがいない場合でも実行されます。その後、最初のツール呼び出しは、ワーカーが実行するまでエラーなしで待機します。 | セッションがツール呼び出しで止まった場合は、ワーカーがその環境をポーリングしていることを確認してください。 |
| [メモリストア](https://platform.claude.com/docs/ja/managed-agents/memory) | APIはすべて揃っています。アタッチされた各ストアをサンドボックスにコピーし、変更を書き戻すのは、サーバーではなくワーカーです。[セルフホスト型サンドボックスでのメモリストア](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-memory)を参照してください。 | ワーカーは[最新バージョンの`ant`](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/quickstart#installation)で実行し、書き込み可能な`/mnt/memory`ディレクトリを用意してください。 |
| [カスタムスキル](https://platform.claude.com/docs/ja/managed-agents/skills#create-a-custom-skill)のアップロード | サーバーはzipアーカイブを展開しません。zipアーカイブをアップロードすると、`SKILL.md not found in uploaded files`というメッセージを含む`400`エラーが返されます。 | `ant apply`とPython SDKの`files_from_dir`ヘルパーは、そのまま動作します。それ以外の方法では、スキルのファイルを個別のパートとしてアップロードし、各パートのファイル名を`my-skill/SKILL.md`のようにスキルのフォルダー名で始めてください。 |
| [マルチエージェントオーケストレーション](https://platform.claude.com/docs/ja/managed-agents/multiagent-orchestration) | エージェントは、記載したサブエージェントにのみ委任できます。動的ワークフロー、アドバイザー、エージェント自身が定義するサブエージェントは利用できません。サーバーは、`type`が`coordinator`である場合にのみ`multiagent` (csharp, go: `Multiagent`)ブロックを受け付けます。マルチエージェントオーケストレーションの例では`type`を`multiagent_20261001`に設定していますが、これでは`400`エラーが返されます。`advisor` (csharp, go: `Advisor`)設定を持つブロックでも`400`エラーが返されます。 | `multiagent` (csharp, go: `Multiagent`)を`{"type": "coordinator", "agents": [...]}`に設定してください。`agents` (csharp, go: `Agents`)には1〜20個のエージェントを記載してください。各エントリは、[事前定義エージェントの形式](https://platform.claude.com/docs/ja/managed-agents/multiagent-orchestration#predefined-and-inline-agents)のいずれかを取ります。 |
| [GitHubリポジトリ](https://platform.claude.com/docs/ja/managed-agents/github)のセッションリソース | サーバーは、設定に対象リポジトリのGitホストが記載されるまで、`github_repository`リソースを拒否します。サーバーはリポジトリの`.claude/skills`ディレクトリ内のスキルを検出しないため、スキルはエージェントにアタッチしてください。 | [Gitリポジトリには許可リストへの登録が必要](https://platform.claude.com/docs/ja/managed-agents/self-hosted/differences#git-repositories-need-an-allowlist-entry)を参照してください。 |
| [MCPサーバー](https://platform.claude.com/docs/ja/managed-agents/mcp-connector) | サーバーは、設定に記載したMCPホストにのみ接続します。 | [MCPサーバーには許可リストへの登録が必要](https://platform.claude.com/docs/ja/managed-agents/self-hosted/differences#mcp-servers-need-an-allowlist-entry)を参照してください。 |
| [Webツール](https://platform.claude.com/docs/ja/managed-agents/tools-web-restrictions) | `web_search`ツールと`web_fetch`ツールは、サーバーの設定で有効にするまで無効です。 | [Webツールにはサーバー設定が必要](https://platform.claude.com/docs/ja/managed-agents/self-hosted/differences#web-tools-need-a-server-setting)を参照してください。 |
| [`environment_variable`のボールトの認証情報](https://platform.claude.com/docs/ja/managed-agents/vaults) | サーバーは、サンドボックスとインターネットの間に位置するプロキシである「egress gateway」（エグレスゲートウェイ）を有効にするまで、これらを拒否します。 | [環境変数の認証情報](https://platform.claude.com/docs/ja/managed-agents/self-hosted/agent-identity#environment-variable-credentials)を参照してください。ゲートウェイを使用しない場合は、サンドボックスに必要なCLIおよびAPIの認証情報を独自のツールを通じて提供してください。 |
| カスタムツールの結果 | サーバーはカスタムツールの結果のテキスト全体をモデルに送信します。結果がモデルの「context window」（コンテキストウィンドウ）に収まらないほど大きい場合でも、サーバーは`200`で応答し、その後セッションは`session.error`で終了します。 | 長い結果は、送信前にクライアント側で短くしてください。 |
| MCPツールの結果 | サーバーは、`mcp.max_result_bytes`設定（デフォルトは100 KiB）より大きい結果を切り詰めます。サーバーは結果が切り詰められたことをモデルに伝え、残りの部分は失われます。ホスト型サービスも長い結果を切り詰めますが、クラウドサンドボックス内のセッションでは[完全な結果をファイルに保存](https://platform.claude.com/docs/ja/managed-agents/mcp-connector#mcp-tool-output-handling)できます。 | 制限を変更するには、[設定ファイル](https://platform.claude.com/docs/ja/managed-agents/self-hosted/configuration-reference#where-settings-go)で`mcp.max_result_bytes`を設定してください。 |
| URLで送信される画像とドキュメント | サーバーは`url`ソースを持つ`image`または`document`ブロックを受け付けますが、モデルがそれを見ることはなく、エラーも発生しません。`file`ソースを持つ`image`ブロックでも同じことが起こります。 | データは`base64`として、ドキュメントの場合は`text`として送信してください。 |
| `rescheduling`セッションステータス | サーバーは、一時的な理由で失敗したモデル呼び出しを再試行し、ホスト型サービスと同様に各試行をイベントストリームで報告します。試行の間もセッションのステータスは`running`のままなので、`statuses[]=rescheduling`フィルターはどのセッションにも一致しません。 | 再試行はイベントストリームから読み取ってください。 |
| セッションメタデータ（モデルゲートウェイを使用する場合） | サーバーの`inference.credentials.assertion.forward_metadata`設定にセッションメタデータのキーが記載されている場合、それらのキーのいずれかを追加、削除、変更する更新では`400`エラーが返されます。 | これらのキーはセッションの作成時に設定してください。この設定については、[短期ゲートウェイトークン](https://platform.claude.com/docs/ja/managed-agents/self-hosted/configuration-reference#short-lived-gateway-tokens)を参照してください。 |
## サーバー設定が必要な機能
これらの各機能は、サーバーの[設定ファイル](https://platform.claude.com/docs/ja/managed-agents/self-hosted/configuration-reference#where-settings-go)を変更するまで、無効であるか、すべてのホストを拒否します。
### MCPサーバーには許可リストへの登録が必要
サーバーは、その[設定ファイル](https://platform.claude.com/docs/ja/managed-agents/self-hosted/configuration-reference#where-settings-go)の`mcp.allowed_hostnames`にホストが記載されている「Model Context Protocol」、すなわちMCPのサーバーにのみ接続します：
```yaml
mcp:
allowed_hostnames:
- mcp.example.com
```
ホストは完全一致で照合されます。ワイルドカードは使用できず、エントリはそのホストのサブドメインには一致しません。リストはデフォルトで空です。MCPサーバーのホストがリストに追加されるまで、お使いのサーバーはそのサーバーを指定するエージェントの保存を拒否します。
プライベートネットワーク内のMCPサーバーには[MCPトンネル](https://platform.claude.com/docs/ja/agents-and-tools/mcp-tunnels/overview)は不要です。[MCPコネクタ](https://platform.claude.com/docs/ja/managed-agents/mcp-connector)の説明に従ってそのURLをエージェント定義に記載し、ホストを「allowlist」（許可リスト）に追加してください。URLには次の2つのルールが適用されます。
* MCPサーバーがループバックアドレス上にある場合を除き、`https`を使用する必要があります。
* ホストがプライベートアドレスまたは予約済みアドレスにのみ解決される名前である場合、お使いのサーバーはデフォルトで接続を拒否します。状況に合った対処方法を選んでください：
| 状況 | 対処方法 |
| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| アドレスが`10.0.0.0/8`、`172.16.0.0/12`、`192.168.0.0/16`のいずれかにあり、その名前のDNSレコードを自分で管理している | 名前を使い続け、設定ファイルの`mcp.private_hostnames`にもその名前を記載してください。 |
| その他の場合 | URLと許可リストの両方で、名前の代わりにIPアドレスを使用してください。MCPサーバーの証明書には、そのアドレスが記載されている必要があります。 |
### Gitリポジトリには許可リストへの登録が必要
ホスト型サービスでは、[セルフホスト型サンドボックス](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes#session-resources)を使用するセッションは`github_repository`リソースを持つことができません。お使いのサーバーでは、セッションはこれを持つことができます。サーバーは、[設定ファイル](https://platform.claude.com/docs/ja/managed-agents/self-hosted/configuration-reference#where-settings-go)に対象リポジトリのGitホストが記載されるまでこれらのリソースを拒否します。エージェントは記載したブランチにのみプッシュできます：
```yaml
git:
allowed_hostnames:
- github.com
allowed_push_refs:
- refs/heads/agent/
```
次の点に注意してください：
* **URL：** ホストは`github.com`である必要はありませんが、URLはHTTPSを使用する必要があります。
* **トークン：** Gitのトラフィックはお使いのサーバーを経由し、サーバーがトークンを付加するため、クライアントが送信するトークンがサンドボックスに届くことはありません。
* **ブランチ：** エージェントにはブランチのリストが伝えられないため、プロンプトでブランチ名を指定してください。
* **強制プッシュ：** サーバーは「force push」（強制プッシュ）を拒否しないため、エージェントは記載した任意のブランチを上書きできます。強制プッシュを拒否するには、Gitホスト側でブランチを保護してください。
[GitHubへのアクセス](https://platform.claude.com/docs/ja/managed-agents/github)では、リクエストとトークンのローテーション方法を示しています。クローンが失敗した場合、セッションは原因を示す`session.error`イベントを受け取ります。プッシュを確認するには、Gitホスト上でブランチを探してください。サーバーのログは、ホストが拒否したプッシュに対しても`ok`と表示します。
### Webツールにはサーバー設定が必要
`web_search`ツールと`web_fetch`ツールはデフォルトで無効です。有効にするには、サーバーの[設定ファイル](https://platform.claude.com/docs/ja/managed-agents/self-hosted/configuration-reference#where-settings-go)に次を追加してください：
```yaml
web_tools:
enabled: true
```
この設定のみの場合、ホスト型サービスと同様に、各エージェント自身のドメインリストとコンテンツ制限が適用されます。
すべてのエージェントのツールを制限するには、`web_tools.allowed_domains`、`web_tools.blocked_domains`、または`web_tools.max_content_tokens`を設定してください。これらの設定はいずれも、ツールを有効にする効果もあります。サーバーは、これらの設定で許可される範囲を超えるものを求めるエージェントの保存を拒否します。たとえば、`web_tools.allowed_domains`の範囲外のドメインを許可するエージェントや、より大きなコンテンツ制限を設定するエージェントは拒否されます。そのようなエージェントがすでに存在する場合、更新するまでセッションを開始できません。
ツールが無効な間、エージェントがどうなるかは、そのツールセット内の`web_search`と`web_fetch`のエントリによって異なります：
| ツールセットの内容 | 動作 |
| -------------------------------------------------------------- | ---------------------------------------- |
| どちらのツールのエントリもない | エージェントはそれらのツールなしで実行され、そのことを示すエラーは発生しません。 |
| `{"name": "web_fetch", "enabled": false}`のように、ツールを無効にするだけのエントリ | 同上です。 |
| ツールを有効のままにするエントリ、またはドメインリスト、コンテンツ制限、ロケーションを設定するエントリ | サーバーはエージェントの保存や、そのエージェントのセッションの開始を拒否します。 |
どのWebツールが存在するかは[推論プロバイダーによっても異なります](https://platform.claude.com/docs/ja/managed-agents/self-hosted/differences#differences-that-depend-on-your-inference-provider)。
## 推論プロバイダーによって異なる点
一部の機能は、サーバーの`inference.provider`設定の特定の値でのみ動作します。この表は、その他の値の場合に何が起こるかを示しています。これらのケースの一部ではエラーが返されません。
`web_search`と`web_fetch`の行は、[Webツールを有効にした](https://platform.claude.com/docs/ja/managed-agents/self-hosted/differences#web-tools-need-a-server-setting)後に適用されます。それまでは、どちらのツールもどのプロバイダーでも動作しません。
| 機能 | `inference.provider`が次の値の場合に動作 | その他の値の場合 | 対処方法 |
| ----------------------------------------------------------------------- | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `web_search`ツール | `anthropic`、`vertex`、`foundry` | サーバーはこのツールをモデルに提供しません。エージェントは引き続き保存・実行でき、ツールも一覧に表示されますが、モデルはこのツールを呼び出せません。 | 検索を行うカスタムツールまたはMCPサーバーをエージェントに与えてください。 |
| `web_fetch`ツール | `anthropic`、`foundry` | `web_search`と同じです。 | ページを取得するカスタムツールまたはMCPサーバーをエージェントに与えてください。 |
| `inference_geo` (java, php: `inferenceGeo`; csharp, go: `InferenceGeo`) | `anthropic` | サーバーは、これを設定したエージェントの保存を拒否します。 | エージェントから`inference_geo` (java, php: `inferenceGeo`; csharp, go: `InferenceGeo`)を削除してください。 |
| 高速モード（`speed: "fast"`） | プロバイダーとエージェントのモデルによって異なる | これを設定したエージェントは次の2つのチェックに合格する必要があります。
**エージェントの保存時：** サーバーのモデルカタログで、エージェントのモデルが高速モードを受け付けるモデルとして記載されている必要があります。そうでない場合、サーバーはエージェントの保存を拒否します。
**各ターン：** プロバイダーがそのモデルまたはデプロイメントで高速モードを提供していない場合、ターンはエラーで終了します。 | エージェントから`speed` (csharp, go: `Speed`)を削除してください。[高速モードを受け付けるモデル](https://platform.claude.com/docs/ja/managed-agents/self-hosted/differences#models-that-accept-fast-mode)を参照してください。 |
`anthropic`の場合、サーバーはデフォルトでClaude APIの[サーバーサイドフォールバック](https://platform.claude.com/docs/ja/build-with-claude/refusals-and-fallback#server-side-fallback)を要求します。これにより、安全性分類器がリクエストを拒否すると、別のClaudeモデル（性能が低い可能性があります）が応答することがあります。モデルはAnthropicが選択し、変更を報告するイベントはありませんが、セッションを読み取るとそのモデルのIDが表示されます。フォールバックを無効にするには、`inference.model_fallback: false`を設定してください。その他のプロバイダーでは、そのようなリクエストは拒否としてターンを終了します。
各機能をサポートするモデルとリージョンについては、プロバイダーのドキュメントを参照してください。カスタムツール、MCPツール、ワーカーが実行するツールは、どのプロバイダーでも同じです。
### 高速モードを受け付けるモデル
デフォルトでは、サーバーのモデルカタログには、高速モードを受け付けるモデルとして、Claude Opus 5.5、Claude Opus 5、Claude Opus 4.8、Claude Opus 4.6の4つのモデルが記載されています。Claude Opus 4.6では、Claude APIはリクエストを受け付けますが、[標準速度で実行します](https://platform.claude.com/docs/ja/build-with-claude/fast-mode#checking-which-speed-was-used)。`inference.provider`の次の値は例外です：
* **`foundry`：** カタログにはClaude Opus 5.5のみが記載されています。
* **`format: vertex-raw-predict`を指定した`gateway`：** カタログにはどのモデルも記載されていません。
* **`vertex`：** カタログにはどのモデルも記載されておらず、どの設定でもこれは変更できません。
カタログの記載内容を変更するには、[モデルエントリ](https://platform.claude.com/docs/ja/managed-agents/self-hosted/configuration-reference#model-entries)を参照してください。
## すでにセルフホスト型サンドボックスを実行している場合
ワーカーのソフトウェアは同じなので、既存のワーカーをお使いのサーバーに接続できます。[独自のワーカーを実行する](https://platform.claude.com/docs/ja/managed-agents/self-hosted/call-the-api#point-a-worker-at-your-server)では、ポーリングするプロセスに設定する3つの値と、最初に変更すべき点を示しています。Webhookをきっかけに起動するワーカーは、ここでは動作しません。