DeepSeek Harness: DeepSeek의 오픈소스 AI Agent 엔지니어링 프레임워크 171

DeepSeek Harness란 무엇인가

DeepSeek Harness는 DeepSeek에서 막 공개한 오픈소스 ai Agent 프레임워크로, 현재 개발자 프리뷰 단계에 있으며 소스코드가 GitHub에 공개되어 있습니다.

DeepSeek Harness의 핵심 아이디어는 한 문장으로 요약됩니다: Agent = Model + Harness. 모델은 추론을 담당하고, Harness는 이 추론을 실제 환경과 연결하여 Agent가 컨텍스트를 이해하고, 도구를 호출하며, 실제 시나리오에서 지속적으로 작업을 수행하도록 합니다.

DeepSeek Harness는 Claude Code 같은 폐쇄형 제품과 달리 오픈소스 노선을 따릅니다. 모델, 도구, UI, 저장 등 모든 기능을 플러그인으로 분리하여, 개발자는 필요한 것을 골라 설정 파일로 조합하기만 하면 되며 소스코드를 수정할 필요가 없습니다.

DeepSeek Harness 기능 특징

• Cordis 커널: Harness는底层에서 Cordis 위에서 동작합니다. Cordis는 플러그인의 마운트, 마운트 해제 및 의존성 관리를 담당하며, 모든 Agent 기능은 플러그인 내에서 작동합니다.

• 모든 것이 플러그인: 모델, 도구, 스킬, 세션, 샌드박스, 저장, 루프, 스케줄러, UI — 전부 플러그인입니다. Cordis는 서비스와 이벤트 메커니즘을 통해 플러그인 간 통신을 구현합니다. 개발자는 필요한 플러그인을 선택하고 설정 파일 하나만 작성하면 원하는 Agent를 조합할 수 있으며, 소스코드를 건드릴 필요가 없습니다.

• Trajectory 전 과정 로그: 모델이 보는 모든 것 — 시스템 프롬프트, 추론 과정, 도구 호출의 파라미터와 반환 결과, 서브 Agent의 스케줄링 기록, 매번의 컨텍스트 주입 — 전부 추가 전용 세션 로그에 기록됩니다. Trajectory 뷰에서 출처별로 항목을 하나씩 확인할 수 있습니다. 문제가 생기면 구체적인 단계로 바로 이동할 수 있고, 임의의 노드에서 새로운 세션을 분기하여 계속 탐색하거나, 전체 작업을 재실행할 수도 있습니다.

• 4가지 실행 모드

• Standard: 파일 편집, shell, 파일/웹 검색, 스킬, 계획, 목표, 서브 Agent, 워크플로우를 갖춘 완전한 코딩 Agent.

• Code: Standard의 모든 기능을 갖추되, 도구는 Code Mode SDK를 통해 노출되어 모델이 TypeScript 프로그램으로 여러 단계를 한 번에 조율할 수 있습니다.

• Minimal: 가장 간단한 환경으로, 영구 bash와 str_replace_editor 두 도구만 제공되며 주로 모델 벤치마크 테스트에 사용됩니다.

• Creator: Standard에 런타임 검사, 플러그인 실험, 프리셋 작성 가이드를 추가하여 사용자 정의 Agent 프리셋을 만드는 데 사용됩니다.

DeepSeek Harness 적합 시나리오

• 복잡한 코드베이스 리팩토링: Trajectory가 리팩토링 과정의 모든 단계별 작업과 추론을 완전히 기록합니다. 문제가 발생하면 오류가 발생한 노드로 정확하게 되돌릴 수 있어 처음부터 다시 할 필요가 없습니다. Code 모드에서는 모델이 스스로 TypeScript 스크립트를 작성하여 여러 라운드의 도구 호출을 조율하므로, 한 단계씩 모델 응답을 기다리는 것보다 빠릅니다.

• 풀스택 요구사항 개발: Standard 모드에는 파일 편집, shell, 검색, 스킬, 계획, 서브 Agent 스케줄링이 기본으로 포함되어 있어, PRD부터 프론트엔드/백엔드 코드, 배포 스크립트까지 한 세션에서 연결됩니다. 세션 로그가 완전히 보존되어 다음에 열면 바로 이어서 작업할 수 있습니다.

• 모델 벤치마크 테스트: Minimal 모드는 bash와 파일 에디터만 남기므로 환경이 깔끔하고 통제 가능합니다. 동일 작업에서 서로 다른 모델의 성능을 비교할 때 불필요한 도구의 영향을 받지 않습니다.

• 사용자 정의 Agent 프리셋: Creator 모드에서는 개발자가 런타임 상태를 실시간으로 확인하고, 메모리에서 Cordis 플러그인을 테스트하며, 조합한 기능을 새로운 프리셋으로 패키징할 수 있습니다. 팀은 비즈니스 시나리오에 맞게 전용 구성을 커스터마이징할 수 있습니다.

