DeepSeek Harness란? 설치 방법과 다른 도구와의 비교

DeepSeek Harness 한눈에 보기

DeepSeek Harness 설치하고 사용하는 법

1. 데스크톱과 웹 중 고르기

   deepseek.com/en/harness에서 macOS(Apple 실리콘)나 Windows(64비트)용 데스크톱 앱을 내려받으세요. macOS에서는 dsh 명령어도 함께 설치할 수 있어요. Node.js가 있는 컴퓨터라면 npx로 Web UI를 실행하거나 소스에서 빌드할 수 있어요.

   # Node.js로 Web UI 실행
   npx @deepseek-ai/dsh web
   # 그다음 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

2. 로그인하거나 API 키 추가하기

   처음 실행할 때 브라우저에서 DeepSeek 계정으로 로그인하거나, Settings → Models(설정 → 모델)에 platform.deepseek.com에서 받은 API 키를 붙여 넣으세요. 키는 ~/.dsh/.credentials.yaml($DSH_HOME)에 저장돼요.

3. 프로젝트 지침 주기

   DeepSeek Harness는 프로젝트의 AGENTS.md 또는 CLAUDE.md(그리고 .local.md 변형)와 전역 ~/.dsh/AGENTS.md를 읽어요. Claude Code나 Codex용으로 써 둔 지침을 그대로 쓸 수 있어요. CLAUDE.md 가이드와 Codex AGENTS.md 가이드를 참고하세요.

4. 어디까지 맡길지 정하기

   샌드박스 모드(read-only, workspace-write, danger-full-access)와 승인 정책(ask 또는 never)을 고르세요. DeepSeek의 안전 안내에 따르면 이 하네스는 실험 단계이고 보안 감사를 받지 않았으며, 샌드박스가 격리를 보장하지도 않아요. 중요한 코드에서는 read-only로 시작하세요.

5. 헤드리스로 작업 실행하고 플러그인 추가하기

   스크립트에서 일회성 작업을 돌릴 때는 dsh headless, 세션을 이어 갈 때는 --resume이나 --session-id, 예약 작업, 서브에이전트, 에이전트 팀 같은 플러그인을 추가할 때는 dsh plugin을 쓰세요.

   # UI 없이 작업 하나를 권한 모드와 함께 실행
   dsh headless "Add tests for src/auth" --permission-mode workspace-write
   
   # 이벤트를 JSON으로 스트리밍(스크립트용 등)
   dsh headless "Summarize open TODOs" --json
   
   # 프로필에 플러그인 추가
   dsh plugin --profile default add <package>

출처: DeepSeek Harness 저장소와 문서

DeepSeek Harness 가격: 실행하는 데 드는 비용

하네스 자체는 무료 오픈소스예요. 사용료는 DeepSeek API가 아래 요금으로 청구하며, 단위는 100만 토큰당 미국 달러예요(api-docs.deepseek.com, 2026년 11월 6일). 비피크 시간대 요금은 피크 요금의 절반이고, 피크 시간대는 평일 UTC 01:00–04:00과 06:00–10:00이에요(중국 공휴일 제외). DeepSeek은 무료 할당량을 안내하지 않으므로, "무료로 쓴다"는 건 사실상 무료 소프트웨어에 갖고 있는 API 크레딧을 더한 것을 뜻해요.

주요 기능

