DeepSeek Harness란 무엇인가? 오픈소스 에이전트 가이드
Updated August 16, 2026 · first published August 16, 2026
DeepSeek Harness(패키지명 dsh)는 DeepSeek AI가 MIT 라이선스로 공개한 오픈소스 자율 에이전트 실행 환경입니다. 본 문서는 에이전트 하네스의 본질, 실행 방법, 아키텍처 구조, 그리고 인프라 비용 통제 관점에서의 가치를 다룹니다.
모델과 하네스의 본질적 차이
AI 모델이 수행하는 일은 텍스트 및 도구 호출 요청을 생성하는 것뿐입니다. 에이전트를 실질적으로 유용하게 만드는 프롬프트 조립, 도구 실제 실행, 권한 정책 강제, 세션 로깅, 후속 모델 호출 루프 제어, 하위 서브에이전트 위임은 모두 하네스의 영역입니다.
동일한 모델을 사용하는 두 기업의 산출물 품질과 월간 API 청구액이 극명하게 갈리는 이유는 모델 자체가 아니라 하네스의 제어 능력 차이 때문입니다.
플러그인 중심 아키텍처
DeepSeek Harness는 Cordis 플러그인 런타임 위에서 동작합니다. 모델 어댑터, 도구 레지스트리, 세션 로그, 에이전트 제어 루프까지 모든 구성 요소가 플러그인으로 구현되어 있어, 코어 코드를 포크하지 않고도 런타임에 손쉽게 가로채거나 교체할 수 있습니다.
설치 및 실행 모드
가장 빠른 실행 방식은 로컬 웹 UI를 띄우는 것입니다:
npx @deepseek-ai/dsh web반면 정기 자동화 및 CI/CD 파이프라인에서 핵심적인 것은 헤드리스(Headless) 모드입니다:
pnpm dsh --profile headless "summarize this workspace"대화형 인터페이스로만 동작하는 하네스는 지속적 통합 환경에서 자동화할 수 없으며, 측정되지 않는 에이전트 비용은 통제할 수 없습니다.
운영 비용과 추론 경제학
하네스 소프트웨어 자체는 MIT 라이선스로 완전 무료이지만, 모델 추론 비용은 유료입니다. 최종 청구액은 턴당 실행 단계 수, 도구 카탈로그 크기, 서브에이전트 위임 깊이, 그리고 무한 루프 차단 정책에 의해 결정됩니다. 이는 모두 하네스 계층의 설계 결정에 달려 있습니다.
Related
Want this applied to your own LLM spend? FinOps LLM runs a free audit of your AI costs and shows where the savings are. Book free audit →