claudekit / updates / self-hosted-claude-managed-agents
[ NEW · ]

Self-hosted Claude Managed Agents — 서비스 전체를 자체 인프라에서 운영 (비공개 베타)

Claude Managed Agents 서비스 전체를 자체 클라우드나 온프레미스 데이터센터에서 운영하는 self-hosted Claude Managed Agents가 비공개 베타(private beta)로 공개됐습니다. 에이전트, 세션, 세션 기록을 자체 데이터베이스에 저장하고, 모델 호출은 Claude API, Amazon Bedrock, Claude Models on Google Cloud (Google managed), Microsoft Foundry, 자체 모델 게이트웨이 중 원하는 곳으로 보낼 수 있습니다.

공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

핵심 요약

Anthropic이 2026년 11월 12일에 self-hosted Claude Managed Agents를 비공개 베타(private beta)로 공개했습니다. 지금까지 Claude Managed Agents는 Anthropic이 서비스를 운영했고, 5월에 나온 self-hosted sandboxes로는 도구가 실행되는 샌드박스만 고객 인프라로 옮길 수 있었습니다. 이번에는 서비스 전체(API, 에이전트 루프, 에이전트와 세션 기록 저장소)까지 자체 클라우드나 온프레미스 데이터센터에서 운영할 수 있게 됐습니다.

주요 기능

  • 서비스와 샌드박스를 모두 직접 호스팅

    self-hosted sandboxes에서는 샌드박스만 고객이 운영하고 서비스는 Anthropic 인프라에 남아 있었습니다. 에이전트 정의, 세션, 세션 기록까지 자체 인프라에 저장해야 하는 조직에는 맞지 않는 구조였습니다. self-hosted Managed Agents에서는 고객이 다음 구성 요소를 직접 운영합니다.

    구성 요소역할
    서버 (cma-server)API 제공, 에이전트 루프 실행, 에이전트와 세션, 세션 기록 저장. 모델이 필요할 때 추론 제공자를 호출하며, 에이전트의 셸과 파일 도구는 직접 실행하지 않음
    데이터베이스PostgreSQL 16 이상. 데이터베이스 없이 실행하면 데이터를 메모리에만 두기 때문에 재시작 시 사라짐
    워커(worker)서버에서 작업을 받아 샌드박스 안에서 에이전트의 셸과 파일 도구를 실행. ant beta:worker 명령 또는 SDK 워커로 실행
    서버 콘솔서버 주소에서 열리는 웹 페이지. 자체 ID 공급자(identity provider)로 로그인해 에이전트를 만들고 세션을 실행
    관리자 CLI (cma-server-admin)환경과 환경 키 생성. Linux(x86-64, Arm), Apple silicon macOS에서 실행
  • 모델 호출을 보낼 곳을 직접 선택

    호스팅 서비스와 self-hosted sandboxes에서는 모델이 Anthropic에서 실행됩니다. 자체 서버에서는 추론 제공자를 설정으로 고를 수 있습니다. 기본값은 Claude API이고, Amazon Bedrock, Claude Models on Google Cloud (Google managed), Microsoft Foundry, 자체 모델 게이트웨이로 바꿀 수 있습니다. 조직이 제로 데이터 보존(ZDR, Zero Data Retention) 계약을 맺고 있다면 Claude로 가는 요청에는 일반 Messages API 호출과 같은 방식으로 적용된다고 발표문은 설명합니다.

  • 호스팅 서비스와 같은 API

    자체 서버는 Anthropic이 운영하는 호스팅 서비스와 같은 API를 제공합니다. 그래서 SDK와 ant CLI를 그대로 쓸 수 있고, 나머지 Managed Agents 문서도 대부분 그대로 적용됩니다. 예외는 공식 문서의 “Differences from the hosted service” 페이지에 정리돼 있습니다.

  • 자체 서버에서만 쓸 수 있는 기능

    추론 제공자 선택 외에도 몇 가지 기능은 자체 서버에만 있습니다. OpenID Connect ID 공급자 토큰으로 서버에 접근하는 single sign-on, vault 자격 증명의 비밀값을 자체 시크릿 매니저에 저장하는 기능, 에이전트가 MCP 서버를 호출할 때 수명이 짧은 서명 토큰을 함께 보내는 agent identity입니다.

