DeepSeek Harness: 모든 것이 플러그인인 오픈소스 에이전트 런타임

DeepSeek이 에이전트 스택의 빠진 절반을 마침내 공개했습니다. DeepSeek Harness v0.1이 개발자 프리뷰로 출시되었습니다 — MIT 라이선스로 배포되는 오픈소스 에이전트 하네스로, 하나의 핵심 원칙을 중심으로 설계되었습니다: 모든 것이 플러그인입니다. 모델, 도구, 스킬, 세션, 샌드박스, 파일시스템, 루프, 오케스트레이션, UI까지 모두 플러그인으로 구현되어 자유롭게 조합하고 교체하며 확장할 수 있습니다. 하네스의 실체, Cordis 기반 아키텍처의 작동 방식, 그리고 에이전트를 직접 구축하거나 자체 호스팅하는 경우 "에이전트 = 모델 + 하네스"라는 공식이 왜 중요한지 살펴봅니다.

DeepSeek Harness란 무엇인가?

DeepSeek Harness(dsh)는 DeepSeek AI가 개발하고 MIT 라이선스로 공개한 오픈소스 에이전트 하네스입니다. 언어 모델을 감싸는 런타임 레이어로, 모델이 환경을 이해하고 도구를 사용하며 복잡한 실제 작업을 단계적으로 수행할 수 있도록 합니다. (GitHub)

DeepSeek은 이 구분을 명확하게 정의합니다: 모델은 에이전트의 영혼이고, 하네스는 그 에이전트가 환경을 인식하고 도구를 호출하며 실제 환경에서 지속적으로 작동할 수 있게 해주는 것입니다. 즉, 에이전트 = 모델 + 하네스입니다. 하네스 없는 강력한 모델은 그저 비싼 자동완성에 불과하며, 하네스가 있어야 비로소 행동하는 에이전트가 됩니다. (DeepSeek)

이는 명백한 공백을 채우는 것입니다. DeepSeek의 V4 모델은 오픈 웨이트(open-weight), MIT 라이선스로 제공되며 프론티어 클로즈드 모델보다 훨씬 저렴하지만, 에이전트 신뢰성이라는 약점이 남아 있었습니다 — 이는 근본적으로 하네스의 문제입니다. Harness는 Anthropic의 Claude Code에 대한 오픈소스 대안으로 포지셔닝된 DeepSeek의 해답입니다. (CryptoBriefing)

"모든 것이 플러그인": Cordis 아키텍처

핵심 설계 원칙은 모든 에이전트 기능이 플러그인이라는 것입니다. Harness는 Cordis 메타 프레임워크 위에 구축되었으며, Cordis 커널이 플러그인 간의 마운트, 언마운트, 의존성을 관리합니다. 에이전트의 실제 기능은 전적으로 이 플러그인들 안에 존재합니다. (DeepSeek)

플러그인으로 구성되는 것들은 다음과 같습니다:

• 모델 — LLM 백엔드 자체
• 도구 — 파일 편집, 셸, 파일 및 웹 검색
• 스킬 — 에이전트가 호출할 수 있는 재사용 가능한 기능
• 세션 — 대화 및 실행 상태
• 샌드박스 — 격리된 실행 환경
• 스토리지 / 파일시스템 — 상태와 아티팩트가 저장되는 곳
• 루프 & 스케줄링 — 에이전트의 제어 흐름 및 서브에이전트 스케줄링
• UI — 인터페이스조차 플러그인

Cordis 서비스와 이벤트를 통해 플러그인들이 서로 통신합니다. 실질적인 이점은 DeepSeek Harness 소스 코드를 수정하지 않고도 설정만으로 모든 기능을 선택하고 교체하거나 확장할 수 있다는 것입니다. 다른 샌드박스, 커스텀 도구, 또는 다른 모델 백엔드가 필요하다면? 런타임을 포크하는 대신 플러그인을 마운트하면 됩니다. (DeepSeek)

이는 루프, 도구, UI가 하나로 결합된 모놀리식 에이전트 도구와는 근본적으로 다른 접근 방식입니다. 여기서 하네스는 얇은 커널과 조합 가능한 구성 요소들의 집합입니다.

네 가지 런타임 모드

