개발자 프리뷰 · MIT 오픈소스 · 2026-08

DeepSeek Harness: 모델이 실제 환경에서 계속 일하게 하세요

DeepSeek Harness(dsh)는 새로운 채팅 모델이 아니라 오픈소스 Agent 실행 계층입니다. 모델은 사고를 담당하고, Harness는 도구, 세션, 샌드박스, 재생 가능한 로그를 담당합니다. 공식은 단순합니다: Agent = 모델 + Harness.

공식 소개 보기 GitHub 소스 DeepSeek 웹 채팅 열기

페이지 업데이트 2026-08-18 · 공식 개발자 프리뷰 공개 정보를 바탕으로 정리

DeepSeek Harness란?

먼저 「모델」과 「Harness」를 구분한 뒤, 어느 계층을 설치할지 결정하세요.

Agent = 모델 + Harness

모델은 영혼입니다. 추론하고, 작업을 쪼개고, 다음 단계를 결정합니다.

Harness는 손발과 현장입니다. 환경을 이해하고 도구를 호출하며, 실제 저장소에서 연속으로 작업합니다.

DeepSeek Harness는 DeepSeek가 2026년 8월 전 세계 개발자를 대상으로 공개한 Agent 실행 인프라(개발자 프리뷰)입니다. 소스는 MIT 라이선스로 열려 있고, npm 패키지 이름은 @deepseek-ai/dsh이며, 저장소 주소는 GitHub의 deepseek-ai/deepseek-harness입니다.

이것이 푸는 문제는 「채팅할 수 있는 모델을 하나 더 내는 것」이 아닙니다. 모델이 이미 추론할 수 있다면, 실제 디렉터리에서 파일을 고치고, 명령을 실행하고, 도구를 호출하고, 로그를 남기고, 실패 후 복구하는 방법은 무엇인가입니다. Harness가 없으면 대개 대화창에서 멈춥니다. Harness가 있으면 모델이 통제된 경계 안에서 연속 실행할 수 있습니다.

공식 슬로건은 「모든 것은 플러그인」입니다. 기본 경로에서도 DeepSeek API Key 설정이 필요합니다. Web UI는 무료로 열 수 있지만, 실제로 Agent를 실행하면 모델 호출 비용이 발생합니다. 현재는 v0.1 시리즈 프리뷰이며, 핵심 플러그인과 API에 호환성을 깨는 변경이 있을 수 있습니다.

누가 DeepSeek Harness를 쓰면 맞나요?

이 사이트의 웹 채팅과는 다른 종류의 진입점입니다. 작업에 맞춰 도구를 고르세요.

저장소에서 코딩 Agent를 돌리고 싶다

파일을 읽고 고치고, Shell을 실행하고, 웹을 검색하며, 모델이 다단계 엔지니어링 작업을 연속으로 끝내게 해야 합니다.
플러그인이나 사용자 지정 preset을 만들고 싶다

Harness 본체를 바꾸지 않고 모델, 도구, 샌드박스, UI를 교체해 나만의 Agent를 조립하고 싶습니다.
브라우저에서 채팅만 하고 싶다

Node.js를 설치할 필요가 없습니다. 이 사이트의 DeepSeek 웹 입구로 들어가 DeepSeek-V4와 바로 대화하세요.

아키텍처 요점: 모든 것은 플러그인

DeepSeek Harness는 Cordis를 기반으로 합니다. 커널은 로드와 의존성만 다루고, 구체적인 능력은 전부 플러그인이 제공합니다.

01

Cordis 커널

플러그인의 마운트, 언마운트, 의존 관계만 담당하고 Agent 업무를 본체에 넣지 않습니다. 능력을 바꿀 때마다 저장소 전체를 포크하지 않아도 됩니다.
02

능력은 모두 플러그인

모델 어댑터, 도구, 스킬, 세션, 샌드박스, 저장소, 루프, 스케줄링, UI를 모두 플러그인으로 조합하고, 서비스와 이벤트로 협업할 수 있습니다.
03

설정 계층에서 재구성

개발자는 Harness 소스를 고치지 않고도 설정 계층에서 어떤 능력이든 선택, 교체, 확장하고 장면에 맞춰 Agent를 조립할 수 있습니다.

네 가지 실행 모드

같은 플러그인 커널이 기본으로 다른 조합을 로드합니다. 일상 코딩, 프로그래밍 방식 도구 호출, 벤치마크, 사용자 지정 preset을 커버합니다.

표준 모드

기능이 완전한 코딩 Agent.

파일 편집, Shell, 파일과 웹 검색, Skills, 계획, 목표, 서브 에이전트, 워크플로를 지원하며 일상 저장소 작업에 맞습니다.

PTC 모드

한 편의 코드로 여러 라운드의 도구 호출을 조합합니다.

표준 모드 능력을 갖추고, Code Mode SDK로 도구를 제시해 모델이 TypeScript 프로그램으로 다단계 작업을 오케스트레이션하게 합니다.

미니멀 모드

최소 도구 면으로, 벤치마크에 적합합니다.

보통 지속 bash와 파일 편집(str_replace_editor)만 남겨, 최소화된 환경에서 모델의 모습을 관찰합니다.

크리에이터 모드

런타임을 검사하고 사용자 지정 preset을 만듭니다.

현재 플러그인을 확인하고, 메모리에서 Cordis 플러그인을 시험하며, 새로운 실행 모드를 조합하는 데 사용합니다.

