Loading...
  • 빌드
  • 관리
  • 모델 및 가격
  • 클라이언트 SDK
  • API 참조
Search...
⌘K
Log in
개요
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
빌드/시작하기

Claude Managed Agents 개요

관리형 인프라에서 실행되는 사전 구축된 구성 가능한 에이전트 하네스. 장기 실행 작업 및 비동기 작업에 최적.

Anthropic offers two ways to build with Claude, each suited to different use cases:

Messages APIClaude Managed Agents
What it isDirect model prompting accessPre-built, configurable agent harness that runs in managed infrastructure
Best forCustom agent loops and fine-grained controlLong-running tasks and asynchronous work
Learn moreMessages API docsClaude Managed Agents docs

Claude Managed Agents는 Claude를 자율 에이전트로 실행하기 위한 하네스와 인프라를 제공합니다. 자신의 에이전트 루프, 도구 실행 및 런타임을 구축하는 대신, Claude가 파일을 읽고, 명령을 실행하고, 웹을 탐색하고, 코드를 안전하게 실행할 수 있는 완전히 관리되는 환경을 얻습니다. 하네스는 고품질의 효율적인 에이전트 출력을 위해 기본 제공 프롬프트 캐싱, 압축 및 기타 성능 최적화를 지원합니다.

빠른 시작

첫 번째 에이전트 세션 생성

API 참조

전체 엔드포인트 문서

핵심 개념

Claude Managed Agents는 네 가지 개념을 중심으로 구축되었습니다:

ConceptDescription
AgentThe model, system prompt, tools, MCP servers, and skills
EnvironmentConfiguration for where sessions run: an Anthropic-managed cloud container, or a self-hosted sandbox on your own infrastructure
SessionA running agent instance within an environment, performing a specific task and generating outputs
EventsMessages exchanged between your application and the agent (user turns, tool results, status updates)

작동 방식

  1. 1

    에이전트 생성

    모델, 시스템 프롬프트, 도구, MCP 서버 및 스킬을 정의합니다. 에이전트를 한 번 생성하고 세션 전체에서 ID로 참조합니다.

  2. 2

    환경 생성

    사전 설치된 패키지(Python, Node.js, Go 등), 네트워크 액세스 규칙 및 마운트된 파일이 있는 클라우드 컨테이너를 구성합니다.

  3. 3

    세션 시작

    에이전트 및 환경 구성을 참조하는 세션을 시작합니다.

  4. 4

    이벤트 전송 및 응답 스트리밍

    사용자 메시지를 이벤트로 전송합니다. Claude는 자율적으로 도구를 실행하고 서버 전송 이벤트(SSE)를 통해 결과를 다시 스트리밍합니다. 이벤트 기록은 서버 측에 유지되며 전체적으로 가져올 수 있습니다.

  5. 5

    조종 또는 중단

    추가 사용자 이벤트를 전송하여 실행 중인 에이전트를 안내하거나 중단하여 방향을 변경합니다.

Claude Managed Agents를 사용하는 경우

Claude Managed Agents는 다음이 필요한 워크로드에 최적입니다:

  • 장기 실행 실행 - 여러 도구 호출로 분 또는 시간 동안 실행되는 작업
  • 클라우드 인프라 - 사전 설치된 패키지 및 네트워크 액세스가 있는 보안 컨테이너
  • 최소 인프라 - 자신의 에이전트 루프, 샌드박스 또는 도구 실행 계층을 구축할 필요가 없음
  • 상태 저장 세션 - 여러 상호 작용 전체에서 지속되는 파일 시스템 및 대화 기록

지원되는 도구

Claude Managed Agents는 Claude에게 포괄적인 기본 제공 도구 세트에 대한 액세스를 제공합니다:

  • Bash - 컨테이너에서 셸 명령 실행
  • 파일 작업 - 컨테이너의 파일 읽기, 쓰기, 편집, glob 및 grep
  • 웹 검색 및 가져오기 - 웹 검색 및 URL에서 콘텐츠 검색
  • MCP 서버 - 외부 도구 제공자에 연결

전체 목록 및 구성 옵션은 도구를 참조하세요.

베타 액세스

Claude Managed Agents는 현재 베타 버전입니다. 모든 Managed Agents 엔드포인트는 managed-agents-2026-04-01 베타 헤더가 필요합니다. SDK는 베타 헤더를 자동으로 설정합니다. 출력을 개선하기 위해 릴리스 간에 동작이 개선될 수 있습니다.

시작하려면 다음이 필요합니다:

  1. Claude API 키
  2. 모든 요청에 대한 위의 베타 헤더
  3. Claude Managed Agents에 대한 액세스(모든 API 계정에 대해 기본적으로 활성화됨)

특정 기능(결과, 다중 에이전트 및 메모리)은 연구 미리보기 상태입니다. 액세스 요청하여 시도해보세요.

속도 제한

Managed Agents 엔드포인트는 조직별로 속도 제한됩니다:

작업제한
엔드포인트 생성(에이전트, 세션, 환경 등)분당 60개 요청
엔드포인트 읽기(검색, 나열, 스트림 등)분당 600개 요청

조직 수준 지출 제한 및 계층 기반 속도 제한도 적용됩니다.

브랜딩 지침

Claude Managed Agents를 통합하는 파트너의 경우 Claude 브랜딩 사용은 선택 사항입니다. 제품에서 Claude를 참조할 때:

허용됨:

  • "Claude Agent"(드롭다운 메뉴에 권장)
  • "Claude"(이미 "Agents"로 레이블이 지정된 메뉴 내)
  • "{YourAgentName} Powered by Claude"(기존 에이전트 이름이 있는 경우)

허용되지 않음:

  • "Claude Code" 또는 "Claude Code Agent"
  • "Claude Cowork" 또는 "Claude Cowork Agent"
  • Claude Code 브랜드 ASCII 아트 또는 Claude Code를 모방하는 시각적 요소

제품은 자체 브랜딩을 유지해야 하며 Claude Code, Claude Cowork 또는 기타 Anthropic 제품으로 보이지 않아야 합니다. 브랜딩 준수에 대한 질문은 Anthropic 영업팀에 문의하세요.

Was this page helpful?

  • Claude Managed Agents를 사용하는 경우