Harness는 동일한 플러그인을 다양한 용도에 맞게 재조합한 네 가지 프리셋 모드를 제공합니다: (DeepSeek)

• Standard 모드 — 완전한 코딩 에이전트: 파일 편집, 셸, 파일 및 웹 검색, 스킬, 계획 수립, 목표 설정, 서브에이전트, 워크플로우를 포함합니다.
• Code 모드 — Standard의 모든 기능을 포함하되, 도구가 Code Mode SDK를 통해 노출되어 모델이 여러 번의 개별 도구 호출 대신 단일 TypeScript 프로그램으로 다단계 작업을 조합할 수 있습니다.
• Minimal 모드 — 두 가지 도구만 갖춘 간소화된 에이전트: 영구 bash와 str_replace_editor. DeepSeek이 공식 모델 벤치마킹에 사용한 모드로, 최소한의 스캐폴딩으로 모델을 평가하는 깔끔한 환경을 제공합니다.
• Creator 모드 — 자체 프리셋 구축용: 라이브 런타임을 검사하고, 메모리에서 Cordis 플러그인을 테스트하며, 새로운 모드로 조합할 수 있습니다.

모델 발표를 읽을 때 Minimal 모드는 특히 주목할 필요가 있습니다: DeepSeek은 공개된 Code Agent 벤치마크를 "Harness minimal mode"에서 실행했으며, 이는 실제 프로덕션 수치가 사용하는 하네스와 스캐폴딩에 크게 의존한다는 것을 의미합니다. 이 주의사항은 DeepSeek V4 Flash 공식 API 분석에서 자세히 다루었습니다.

모든 실행은 추적 가능

두 번째 설계 원칙은 관찰 가능성(observability)입니다. 모델이 보는 모든 것이 추가 전용(append-only) 세션 로그에 기록됩니다 — 시스템 프롬프트, 추론 과정, 도구 호출과 결과, 서브에이전트 스케줄링, 모든 컨텍스트 주입이 포함됩니다. (DeepSeek)

Trajectory 뷰를 통해 소스별로 해당 기록을 검사할 수 있으며, 로그가 단일 이벤트 스트림이기 때문에 동일한 히스토리를 기반으로 재개, 포크, 검색, 재실행이 가능합니다. 에이전트가 왜 잘못된 방향으로 갔는지 디버깅하는 사람에게, 검사하고 재실행할 수 있는 이벤트 로그는 추측과 확인의 차이를 만들어냅니다.

MIT와 오픈소스가 중요한 이유

라이선스 선택은 전략적입니다. MIT는 가장 허용적인 오픈소스 라이선스 중 하나로 — React와 Node.js 같은 핵심 도구들과 동일한 라이선스로, 누구나 코드를 사용하고 수정하며 상업적 제품을 구축할 수 있습니다. (CryptoBriefing)

이는 DeepSeek의 더 넓은 패턴을 이어갑니다: 경쟁력 있는 모델 성능과 공격적인 오픈소스 공개의 결합 — OpenAI가 오픈소스에서 멀어지고, Anthropic은 한 번도 오픈소스를 수용하지 않았으며, Meta의 Llama는 커스텀 제한 라이선스로 배포되는 시점에서 말입니다. MIT 라이선스 하네스와 MIT 라이선스 오픈 웨이트의 조합은 팀이 독점 벤더 없이 원칙적으로 완전한 에이전트 스택을 처음부터 끝까지 실행할 수 있음을 의미합니다. (CryptoBriefing)

DeepSeek Harness 사용해보기

Harness는 Node.js 프로젝트입니다. 가장 빠른 방법은 npx를 통한 호스팅 Web UI입니다:

npx @deepseek-ai/dsh web

이 명령어는 Web UI를 실행하며 기본적으로 http://127.0.0.1:3080에서 서비스됩니다. 소스 체크아웃에서 실행하려면:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

DeepSeek은 플러그인 생태계도 장려합니다 — 플러그인 저장소에 dsh-plugin 토픽을 태그하면 검색이 가능해지며, 피드백은 GitHub Discussions와 Discord 커뮤니티를 통해 제공할 수 있습니다. (GitHub)