모든 실행에는 흔적이 남습니다

세션은 추가 전용 이벤트 스트림으로 기록됩니다. 복구, 포크, 검색, 재생이 같은 로그를 공유합니다.

시스템 프롬프트, 사고 사슬, 도구 호출과 결과가 세션 로그에 기록됩니다
서브 Agent 디스패치와 매번 컨텍스트 주입은 출처별로 확인할 수 있습니다
Trajectory 보기는 모델이 무엇을 보고 무엇을 했는지 감사하는 데 도움이 됩니다
고위험 작업은 권한과 승인을 함께 써야 하며, 저장소를 그대로 모델에 넘겨서는 안 됩니다

시작하기

빠르게 체험하거나 소스에서 설치

로컬에 Node.js가 설치되어 있어야 합니다. 버전 요구사항은 공식 저장소 README를 따릅니다.

빠른 체험

Node.js를 설치한 뒤 npx로 Web UI를 시작할 수 있습니다. 기본값은 로컬 3080 포트입니다: http://127.0.0.1:3080

$ npx @deepseek-ai/dsh web

소스 설치

전체 프로젝트 소스를 가져온 뒤 저장소 안내에 따라 설치를 완료합니다(pnpm install, pnpm run build, pnpm dsh web).

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

API Key와 모델 설정

화면에서 DeepSeek API Key를 설정하고 DeepSeek-V4-Flash 또는 DeepSeek-V4-Pro를 선택하세요. 먼저 Flash로 시험 실행하는 것이 좋습니다.

작업 공간과 권한 지정

저장소 디렉터리를 고르고 파일과 명령 권한을 좁힌 뒤에 작업을 주세요. 프리뷰 단계에서는 명령과 설정이 바뀔 수 있으니 저장소 문서를 따르세요.

웹 대화와 Harness는 무엇이 다른가요?

이 사이트의 DeepSeek 웹 버전은 「열면 바로 대화」를 해결합니다. Harness는 「저장소에서 연속 실행」을 해결합니다.

웹 대화와 Harness는 무엇이 다른가요?
비교 항목	DeepSeek 웹 채팅	DeepSeek Harness
무엇을 찾고 있나요	설치 없는 온라인 대화 입구	로컬 / 소스 수준 Agent 실행 계층
전형적인 사용자	학습, 사무, 글쓰기, Q&A	개발자, Agent와 플러그인을 만드는 사람
저장소 파일을 고칠 수 있나요	대화가 중심	권한 범위 안에서 파일 읽기/쓰기와 명령 실행 가능
시작하는 방법	브라우저에서 이 사이트 입구를 열기	npx로 Web UI를 시작하거나 소스를 클론

DeepSeek Harness 자주 묻는 질문

오픈소스 라이선스, 비용, 모델 선택, 웹 버전과의 차이에 대해.

DeepSeek Harness는 공식 새 모델인가요?

아닙니다. DeepSeek가 오픈소스로 공개한 Agent 실행 프레임워크(Harness)로, 모델, 도구, 세션, UI를 연결합니다. 채팅과 추론 능력은 여전히 DeepSeek-V4 같은 모델에서 옵니다.

DeepSeek Harness는 무료인가요?

프레임워크 소스는 MIT 라이선스로 오픈소스이며 무료로 받을 수 있습니다. Agent를 실행하려면 보통 DeepSeek API를 호출하므로 token 비용이 발생합니다. 공식 요금과 키 잔액을 따르세요.

이 사이트의 DeepSeek 웹 버전과 같은 것인가요?

아닙니다. 웹 버전은 브라우저를 열어 바로 대화하기 위한 것이고, Harness는 개발자가 실제 환경에서 코딩 Agent를 돌리기 위한 것입니다. 채팅이 필요하면 이 사이트 입구를, 코드를 고치고 도구를 실행해야 하면 Harness를 쓰세요.

Harness를 쓰려면 대형 모델을 로컬에 배포해야 하나요?

그럴 필요는 없습니다. 공개 문서의 일반적인 경로는 DeepSeek 클라우드 API입니다. Node.js, API Key, 브라우저가 필요하며 GPU를 직접 준비할 필요는 없습니다.

지금 프로덕션에 써도 되나요?

공식은 개발자 프리뷰라고 명시하고 호환성을 깨는 변경이 있을 수 있다고 안내합니다. 학습, 실험, 플러그인 개발에 적합합니다. 프로덕션 연동은 안정성을 직접 평가하고, 검증한 버전을 고정하세요.

dsh란 무엇이고 어떻게 시작하나요?

dsh는 DeepSeek Harness의 흔한 약칭이자 CLI 이름입니다. Node.js를 설치한 뒤 npx @deepseek-ai/dsh web을 실행하면 기본적으로 http://127.0.0.1:3080에서 Web UI가 열립니다.

먼저 장면을 가른 뒤 입구를 고르세요

바로 대화하려면 DeepSeek 웹 버전을 여세요. 저장소에서 Agent를 돌리려면 공식 DeepSeek Harness를 사용하세요.

DeepSeek 웹 버전 열기 GitHub 저장소 열기

이 페이지는 DeepSeek-V4 사이트가 DeepSeek 공식 Harness 페이지와 GitHub 저장소의 공개 정보를 바탕으로 정리한 것으로, 검색과 대조를 돕기 위한 것이며 DeepSeek 공식 사이트가 아닙니다. 설치, 설정, 호환성은 공식 문서와 저장소 README를 따릅니다.