'DeepSeek Harness 설치 방법'용 타이틀 카드로, 헤드라인, 부제 'npx @deepseek-ai/dsh web → 127.0.0.1:3080', 태그라인 '에이전트 런타임, 모델이 아님', 그리고 'Node 22.19+', '0.1.0-rc.6', 'MIT'라고 표시된 세 개의 칩을 보여줍니다. OrcaRouter 로고는 오른쪽 하단에 합성되어 있습니다.
Guides & Insights

DeepSeek Harness(dsh) 설치 방법: 데스크톱 앱, npx 한 줄 명령, 소스 빌드, 플러그인

작성자

Alistair Wren

게시일

최신 모델 · 20모든 모델 보기 →
벤치마크: Artificial Analysis · 매일 업데이트
모든 게시물로 돌아가기

Deep​Seek Harness(dsh) — Deep​Seek가 2026년 8월 13일에 출시한 오픈소스 에이전트 런타임 — 은 2026년 9월 24일에 공식 데스크톱 클라이언트를 얻었습니다. Windows와 Apple 실리콘 macOS용으로 패키징된 앱이며, 하니스 런타임이 내부에 번들된 상태로 Deep​Seek 자체 다운로드 호스트에서 배포됩니다: Node.js 설치도, npx도, 터미널도 필요 없습니다. 명령줄이 사라진 것은 아닙니다 — npx @deepseek-ai/dsh web은 데스크톱 빌드가 지원하지 않는 Linux에서 여전히 가장 빠른 방법입니다. 시작하기 전에 알아야 할 두 가지: dsh는 모델이 아닙니다 — DeepSeek V4 Flash 0731이나 DeepSeek V4 Pro 0813 같은 모델을 도구, 파일, 터미널에 연결해 주는 하니스 계층입니다 — 그리고 그것의 모든 채널은 여전히 개발자 프리뷰이므로 릴리스마다 호환성을 깨뜨리는 변경이 있을 것으로 예상해야 합니다. 이 가이드에서는 데스크톱 앱, npx 한 줄 명령, 소스 빌드, 헤드리스 모드, 플러그인, MCP, 그리고 솔직하게 말하자면 거친 부분들을 다룹니다.

Deep​Seek Harness가 무엇인지 — 그리고 무엇이 아닌지

수석 연구원 Chen Deli가 확인한 Deep​Seek의 내부 공식은 모델 + 하네스 = 에이전트입니다. 모델은 두뇌이며, 하네스는 그것을 실제로 작업을 수행하는 무언가로 만들어 주는 모든 것입니다: 컨텍스트 및 메모리 관리, 도구 호출, 작업 계획, 파일 읽기와 쓰기, 터미널 실행, 오류 피드백, 그리고 작업 완료 시점 판단까지. Deep​Seek Harness는 바로 그 계층이며, DeepSeek V4 Pro 0813 빌드가 Deep​Seek API에 출시된 바로 그날인 2026년 8월 13일에 MIT 라이선스로 오픈소스 공개되었습니다.

설치 경험을 규정하는 두 가지 사실이 있습니다. 첫째, 아키텍처는 "모든 것이 플러그인"이며, TypeScript 플러그인 컨테이너인 Cordis 위에 구축됩니다. 따라서 여러분이 설치하는 것은 작은 코어와 모델 어댑터, 도구, 세션, UI를 제공하는 일련의 플러그인입니다. 둘째, 오늘날 npm 채널은 latest의 0.1.5-rc.3과 next의 0.1.7-rc.2이며, 둘 다 프로젝트 자체가 개발자 프리뷰라고 명시한 릴리스 후보입니다. README는 호환성을 깨뜨리는 변경이 다가오고 있다고 대문자로 경고합니다. 인기는 실재합니다 — 첫 12시간 만에 GitHub 스타 50,000개, 2026년 9월 말까지 235,000개 — 하지만 스타는 관심을 측정할 뿐 안정성을 측정하지 않습니다. 프리뷰를 계획하듯 설치를 계획하세요: 시도는 빠르게, 버리기는 저렴하게.

시작하기 전에: 실제 시스템 요구 사항

