---
title: 자체 호스팅 Claude Managed Agents
url: https://platform.claude.com/docs/ko/managed-agents/self-hosted
description: Claude Managed Agents 서비스와 해당 샌드박스를 자체 인프라에서 호스팅하세요. 각 부분을 누가 호스팅하는지, 언제 이 옵션을 선택해야 하는지, 어디서부터 시작해야 하는지 알아보세요.
---
자체 호스팅 Claude Managed Agents에 대한 접근 권한을 요청하려면 Anthropic 계정 팀에 문의하세요.
자체 호스팅 Claude Managed Agents는 자체 인프라에서 실행하는 Managed Agents이며, 인프라는 클라우드 계정일 수도 있고 온프레미스 데이터 센터일 수도 있습니다. 서비스와 샌드박스를 직접 호스팅합니다. 모델은 Anthropic 또는 사용자가 선택한 공급자에서 실행됩니다.
Managed Agents에는 사용자가 호스팅할 수 있는 두 가지 부분이 있습니다.
* **샌드박스:** 에이전트의 도구가 명령을 실행하고 파일 작업을 하는 컨테이너, VM 또는 기타 격리된 작업 공간입니다. [자체 호스팅 샌드박스](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes)를 참조하세요.
* **서비스:** API, 에이전트 루프, 그리고 에이전트, 세션, 세션 기록을 위한 스토리지입니다.
자체 호스팅 샌드박스는 첫 번째 부분을 사용자에게 옮깁니다. 자체 호스팅 Managed Agents는 이를 확장하여 서비스까지 직접 호스팅합니다. 각 옵션의 이름은 사용자가 호스팅하는 항목을 나타냅니다.
| 옵션 | 샌드박스 | 서비스 | 모델 |
| --------------------------------------------------------------------------------------- | --------- | --------- | ------------------------- |
| 클라우드 샌드박스(기본값) | Anthropic | Anthropic | Anthropic |
| [자체 호스팅 샌드박스](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes) | 사용자 | Anthropic | Anthropic |
| 자체 호스팅 Managed Agents | 사용자 | 사용자 | Anthropic 또는 사용자가 선택한 공급자 |
이 페이지들에서 호스팅 서비스란 Anthropic이 운영하는 서비스를 의미하고, 사용자의 서버란 자체 데이터베이스와 함께 사용자가 운영하는 서비스를 의미합니다. 두 서비스는 동일한 API를 제공하므로 SDK와 `ant` CLI가 사용자의 서버와 함께 작동하며, 나머지 Managed Agents 문서도 그대로 적용됩니다. [호스팅 서비스와의 차이점](https://platform.claude.com/docs/ko/managed-agents/self-hosted/differences)에 예외 사항이 나열되어 있습니다.
Claude Managed Agents는 Claude를 자율 에이전트로 실행합니다. 에이전트를 정의하고, 세션을 시작하고, 에이전트가 작업하는 동안 에이전트와 이벤트를 주고받습니다. [핵심 개념](https://platform.claude.com/docs/ko/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/ko/managed-agents/self-hosted/inference-provider)를 참조하세요.
도구만 자체 인프라에서 실행하면 되는 경우 Anthropic이 서비스를 운영하는 자체 호스팅 샌드박스를 사용하세요. [에이전트 환경 선택하기](https://platform.claude.com/docs/ko/managed-agents/choosing-an-environment)를 참조하세요.
자체 호스팅 Managed Agents를 사용하면 서버, 해당 데이터베이스, 샌드박스를 직접 운영하고 보호해야 하며, 각 릴리스도 사용자가 직접 설치합니다. 일부 기능은 호스팅 서비스에만 있으므로 결정하기 전에 [호스팅 서비스와의 차이점](https://platform.claude.com/docs/ko/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`):** API를 제공하고, 에이전트 루프를 실행하며, 에이전트, 세션, 각 세션의 기록을 저장합니다. 에이전트가 모델을 필요로 할 때마다 추론 공급자를 호출합니다. 서버는 에이전트의 셸 또는 파일 도구를 절대 실행하지 않습니다.
* **데이터베이스:** PostgreSQL 16 이상. 데이터베이스가 없으면 서버는 데이터를 메모리에 보관하며, 재시작하면 데이터가 삭제됩니다.
* **워커:** 서버에서 작업을 받아 사용자의 샌드박스에서 에이전트의 셸 및 파일 도구를 실행하는 프로그램입니다. 워커는 `ant beta:worker` 명령 또는 SDK 워커입니다.
* **사용자 애플리케이션:** SDK 또는 `ant` CLI를 사용하여 서버에 접근하는 사용자의 코드와 스크립트입니다.
* **서버의 콘솔:** 서버 주소에 있는 웹 페이지로, 사용자는 ID 공급자를 통해 로그인하여 에이전트를 생성하고 세션을 실행합니다. [서버에서 콘솔 사용하기](https://platform.claude.com/docs/ko/managed-agents/self-hosted/console)를 참조하세요.
* **관리자 CLI (`cma-server-admin`):** 환경과 해당 환경 키를 생성합니다. Linux(x86-64 및 Arm)와 Apple silicon 기반 macOS에서 실행됩니다.
## 사용자의 보안 책임
에이전트의 `bash` 도구는 워커 프로세스의 권한과 네트워크 접근 권한을 가진 실제 셸입니다. 워커는 이 셸을 격리하지 않습니다. 격리는 워커가 실행되는 환경에서 이루어집니다. Docker Compose 스택과 `cma-sandboxes` Helm 차트는 각 세션의 워커를 별도의 컨테이너나 pod에서 시작합니다. 워커를 직접 시작하는 경우 보호해야 할 항목이 전혀 없는 일회용 컨테이너나 VM에서 실행하세요.
자체 호스팅 샌드박스의 [보안 모델](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes-security)은 여기에 적용되지만, 두 가지 차이점이 있습니다. 해당 페이지에서 Anthropic이 담당하는 것으로 설명한 사항은 서버 보안, 메모리 스토어 호스팅, 비정상적인 사용 감지를 포함하여 모두 직접 책임져야 합니다. 또한 해당 페이지는 신뢰 경계마다 별도의 워크스페이스와 환경을 사용할 것을 제안합니다. 여기서는 [멀티테넌시](https://platform.claude.com/docs/ko/managed-agents/self-hosted-data-and-access#multitenancy)에서 설명하는 것처럼 신뢰 수준마다 별도의 배포가 필요합니다.
## 세 가지 자격 증명
| 자격 증명 | 보유자 | 인증 대상 |
| ------------ | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| **서버 API 키** | 사용자 애플리케이션, `ant` CLI, 관리자 CLI | 서버에 대한 요청. 설정 과정에서 이 키가 생성됩니다. 호스팅 서비스에서 Claude API 키가 하는 역할을 합니다. |
| **추론 자격 증명** | 서버 | 서버가 추론 공급자로 보내는 모델 호출. 예를 들어 Claude API 키, 클라우드 공급자의 자격 증명 또는 모델 게이트웨이가 허용하는 토큰일 수 있습니다. 애플리케이션과 워커에는 이 자격 증명이 필요하지 않습니다. |
| **환경 키** | 서버를 폴링하는 사용자의 워커 | 한 환경의 작업 큐와 해당 환경의 세션. |
## 네트워크 외부로 나가는 데이터
각 모델 호출마다 서버는 도구 입력과 도구 결과를 포함하여 지금까지의 대화를 추론 공급자로 전송합니다. 기본적으로 이는 Claude API입니다. Claude API에 대한 호출에는 해당 세션의 ID와 그 세션의 에이전트 및 환경의 ID도 함께 포함됩니다. [자체 호스팅 Claude Managed Agents의 데이터 및 접근](https://platform.claude.com/docs/ko/managed-agents/self-hosted-data-and-access)에는 서버가 만드는 모든 연결이 나열되어 있습니다. 또한 로그가 어디로 전송되는지, 누가 서버에 접근할 수 있는지도 설명합니다.
## 시작 위치
다운로드에 대한 접근 권한을 요청하려면 Anthropic 계정 팀에 문의하세요. 그런 다음 [자체 호스팅 Claude Managed Agents 시작하기](https://platform.claude.com/docs/ko/managed-agents/self-hosted/quickstart)를 따라 서버를 시작하고 첫 세션을 실행하세요.
각 릴리스의 아카이브에는 해당 버전의 운영자 가이드인 `operator-guide.md`가 포함되어 있습니다. Claude가 이 파일을 읽도록 하면 Claude가 서버를 구성하고 실행하는 작업과 서버에 연결하는 코드를 작성하는 작업을 도와줄 수 있습니다.