에이전트 환경 선택하기
Claude Managed Agents의 도구와 코드를 Anthropic이 관리하는 클라우드 환경에서 실행할지, 자체 호스팅 샌드박스에서 실행할지 결정하고, 전환할 경우 무엇이 달라지는지 알아보세요.
환경은 에이전트의 도구와 코드가 실행되는 위치를 설정합니다. 도구와 코드는 샌드박스에서 실행됩니다. "Sandbox"(샌드박스)는 컨테이너와 같은 격리된 작업 공간으로, 에이전트가 이곳에서 명령을 실행하고 파일 작업을 수행합니다. 두 가지 옵션이 있습니다:
- 클라우드 환경: Anthropic이 샌드박스를 대신 실행합니다. 각 세션은 Anthropic이 관리하는 인프라에서 자체적인 새 Linux 컨테이너를 받으며, 일반적인 언어, 데이터베이스, 유틸리티가 이미 설치되어 있습니다. 네트워크 규칙과 추가로 설치할 패키지는 사용자가 선택합니다.
- 자체 호스팅 샌드박스: 사용자가 자체 인프라에서 샌드박스를 실행합니다. Claude는 여전히 Anthropic 측에서 실행되며 다음에 호출할 도구를 결정합니다. "Worker"(워커)라고 하는, 사용자가 실행하는 프로그램이 사용자의 머신에서 에이전트의 bash 및 파일 도구 호출을 수행하고 각 결과를 다시 전송합니다. 워커는 사용자 정의 도구를 제공할 수도 있습니다.
어느 쪽을 선택하든 에이전트 정의는 동일합니다. 모델, 프롬프트, 도구는 환경이 아니라 에이전트에서 설정합니다.
클라우드 환경으로 시작하기
어느 쪽을 선택해야 할지 확실하지 않거나 Claude Managed Agents를 처음 사용하는 경우, 빠른 시작에서처럼 클라우드 환경으로 시작하세요. Anthropic이 각 세션마다 일반적인 언어와 도구가 이미 설치된 격리된 컨테이너를 실행하므로 사용자가 호스팅할 것이 없습니다. 도구가 반드시 사용자가 제어하는 인프라에서 실행되어야 하는 경우에만 자체 호스팅 샌드박스를 선택하세요.
옵션 비교
다음 표는 두 옵션을 비교합니다.
| 클라우드 환경 (기본값) | 자체 호스팅 샌드박스 | |
|---|---|---|
| 도구와 코드가 실행되는 위치 | Anthropic이 관리하는 샌드박스 | 사용자 인프라의 워커 |
| Anthropic에 전달되는 것 | 대화 기록, 도구 결과, 샌드박스의 파일과 상태, 스킬, 메모리 스토어 | 대화 기록, 도구 결과, 스킬, 메모리 스토어. 샌드박스의 파일과 프로세스는 워커에 남습니다. |
| 사용자가 운영하는 것 | 없음 | 워커 호스트, 호스트 보안 강화, 네트워크 제한, 워커가 인증에 사용하는 환경 키 |
| 네트워크 접근 범위 | 환경에 설정한 네트워크 규칙 | 사용자 자체 네트워크 정책 |
| 파일 및 GitHub 리포지토리 마운트 | Anthropic이 관리 | 사용자가 관리 |
| 메모리 스토어 | Anthropic이 /mnt/memory/에 마운트 | /mnt/memory/에 다운로드되고 워커가 동기화 |
| 샌드박스 수명 주기 | Anthropic이 관리 | 사용자가 관리 |
| 선택해야 하는 경우 | 기본값. 도구를 자체 인프라에서 실행할 필요가 없는 경우. | 도구가 반드시 사용자가 제어하는 인프라에서 실행되어야 하는 경우. |
자체 호스팅 샌드박스를 선택해야 하는 경우
자체 호스팅 샌드박스는 에이전트가 다음 중 하나를 수행해야 할 때 적합합니다:
- 네트워크 밖으로 나갈 수 없는 데이터 작업: 에이전트의 파일과 프로세스는 워커에 남습니다. 도구가 모델에 반환하는 내용은 여전히 Managed Agents 서비스에 전달됩니다.
- 공개적으로 라우팅되지 않는 내부 서비스 접근: 에이전트의 bash 및 파일 도구와 워커가 제공하는 모든 사용자 정의 도구는 사용자의 네트워크 내부에서 실행됩니다. 에이전트의 MCP 서버에 연결하는 것은 워커가 아니라 Anthropic입니다. 비공개 MCP 서버는 내부 티켓 시스템이나 회사 위키 앞단에 있을 수 있습니다. 이러한 서버에 접근하려면 두 옵션 모두에서 MCP 터널을 사용할 수 있습니다. MCP 터널은 연구 프리뷰 단계이며 액세스 요청이 필요합니다. 자체 호스팅 샌드박스와 MCP 터널을 참조하세요.
- 조직 자체의 규정 준수 및 감사 통제하에서 실행: 도구는 사용자가 구성하고, 로깅하고, 감사하는 호스트에서 실행됩니다.
자체 호스팅 샌드박스로도 달라지지 않는 것
어느 옵션을 사용하든 대화 기록과 도구 결과는 Anthropic이 운영하는 Managed Agents 서비스로 전달됩니다. 이것이 모델이 각 도구 호출의 결과를 받는 방식입니다. 웹 검색 및 웹 가져오기 도구도 샌드박스가 아니라 Anthropic 측에서 실행됩니다. 웹 검색 및 웹 가져오기 도메인 제한을 참조하세요. 어느 옵션도 Managed Agents의 규정 준수 적용 범위나 대화 기록 보관 기간을 변경하지 않습니다. API 및 데이터 보존을 참조하세요.
자체 호스팅 샌드박스로 떠맡게 되는 것과 포기하게 되는 것
자체 호스팅 샌드박스를 사용하면 사용자가 워커 호스트의 운영자가 됩니다. 샌드박스 이미지의 보안을 강화하고, 네트워크 이그레스(egress)를 제어하고, 환경 키를 저장 및 교체하고, 세션을 서로 격리해야 합니다. 자세한 내용은 보안 모델 페이지에 있습니다.
또한 다음 클라우드 환경 기능을 포기하게 됩니다:
file및github_repository세션 리소스. 입력 파일은 직접 준비해야 하며, 자체 GitHub 리포지토리를 마운트하는 것도 사용자의 책임입니다.- 리포지토리 스킬 검색.
- 볼트의 환경 변수 자격 증명.
- 클라우드 샌드박스의 사전 설치된 런타임 및 패키지. 자체 호스팅 샌드박스에는 워커가 제공하는 것만 있습니다.
Claude Platform on AWS에서의 차이점
Claude Platform on AWS를 통해 Claude Managed Agents를 사용하는 경우에도 서비스는 여전히 Anthropic이 운영합니다. 이 경우 자체 호스팅 샌드박스는 메모리 스토어를 사용할 수 없고, 워커는 환경 키를 사용하지 않으며, MCP 터널을 사용할 수 없습니다. Claude Platform on AWS의 Claude Managed Agents 및 지원되지 않는 기능을 참조하세요.
클라우드 환경에서 자체 호스팅 샌드박스로 전환하기
자체 호스팅 샌드박스로 전환하려면 에이전트는 그대로 유지하고, self_hosted 환경을 생성한 다음, 새 세션과 배포에서 해당 환경의 ID를 참조합니다.
- 그대로 유지되는 것: 에이전트 정의, 애플리케이션이 사용하는 API 키 또는 AWS 자격 증명, 스킬, MCP 서버, 메모리 스토어.
- 새로 필요한 것:
self_hosted환경, Claude Console에서 생성하는 환경 키, 사용자가 실행하는 워커. 자체 호스팅 샌드박스 빠른 시작에서 세 가지를 모두 다룹니다. - 더 이상 작동하지 않는 것: 자체 호스팅 샌드박스로 떠맡게 되는 것과 포기하게 되는 것에 나열된 기능.
Claude Platform on AWS에서는 메모리 스토어가 자체 호스팅 샌드박스로 이전되지 않으며, 워커는 환경 키를 사용하지 않습니다. Claude Platform on AWS에서의 차이점을 참조하세요.
Was this page helpful?