명령줄 설치에서 단 하나의 필수 요건은 Node.js입니다. 이 프로젝트는 엔진 범위 ^22.19.0 || >=24.0.0를 대상으로 합니다 — 쉽게 말해 Node 22.19 이상 또는 모든 Node 24.x입니다. 본인의 버전은 node --version으로 확인하세요. 구버전 Node를 사용 중이라면 npx 설치가 실패하거나 제대로 동작하지 않을 뿐, 완만하게 저하되지는 않습니다. 아래의 데스크톱 앱은 예외입니다. 자체 런타임을 번들로 포함하므로 Node.js가 전혀 필요하지 않습니다.

다른 모든 것은 모델 우선 집단이 가정하는 것보다 가볍다:

• 모델 API 키.dsh는 실제 모델을 실행합니다. Deep​Seek API 또는 설정한 Open​AI 호환 제공업체의 키가 필요합니다. 첫 실행 후 웹 UI에서 추가할 수 있습니다.

• pnpm — 소스에서 빌드할 때만 필요합니다. 다음 명령어로 한 번 설치하세요: npm install -g pnpm.

• ~1GB의 여유 디스크 공간가 필요합니다: npm 패키지, 워크스페이스, 세션 로그, 그리고 로컬 모델이 필요로 할 수 있는 모든 것(dsh 자체는 가중치를 실행하지 않습니다). 데스크톱 설치 프로그램은 더 무겁습니다 — Windows .exe의 경우 288MB, macOS의 경우 368MB 디스크 이미지입니다 — 내부에 해당 런타임을 포함하고 있기 때문입니다.

• OS: npm 경로는 Windows, macOS, Linux에서 작동합니다. 데스크톱 앱은 지원 범위가 더 좁아 Windows x64와 Apple 실리콘 macOS만 지원하며, Intel Mac 빌드와 Linux 타깃은 없습니다. Python SDK는 지원 범위가 더욱 좁습니다(Linux x64/arm64, macOS 14+ arm64 — 네이티브 Windows 없음). 아래에서 다룹니다.

당신은 전혀 GPU를 필요로 하지 않습니다. 하네스는 단지 조정만 할 뿐이며, 모델은 API를 통해 원격으로 실행됩니다.

방법 1 — 공식 데스크톱 앱(Windows 및 macOS)

2026년 9월 24일, Deep​Seek는 Deep​Seek Harness의 최초 패키징된 데스크톱 빌드를 공개했습니다. 이는 동일한 Web UI를 감싼 Electron 셸이며 dsh 런타임이 내부에 번들되어 있어, 먼저 설치할 것도 없고 수동으로 시작할 것도 없습니다. Node.js도, npx도, 터미널도, 127.0.0.1:3080에 열어 둔 브라우저 탭도 없습니다. 소스는 공개 저장소의 apps/desktop 아래에 @deepseek-ai/dsh-desktop 패키지로 위치해 있고, 아티팩트는 Deep​Seek 자체 프로덕션 다운로드 호스트인 download.deepseek.com/dsh-desk/에서 제공되며, 앱은 harness 버전을 정확히 따릅니다 — 현재 빌드는 0.1.7-rc.2입니다.

그 호스트가 2026년 9월 25일에 제공하고 있던 것:

• Windows — deepseek-harness-0.1.7-rc.2-win-x64.exe, 288MB 설치 프로그램이며, 델타 업데이트를 위한 .blockmap 파일이 함께 제공됩니다.

• macOS — deepseek-harness-0.1.7-rc.2-mac-arm64.dmg, 368 MB 디스크 이미지 또는 373 MB .zip으로 된 동일 빌드. Apple silicon 전용.

• 버전 — 0.1.7-rc.2, 릴리스 날짜는 2026년 9월 24일이며, npm의 next 태그에 있는 harness 버전과 일치합니다.

• 누락 — Intel-Mac 빌드 없음(mac-x64 업데이트 피드가 404를 반환함), 그리고 어떤 종류의 Linux 타깃도 없음.

