---
title: Perbedaan dari layanan yang di-hosting
url: https://platform.claude.com/docs/id/managed-agents/self-hosted/differences
description: Lihat fitur mana yang hanya dimiliki Claude Managed Agents yang di-host sendiri, fitur layanan yang di-hosting mana yang tidak dimilikinya, mana yang berperilaku berbeda, dan mana yang memerlukan pengaturan server terlebih dahulu.
---
Untuk meminta akses ke Claude Managed Agents yang di-host sendiri, hubungi tim akun Anthropic Anda.
Server Claude Managed Agents yang di-host sendiri memiliki API yang sama dengan layanan [Managed Agents](https://platform.claude.com/docs/id/managed-agents/overview) yang di-hosting oleh Anthropic, kecuali perbedaan di halaman ini. Tabel-tabel berikut menyebutkan apa yang perlu dilakukan untuk masing-masing. Periksa tabel-tabel tersebut sebelum Anda memindahkan aplikasi ke server Anda. Tidak ada yang disalin dari layanan yang di-hosting, termasuk riwayat sesi. Buat kembali agen, skill, kredensial vault, dan memory store Anda di server Anda.
## Fitur yang hanya dimiliki server Anda
| Fitur | Fungsinya | Cara menyiapkannya |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Pilihan penyedia inferensi | Server dapat mengirim panggilan model ke penyedia cloud atau gateway model Anda sendiri sebagai pengganti Claude API. | [Penyedia inferensi](https://platform.claude.com/docs/id/managed-agents/self-hosted/inference-provider) |
| Single sign-on | Orang memanggil server dengan token dari penyedia identitas OpenID Connect Anda. Server memberikan peran kepada setiap pemanggil berdasarkan grup dalam token. Kunci API server tetap berfungsi. | [Single sign-on](https://platform.claude.com/docs/id/managed-agents/self-hosted/configure#single-sign-on) |
| Pengelola rahasia Anda sendiri | Server dapat menyimpan secret dari setiap kredensial vault baru di secret manager Anda sebagai pengganti database-nya sendiri. | [Pengelola rahasia](https://platform.claude.com/docs/id/managed-agents/self-hosted/agent-identity#secret-manager) |
| Identitas agen | Server dapat menandatangani token berumur pendek dan mengirimkannya bersama panggilan agen ke server MCP. Server MCP atau gateway memeriksa token tersebut terhadap kunci publik yang Anda publikasikan. | [Identitas agen](https://platform.claude.com/docs/id/managed-agents/self-hosted/agent-identity#agent-identity) |
## Fitur yang tidak tersedia
| Fitur | Apa yang terjadi | Apa yang dilakukan sebagai gantinya |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Environment cloud](https://platform.claude.com/docs/id/managed-agents/environments) | Hanya environment `self_hosted` yang ada. Permintaan untuk environment cloud mengembalikan error `400`. | [Deploy worker yang di-host sendiri](https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes-workers) untuk setiap environment. |
| Bagian lain dari Claude API, seperti [Messages API](https://platform.claude.com/docs/id/build-with-claude/working-with-messages) dan Models API | Server tidak melayaninya. Panggilan SDK ke `/v1/messages` dan `/v1/models` mengembalikan error `404`. | Kirim permintaan tersebut ke Claude API atau ke penyedia Anda, dari klien yang tidak diarahkan ke server Anda. |
| Resource sesi [File](https://platform.claude.com/docs/id/managed-agents/files) dan Files API | Server menolak resource `file`, dan `/v1/files` tidak ada. Resource `memory_store` berfungsi. | Letakkan file di direktori kerja worker. Lihat [Memindahkan data masuk dan keluar dari sesi](https://platform.claude.com/docs/id/managed-agents/self-hosted/call-the-api#move-data-in-and-out-of-a-session). Untuk menunjukkan gambar atau PDF kepada model, kirimkan sebagai `base64` dalam sebuah pesan. |
| [Kredensial vault `mcp_oauth`](https://platform.claude.com/docs/id/managed-agents/vaults) | Server menolaknya saat Anda membuatnya, karena server tidak memiliki alur OAuth untuk memperbarui token. | Simpan token sebagai kredensial `static_bearer`. Perbarui kredensial dengan token baru sebelum token lama kedaluwarsa. |
| [Skill bawaan `docx`, `pdf`, `pptx`, dan `xlsx`](https://platform.claude.com/docs/id/managed-agents/skills) | Server menolak agen yang mendeklarasikannya. Hanya skill yang Anda unggah yang ada. | Unduh sumbernya dari [repositori skill](https://github.com/anthropics/skills) dan unggah sebagai skill kustom. |
| [Deployment terjadwal](https://platform.claude.com/docs/id/managed-agents/scheduled-deployments) dan [dreams](https://platform.claude.com/docs/id/managed-agents/dreams) | Server tidak memiliki rute untuk keduanya. | Mulai sesi dari penjadwal Anda sendiri, seperti cron job. Dreams tidak memiliki pengganti. |
| [Webhook](https://platform.claude.com/docs/id/managed-agents/webhooks) | Server tidak mengirim webhook, sehingga worker yang dimulai oleh webhook tidak pernah dimulai. | Ikuti sesi melalui [aliran event](https://platform.claude.com/docs/id/managed-agents/events-and-streaming)-nya, atau tampilkan daftar event-nya. Biarkan worker Anda tetap berjalan agar dapat melakukan polling. |
## Fitur yang berperilaku berbeda
| Fitur | Apa yang berbeda | Apa yang dilakukan |
| -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude Console | Claude Console di platform.claude.com tidak menampilkan apa yang ada di server Anda. | Gunakan [konsol di server Anda](https://platform.claude.com/docs/id/managed-agents/self-hosted/console). |
| Panggilan alat | Giliran model dalam sesi tetap berjalan meskipun tidak ada worker yang melakukan polling pada environment-nya. Panggilan alat pertama kemudian menunggu, tanpa error, hingga sebuah worker menjalankannya. | Jika sesi berhenti pada panggilan alat, periksa apakah ada worker yang melakukan polling pada environment-nya. |
| [Memory store](https://platform.claude.com/docs/id/managed-agents/memory) | API-nya lengkap. Worker, bukan server, yang menyalin setiap store yang terlampir ke dalam sandbox dan menulis kembali perubahannya. Lihat [Memory store di sandbox self-hosted](https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes-memory). | Jalankan worker Anda pada [versi terbaru `ant`](https://platform.claude.com/docs/id/cli-sdks-libraries/cli/quickstart#installation), dengan direktori `/mnt/memory` yang dapat ditulis. |
| Unggahan [skill kustom](https://platform.claude.com/docs/id/managed-agents/skills#create-a-custom-skill) | Server tidak mengekstrak arsip zip. Unggahan arsip zip mengembalikan error `400` yang menyatakan `SKILL.md not found in uploaded files`. | `ant apply` dan helper `files_from_dir` dari Python SDK berfungsi apa adanya. Dengan cara lain, unggah file-file skill sebagai bagian terpisah, dan awali nama file setiap bagian dengan folder skill, seperti pada `my-skill/SKILL.md`. |
| [Orkestrasi multiagen](https://platform.claude.com/docs/id/managed-agents/multiagent-orchestration) | Agen hanya dapat mendelegasikan ke subagen yang Anda cantumkan. Alur kerja dinamis, advisor, dan subagen yang didefinisikan sendiri oleh agen tidak tersedia. Server menerima blok `multiagent` (csharp, go: `Multiagent`) hanya jika `type` bernilai `coordinator`. Contoh-contoh di Orkestrasi multiagen mengatur `type` ke `multiagent_20261001`, yang mengembalikan error `400`. Blok yang memiliki pengaturan `advisor` (csharp, go: `Advisor`) juga mengembalikan error `400`. | Atur `multiagent` (csharp, go: `Multiagent`) ke `{"type": "coordinator", "agents": [...]}`. Cantumkan 1 hingga 20 agen di `agents` (csharp, go: `Agents`). Setiap entri menggunakan salah satu [bentuk agen yang telah ditentukan](https://platform.claude.com/docs/id/managed-agents/multiagent-orchestration#predefined-and-inline-agents). |
| Resource sesi [repositori GitHub](https://platform.claude.com/docs/id/managed-agents/github) | Server menolak resource `github_repository` sampai Anda mencantumkan host Git-nya dalam pengaturan server. Server tidak menemukan skill di direktori `.claude/skills` milik repositori, jadi lampirkan skill ke agen. | Lihat [Repositori Git memerlukan entri allowlist](https://platform.claude.com/docs/id/managed-agents/self-hosted/differences#git-repositories-need-an-allowlist-entry). |
| [Server MCP](https://platform.claude.com/docs/id/managed-agents/mcp-connector) | Server hanya terhubung ke host MCP yang Anda cantumkan dalam pengaturannya. | Lihat [Server MCP memerlukan entri allowlist](https://platform.claude.com/docs/id/managed-agents/self-hosted/differences#mcp-servers-need-an-allowlist-entry). |
| [Alat web](https://platform.claude.com/docs/id/managed-agents/tools-web-restrictions) | Alat `web_search` dan `web_fetch` nonaktif sampai Anda mengaktifkannya dalam pengaturan server. | Lihat [Alat web memerlukan pengaturan server](https://platform.claude.com/docs/id/managed-agents/self-hosted/differences#web-tools-need-a-server-setting). |
| [Kredensial vault `environment_variable`](https://platform.claude.com/docs/id/managed-agents/vaults) | Server menolaknya sampai Anda mengaktifkan egress gateway, sebuah proxy di antara sandbox Anda dan internet. | Lihat [Kredensial variabel environment](https://platform.claude.com/docs/id/managed-agents/self-hosted/agent-identity#environment-variable-credentials). Tanpa gateway, berikan sandbox Anda kredensial CLI dan API yang dibutuhkannya melalui tooling Anda sendiri. |
| Hasil alat kustom | Server mengirimkan seluruh teks hasil alat kustom kepada model. Jika hasil terlalu besar untuk “context window” (jendela konteks) model, server tetap menjawab dengan `200`, lalu sesi berakhir dengan `session.error`. | Persingkat hasil yang panjang di klien Anda sebelum mengirimkannya. |
| Hasil alat MCP | Server memotong hasil yang lebih besar dari pengaturan `mcp.max_result_bytes` miliknya, yang secara default adalah 100 KiB. Server memberi tahu model bahwa hasil tersebut dipotong, dan sisanya hilang. Layanan yang di-hosting juga memotong hasil yang panjang, tetapi dapat [menyimpan hasil lengkap ke file](https://platform.claude.com/docs/id/managed-agents/mcp-connector#mcp-tool-output-handling) untuk sesi di sandbox cloud. | Untuk mengubah batasnya, atur `mcp.max_result_bytes` di [file pengaturan](https://platform.claude.com/docs/id/managed-agents/self-hosted/configuration-reference#where-settings-go). |
| Gambar dan dokumen yang dikirim melalui URL | Server menerima blok `image` atau `document` dengan sumber `url`, tetapi model tidak pernah melihatnya, dan tidak ada error. Hal yang sama terjadi pada blok `image` dengan sumber `file`. | Kirim data sebagai `base64`, atau sebagai `text` untuk dokumen. |
| Status sesi `rescheduling` | Server mencoba ulang panggilan model yang gagal karena alasan sementara dan melaporkan setiap percobaan di aliran event, seperti yang dilakukan layanan yang di-hosting. Status sesi tetap `running` di antara percobaan, sehingga filter `statuses[]=rescheduling` tidak cocok dengan sesi mana pun. | Baca percobaan ulang dari aliran event. |
| Metadata sesi, dengan gateway model | Jika pengaturan `inference.credentials.assertion.forward_metadata` server mencantumkan kunci metadata sesi, pembaruan yang menambah, menghapus, atau mengubah salah satunya mengembalikan error `400`. | Atur kunci-kunci tersebut saat Anda membuat sesi. Untuk pengaturannya, lihat [Token gateway berumur pendek](https://platform.claude.com/docs/id/managed-agents/self-hosted/configuration-reference#short-lived-gateway-tokens). |
## Fitur yang memerlukan pengaturan server
Masing-masing fitur ini nonaktif, atau menolak setiap host, sampai Anda mengubah [file pengaturan](https://platform.claude.com/docs/id/managed-agents/self-hosted/configuration-reference#where-settings-go) server.
### Server MCP memerlukan entri allowlist
Server hanya terhubung ke server MCP yang host-nya Anda cantumkan di bawah `mcp.allowed_hostnames` dalam [file pengaturan](https://platform.claude.com/docs/id/managed-agents/self-hosted/configuration-reference#where-settings-go)-nya:
```yaml
mcp:
allowed_hostnames:
- mcp.example.com
```
Host dicocokkan secara persis, tanpa wildcard dan tanpa subdomain, dan daftarnya kosong secara default. Sampai host server MCP ada dalam daftar, server Anda menolak menyimpan agen yang menyebutkannya.
Server MCP di dalam jaringan privat Anda tidak memerlukan [tunnel MCP](https://platform.claude.com/docs/id/agents-and-tools/mcp-tunnels/overview). Masukkan URL-nya ke dalam definisi agen, seperti yang dijelaskan di [Konektor MCP](https://platform.claude.com/docs/id/managed-agents/mcp-connector), dan tambahkan host-nya ke allowlist. Dua aturan berlaku untuk URL tersebut:
* URL harus menggunakan `https`, kecuali server MCP berada di alamat loopback.
* Jika host-nya adalah nama yang hanya ter-resolve ke alamat privat atau yang dicadangkan, server Anda menolak untuk terhubung secara default. Pilih perbaikan yang sesuai dengan kasus Anda:
| Kasus Anda | Perbaikan |
| -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Alamatnya berada di `10.0.0.0/8`, `172.16.0.0/12`, atau `192.168.0.0/16`, dan Anda mengendalikan catatan DNS nama tersebut | Pertahankan nama tersebut, dan cantumkan juga nama itu di bawah `mcp.private_hostnames` dalam file pengaturan. |
| Kasus lainnya | Gunakan alamat IP sebagai ganti nama, di URL dan di allowlist. Sertifikat server MCP harus mencantumkan alamat tersebut. |
### Repositori Git memerlukan entri allowlist
Di layanan yang di-hosting, sesi yang menggunakan [sandbox yang di-host sendiri](https://platform.claude.com/docs/id/managed-agents/self-hosted-sandboxes#session-resources) tidak dapat memiliki resource `github_repository`. Di server Anda, sesi dapat memilikinya. Server menolak resource ini sampai Anda mencantumkan host Git-nya dalam [file pengaturan](https://platform.claude.com/docs/id/managed-agents/self-hosted/configuration-reference#where-settings-go)-nya. Agen hanya dapat melakukan push ke branch yang Anda cantumkan:
```yaml
git:
allowed_hostnames:
- github.com
allowed_push_refs:
- refs/heads/agent/
```
Perhatikan poin-poin berikut:
* **URL:** Host tidak harus `github.com`, tetapi URL harus menggunakan HTTPS.
* **Token:** Token yang dikirim klien Anda tidak pernah mencapai sandbox, karena lalu lintas Git melewati server Anda, yang menambahkan token tersebut.
* **Branch:** Agen tidak diberi tahu daftar branch, jadi sebutkan sebuah branch dalam prompt Anda.
* **Force push:** Server tidak menolak force push, sehingga agen dapat menimpa branch mana pun yang Anda cantumkan. Untuk menolak force push, lindungi branch tersebut di host Git Anda.
[Mengakses GitHub](https://platform.claude.com/docs/id/managed-agents/github) menunjukkan permintaannya dan cara merotasi token. Jika clone gagal, sesi menerima event `session.error` yang menyebutkan penyebabnya. Untuk memeriksa push, cari branch tersebut di host Git Anda. Log server menyatakan `ok` bahkan untuk push yang ditolak oleh host Anda.
### Alat web memerlukan pengaturan server
Alat `web_search` dan `web_fetch` nonaktif secara default. Untuk mengaktifkannya, tambahkan ini ke [file pengaturan](https://platform.claude.com/docs/id/managed-agents/self-hosted/configuration-reference#where-settings-go) server:
```yaml
web_tools:
enabled: true
```
Dengan pengaturan ini saja, daftar domain dan batas konten milik masing-masing agen yang berlaku, seperti pada layanan yang di-hosting.
Untuk membatasi alat tersebut bagi setiap agen, atur `web_tools.allowed_domains`, `web_tools.blocked_domains`, atau `web_tools.max_content_tokens`. Masing-masing pengaturan ini juga mengaktifkan alat tersebut. Server menolak menyimpan agen yang meminta lebih dari yang diizinkan pengaturan ini. Misalnya, server menolak agen yang mengizinkan domain di luar `web_tools.allowed_domains`, atau yang mengatur batas konten yang lebih besar. Jika agen seperti itu sudah ada, agen tersebut tidak dapat memulai sesi hingga Anda memperbaruinya.
Selama alat tersebut nonaktif, apa yang terjadi pada agen bergantung pada entri `web_search` dan `web_fetch` dalam toolset-nya:
| Toolset memiliki | Apa yang terjadi |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| Tidak ada entri untuk kedua alat tersebut | Agen berjalan tanpa alat tersebut, dan tidak ada error yang memberitahukannya. |
| Entri yang hanya menonaktifkan alatnya, seperti `{"name": "web_fetch", "enabled": false}` | Sama. |
| Entri yang membiarkan alatnya aktif, atau yang mengatur daftar domain, batas konten, atau lokasinya | Server menolak menyimpan agen, atau memulai sesi untuknya. |
Alat web mana yang tersedia juga [bergantung pada penyedia inferensi Anda](https://platform.claude.com/docs/id/managed-agents/self-hosted/differences#differences-that-depend-on-your-inference-provider).
## Perbedaan yang bergantung pada penyedia inferensi Anda
Beberapa fitur hanya berfungsi pada nilai tertentu dari pengaturan `inference.provider` server. Tabel menunjukkan apa yang terjadi pada nilai lainnya. Beberapa kasus ini tidak mengembalikan error.
Baris `web_search` dan `web_fetch` berlaku setelah Anda [mengaktifkan alat web](https://platform.claude.com/docs/id/managed-agents/self-hosted/differences#web-tools-need-a-server-setting). Sampai saat itu, kedua alat tersebut tidak berfungsi pada penyedia mana pun.
| Fitur | Berfungsi saat `inference.provider` adalah | Pada nilai lainnya | Apa yang dilakukan |
| ----------------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Alat `web_search` | `anthropic`, `vertex`, `foundry` | Server tidak pernah menawarkan alat tersebut kepada model. Agen tetap dapat disimpan dan dijalankan, dan tetap mencantumkan alat tersebut, tetapi model tidak dapat memanggilnya. | Berikan agen alat kustom atau server MCP yang melakukan pencarian. |
| Alat `web_fetch` | `anthropic`, `foundry` | Sama seperti untuk `web_search`. | Berikan agen alat kustom atau server MCP yang mengambil halaman. |
| `inference_geo` (java, php: `inferenceGeo`; csharp, go: `InferenceGeo`) | `anthropic` | Server menolak menyimpan agen yang mengaturnya. | Hapus `inference_geo` (java, php: `inferenceGeo`; csharp, go: `InferenceGeo`) dari agen. |
| Mode cepat (`speed: "fast"`) | Bergantung pada penyedia dan pada model agen | Agen yang mengaturnya harus lolos dua pemeriksaan.
**Saat Anda menyimpan agen:** Katalog model server harus mencantumkan model agen sebagai model yang menerima mode cepat. Jika tidak, server menolak menyimpan agen tersebut.
**Pada setiap giliran:** Jika penyedia tidak melayani mode cepat untuk model atau deployment tersebut, giliran berakhir dengan error. | Hapus `speed` (csharp, go: `Speed`) dari agen. Lihat [Model yang menerima mode cepat](https://platform.claude.com/docs/id/managed-agents/self-hosted/differences#models-that-accept-fast-mode). |
Di bawah `anthropic`, server meminta [fallback sisi server](https://platform.claude.com/docs/id/build-with-claude/refusals-and-fallback#server-side-fallback) dari Claude API secara default. Ketika pengklasifikasi keamanan menolak sebuah permintaan, model Claude lain, yang mungkin kurang mampu, kemudian dapat menjawabnya. Anthropic memilih modelnya, dan tidak ada event yang melaporkan perubahan tersebut, tetapi pembacaan sesi menunjukkan ID model tersebut. Untuk menonaktifkan fallback, atur `inference.model_fallback: false`. Di bawah penyedia lainnya, permintaan seperti itu mengakhiri giliran dengan penolakan.
Dokumentasi penyedia Anda menyebutkan model dan region mana yang mendukung setiap fitur. Alat kustom, alat MCP, dan alat yang dijalankan oleh worker Anda sama di semua penyedia.
### Model yang menerima mode cepat
Secara default, katalog model server mencantumkan empat model sebagai model yang menerima mode cepat: Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, dan Claude Opus 4.6. Pada Claude Opus 4.6, Claude API menerima permintaan tersebut tetapi [menjalankannya pada kecepatan standar](https://platform.claude.com/docs/id/build-with-claude/fast-mode#checking-which-speed-was-used). Nilai `inference.provider` berikut merupakan pengecualian:
* **`foundry`:** Katalog hanya mencantumkan Claude Opus 5.5.
* **`gateway` dengan `format: vertex-raw-predict`:** Katalog tidak mencantumkan model apa pun.
* **`vertex`:** Katalog tidak mencantumkan model apa pun, dan tidak ada pengaturan yang dapat mengubahnya.
Untuk mengubah apa yang dicantumkan katalog, lihat [Entri model](https://platform.claude.com/docs/id/managed-agents/self-hosted/configuration-reference#model-entries).
## Jika Anda sudah menjalankan sandbox yang di-host sendiri
Perangkat lunak worker-nya sama, sehingga worker Anda dapat terhubung ke server Anda. [Menjalankan worker Anda sendiri](https://platform.claude.com/docs/id/managed-agents/self-hosted/call-the-api#point-a-worker-at-your-server) mencantumkan tiga nilai untuk proses yang melakukan polling, dan apa yang perlu diubah terlebih dahulu. Worker yang dimulai oleh webhook tidak berfungsi di sini.