DeepSeek Harness 가격

Harness 프레임워크 자체는 오픈소스로 무료이며, 소스코드는 GitHub에서 바로 clone할 수 있습니다.단, Agent를 실행하려면底层 모델을 호출해야 하므로 비용은 연결된 모델과 사용량에 따라 다릅니다. DeepSeek-V4에 연결하는 경우 API는 피크/오프피크 요금이 적용됩니다.

피크 시간대는 베이징 시간 기준 9:00-12:00 및 14:00-18:00입니다.

DeepSeek Harness 자주 묻는 질문

Q: Harness를 지금 사용할 수 있나요?

사용할 수 있습니다. 개발자 프리뷰 버전이 이미 공개되었으며, 한 줄 명령으로 Web UI를 시작할 수 있습니다.

Q: DeepSeek 모델만 연결할 수 있나요?

아닙니다. 모델 기능도 플러그인화되어 있어 이론적으로 다른 모델도 연결할 수 있으며, DeepSeek 자체 모델이 가장 잘 최적화되어 있을 뿐입니다.

Q: 플러그인 시스템이 배우기 어렵나요?

공식 사이트의 컨셉은 "구성이 곧 조합"입니다. 플러그인을 선택하고 설정 파일을 작성하기만 하면 되며 소스코드를 수정할 필요가 없습니다. Creator 모드에는 런타임 검사 및 플러그인 실험 도구도 제공되어 커스터마이징 진입 장벽을 낮춥니다.

Q: Trajectory가 구체적으로 무엇을 할 수 있나요?

Agent의 블랙박스와 같습니다. 시스템 프롬프트, 모델 추론, 매번의 도구 호출 세부 정보, 서브 Agent의 스케줄링 기록이 모두 타임라인별로 정리됩니다. 문제가 생기면 바로 로그를 확인하여 위치를 특정할 수 있고, 중간 단계에서 새로운 세션으로 분기할 수도 있습니다.

Q: 4가지 모드를 어떻게 선택하나요?

일상 개발에는 Standard를, 모델이 직접 스크립트를 작성하여 복잡한 흐름을 구성해야 할 때는 Code를, 모델 비교 테스트에는 Minimal을, 자체 Agent 프리셋을 구축하려면 Creator를 사용하세요.

DeepSeek Harness 사용 방법

Web UI 빠른 시작

Node.js가 필요하며, 다음을 실행하세요:

npx @deepseek-ai/dsh web

소스코드 설치

git clone https://github.com/deepseek-ai/deepseek-harness

그런 다음 저장소의 setup 안내에 따라 구성하세요.

DeepSeek Harness와 경쟁 제품 비교

DeepSeek Harness는 다른同类 제품 대비 어디가 강한가

• 오픈소스 + 플러그인 방식：폐쇄형 제품이 아니라, 분해하고 조립할 수 있는 프레임워크입니다. 팀은 필요한 부분만 가져갈 수도 있고, 깊이 있게 커스터마이징할 수도 있습니다. 코드가 공개되어 있어 블랙박스가 없고, 공급업체 종속에 갇히지 않습니다.

• Trajectory 전 과정 기록：디버깅과 감사에 모두 근거가 있습니다. 복구, 분기, 재실행이 동일한 이벤트 스트림을 기반으로 바로 이루어지므로, 별도의 상태 관리가 필요하지 않습니다.

• 네 가지 모드로 다양한 시나리오 커버：완전한 Standard부터 가장 간결한 Minimal, 개발자向けの Creator까지, 다양한 시나리오를 위해 여러 도구를 설치할 필요가 없습니다.

• 구성 기반 방식：모델, 도구, 저장 방식을 바꿀 때 설정 파일만 수정하면 됩니다. Agent 기능을 빠르게 반복 개발해야 하는 팀의 경우 번거로움이 크게 줄어듭니다.

왜 DeepSeek Harness를 선택해야 하는가

스스로 통제할 수 있고 필요에 따라 잘라 쓸 수 있는 Agent 프레임워크가 필요하다면, Harness는 폐쇄형 제품보다 유연합니다. 오픈소스이기 때문에 공급업체 종속이 없고, 플러그인 방식 덕분에 기능을 점진적으로 확장할 수 있습니다. Trajectory의 전 과정 기록은 감사와 디버깅이 필요한 기업용 시나리오에서도 매우 유용합니다. DeepSeek-V4를 연동하면 API 비용이 매우 낮아 대규모 Agent 작업을 부담 없이 실행할 수 있습니다.

관련 소식：

DeepSeek, Harness v0.1 개발자 프리뷰 버전 출시

Harness란 무엇인가? 코드智能体 엔지니어링 시스템 종합 해설