---
title: 自行託管的 Claude Managed Agents
url: https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted
description: 在您自己的基礎架構上託管 Claude Managed Agents 服務及其沙箱。了解各部分由誰託管、何時該選擇此選項，以及從何處開始。
---

<Note>
  若要申請自行託管的 Claude Managed Agents 存取權，請聯絡您的 Anthropic 客戶團隊。
</Note>

自行託管的 Claude Managed Agents 是在您自己的基礎架構上執行的 Managed Agents，該基礎架構可以是雲端帳戶或地端資料中心。您負責託管服務與沙箱。模型則在 Anthropic 或您所選擇的供應商上執行。

Managed Agents 有兩個您可以託管的部分：

* **沙箱：**&#x4EE3;理工具執行指令與處理檔案的容器、VM 或其他隔離的工作空間。請參閱[自行託管的沙箱](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted-sandboxes)。
* **服務：**&#x41;PI、代理迴圈，以及代理、工作階段與工作階段歷程記錄的儲存。

自行託管的沙箱會將第一個部分移交給您。自行託管的 Managed Agents 延伸了這一點：服務也由您託管。每個選項的名稱都說明了您託管的內容：

| 選項                                                                                     | 沙箱        | 服務        | 模型                  |
| -------------------------------------------------------------------------------------- | --------- | --------- | ------------------- |
| 雲端沙箱（預設）                                                                               | Anthropic | Anthropic | Anthropic           |
| [自行託管的沙箱](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted-sandboxes) | 您         | Anthropic | Anthropic           |
| 自行託管的 Managed Agents                                                                   | 您         | 您         | Anthropic，或您所選擇的供應商 |

在這些頁面中，「託管服務」指的是由 Anthropic 執行的服務，而「您的伺服器」指的是由您執行、並具有自己資料庫的服務。兩者具有相同的 API，因此 SDK 和 `ant` CLI 都能與您的伺服器搭配使用，其餘的 Managed Agents 文件也同樣適用。[與託管服務的差異](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/differences)列出了例外情況。

<Note title="初次使用 Claude Managed Agents？">
  Claude Managed Agents 會將 Claude 作為自主代理執行：您定義一個代理、啟動一個工作階段，並在代理工作時與其交換事件。[核心概念](https://platform.claude.com/docs/zh-TW/managed-agents/overview#core-concepts)說明了代理、環境、工作階段與事件。您不需要先使用託管服務。
</Note>

## 何時該選擇自行託管的 Managed Agents

當您需要下列其中一項時，請選擇自行託管的 Managed Agents：

* **儲存在您的基礎架構上：**&#x60A8;必須自行儲存代理、工作階段與工作階段歷程記錄。
* **自行選擇推論供應商：**&#x6A21;型呼叫必須傳送至 Amazon Bedrock、Claude Models on Google Cloud (Google managed)、Microsoft Foundry，或您自己的模型閘道。請參閱[推論提供者](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/inference-provider)。

如果您只需要在自己的基礎架構上執行工具，請使用自行託管的沙箱，此時服務由 Anthropic 執行。請參閱[選擇代理環境](https://platform.claude.com/docs/zh-TW/managed-agents/choosing-an-environment)。

使用自行託管的 Managed Agents 時，您需要執行並保護伺服器、其資料庫以及您的沙箱，而且每個版本都需由您自行安裝。部分功能僅存在於託管服務中，因此請在決定之前先查看[與託管服務的差異](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/differences)。

## 各元件的執行位置

一或多個伺服器、其資料庫以及您的沙箱構成一個部署。

```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`）：**&#x63D0;供 API、執行代理迴圈，並儲存代理、工作階段以及每個工作階段的歷程記錄。每當代理需要模型時，它會呼叫您的推論供應商。伺服器永遠不會執行代理的 shell 或檔案工具。
* **資料庫：**&#x50;ostgreSQL 16 或更新版本。若沒有資料庫，伺服器會將資料保存在記憶體中，重新啟動後資料便會清除。
* **Worker：**&#x5F9E;伺服器取得工作，並在您的沙箱中執行代理的 shell 與檔案工具的程式。Worker 是一個 `ant beta:worker` 指令或一個 SDK worker。
* **您的應用程式：**&#x60A8;自己的程式碼與指令碼，透過 SDK 或 `ant` CLI 連線至伺服器。
* **您伺服器上的主控台：**&#x4F4D;於伺服器位址的網頁，使用者透過您的身分識別提供者登入，即可建立代理並執行工作階段。請參閱[在您的伺服器上使用主控台](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/console)。
* **管理 CLI（`cma-server-admin`）：**&#x5EFA;立環境及其環境金鑰。它可在 Linux（x86-64 與 Arm）以及搭載 Apple silicon 的 macOS 上執行。

## 您的安全責任

<Warning>
  代理的 `bash` 工具是一個真實的 shell，具有 worker 處理程序的權限與網路存取能力。Worker 不會隔離該 shell。隔離取決於 worker 的執行環境。Docker Compose 堆疊與 `cma-sandboxes` Helm chart 會將每個工作階段的 worker 啟動在其專屬的容器或 pod 中。如果您自行啟動 worker，請將其執行於可拋棄的容器或 VM 中，且其中不包含任何您需要保護的內容。
</Warning>

自行託管沙箱的[安全模型](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted-sandboxes-security)同樣適用於此處，但有兩項差異。該頁面指派給 Anthropic 的職責改由您負責，包括保護伺服器、託管記憶體儲存區，以及偵測異常使用。該頁面也建議為每個信任邊界使用個別的工作區與環境。在此處，每個信任層級都需要各自的部署，如[多租戶](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted-data-and-access#multitenancy)所述。

## 三種憑證

| 憑證             | 持有者                      | 驗證對象                                                                              |
| -------------- | ------------------------ | --------------------------------------------------------------------------------- |
| **伺服器 API 金鑰** | 您的應用程式、`ant` CLI 與管理 CLI | 傳送至您伺服器的請求。設定過程會產生此金鑰。它扮演的角色等同於 Claude API 金鑰在託管服務中的角色。                           |
| **推論憑證**       | 伺服器                      | 伺服器對您推論供應商發出的模型呼叫。例如，它可以是 Claude API 金鑰、您雲端供應商的憑證，或您模型閘道所接受的權杖。應用程式與 worker 不需要它。 |
| **環境金鑰**       | 您向伺服器輪詢工作的 worker        | 單一環境的工作佇列以及該環境的工作階段。                                                              |

## 哪些資料會離開您的網路

每次進行模型呼叫時，伺服器都會將目前為止的對話（包括工具輸入與工具結果）傳送至您的推論供應商。預設情況下，該供應商是 Claude API。對 Claude API 的呼叫也會帶有其工作階段的 ID，以及該工作階段的代理與環境的 ID。[自行託管的 Claude Managed Agents 中的資料與存取](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted-data-and-access)列出了伺服器建立的每一個連線。該頁面也說明了記錄檔的去向，以及誰能連線至伺服器。

## 從何處開始

若要申請下載存取權，請聯絡您的 Anthropic 客戶團隊。接著依照[開始使用自行託管的 Claude Managed Agents](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/quickstart)啟動伺服器並執行第一個工作階段。

每個版本的封存檔都包含該版本的操作人員指南 `operator-guide.md`。請讓 Claude 閱讀該檔案，如此 Claude 便能協助您設定並執行伺服器，以及撰寫連線至伺服器的程式碼。