Claude Agent SDK로 내 프로세스 안에서 에이전트 돌리는 선택 기준
Claude Agent SDK in 2026: Build vs Buy, and Where to Run Production Agents
Claude Agent SDK는 Claude Code를 구동하는 바로 그 기계를 라이브러리로 떼어낸 것으로, 2025년 9월 Claude Code SDK에서 이름이 바뀌었다. Python·TypeScript로 제공되며 CLI 바이너리, 서브에이전트, 세션, MCP 지원, 호스팅 실행 모델을 번들로 갖는다. 핵심 철학은 '에이전트에게 컴퓨터를 줘라' — 사람처럼 셸·파일시스템·웹을 그대로 쓰게 한다. 2026년 실무의 핵심은 실행 위치 선택이다. 도구 루프를 직접 소유하고 싶으면 Messages API, 루프와 샌드박스까지 Anthropic이 호스팅하길 원하면 Managed Agents, 에이전트를 자사 프로세스·파일시스템·서비스 안에서 돌리고 싶으면 Agent SDK를 쓴다. 설치는 pip install claude-agent-sdk 또는 npm install @anthropic-ai/claude-agent-sdk이며 인증은 ANTHROPIC_API_KEY(또는 Bedrock·Vertex·Azure 라우팅)다. 2026년 6월 15일부터는 인터랙티브 Claude 사용량과 분리된 'Agent SDK 크레딧' 풀이 도입돼, 구독 사용자(Pro·Max·Team·Enterprise)는 인터랙티브 쿼터를 소진하지 않고 SDK 워크로드를 돌릴 월 할당량을 받는다.
'에이전트를 어디서 돌리나'가 비용·보안·통제권을 동시에 가르는 1차 설계 결정이 됐다. 사내 데이터·파일시스템에 직접 붙어야 하는 한국 팀에는 Agent SDK가, 운영 부담을 외주하고 싶으면 Managed Agents가 맞는다. 특히 SDK 크레딧 풀 분리는 자동화 워크로드가 사람의 인터랙티브 쿼터를 잠식하던 문제를 정면으로 해결한 변화라 백그라운드 에이전트 운영의 예측 가능성이 올라간다.
원문 출처
HatchWorks