알아두면 좋은 점

  • 비공개 베타이며 액세스 요청이 필요합니다 — 다운로드 액세스는 Anthropic 어카운트 팀에 요청합니다. 이후 공식 문서의 quickstart를 따라 서버를 띄우고 첫 세션을 실행합니다. 가격 정보는 발표문에 없습니다.
  • 운영과 보안은 고객 책임입니다 — 서버, 데이터베이스, 샌드박스를 직접 운영하고 보안을 관리하며, 새 릴리스도 직접 설치해야 합니다. 에이전트의 bash 도구는 워커 프로세스 권한으로 실행되는 실제 셸이고 워커가 격리해 주지 않습니다. 워커를 직접 띄운다면 지워도 상관없는 일회용 컨테이너나 VM 안에서 실행하라고 문서는 경고합니다.
  • 호스팅 서비스의 일부 기능은 쓸 수 없습니다 — 클라우드 환경(self_hosted 환경만 존재), Messages API와 Models API, Files API와 file 세션 리소스, mcp_oauth vault 자격 증명, 기본 제공 docx, pdf, pptx, xlsx 스킬, scheduled deployments, dreams, webhooks는 자체 서버에서 제공되지 않습니다.
  • 기존 데이터는 옮겨지지 않습니다 — 호스팅 서비스의 데이터는 세션 기록을 포함해 아무것도 복사되지 않습니다. 에이전트, 스킬, vault 자격 증명, memory store를 자체 서버에서 새로 만들어야 합니다.
  • 일부 기능은 서버 설정을 먼저 바꿔야 합니다 — MCP 서버와 Git 호스트는 허용 목록(allowlist)에 등록해야 연결되고, web_search, web_fetch 도구는 기본으로 꺼져 있습니다.
  • 모델 호출 시 외부로 나가는 데이터 — 서버는 모델을 호출할 때마다 도구 입력과 결과를 포함한 대화 내용을 설정한 추론 제공자로 보냅니다. 서버가 맺는 모든 연결은 공식 문서의 “Data and access” 페이지에 정리돼 있습니다.
  • self-hosted sandboxes 사용자 — 워커 소프트웨어가 같아서 기존 워커를 자체 서버에 연결할 수 있습니다. 단, webhook으로 시작하는 워커는 동작하지 않습니다.
§ 4

자주 묻는 질문

자주 묻는 질문
§ 4.1
self-hosted Claude Managed Agents는 무엇인가요?
Claude Managed Agents를 자체 인프라(클라우드 계정 또는 온프레미스 데이터센터)에서 운영하는 방식입니다. 서비스(API, 에이전트 루프, 세션 기록 저장소)와 샌드박스를 모두 직접 호스팅하고, 모델은 Anthropic 또는 직접 고른 제공자에서 실행됩니다.
§ 4.2
지금 바로 사용할 수 있나요?
2026년 11월 12일에 비공개 베타(private beta)로 공개됐습니다. 사용하려면 Anthropic 어카운트 팀에 액세스를 요청해야 합니다.
§ 4.3
기존 self-hosted sandboxes와 무엇이 다른가요?
self-hosted sandboxes는 도구가 실행되는 샌드박스만 직접 호스팅하고 서비스는 Anthropic이 운영합니다. self-hosted Managed Agents는 서비스까지 직접 호스팅하며, 모델 호출을 보낼 추론 제공자도 고를 수 있습니다. 도구 실행 위치만 자체 인프라로 옮기면 되는 경우에는 self-hosted sandboxes를 쓰라고 공식 문서는 안내합니다.
§ 4.4
모델 호출은 어디로 보낼 수 있나요?
기본값은 Claude API입니다. 그 밖에 Amazon Bedrock, Claude Models on Google Cloud (Google managed), Microsoft Foundry, 자체 모델 게이트웨이로 보낼 수 있습니다.
§ 4.5
호스팅 서비스에서 쓰던 기능을 그대로 쓸 수 있나요?
API는 같지만 일부 기능은 제공되지 않습니다. 클라우드 환경, Files API, 기본 제공 docx, pdf, pptx, xlsx 스킬, scheduled deployments, dreams, webhooks 등은 자체 서버에서 쓸 수 없고, 호스팅 서비스의 에이전트나 세션 기록도 복사되지 않아 새로 만들어야 합니다.
§ 4.6
공식 발표 자료는 어디서 볼 수 있나요?
Claude 블로그 발표문(claude.com/resources/articles/self-hosted-claude-managed-agents)과 Claude Platform 문서의 Self-hosted Claude Managed Agents 페이지(platform.claude.com/docs/en/managed-agents/self-hosted)에서 확인할 수 있습니다.