--- title: 에이전트 환경 선택하기 url: https://platform.claude.com/docs/ko/managed-agents/choosing-an-environment description: Claude Managed Agents의 도구와 코드를 Anthropic이 관리하는 클라우드 환경에서 실행할지, 자체 호스팅 샌드박스에서 실행할지 결정하고, 전환할 경우 무엇이 달라지는지 알아보세요. featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- 환경은 에이전트의 도구와 코드가 실행되는 위치를 설정합니다. 도구와 코드는 샌드박스에서 실행됩니다. "Sandbox"(샌드박스)는 컨테이너와 같은 격리된 작업 공간으로, 에이전트가 이곳에서 명령을 실행하고 파일 작업을 수행합니다. 두 가지 옵션이 있습니다: * **클라우드 환경:** Anthropic이 샌드박스를 대신 실행합니다. 각 세션은 Anthropic이 관리하는 인프라에서 자체적인 새 Linux 컨테이너를 받으며, 일반적인 언어, 데이터베이스, 유틸리티가 이미 설치되어 있습니다. 네트워크 규칙과 추가로 설치할 패키지는 사용자가 선택합니다. * **자체 호스팅 샌드박스:** 사용자가 자체 인프라에서 샌드박스를 실행합니다. Claude는 여전히 Anthropic 측에서 실행되며 다음에 호출할 도구를 결정합니다. "Worker"(워커)라고 하는, 사용자가 실행하는 프로그램이 사용자의 머신에서 에이전트의 bash 및 파일 도구 호출을 수행하고 각 결과를 다시 전송합니다. 워커는 사용자 정의 도구를 제공할 수도 있습니다. 어느 쪽을 선택하든 에이전트 정의는 동일합니다. 모델, 프롬프트, 도구는 환경이 아니라 [에이전트](https://platform.claude.com/docs/ko/managed-agents/agent-setup)에서 설정합니다. ## 클라우드 환경으로 시작하기 어느 쪽을 선택해야 할지 확실하지 않거나 Claude Managed Agents를 처음 사용하는 경우, [빠른 시작](https://platform.claude.com/docs/ko/managed-agents/quickstart)에서처럼 [클라우드 환경](https://platform.claude.com/docs/ko/managed-agents/environments)으로 시작하세요. Anthropic이 각 세션마다 일반적인 언어와 도구가 이미 설치된 격리된 컨테이너를 실행하므로 사용자가 호스팅할 것이 없습니다. 도구가 반드시 사용자가 제어하는 인프라에서 실행되어야 하는 경우에만 자체 호스팅 샌드박스를 선택하세요. ## 옵션 비교 다음 표는 두 옵션을 비교합니다. | | [클라우드 환경](https://platform.claude.com/docs/ko/managed-agents/environments) (기본값) | [자체 호스팅 샌드박스](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes) | | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | | 도구와 코드가 실행되는 위치 | Anthropic이 관리하는 샌드박스 | 사용자 인프라의 워커 | | Anthropic에 전달되는 것 | [대화 기록](https://platform.claude.com/docs/ko/managed-agents/events-and-streaming#list-past-events), [도구 결과](https://platform.claude.com/docs/ko/managed-agents/tools#available-tools), 샌드박스의 파일과 상태, 스킬, 메모리 스토어 | 대화 기록, 도구 결과, 스킬, 메모리 스토어. 샌드박스의 파일과 프로세스는 워커에 남습니다. | | 사용자가 운영하는 것 | 없음 | 워커 호스트, 호스트 보안 강화, 네트워크 제한, 워커가 인증에 사용하는 환경 키 | | 네트워크 접근 범위 | 환경에 설정한 네트워크 규칙 | 사용자 자체 네트워크 정책 | | 파일 및 GitHub 리포지토리 마운트 | Anthropic이 관리 | 사용자가 관리 | | 메모리 스토어 | Anthropic이 `/mnt/memory/`에 마운트 | `/mnt/memory/`에 다운로드되고 워커가 동기화 | | 샌드박스 수명 주기 | Anthropic이 관리 | 사용자가 관리 | | 선택해야 하는 경우 | 기본값. 도구를 자체 인프라에서 실행할 필요가 없는 경우. | 도구가 반드시 사용자가 제어하는 인프라에서 실행되어야 하는 경우. | ## 자체 호스팅 샌드박스를 선택해야 하는 경우 자체 호스팅 샌드박스는 에이전트가 다음 중 하나를 수행해야 할 때 적합합니다: * **네트워크 밖으로 나갈 수 없는 데이터 작업:** 에이전트의 파일과 프로세스는 워커에 남습니다. 도구가 모델에 반환하는 내용은 여전히 Managed Agents 서비스에 전달됩니다. * **공개적으로 라우팅되지 않는 내부 서비스 접근:** 에이전트의 bash 및 파일 도구와 워커가 제공하는 모든 사용자 정의 도구는 사용자의 네트워크 내부에서 실행됩니다. 에이전트의 MCP 서버에 연결하는 것은 워커가 아니라 Anthropic입니다. 비공개 MCP 서버는 내부 티켓 시스템이나 회사 위키 앞단에 있을 수 있습니다. 이러한 서버에 접근하려면 두 옵션 모두에서 [MCP 터널](https://platform.claude.com/docs/ko/agents-and-tools/mcp-tunnels/overview)을 사용할 수 있습니다. MCP 터널은 연구 프리뷰 단계이며 액세스 요청이 필요합니다. [자체 호스팅 샌드박스와 MCP 터널](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes#self-hosted-sandboxes-and-mcp-tunnels)을 참조하세요. * **조직 자체의 규정 준수 및 감사 통제하에서 실행:** 도구는 사용자가 구성하고, 로깅하고, 감사하는 호스트에서 실행됩니다. ## 자체 호스팅 샌드박스로도 달라지지 않는 것 어느 옵션을 사용하든 대화 기록과 도구 결과는 Anthropic이 운영하는 Managed Agents 서비스로 전달됩니다. 이것이 모델이 각 도구 호출의 결과를 받는 방식입니다. 웹 검색 및 웹 가져오기 도구도 샌드박스가 아니라 Anthropic 측에서 실행됩니다. [웹 검색 및 웹 가져오기 도메인 제한](https://platform.claude.com/docs/ko/managed-agents/tools-web-restrictions)을 참조하세요. 어느 옵션도 Managed Agents의 규정 준수 적용 범위나 대화 기록 보관 기간을 변경하지 않습니다. [API 및 데이터 보존](https://platform.claude.com/docs/ko/manage-claude/api-and-data-retention#feature-eligibility)을 참조하세요. ## 자체 호스팅 샌드박스로 떠맡게 되는 것과 포기하게 되는 것 자체 호스팅 샌드박스를 사용하면 사용자가 워커 호스트의 운영자가 됩니다. 샌드박스 이미지의 보안을 강화하고, 네트워크 이그레스(egress)를 제어하고, 환경 키를 저장 및 교체하고, 세션을 서로 격리해야 합니다. 자세한 내용은 [보안 모델](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes-security) 페이지에 있습니다. 또한 다음 클라우드 환경 기능을 포기하게 됩니다: * [`file` 및 `github_repository` 세션 리소스](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes#session-resources). [입력 파일은 직접 준비](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes-workers#stage-files-for-a-session)해야 하며, 자체 GitHub 리포지토리를 마운트하는 것도 사용자의 책임입니다. * [리포지토리 스킬 검색](https://platform.claude.com/docs/ko/managed-agents/skills#load-skills-from-a-github-repository). * 볼트의 [환경 변수 자격 증명](https://platform.claude.com/docs/ko/managed-agents/vaults#add-a-credential). * 클라우드 샌드박스의 [사전 설치된 런타임 및 패키지](https://platform.claude.com/docs/ko/managed-agents/cloud-sandboxes-reference). 자체 호스팅 샌드박스에는 워커가 제공하는 것만 있습니다. ## Claude Platform on AWS에서의 차이점 Claude Platform on AWS를 통해 Claude Managed Agents를 사용하는 경우에도 서비스는 여전히 Anthropic이 운영합니다. 이 경우 자체 호스팅 샌드박스는 메모리 스토어를 사용할 수 없고, 워커는 환경 키를 사용하지 않으며, MCP 터널을 사용할 수 없습니다. [Claude Platform on AWS의 Claude Managed Agents](https://platform.claude.com/docs/ko/build-with-claude/claude-platform-on-aws#claude-managed-agents) 및 [지원되지 않는 기능](https://platform.claude.com/docs/ko/build-with-claude/claude-platform-on-aws#features-not-supported)을 참조하세요. ## 클라우드 환경에서 자체 호스팅 샌드박스로 전환하기 자체 호스팅 샌드박스로 전환하려면 에이전트는 그대로 유지하고, `self_hosted` 환경을 생성한 다음, 새 세션과 배포에서 해당 환경의 ID를 참조합니다. * **그대로 유지되는 것:** 에이전트 정의, 애플리케이션이 사용하는 API 키 또는 AWS 자격 증명, 스킬, MCP 서버, [메모리 스토어](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes-memory). * **새로 필요한 것:** `self_hosted` 환경, Claude Console에서 생성하는 환경 키, 사용자가 실행하는 워커. [자체 호스팅 샌드박스 빠른 시작](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes#quickstart)에서 세 가지를 모두 다룹니다. * **더 이상 작동하지 않는 것:** [자체 호스팅 샌드박스로 떠맡게 되는 것과 포기하게 되는 것](https://platform.claude.com/docs/ko/managed-agents/choosing-an-environment#what-you-take-on-and-give-up-with-a-self-hosted-sandbox)에 나열된 기능. Claude Platform on AWS에서는 메모리 스토어가 자체 호스팅 샌드박스로 이전되지 않으며, 워커는 환경 키를 사용하지 않습니다. [Claude Platform on AWS에서의 차이점](https://platform.claude.com/docs/ko/managed-agents/choosing-an-environment#differences-on-claude-platform-on-aws)을 참조하세요.