각 타깃은 download.deepseek.com/dsh-desk/feeds/ 아래에 업데이트 피드도 게시하며, 여기서 releaseDate 필드는 빌드 날짜입니다. 이 파일을 확인하는 것이 앱이 새 빌드를 제안할 때까지 기다리지 않고 더 새로운 빌드가 있는지 가장 빠르게 확인하는 방법입니다.

왜 공식 클라이언트가 커뮤니티 래퍼와 다른가. 이는 퍼스트파티이며 자체 업데이트되고, 첫 실행 때 런타임을 내려받는 대신 설치 프로그램에 런타임을 포함하며, 웹 프로필의 3080에서 UI를 제공하지 않습니다. 셸은 내부 dsh-app:// 스킴을 통해 애플리케이션을 로드하고, 기본값인 자체 포트 19387에서 전용 호스트 프로세스와 통신합니다. 또한 데스크톱 애플리케이션처럼 동작합니다. 창을 닫아도 실행 중인 작업은 계속 실행되고(Windows는 트레이 아이콘을 유지합니다), 작업이 진행 중일 때 종료하면 먼저 확인을 요청하며, 0.1.7-rc.2 릴리스 노트에는 사용 가능한 크레딧을 소개하고 계정 크레딧으로 처리되는 작업과 API 키 작업을 구분하는 첫 실행 온보딩이 추가되어, 키를 붙여넣는 대신 Deep​Seek 계정으로 로그인할 수 있습니다.

두 가지 주의사항이 있습니다. 이 클라이언트는 공지되지 않고 조용히 배포되었기 때문입니다. 저장소의 README는 여전히 npx와 소스 빌드만 문서화하고 있으며, www.deepseek.com/harness의 프로젝트 페이지에는 다운로드 링크가 전혀 없습니다 — 바이너리와 그 업데이트 피드는 Deep​Seek 자체 호스트에서 라이브 상태이고, 이는 우리가 2026년 9월 25일에 확인한 내용이지만, 이를 설명하는 릴리스 노트는 어디에도 없습니다. 그리고 우리는 설치 프로그램을 실행하지 않았으므로, 이 가이드는 게시된 바이너리의 서명 또는 공증 상태에 대해 어떠한 입장도 취하지 않습니다; 저장소의 패키징 파이프라인에는 Windows 코드 서명 및 Apple 공증 단계가 포함되어 있으며, 외부에서 말할 수 있는 것은 그것이 전부입니다.

데스크톱 빌드가 하네스 버전을 따르는 데서 오는 한 가지 결과: 현재 기본 명령줄 설치보다 앞서 있습니다. npm의 latest 태그는 여전히 0.1.5-rc.3을 가리키는 반면 모든 데스크톱 아티팩트는 0.1.7-rc.2입니다. 데스크톱 앱이 지원하지 않는 플랫폼에서 최신 하네스를 원한다면 해당 태그를 명시적으로 설치하세요 — npx @deepseek-ai/dsh@next web — 기본값을 신뢰하기보다는.

방법 2 — npx 한 줄 명령(Linux를 포함한 모든 플랫폼)

공식 퀵 스타트는 명령어 하나이며, 정말로 명령어 하나입니다:

npx @deepseek-ai/dsh web

