Deep Agents vs Claude Agent SDK 비교

LangChain의 Deep Agents와 Anthropic의 Claude Agent SDK는 둘 다 커스텀 에이전트를 만드는 하네스(harness)예요. 그런데 실행 환경, 배포 방식, 벤더 의존성에서 서로 다른 선택을 하고 있어서, 어느 쪽이 내 상황에 맞는지 따져볼 필요가 있죠. 이 페이지는 두 하네스를 나란히 놓고 어디서 갈리는지 보여드릴게요. 참고로 Deep Agents는 실제로 OpenSWE와 LangSmith Fleet에서 프로덕션으로 쓰이고 있어요.

출처: 공식문서

한눈에 보기

항목	Deep Agents	Claude Agent SDK
에이전트 실행 위치	샌드박스 안, 또는 샌드박스 밖에서 명령을 원격 실행	샌드박스 안
실행 백엔드	플러그인형: 로컬, 가상 파일시스템, 원격 샌드박스, 커스텀	실행되는 샌드박스의 로컬 파일시스템
모델 제공자	아무 곳이나 가능 (Anthropic, OpenAI, Google, 그 외 100+ 곳)	Claude (Anthropic, Bedrock, Vertex, Azure)
제공자·모델별 튜닝	Harness 프로필(beta): 시스템 프롬프트·도구·미들웨어·서브에이전트 조정을 선언적으로 묶어 제공자나 특정 모델별로 등록	각 모델 호출 지점에서 코드로 설정
배포	LangSmith의 Managed Deep Agents, 또는 LangGraph Build로 독립 이미지 셀프호스팅	셀프호스팅. 서버·인증·스트리밍 레이어를 직접 구축. Claude managed agents는 별도 제품
멀티테넌시	내장: 스코프된 스레드, 사용자별 샌드박스, RBAC	직접 구축해야 함
라이선스	MIT	MIT (단, Claude Code 자체는 독점)

주요 차이점

에이전트와 실행 환경

에이전트를 샌드박스에 연결하는 방식은 크게 두 가지예요. 에이전트를 샌드박스 안에서 실행하는 방식, 그리고 에이전트를 밖에서 실행하면서 샌드박스를 일종의 도구(tool)로 쓰는 방식이죠.

Claude Agent SDK는 첫 번째 방식만 지원해요. 에이전트가 샌드박스 안에서 돌면서 샌드박스의 로컬 파일시스템을 대상으로 도구를 실행하죠. 그런데 Anthropic의 호스팅 모델인 Claude managed agents는 분리(decoupled)된 모델을 쓰는데, 이게 바로 프로덕션 에이전트 아키텍처가 나아가는 방향을 보여줘요.

Deep Agents는 두 방식을 모두 지원하고, 둘을 엮을 백엔드를 직접 고를 수 있어요. 실제로는 이렇게 할 수 있죠.

에이전트를 샌드박스 안에서 실행 (Claude Agent SDK와 동일한 모델)
오래 살아 있는 컨테이너에서 에이전트를 실행하고, 원격 샌드박스를 도구로 써서 네트워크를 통해 명령 실행
테스트용으로 가상 파일시스템을 꽂거나, 자체 인프라에 맞는 커스텀 백엔드로 교체

멀티테넌시

앱을 프로덕션에 올리면 보통 수많은 최종 사용자에게 노출되니까, 사용자마다 환경을 격리해야 해요. Claude Agent SDK에서는 SDK가 에이전트를 샌드박스에 묶어 두거든요. 사용자마다 격리된 실행 환경을 주려면 사용자별로 샌드박스를 띄우고 누구 것인지 추적하며 끝나면 정리하는 API 래퍼를 직접 만들어야 해요.

Deep Agents는 이걸 직접 처리해 줘요. 하네스에서 사용자별·어시스턴트별로 샌드박스를 설정하면, 스코프된 스레드·실행 기록·RBAC까지 함께 딸려 오죠. LangSmith Sandbox를 쓰면 인증 프록시도 기본 제공이라, 사용자마다 자격 증명을 프로비저닝하지 않아도 최종 사용자가 샌드박스 안에서 타사 API를 호출할 수 있어요.

프로덕션 에이전트 서버

셀프호스팅한 Claude Agent SDK 앱을 최종 사용자에게 노출하려면, 에이전트를 호출하고 토큰을 스트리밍하며 대화 스레드를 관리하는 HTTP/WebSocket 또는 SSE 서버를 직접 작성해야 해요. 그 서버는 만들고 운영하고 보호하는 것까지 전부 여러분 몫이죠.

Deep Agents 배포에는 에이전트 서버가 기본 포함돼요. 스트리밍 엔드포인트, 스레드 관리, 실행 기록, 웹훅, 인증까지 갖춰져 있죠.

관리형 클라우드 또는 셀프호스팅

Claude Agent SDK 배포는 셀프호스팅이 원칙이에요. SDK와 Claude managed agents는 별개의 제품이고, SDK로 작성한 코드가 관리형 서비스에 그대로 배포되지는 않아요.

Deep Agents는 코드 변경 없이 두 가지 모드로 돌아요.

관리형(Managed): LangSmith의 Managed Deep Agents로 딥 에이전트를 만들고 실행
셀프호스팅: langgraph build를 실행해 어디든 배포할 수 있는 독립 Docker 이미지 생성

어떤 모델 제공자와도 함께 쓸 수 있는 관리형 에이전트 플랫폼을 원한다면 LangSmith Fleet을 쓰면 돼요. Claude managed agents는 Anthropic 생태계로 한정돼 있죠.

LLM

Claude Agent SDK는 모델·백엔드·배포를 하나로 묶어 셋 사이의 지원을 최적화해요. Deep Agents는 모델 제공자, 실행 백엔드, 배포 대상을 각각 독립적으로 고를 수 있어요. 이 하네스를 고르는 순간 모델과 인프라 선택권을 최대한 유지할 수 있죠.

생태계

Claude Agent SDK는 Claude와 Anthropic의 제품 표면에 맞춰 설계된 반면, Deep Agents는 더 넓은 LangChain 생태계와 통합돼요. 관찰성·평가·배포에 쓰는 LangSmith까지 포함해서요, 어떤 모델 제공자와도 함께 동작하죠.

요약

모델과 인프라의 유연성, 내장된 멀티테넌트 배포, 코드 변경 없이 관리형·셀프호스팅을 선택할 수 있는 점이 필요하다면 Deep Agents를 고르세요. 반대로 이미 Anthropic 생태계에 투자했고 API·인증·멀티테넌트 레이어를 직접 구축해서 셀프호스팅하고 싶다면 Claude Agent SDK가 더 맞아요.

참고: 이 비교 글은 2026년 4월 16일 기준으로 작성됐어요. 제품이 바뀌었다면 이슈로 알려주세요.

Deep Agents vs Claude Agent SDK 비교