• 모든 것이 플러그인: 도구, 모델, 인터페이스, 동작이 모두 플러그인이에요. 프로필별로 설치할 수 있고, 채팅으로 부탁해 새로 만들 수도 있어요("Creator mode"). 커뮤니티 플러그인은 GitHub 토픽 dsh-plugin을 써요.
• DeepSeek이 소개하는 공식·실험 플러그인으로는 에이전트 팀, 자동 승인 검토, 예약 작업, 음성 입력, 터미널, 에이전트 루프, 서브에이전트가 있어요.
• Skills(SKILL.md 폴더), MCP 서버, hooks, 그리고 기존 Claude Code hooks를 실행하는 실험적 브리지도 있어요.
• 서브에이전트는 같은 프로세스 안에서 돌릴 수도 있고, ACP, Codex, Claude Code 또는 다른 Harness를 백엔드로 쓸 수도 있어요.
• 이어서 쓸 수 있는 세션, 컨텍스트 압축(compaction), JSON 이벤트를 내보내는 헤드리스 모드, 그 위에 무언가를 만들 수 있는 SDK.
• Super-agent: 별도의 MIT 번들인 dsh-superagent를 쓰면 하네스가 GitHub 저장소에서 능동적으로 일해요. DeepSeek은 이를 연구용 프로토타입이라고 불러요. DeepSeek Super-Agent 해설을 참고하세요.
• 함께 자주 언급되는 논문 "A Programming Paradigm for Spatiotemporal Composability"(arXiv, 2026년 8월)는 하네스 자체가 아니라 그 바탕이 되는 Cordis 프레임워크를 다뤄요.

DeepSeek Harness vs Claude Code vs Codex vs OpenCode

DeepSeek은 비교 자료를 내지 않았어요. 아래는 2026년 11월 6일 기준 각 도구의 공식 문서를 저희가 정리한 내용이에요. DeepSeek은 Claude Code, Codex, OpenCode 안에서 자사 모델을 쓰는 방법도 안내하고 있어서 섞어 쓸 수도 있어요.

자주 검색하는 질문

• Linux: 아직 Linux용 데스크톱 앱은 없어요. Linux에서는 npx @deepseek-ai/dsh web으로 Web UI를 실행하거나 소스에서 빌드하세요.
• VS Code: DeepSeek은 VS Code 확장을 제공하지 않아요. 에디터 옆에 데스크톱 앱이나 Web UI를 띄워 두거나, DeepSeek이 사용법을 안내하는 Claude Code나 Codex 같은 에디터용 에이전트에서 DeepSeek 모델을 쓰세요.
• Ollama와 로컬 모델: 문서화되어 있지 않아요. 하네스는 셀프 호스팅 서버용으로 OpenAI·Anthropic 호환 커스텀 엔드포인트를 받으며, 이것이 자체 모델을 쓰는 공식 방법이에요.
• TUI: 기본으로 제공되는 터미널 UI는 없어요. 커스텀 프로필이나 실험적 터미널 플러그인이 문서에 나온 선택지예요.
• 논문: 위의 Cordis 논문을 참고하세요. DeepSeek은 하네스 자체를 인용할 때 "DeepSeek Harness: Everything is a Plugin"으로 표기해 달라고 요청해요.

DeepSeek Harness에게 작업이 아니라 직무를 맡기세요

Crewmark는 Claude Code, Codex, OpenCode와 함께 DeepSeek Harness도 지원해요. 세션을 직무, 목표, 근무 시간을 가진 AI 직원으로 바꾸고, 하트비트로 깨워 공유 보드에서 다음 이슈를 가져가게 해요.

1. 에이전트로 DeepSeek Harness 고르기

   프로젝트에서 설정 명령어를 실행하세요. 직원은 내 컴퓨터의 DeepSeek Harness 세션에서 돌아가고, 비용은 내 DeepSeek API 계정으로 청구돼요.

2. 직무와 목표 주기

   소프트웨어 엔지니어, SEO 전문가, 그로스 마케터처럼 각자 움직여야 할 숫자가 있어요. AI 직원이란을 읽어 보세요.

3. 하트비트로 일을 시작하게 하기

   근무 시간 중에 15, 30, 60분마다 깨어나 다음 이슈를 가져가고, 결정이 필요하면 메시지를 보내요. 여러 방식의 비교는 슈퍼에이전트란에서 확인하세요.

DeepSeek Harness 자주 묻는 질문