Managed Agents레퍼런스

참조

Claude Managed Agents의 이벤트 유형, 자체 호스팅 워커 CLI 플래그, 지원되는 MCP 서버 유형, 속도 제한 및 브랜딩 가이드라인입니다.

이 페이지는 Claude Managed Agents에 대한 참조 자료를 모아 놓은 곳입니다. 작업 중심 가이드는 각 섹션의 링크를 참조하세요. 세션 리소스에 대한 작업은 세션 작업을 참조하세요.

모든 Managed Agents API 요청에는 managed-agents-2026-04-01 베타 헤더가 필요합니다. SDK는 베타 헤더를 자동으로 설정합니다.

이벤트 유형

이벤트 유형 문자열은 {domain}.{action} 명명 규칙을 따릅니다. 이벤트 전송, 스트리밍 및 나열에 대해서는 세션 이벤트 스트림을 참조하세요.

자체 호스팅 워커

다음은 self_hosted 환경을 구동하는 사전 구축된 워커의 ant beta:worker CLI 플래그입니다. 환경 설정, 워커 실행 및 SDK 헬퍼 옵션에 대해서는 자체 호스팅 샌드박스를 참조하세요.

플래그	설명
`--environment-id`	작업을 폴링할 환경입니다. `ANTHROPIC_ENVIRONMENT_ID`에서도 읽습니다.
`--environment-key`	이 환경으로 워커를 인증합니다. `ANTHROPIC_ENVIRONMENT_KEY`에서도 읽습니다.
`--workdir`	스킬이 다운로드되고 도구가 파일을 읽고 쓰는 디렉터리입니다. 기본값은 `.`(현재 디렉터리)이며, 시스템 기본 작업 디렉터리는 `/workspace`입니다.
`--on-work`	도구를 프로세스 내에서 실행하는 대신 각 할당된 작업 항목에 대해 호출할 스크립트입니다. 세션 세부 정보를 환경 변수로 받습니다.
`--unrestricted-paths`	도구 호출이 `--workdir` 외부의 경로에 접근할 수 있도록 허용합니다.
`--max-idle`	세션이 `end_turn` 중지 이유로 유휴 상태가 된 후 종료하기 전까지 대기할 시간입니다. 기본값은 `60s`입니다.
`--log-format`	로그 출력 형식입니다. 구조화된 로그 수집을 위해서는 `json`을 사용하세요. 기본값은 `text`입니다.

지원되는 MCP 서버 유형

Claude Managed Agents는 HTTP 엔드포인트를 노출하는 원격 MCP 서버에 연결하거나, MCP 터널을 통해 비공개 MCP 서버에 연결합니다. 서버는 MCP 프로토콜의 스트리밍 가능한 HTTP 전송을 지원해야 합니다. 에이전트에서 서버를 선언하는 방법은 MCP 커넥터를 참조하세요.

MCP 및 MCP 서버 구축에 대한 자세한 내용은 MCP 문서를 참조하세요.

속도 제한

Managed Agents 엔드포인트는 조직별로 속도 제한이 적용됩니다.

작업	제한
생성 엔드포인트(에이전트, 세션, 환경 등)	분당 300개 요청
읽기 엔드포인트(조회, 나열, 스트림 등)	분당 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?

Managed Agents레퍼런스

참조

Claude Managed Agents의 이벤트 유형, 자체 호스팅 워커 CLI 플래그, 지원되는 MCP 서버 유형, 속도 제한 및 브랜딩 가이드라인입니다.

모든 Managed Agents API 요청에는 managed-agents-2026-04-01 베타 헤더가 필요합니다. SDK는 베타 헤더를 자동으로 설정합니다.

이벤트 유형

이벤트 유형 문자열은 {domain}.{action} 명명 규칙을 따릅니다. 이벤트 전송, 스트리밍 및 나열에 대해서는 세션 이벤트 스트림을 참조하세요.

자체 호스팅 워커

플래그	설명
`--environment-id`	작업을 폴링할 환경입니다. `ANTHROPIC_ENVIRONMENT_ID`에서도 읽습니다.
`--environment-key`	이 환경으로 워커를 인증합니다. `ANTHROPIC_ENVIRONMENT_KEY`에서도 읽습니다.
`--workdir`	스킬이 다운로드되고 도구가 파일을 읽고 쓰는 디렉터리입니다. 기본값은 `.`(현재 디렉터리)이며, 시스템 기본 작업 디렉터리는 `/workspace`입니다.
`--on-work`	도구를 프로세스 내에서 실행하는 대신 각 할당된 작업 항목에 대해 호출할 스크립트입니다. 세션 세부 정보를 환경 변수로 받습니다.
`--unrestricted-paths`	도구 호출이 `--workdir` 외부의 경로에 접근할 수 있도록 허용합니다.
`--max-idle`	세션이 `end_turn` 중지 이유로 유휴 상태가 된 후 종료하기 전까지 대기할 시간입니다. 기본값은 `60s`입니다.
`--log-format`	로그 출력 형식입니다. 구조화된 로그 수집을 위해서는 `json`을 사용하세요. 기본값은 `text`입니다.

지원되는 MCP 서버 유형

MCP 및 MCP 서버 구축에 대한 자세한 내용은 MCP 문서를 참조하세요.

속도 제한

Managed Agents 엔드포인트는 조직별로 속도 제한이 적용됩니다.

작업	제한
생성 엔드포인트(에이전트, 세션, 환경 등)	분당 300개 요청
읽기 엔드포인트(조회, 나열, 스트림 등)	분당 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를 모방하는 시각적 요소

Was this page helpful?