DeepSeek Harness의 개요
DeepSeek Harness(dsh)는 DeepSeek가 직접 만든 오픈소스 에이전트 하네스로, 2026년 8월 개발자 프리뷰로 공개되었습니다. 기본 상태에서는 작업 공간의 파일을 읽고 수정하고, 명령을 실행하고, 서브에이전트에 위임하고, 계획을 유지하며, 반복 작업을 예약하는 코딩 및 일반 업무용 에이전트입니다. 로컬 Web UI(npx @deepseek-ai/dsh web), macOS와 Windows용 공식 데스크톱 앱, 헤드리스 모드, ACP 서버, Python SDK로 조작합니다. 내부적으로는 모든 것이 Cordis 프레임워크의 플러그인입니다. 모델 어댑터, 도구, 샌드박스, 세션 저장소, UI, 에이전트 루프 자체까지 교체할 수 있습니다.
MIT 라이선스의 TypeScript이며, 2026년 8월 13일에 만들어진 저장소치고 GitHub 스타 약 267,000개와 포크 32,000개를 기록했고, npm 패키지 @deepseek-ai/dsh는 2026년 10월 29일까지 한 주 동안 약 680,000회 내려받아졌습니다. 안정 릴리스는 없습니다. 최신은 2026년 10월 30일의 릴리스 후보 v0.2.1-rc.5이고, README는 호환성을 깨는 변경을 예고하며, 안전 공지는 프로젝트가 보안 감사를 받지 않았다고 밝힙니다. GitHub 이슈는 꺼져 있고 피드백은 Discussions로 가며, 스레드가 약 11,500개입니다.
DeepSeek Harness, 쓸 만한 가치가 있습니까?
DeepSeek Harness는 DeepSeek 모델로 에이전트를 돌리는 가장 저렴한 본격적 방법이지만, 소중한 것이 담긴 기기에 설치하기에는 위험합니다. 에이전트 자체는 Claude Code, Codex, OpenCode와 같은 영역을 다룹니다. 내세우는 것은 구조입니다. 모든 부분이 플러그인이고, Creator 모드에서는 에이전트가 새 플러그인을 작성해 설치해 줍니다. 몇 주 만에 커뮤니티가 형성되었고, awesome-dsh-plugin 목록에는 이제 플러그인 8,076개가 있습니다.
그 개방성이 곧 보안 문제입니다. 플러그인은 샌드박스에 격리되지 않습니다. Cordis 문서는 플러그인을 같은 프로세스에서 도는 신뢰된 코드로 설명하며, 번들을 설치하면 Host 프로세스에서 그 코드가 실행됩니다. 그래서 에이전트가 이를 하려면 Full access나 사용자의 승인이 필요합니다. 플러그인을 중앙에서 검증하는 곳은 없습니다. DSH는 플러그인 색인을 제공하지 않고, Discover 탭은 사용자가 추가한 색인 파일만 읽으며, 문서는 색인의 제목, 작성자, 출처가 검증되지 않은 주장이라고 경고합니다. awesome-dsh-plugin 메인테이너들은 플러그인이 설치되고 설명대로 동작하는지 확인하지만, 등재가 보안 검토가 아니며 도구 승인이 플러그인 코드를 격리하지 않는다고 분명히 밝힙니다. 명령 샌드박스(bwrap, Seatbelt 또는 Landlock, Windows에서는 부분적)와 승인 요청을 동반한 기본 workspace-write 모드는 모델이 실행하는 것을 통제할 뿐, 플러그인이 하는 일은 통제하지 않습니다.
DeepSeek에만 묶여 있지는 않습니다. Settings → Models는 DeepSeek API 키나 계정 로그인을 받고, Anthropic, OpenAI, Kimi, GLM 같은 공급자의 카탈로그 항목이 있으며, OpenAI Chat Completions, OpenAI Responses 또는 Anthropic Messages를 지원하는 어떤 게이트웨이든 받아들입니다. 그래도 경제성은 DeepSeek 쪽이 유리합니다. 혼잡 시간대에 deepseek-flash는 캐시되지 않은 입력 토큰 100만 개당 $0.30, 캐시된 입력 $0.006, 출력 $1.20이고, deepseek-v4-pro는 $1.32, $0.044, $3.96입니다. 비혼잡 시간대 요율은 절반이며, 혼잡 시간대(평일 UTC 01:00~04:00, 06:00~10:00)는 중국의 근무 시간에 걸쳐 있어 유럽의 오전은 정가를 내고 미국의 근무 시간은 모두 비혼잡 시간대에 들어갑니다. 우리 계산으로는 입력 토큰 1,000만 개(그중 90%가 캐시됨)를 읽고 500,000개를 쓰는 세션이 혼잡 시간대 V4 Pro에서 약 $3.70, Flash에서 약 $0.95입니다. 지금까지 무료였던 웹 검색과 가져오기는 2026년 11월 1일부터 요청 1,000회당 $0.75로 과금됩니다.
데이터 기본값은 구매자가 주의 깊게 볼 부분입니다. 공식 DeepSeek API에서는 세션 로그 플러그인이 기본으로 켜져 있어, 요청당 최대 8 MiB의 전체 세션 로그를 이후 모델 요청에 첨부합니다. CLI 참조에 따르면 이 업로드에는 메시지 텍스트, 도구 인자와 결과, 작업 공간 경로가 포함될 수 있습니다. Settings → General에서 끕니다. 별도로 /feedback을 기록하면 DSH_TELEMETRY_MODE=DISABLED를 설정하지 않는 한 세션이 DeepSeek의 수집기로 업로드됩니다. DeepSeek의 개인정보 처리방침은 중화인민공화국에서 개인정보를 수집, 처리, 저장한다고 밝히며 그 목적 가운데 자사 모델 학습을 꼽고, 우리가 읽은 바로는 플랫폼 약관에 데이터 무보존이나 지역 호스팅 선택지가 없습니다. DSH를 다른 공급자로 연결하면 이 우려는 사라지지만 가격 이점도 함께 사라집니다.
DeepSeek의 자체 API 문서는 Claude Code, Codex, OpenCode를 자사 모델의 지원 프런트엔드로 나열하므로, 저렴한 DeepSeek 토큰을 쓰는 데 DSH가 필요한 것은 아닙니다. OpenCode는 안정 릴리스 라인에서 같은 공급자 선택 자유를 제공하고, Claude Code와 Codex는 제작사 자체 모델을 중심으로 만들어졌습니다. DSH가 더하는 것은 분해하고 다시 조립할 수 있는 하네스이며, 그 대가는 자체 안전 공지가 안전하다고 여겨서는 안 된다고 말하는 프리뷰 소프트웨어입니다.
제 역할을 하는 곳
이미 DeepSeek API 토큰 비용을 내는 1인 개발자
몇 달러로 하루 종일 코딩 에이전트 돌리기
npx @deepseek-ai/dsh web을 실행하고 API 키를 추가한 뒤 작업 공간을 고릅니다. 혼잡 시간대 deepseek-flash는 캐시되지 않은 입력 토큰 100만 개당 $0.30으로 V4 Pro의 $1.32보다 싸며, 긴 배치 작업을 비혼잡 시간대로 옮기면 어느 쪽이든 요금이 절반이 됩니다.
40명 제품 팀을 위한 사내 에이전트를 만드는 플랫폼 엔지니어
코드베이스를 포크하지 않고 자체 도구, 승인 규칙, 세션 저장소를 갖춘 회사 에이전트 내놓기
Cordis 플러그인을 작성해 사설 npm 레지스트리나, 참조 생성기가 평범한 목록으로 만들어 주는 https 기반 팀 색인 파일에 게시합니다. 프리뷰가 호환성을 깨는 변경을 예고하므로 릴리스 후보를 고정하고, 업그레이드할 때마다 다시 테스트할 시간을 예산에 넣어야 합니다.
직원이 DSH를 설치해도 되는지 질문받은 유럽 핀테크의 보안 책임자
허용할 수 있는 구성이 있다면 무엇인지 결정하기
안전 공지가 권하는 대로 일회용 VM이나 컨테이너를 요구하고, 승인된 비DeepSeek 게이트웨이로 모델을 연결하거나 세션 로그 업로드를 끄고, DSH_TELEMETRY_MODE=DISABLED를 설정하며, 플러그인은 내부 색인에서만 허용합니다. 소프트웨어는 무료이고, 실제 비용은 검토 작업과 데이터 상주 문제입니다.
에이전트 벤치마크를 돌리는 평가 연구자
Python에서 격리된 에이전트 작업을 많이 실행하기
pip install deepseek-harness-sdk는 런타임을 함께 담고 있어 시스템 Node.js가 필요 없습니다. sdk-minimal 프로필은 danger-full-access 모드로 실행되므로, 작업마다 별도의 작업 공간, 세션 ID, 컨테이너가 필요합니다.
도입 전 확인할 점
- 설정
- npx @deepseek-ai/dsh web은 Node.js가 필요하며 127.0.0.1:3080에서 Web UI를 엽니다. Settings → Models에서 DeepSeek 키를 추가하고 작업 공간을 고릅니다. 공식 데스크톱 빌드는 Apple silicon Mac과 64비트 Windows를 지원합니다. Python SDK는 deepseek-harness-sdk이며, PyPI의 deepseek-harness라는 이름은 관계없는 프로젝트의 것입니다. Web UI를 0.0.0.0에 바인딩하는 것은 지원되지 않습니다.
- 연동
- API 키나 계정 로그인을 통한 DeepSeek, anthropic, openai, moonshotai, zai 등 카탈로그 공급자, OpenAI Chat Completions, OpenAI Responses 또는 Anthropic Messages 기반 사용자 정의 게이트웨이, MCP, LSP, ACP, 헤드리스 모드, Python SDK를 지원합니다. 플러그인은 dsh plugin add로 npm, Git, tarball에서 설치합니다. 커뮤니티 색인으로 awesome-dsh-plugin과 dsh-market이 있습니다. anywhere-labs의 DSH Desktop(스타 약 34,300개)은 DeepSeek와 무관하다고 밝힌 비공식 클라이언트이고, coeasy/dsh-go는 서명된 게시자 신뢰 등급을 제안하는 스타 2개짜리 마켓플레이스입니다.
- 데이터와 개인정보
- 공식 DeepSeek API에서는 요청당 최대 8 MiB의 전체 세션 로그가 기본으로 모델 요청에 첨부됩니다(Settings → General에서 전환). /feedback은 DSH_TELEMETRY_MODE=DISABLED가 아니면 세션을 DeepSeek의 수집기로 업로드합니다. DeepSeek의 개인정보 처리방침은 개인정보 저장 위치를 중화인민공화국으로 둡니다. 세션은 $DSH_HOME 아래에 JSONL로 로컬 보관되고, 키는 $DSH_HOME/.credentials.yaml에 있습니다.
- 대규모 사용 시 비용
- 하네스는 무료이며 유료나 엔터프라이즈 에디션이 없습니다. DeepSeek에서 비용은 토큰입니다. 입력 토큰 1,000만 개(90% 캐시)를 읽고 500,000개를 쓰는 세션은 혼잡 시간대 V4 Pro에서 약 $3.70, Flash에서 $0.95이며, 비혼잡 시간대는 그 절반입니다. 검색과 가져오기는 2026년 11월 1일부터 요청 1,000회당 $0.75이고, 동시 요청 한도는 Flash 2,500, V4 Pro 500입니다.
- 제한
- 1.0 이전 버전으로, 며칠마다 릴리스 후보가 나오고 호환성을 깨는 변경이 예고되어 있습니다. 보안 감사가 없고 Windows 샌드박스는 부분적입니다. 이슈가 꺼져 있어 버그 보고는 약 11,500개의 Discussions 스레드 사이에 있습니다. 공개된 보안 권고는 없지만, 생긴 지 11주 된 프로젝트에게 이는 큰 의미가 없습니다.
좋은 점
- 에이전트 루프까지 모든 부분을 플러그인으로 교체 가능
- DeepSeek뿐 아니라 Anthropic, OpenAI, 호환 게이트웨이와도 작동
- DeepSeek 토큰은 캐시되지 않은 입력 100만 개당 $0.30부터, 비혼잡 시간대는 그 절반
- 하나의 코드베이스에서 Web UI, 데스크톱 앱, 헤드리스 모드, ACP, Python SDK 제공
아쉬운 점
- 보안 감사 없는 개발자 프리뷰이며 호환성을 깨는 변경이 예고됨
- 플러그인이 중앙 검증 없이 호스트 프로세스에서 격리 없이 실행
- 공식 API에서는 세션 로그가 기본으로 DeepSeek로 전송
- DeepSeek 개인정보 처리방침상 데이터가 중국에 저장됨
추천 대상
플러그인으로 다시 만들 수 있는 에이전트를 원하며, 이를 민감한 것이 없는 기기나 VM에서 돌릴 DeepSeek API 사용 개발자.
DeepSeek Harness 대안
DeepSeek Harness: 자주 묻는 질문
- DeepSeek Harness, 쓸 만한 가치가 있습니까?
- 저렴한 DeepSeek 토큰과 부품 단위로 다시 조립할 수 있는 하네스지만, 감사를 받지 않은 프리뷰 코드에 싸여 있고 기본적으로 세션 로그를 DeepSeek로 보냅니다. 평점은 5점 만점에 3.7점입니다.
- DeepSeek Harness의 가격은 얼마입니까?
- 무료 오픈소스(MIT)이며 모델 사용료를 냅니다. DeepSeek API 혼잡 시간대 기준 deepseek-flash는 캐시되지 않은 입력 토큰 100만 개당 $0.30, 출력 토큰 100만 개당 $1.20이고, deepseek-v4-pro는 $1.32와 $3.96입니다. 비혼잡 시간대 요율은 절반입니다.
- DeepSeek Harness의 단점은 무엇입니까?
- 보안 감사 없는 개발자 프리뷰이며 호환성을 깨는 변경이 예고됨; 플러그인이 중앙 검증 없이 호스트 프로세스에서 격리 없이 실행; 공식 API에서는 세션 로그가 기본으로 DeepSeek로 전송; DeepSeek 개인정보 처리방침상 데이터가 중국에 저장됨.
- DeepSeek Harness에 적합한 사람은 누구입니까?
- 플러그인으로 다시 만들 수 있는 에이전트를 원하며, 이를 민감한 것이 없는 기기나 VM에서 돌릴 DeepSeek API 사용 개발자.
- 팀이나 프로덕션 환경에서 DeepSeek Harness의 비용은 얼마입니까?
- 하네스는 무료이며 유료나 엔터프라이즈 에디션이 없습니다. DeepSeek에서 비용은 토큰입니다. 입력 토큰 1,000만 개(90% 캐시)를 읽고 500,000개를 쓰는 세션은 혼잡 시간대 V4 Pro에서 약 $3.70, Flash에서 $0.95이며, 비혼잡 시간대는 그 절반입니다. 검색과 가져오기는 2026년 11월 1일부터 요청 1,000회당 $0.75이고, 동시 요청 한도는 Flash 2,500, V4 Pro 500입니다.
- DeepSeek Harness에 회사 데이터를 맡겨도 안전합니까?
- 공식 DeepSeek API에서는 요청당 최대 8 MiB의 전체 세션 로그가 기본으로 모델 요청에 첨부됩니다(Settings → General에서 전환). /feedback은 DSH_TELEMETRY_MODE=DISABLED가 아니면 세션을 DeepSeek의 수집기로 업로드합니다. DeepSeek의 개인정보 처리방침은 개인정보 저장 위치를 중화인민공화국으로 둡니다. 세션은 $DSH_HOME 아래에 JSONL로 로컬 보관되고, 키는 $DSH_HOME/.credentials.yaml에 있습니다.
- DeepSeek Harness의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 OpenCode, OpenAI Codex CLI, Cline 및 Aider입니다.
답변 확인일: 2026년 10월 31일.