npx fetches the @deepseek-ai/dsh package (npm's latest tag currently resolves to 0.1.5-rc.3, not the newest harness), installs it into npm's cache, and starts the Web UI profile. Watch the output for the line that tells you it's listening — by default that is http://127.0.0.1:3080. Open it in your browser. Note the 127.0.0.1 loopback address: the UI binds to localhost only, which is the right default for a tool that can read and write files in your workspace — it also means you won't casually expose it on your network.

최초 실행에는 정확히 두 가지 설정 단계가 있습니다:

• 모델 키를 추가하세요. 설정 → 모델 → API 키를 입력하세요. 이 키는 $DSH_HOME/.credentials.yaml에 저장되며 이후 평문으로 표시되지 않습니다. 기본 설치에서 DSH_HOME의 기본값은 ~/.dsh입니다.

• 작업 공간을 선택하세요. dsh가 작업할 수 있는 프로젝트 디렉터리를 추가하세요. 두 단계가 모두 완료될 때까지 입력은 잠긴 상태로 유지됩니다.

그런 다음 첫 번째 작업을 보내세요. 좋은 스모크 테스트는 "이 저장소를 요약하고 주요 패키지를 식별하세요."입니다. 요약이 돌아오고 실행 추적에 도구 호출이 표시되면 설치가 제대로 작동하는 것입니다.

방법 3 — 소스에서 빌드

저장소에서 실행하는 것을 선호하시나요? 공식 경로는 다음과 같습니다:

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

cd deepseek-harness

pnpm install

pnpm run build

pnpm dsh 웹

이 작업에는 pnpm이 필요합니다 (기여자들은 pnpm 11.7.0을 고정합니다). 최신 main을 출시된 릴리스 후보 대신 실행하려는 경우, 하네스를 읽거나 수정할 계획이 있거나, 저장소의 apps/cli/config/agent-presets/ 디렉터리에서 사용자 정의 프리셋을 빌드하려는 경우에는 소스 빌드를 선택하세요. 다른 모든 사람들에게는 npx 방식이 절차가 더 간단한 동일한 소프트웨어입니다 — 소스 빌드가 npm 패키지에 없는 기능을 제공하지 않습니다.

An install cheat-sheet card titled 'DeepSeek Harness (dsh) — install commands' listing the two official methods with exact commands: Method 1 'npx quick start' as 'npx @deepseek-ai/dsh web' opening http://127.0.0.1:3080 with Node 22.19+; Method 2 'from source' as git clone, cd deepseek-harness, pnpm install, pnpm run build, pnpm dsh web; plus a 'one-shot task' row for headless mode 'dsh --profile headless "task"' and a plugin row 'dsh plugin --profile web add dshmarket'. Footer: 'Version 0.1.0-rc.6 — developer preview, breaking changes expected.'

세 가지 프로필: web, headless, tui

dsh는 세 가지 실행 프로필로 제공되며, 어떤 프로필을 사용할지는 작업이 이루어지는 위치에 따라 달라집니다:

• web (기본값) — 포트 3080에서의 전체 브라우저 UI입니다. 이것은 npx @deepseek-ai/dsh web이 시작하는 것이며, 대부분의 사람들이 가장 먼저 설치하는 프로필입니다.

• headless — 한 가지 작업만 수행하고 종료합니다. dsh --profile headless "run the test suite and report failures" 명령은 세션을 시작하고, 작업을 실행하며, 결과를 기록한 후 종료합니다. headless 런타임은 명시적으로 단일 작업 프로세스입니다. 실행 도중에 후속 작업을 주입할 수 없으며, 수정은 동일한 작업 공간에서의 새 실행으로 이루어집니다. 이것이 스크립트와 CI에 연결할 프로파일입니다.

• tui — 키보드 기반 세션을 위한 터미널 UI: dsh --profile tui.

세 가지 모두 동일한 설정을 공유합니다 (~/.dsh/profiles/<name>/) 그리고 동일한 플러그인 시스템을 사용하므로, 웹 UI에서 헤드리스로 작업을 옮기는 것은 재설치가 아니라 명령어 교체입니다.

플러그인 추가

플러그인 관리는 일급 CLI 명령어로서, 제자리에서 편집하는 방식이 아닙니다:

npx @deepseek-ai/dsh plugin --profile web add <source>

소스는 npm 패키지 이름, GitHub 저장소(github:user/repo), tarball 또는 로컬 폴더일 수 있습니다. 가장 유용한 첫 설치는 플러그인 탐색을 UI로 바꿔 주는 공식 플러그인 마켓입니다:

npx @deepseek-ai/dsh 플러그인 --프로필 웹 dshmarket 추가

그런 다음 웹 서비스를 다시 시작하고 설정 → 플러그인 마켓을 열어 카탈로그에서 찾아보고 원클릭으로 설치하세요. 사람들이 자주 헷갈리는 두 가지 규칙이 있습니다: 플러그인 번들은 프로필 시작 시 마운트되므로, 새로 추가된 플러그인은 dsh web의 재시작이 필요합니다. 그리고 그냥 npm install은 프로필에 플러그인을 등록하지 않습니다 — 반드시 dsh plugin을 사용해야 합니다. 생태계는 아직 젊지만 비어 있지 않습니다: 커뮤니티에서 유지 관리하는 awesome-dsh-plugin 목록에는 이미 UI, 스킬, 도구, 공급자, 알림과 같은 카테고리의 수백 개 플러그인이 등록되어 있습니다.

MCP, 네 가지 프리셋, 그리고 궤적 재생

기본 설치를 넘어서면 세 가지 기능이 중요합니다:

MCP.dsh는 내장된 @deepseek-ai/dsh-mcp-client 플러그인을 통해 Model Context Protocol을 사용합니다. 현재는 UI가 아닌 파일에서 설정합니다: 편집할 파일은 ~/.dsh/profiles/web/cordis.patch.yml (또는 프로젝트 로컬 패치)이며, 각 서버의 전송 방식을 선언합니다 — stdio는 로컬 명령용(예: npx @playwright/mcp@latest)이고, streamable-http는 원격 URL용입니다. 작동은 하지만, 미리보기에서 가장 덜 다듬어진 부분입니다. 가끔 불안정할 수 있고 서버를 켜고 끄는 GUI도 없습니다.

프리셋. dsh는 세션마다 네 가지 에이전트 프리셋 중 하나를 로드하며, 각각은 서로 다른 트레이드오프를 제공합니다:

• Standard — 전체 도구 세트: 파일 편집, 셸, 파일 및 웹 검색, 스킬, 계획 수립, 하위 에이전트, 워크플로우. 일상의 기본.

• PTC (Programmatic Tool Calling) — Standard에 모델이 TypeScript 프로그램을 작성하여 다중 라운드 도구 호출을 조율할 수 있게 해주는 Code Mode SDK가 추가된 형태입니다. 더 강력하며 부작용도 더 많습니다.

• 최소 — 오직 bash와 파일 편집기만, 그 외에는 아무것도 없음. 모델 벤치마킹과 최소 재현을 위해 제작되었으며; DeepSeek V4 Flash API 문서가 자체 에이전트 점수를 공개하면서 언급한 모드는 "Deep​Seek Harness minimal mode"에서 실행되었다.

• Creation — 런타임 플레이그라운드: Cordis 플러그인을 메모리에서 검사하고 로드하며, 실험하고, 작동하는 조합을 새 프리셋으로 확정하세요.

An infographic titled 'Choose your profile & preset' with a left column 'Profiles' listing three rows: 'web — browser UI on 3080', 'headless — one task, then exit', 'tui — terminal UI'; and a right column 'Presets' listing four rows: 'Standard — full toolset', 'PTC — code orchestration', 'Minimal — bash + editor', 'Creation — plugin playground'. OrcaRouter logo composited bottom-right.

궤적 재생.모든 실행은 추가 전용 세션 로그를 기록합니다. 시스템 프롬프트, 추론, 도구 호출 및 그 결과, 하위 에이전트 스케줄링이 포함됩니다. 궤적 뷰에서는 실행을 소스별로 검사하고, 재개하고, 분기하고, 검색하고, 재생할 수 있습니다. 이것이 에이전트 작업을 위한 디버거입니다. 작업이 실패하면 다시 실행하며 기대하는 대신, 실패한 궤적을 재생하고, 잘못된 단계에서 분기하여 원본을 버리지 않고 수정 사항을 테스트합니다.

Python SDK 옵션

브라우저 대신 Python에서 하네스를 구동하고 싶다면 공식 SDK가 있습니다: pip install deepseek-harness-sdk. 이 SDK는 dsh 런타임을 포함하며(pip wheel이 Node 런타임을 포함하므로 별도의 Node 설치가 필요 없습니다), 사용법은 컨텍스트 매니저입니다: Deep​SeekHarness 인스턴스를 만들고 run("task")를 호출합니다. 표준 환경 변수(예: DEEPSEEK_API_KEY 및 DEEPSEEK_BASE_URL)를 상속하므로 공급자 변경은 설정 변경입니다. 단점: Python 3.10+이며 Linux x64/arm64 및 macOS 14+ arm64만 지원합니다 — Windows용 네이티브 휠이 없어 Windows를 호스트로 사용한다면 정말 큰 단점입니다. Windows에서는 npm 경로를 사용하세요.

유료 모델에 dsh를 지정하기

dsh는 모델 API 키가 필요하며, 의도적으로 공급자 중립적입니다: 설정 → 모델은 Open​AI 호환 base URL을 가진 사용자 지정 공급자를 허용합니다 (settings.yaml에서 api: openai-completions, baseURL, 그리고 models 목록입니다). 기본값은 Deep​Seek 자체 API입니다. 사용자 지정 공급자는 라우팅 게이트웨이가 유용해지는 곳입니다.

OrcaRouter is an Open​AI-compatible endpoint that passes Deep​Seek's list price through with zero markup — https://api.orcarouter.ai/v1. The models dsh will actually call are all on it: DeepSeek V4 Flash 0731 (deepseek/deepseek-v4-flash-0731, $0.22 per million input tokens and $0.66 per million output), DeepSeek V4 Pro 0813 (deepseek/deepseek-v4-pro-0813, $0.66/$1.98) and DeepSeek V4.1 Flash (deepseek/deepseek-v4.1-flash, $0.15/$0.60), the model Deep​Seek's own rate card bills as deepseek-flash. Every rate doubles inside Deep​Seek's peak windows, 01:00-04:00 and 06:00-10:00 UTC on weekdays; the router passes that surcharge through rather than hiding it, and automatic failover moves a request to another provider if one wobbles. Figures checked against both rate cards on September 25, 2026. For dsh, the practical win is that you can keep the cheap tier for the bulk of everyday agent tasks and switch the same harness to V4 Pro for the hard passes — one key, one base URL, and the swap is a model name in the settings, not a reinstall.

The OrcaRouter model page for DeepSeek V4 Flash 0731 (deepseek/deepseek-v4-flash-0731), showing the FEATURED badge, 284B total / 13B active parameters, a 1M-token context window, 384K max output, INPUT $0.15 and OUTPUT $0.29 per 1M tokens, a p50 time-to-first-token of 844 ms, OpenAI-compatible code samples with base_url https://api.orcarouter.ai, and a Terminal-Bench 2.1 score of 82.7.

경계를 분명히 하자면, OrcaRouter가 호스팅하는 것은 모델 중 dsh가 호출하는 것입니다; dsh 자체를 호스팅하지는 않으며, 데스크톱 클라이언트도 제공하지 않습니다 — 그것은 Deep​Seek 자체 다운로드 호스트에서 제공됩니다. dsh는 로컬 에이전트 런타임이며, 자신의 컴퓨터에서 실행합니다.

이 가이드가 당신에게 맞지 않는 경우 — 프리뷰의 솔직한 문제점

입력할 내용만 알려주는 설치 튜토리얼은 일을 절반만 하는 셈입니다. 오늘 미리보기에서 무엇이 잘못되었는지 여기에 정리했습니다. 새벽 2시에 그걸 발견하지 않도록 말이죠:

• 호환성을 깨는 변경은 경고가 아니라 약속입니다. 당신은 릴리스 후보를 사용 중입니다 — npm 기본값을 선택했다면 0.1.5-rc.3, 데스크톱 앱이나 next 태그를 설치했다면 0.1.7-rc.2입니다. 구성 키, 플러그인 API, 프리셋 형식은 모두 예고 없이 바뀔 수 있습니다. ~/.dsh를 버려도 되는 상태로 취급하세요 — 잘못된 업데이트의 대가는 재설치이며, 이 단계에서 그것이 허용되는 것은 여기의 모든 설치 경로가 다운로드나 단일 명령이기 때문입니다.

• Deep​Seek 모델을 에이전트로 사용하는 데 dsh가 필요하지 않습니다. 만약 오늘 에이전트 안에서 DeepSeek V4 Flash 또는 DeepSeek V4 Pro를 사용하는 것이 유일한 목표라면, Deep​Seek의 Anthro​pic 호환 엔드포인트는 이미 Claude Code 및 기타 에이전트 도구에서 새 소프트웨어 없이 작동합니다. dsh는 자사 옵션일 뿐 필수 조건이 아닙니다. 자체 하네스를 특별히 원할 때까지 이 설치를 건너뛰세요.

• MCP는 파일 기반으로 구성되어 있으며 때때로 불안정합니다. GUI도 없고, 서버별 시작/중지 토글도 없으며, 실사용 보고서에는 간헐적 장애가 언급됩니다. 워크플로가 MCP 서버에 의존한다면 YAML 디버깅에 시간을 할애하세요.

• 플러그인 신뢰는 보안 결정입니다. 서드파티 플러그인은 하네스의 핵심 프로세스 내에서 실행되며, 설치 시 서명이나 소스 검증이 없습니다. 직접 읽어본 플러그인이나 신뢰하는 출처의 플러그인만 설치하고, 실제 작업에 적용하기 전에 일회용 작업 공간에서 테스트하세요. danger-full-access 샌드박스 프로필은 보이는 모든 파일을 수정할 수 있으므로, 임시 체크아웃에만 사용하세요.

• 미리보기에는 알려진 버그가 있습니다. 중단된 bash 루프는 문서화된 실패 모드이며(중단 후 재시도), 장기 실행 세션의 동작은 아직 안정화 중입니다.

• 비공식 데스크톱 빌드는 더 이상 역할이 없습니다. 2026년 9월 24일까지 클릭하여 설치할 수 있는 유일한 dsh 데스크톱 앱은 서명되지 않은 커뮤니티 래퍼였고, 선택지는 그것들과 명령줄뿐이었습니다. 공식 클라이언트는 이러한 트레이드오프를 제거합니다: 퍼스트파티, 런타임 번들, 자동 업데이트. 두 종류의 셸 사이에는 실제 마이그레이션 경로가 없습니다 — 둘은 같은 하네스를 감싸고 있으니까요 — 따라서 하나를 제거하고 다른 하나를 설치하고, 같은 작업 공간 디렉터리를 유지하세요.

• 프로덕션 안정성이 필요하다면, RC가 아닌 릴리스를 기다리세요. 이 하네스는 강력하지만 아직 검증되지 않았습니다. 프로덕션 에이전트 스택을 위해서는, dsh가 안정적인 태그에 도달할 때까지 성숙하고 실전 검증된 하네스 — 또는 Anthro​pic 호환 엔드포인트 경로 — 가 타당한 선택입니다.

결론은

DeepSeek Harness 설치는 이제 플랫폼에 따라 완전히 다른 두 가지 작업입니다. Windows나 Apple 실리콘 Mac에서는 DeepSeek 자체 호스트에서 0.1.7-rc.2를 다운로드하면 끝입니다. Node.js도, 터미널도 필요 없고, 어느 채널보다도 최신 하네스 버전을 쓸 수 있습니다. 그 외의 환경에서는 여전히 Node 22.19+에서 명령어 하나면 됩니다: npx @deepseek-ai/dsh@next web, 그다음 모델 키와 워크스페이스를 추가하고 테스트 작업을 보내면 됩니다. 스크립트에는 헤드리스를 사용하고, 소스 빌드는 main을 수정하거나 추적하려는 경우에만 사용하며, MCP는 아직 개발 중인 것으로 취급하세요. 솔직한 단서 조항은 변함없습니다. 이 채널은 모두 0.x 릴리스 후보이며 안정판으로 가는 길에 문제를 일으킬 것입니다. DeepSeek이 에이전트 계층을 어디로 이끌어 가는지 보고 싶다면 충분히 괜찮은 거래입니다. 여기서 실행되는 모델 — DeepSeek V4 Flash 0731, DeepSeek V4 Pro 0813, DeepSeek V4.1 Flash — 은 오늘날 OrcaRouter를 통해 정가로 이용할 수 있으며, 설치 반대편에서 하네스를 구동할 준비가 되어 있습니다.

이 글에서 비교한 모델2

이 글에서 자동 인식 · 벤치마크: Artificial Analysis · 매일 업데이트