중요한 주의사항: Harness는 개발자 프리뷰 단계로 빠르게 반복 개발 중입니다. DeepSeek은 호환성을 깨는 변경 사항이 발생할 것이며 핵심 플러그인과 API가 계속 진화할 것임을 명확히 경고합니다. v0.1은 프로덕션 시스템에 고정하기보다는 실험하고 플러그인을 구축하는 용도로 활용하는 것이 적합합니다. (GitHub)

주목해야 할 대상

• 에이전트 빌더 — 자체 에이전트 루프를 설계하고 있다면, 교체 가능한 도구·샌드박스·오케스트레이션을 갖춘 플러그인 기반 커널은 처음부터 만들 필요 없이 확장할 수 있는 완성된 기반입니다.
• DeepSeek 모델을 운영하는 팀 — Harness는 V4 시리즈 모델을 신뢰할 수 있는 자율 코딩 에이전트로 전환하기 위한 공식 런타임으로, 모델과 런타임 간의 격차를 해소합니다.
• 자체 호스팅 및 데이터 주권을 중시하는 팀 — MIT 하네스 + MIT 오픈 웨이트는 독점 벤더 종속 없이 에이전트를 실행할 수 있는 완전한 오픈 경로입니다.
• 에이전트 벤치마크를 비교하는 모든 분 — 점수가 "minimal mode"에서 산출되었다는 것을 알면 결과에서 모델과 스캐폴딩의 기여도를 구분할 수 있습니다.

나만의 AI 인력으로 실현하기

플러그인 기반의 모델 독립적 하네스는 아키텍처를 재설계하지 않고도 각 단계에 최적의 모델을 교체할 수 있기 때문에 강력합니다 — 이는 Eigent가 추구하는 방향과 동일합니다. Eigent는 오픈소스 멀티 에이전트 "Cowork" 데스크톱 앱으로, 전문화된 에이전트들을 로컬에서 실제 워크플로우에 걸쳐 오케스트레이션합니다. 런타임을 직접 조합하는 대신 DeepSeek 모델(또는 다른 모델)을 구체적인 작업에 바로 연결할 수 있습니다. 에이전트 코딩 작업에서 이를 실제로 확인하고 싶다면 Eigent가 GitHub PR 리뷰를 처리하는 방식을 살펴보거나, Eigent를 다운로드하여 나만의 AI 인력을 구성해 보세요.

자주 묻는 질문

DeepSeek Harness란 무엇인가요?

DeepSeek Harness(dsh)는 DeepSeek AI가 개발한 오픈소스 MIT 라이선스 에이전트 하네스입니다. 언어 모델에 도구, 샌드박스, 세션, 오케스트레이션을 결합하는 런타임 레이어로, 모델이 다단계 작업에서 자율 에이전트로 동작할 수 있게 합니다. v0.1로 개발자 프리뷰를 시작했습니다.

Cordis 메타 프레임워크란 무엇인가요?

Cordis는 Harness가 구축된 플러그인 시스템입니다. 커널이 플러그인 간의 마운트, 언마운트, 의존성을 관리하며, 모델·도구·스킬·샌드박스·스토리지·루프·스케줄링·UI 등 모든 에이전트 기능이 설정을 통해 교체하거나 확장할 수 있는 플러그인으로 존재합니다.

DeepSeek Harness는 무료 오픈소스인가요?

네. DeepSeek은 상업적 사용, 수정, 재배포를 허용하는 가장 허용적인 오픈소스 라이선스 중 하나인 MIT 라이선스로 코드베이스를 공개했습니다.

네 가지 런타임 모드는 무엇인가요?

Standard(전체 도구셋), Code(모델이 하나의 TypeScript 프로그램으로 다단계 작업을 오케스트레이션할 수 있도록 Code Mode SDK를 통해 도구가 노출됨), Minimal(벤치마킹에 사용되는 bash와 에디터 두 가지 도구만 갖춘 에이전트), Creator(런타임을 검사하고 커스텀 프리셋을 구축하기 위한 모드)입니다.

DeepSeek Harness는 프로덕션에 사용할 수 있나요?

아직은 아닙니다. 개발자 프리뷰 단계로 빠르게 반복 개발 중이며, DeepSeek은 호환성을 깨는 변경 사항이 발생할 것임을 명시적으로 경고합니다. 현재는 프로덕션 시스템에 고정하기보다 실험과 플러그인 구축 용도로 활용하는 것이 가장 적합합니다.