DeepSeek Harness(dsh)는 2026년 8월 13일에 출시되었으며, 그 위상은 주목하지 않을 수 없었습니다. VentureBeat의 출시 기사 헤드라인은 이를 DeepSeek V4-Pro와 함께 API로 출시된 "Claude Code의 오픈소스 경쟁자"라고 불렀습니다. 일주일 후, 리포지토리는 약 16.9만 개의 별(8월 20일 기준)을 기록했습니다. 이는 매우 강력한 등장을 알리는 것이었습니다.
하지만 별점만으로는 개발자들이 실제로 궁금해하는 질문에 답할 수 없습니다. 내 코딩 에이전트를 DeepSeek Harness에서 실행해야 할까요, 아니면 Claude Code에서 실행해야 할까요? 두 도구는 서로 다른 방향을 제시합니다. 하나는 플러그인 커널과 로컬 웹 UI를 기반으로 구축된 MIT 라이선스 개발자 프리뷰입니다. 다른 하나는 스킬, 훅, 네이티브 MCP, 서브 에이전트, 그리고 실행 가능한 다섯 가지 표면을 갖춘 심도 깊은 생태계를 가진 독점적인 성숙 제품입니다.
이 비교는 라이선싱, 인터페이스, 모델 자유, 가격 책정, 성숙도, 확장성, 권한 및 MCP와 같은 중요한 측면을 다룹니다. 허구의 벤치마크나 느낌에 기반한 성능 주장은 없습니다. 각 도구가 현재 실제로 무엇을 하는지에 대한 검증 가능한 내용만 있습니다. dsh가 처음이라면, DeepSeek Harness가 무엇이며 어떻게 작동하는지부터 시작한 다음 다시 오세요.
간단한 비교
| 항목 | DeepSeek Harness (dsh) | Claude Code |
|---|---|---|
| 라이선스 | MIT, GitHub에 소스 공개 | 독점; "모든 권리 보유", Anthropic 상업 약관 |
| 출시 시점/성숙도 | 2026년 8월 13일 출시; 개발자 프리뷰 | 일반 출시, 성숙한 제품 |
| 안정성 | README에 호환성을 깨뜨리는 변경 사항에 대한 경고 있음 | 안정적인 릴리스 채널, 버전 관리되는 설정 |
| 인터페이스 | 127.0.0.1:3080에서 로컬 웹 UI, 헤드리스 포함 프로필 기반 CLI 모드 지원 |
터미널 CLI, VS Code, JetBrains, 데스크톱 앱, 웹 및 모바일 |
| 모델 | DeepSeek, 그리고 카탈로그 제공업체(Anthropic, OpenAI, Bedrock, Vertex, Azure) 및 모든 OpenAI 호환 엔드포인트 | Claude 모델만 (직접 또는 Bedrock, Vertex, Foundry를 통해) |
| 가격 | 하네스는 무료; 연결하는 API에 따라 토큰당 요금 지불 | Claude Pro/Max 구독, 또는 콘솔을 통한 사용량 기반 API 청구 |
| 확장성 | 모든 것이 플러그인(Cordis 커널); 커뮤니티 dsh-plugin 토픽 |
플러그인, 스킬, 훅, 서브 에이전트, 에이전트 SDK |
| 권한 | 활성 권한 정책에 따라 웹 UI 승인 프롬프트 표시 | 여섯 가지 문서화된 권한 모드, 세분화된 허용/거부 규칙 |
| MCP | 커뮤니티 플러그인 (dsh-mcp-manager), 코어 아님 | 네이티브, 일등 시민 |
이제 자세한 내용을 살펴보겠습니다. 표에서는 흥미로운 부분 대부분이 가려져 있기 때문입니다.
오픈소스 vs 독점: MIT 라이선스가 실제로 제공하는 것
DeepSeek Harness는 MIT 라이선스를 따르며, 서드파티 종속성은 THIRD_PARTY_NOTICES.md에 기록됩니다. 이는 라이선싱 측면에서 가장 허용적인 방식 중 하나입니다. 에이전트 루프를 읽고, 포크하고, 패치하고, 상업 제품에 포함하고, 네트워크를 통해 무엇을 보내는지 정확히 감사할 수 있습니다. 엄격한 규정 준수 요구사항이 있는 팀이나, 의존하던 기능이 공급업체에 의해 중단되어 어려움을 겪었던 사람들에게는 이러한 투명성이 핵심 기능입니다.
Claude Code는 정반대입니다. Anthropic의 공개 리포지토리 내 LICENSE 파일에는 "© Anthropic PBC. 모든 권리 보유. 사용은 Anthropic의 상업 서비스 약관에 따릅니다."라고 명시되어 있습니다. GitHub 리포지토리는 이슈 및 문서용이며, 소스 코드를 제공하지 않습니다. 검사하거나 포크할 수 있는 코드가 아니라, 완성된 바이너리와 계약을 받는 것입니다.
이것이 중요할까요? 누구냐에 따라 다릅니다. 개인 개발자는 주로 도구가 작동하는지 여부에 관심을 가집니다. 내부 도구에 에이전트를 통합하는 플랫폼 팀은 매우 중요하게 생각합니다. MIT 라이선스는 dsh가 인프라가 될 수 있음을 의미하는 반면, Claude Code는 구독해야 하는 제품으로 남습니다. 솔직히 말하자면, 오픈소스는 프로젝트가 지속적으로 유지될 때만 가치가 있으며, dsh는 출시된 지 일주일밖에 되지 않았습니다. MIT 라이선스는 권리에 대한 약속이지, 지속성에 대한 약속은 아닙니다.
인터페이스: 로컬 웹 UI vs 어디서든 사용 가능
dsh는 "CLI" 에이전트로는 이례적인 경로를 택합니다. 빠른 시작은 npx @deepseek-ai/dsh web 명령어를 통해 http://127.0.0.1:3080에서 로컬 웹 UI를 시작하고 브라우저를 엽니다(--no-open을 전달하여 건너뛸 수 있습니다). 작업 공간을 선택하고, dsh를 실행한 프로젝트 디렉터리를 가리킨 다음, 브라우저에서 작업합니다. 이는 로컬 우선 방식입니다. UI는 호스팅된 서비스가 아니라 사용자 기기에서 제공됩니다.
웹 UI 외에도, dsh의 CLI README는 프로필 기반 진입 모드를 문서화합니다. dsh --profile <name>은 $DSH_HOME/profiles/<name> 아래에서 지정된 프로필을 시작하고, 헤드리스 프로필은 한 번의 영구 세션을 실행하고 최종 답변을 출력한 후 종료됩니다. dsh web 자체는 웹 프로필의 약어이며, dsh plugin은 pnpm으로 포워딩하여 프로필의 플러그인을 관리합니다. 따라서 스크립팅과 자동화가 가능하지만, 웹 UI가 명확한 주 진입점입니다.
Claude Code는 터미널 우선으로 시작하여 거기서부터 확장되었습니다. 공식 문서에 따르면, 이제 터미널, VS Code 및 JetBrains 확장, 독립형 데스크톱 앱, 그리고 claude.ai/code 웹 브라우저에서 모바일 지원과 함께 실행됩니다. 세션은 다양한 인터페이스 간에 이동합니다. 헤드리스 기능 또한 성숙하여, claude -p "prompt"는 CI, cron 및 셸 파이프라인으로 연결됩니다.
하나의 기기에서 하나의 프로젝트에만 집중한다면, dsh의 로컬 웹 UI는 쾌적하고 설정이 간편한 경험을 제공합니다. 그러나 IDE, 터미널, CI 및 휴대폰을 오가며 작업한다면, 현재 Claude Code의 인터페이스 지원 범위는 다른 수준에 있습니다.
모델 자유: 가장 날카로운 철학적 분열
이것은 두 도구가 코딩 에이전트가 무엇이어야 하는지에 대해 진정으로 의견이 갈리는 부분입니다.
dsh는 설계상 모델에 구애받지 않습니다. 제공자 문서는 Anthropic, OpenAI, Bedrock, Vertex 및 Azure용 카탈로그 제공업체를 제공하며, $DSH_HOME/settings.yaml에서 모든 OpenAI 호환 엔드포인트를 등록할 수 있도록 합니다. apiKeyEnv, api: openai-completions, baseURL 및 모델 목록을 설정하면, 하네스는 이를 다른 백엔드와 동일하게 취급합니다. API 키는 별도의 .credentials.yaml 파일에 있으므로 설정 파일은 공유 가능합니다. 이는 dsh가 DeepSeek 자체 모델, 경쟁 연구소의 API, 또는 로컬 서버를 통해 자체 GPU에서 양자화된 모델을 구동할 수 있음을 의미합니다. 전체 설정은 DeepSeek Harness에서 모든 모델을 실행하는 방법에서 다룹니다.
Claude Code는 Claude 모델만 실행합니다. 그게 전부입니다. Anthropic의 API 대신 Amazon Bedrock, Google Cloud의 에이전트 플랫폼 또는 Microsoft Foundry를 통해 추론을 라우팅할 수 있지만, 이는 요금 청구 및 인프라 선택에 불과하며 모델은 여전히 Claude입니다. Anthropic의 입장은 하네스와 모델이 공동 개발되며, 긴밀한 통합이 유연성보다 우수하다는 것입니다.
어떤 입장도 틀린 것은 아닙니다. 모델 종속은 가격이 변동하거나 더 나은 모델이 다른 곳에서 출시될 때 불편함을 초래합니다. 긴밀한 결합은 공급업체가 에이전트 루프와 모델을 함께 조정할 때 효과를 발휘합니다. 탈출구의 가치를 얼마나 중요하게 생각하는지에 따라 선택하세요.
가격: 토큰당 요금 vs 구독
dsh 하네스 자체는 무료입니다. 비용을 지불하는 부분은 연결하는 API에 대한 추론입니다. DeepSeek 자체 API를 사용하는 경우, DeepSeek의 토큰당 요금을 지불합니다. dsh와 같은 날 출시된 V4-Pro는 VentureBeat의 출시 보도에 따르면 이전 버전보다 더 높은 가격으로 출시되었습니다. DeepSeek V4-Pro-0813 API 사용 가이드는 해당 경로를 선택할 경우 모델 ID와 요청 형식을 다룹니다. 토큰당 가격 책정은 투명하며 코딩하지 않을 때는 비용이 0으로 확장되지만, 에이전트의 집중적인 세션은 예측할 수 없이 많은 토큰을 소모할 수 있으며, 고정된 상한선은 없습니다.
Claude Code는 이와 반대입니다. 대부분의 사용자는 Claude Pro($20/월) 또는 Max($100 또는 $200/월) 구독을 통해 이를 실행하며, 팀이 선호하는 경우 Claude Console을 통한 사용량 기반 API 청구가 대안으로 제공됩니다. 구독은 사용량 측정기가 아닌 사용량 제한이 있는 예측 가능한 요금을 제공하며, 이러한 제한은 항상 논란의 대상이었습니다. Anthropic은 2026년 7월에 주간 제한을 50% 인상했으며, 이에 대한 내용은 Claude Code 주간 제한 인상에 대한 저희 기사에서 자세히 다루었습니다.
대략적인 규칙: 가벼운 또는 간헐적인 사용은 토큰당 요금에 유리하며, 매일 집중적인 사용은 고정 구독에 유리한 경향이 있습니다. 또한 dsh는 카탈로그 제공업체를 통해 Anthropic의 API를 가리킬 수도 있으므로, 가격 책정 문제는 하네스 문제와 부분적으로는 독립적입니다.
성숙도: 7일 vs 생태계
여기서는 솔직함이 필요합니다. DeepSeek Harness는 개발자 프리뷰이며, README에는 "호환성을 깨뜨리는 변경 사항이 있을 것입니다"라고 명시되어 있습니다. 이는 회피가 아니라 약속입니다. 오늘 작성한 설정은 다음 달에 파싱되지 않을 수 있습니다. 플러그인도 다시 작성해야 할 수 있습니다. 문서는 여전히 부족한 부분이 많으며, 참조된 몇몇 페이지는 내용이 부실하거나 변경 중입니다. 지금 dsh 위에 워크플로우를 구축한다면, 변화를 통해 유지보수해야 할 것입니다.
Claude Code는 2025년 초부터 개발자들에게 제공되어 왔으며, 프로덕션 수준의 안정화는 다음과 같은 기능에서 드러납니다: CLAUDE.md 프로젝트 메모리, 자동 메모리, 패키지화된 워크플로우를 위한 스킬, 에이전트 액션 주변에서 셸 명령을 실행하는 훅, 조율하는 리드 에이전트를 가진 서브 에이전트, 커스텀 에이전트 구축을 위한 Agent SDK, GitHub Actions 및 GitLab CI/CD 통합, 그리고 예약 루틴. 이 모든 것은 더 이상 이국적인 것이 아니며, 문서화되고 버전 관리되며 매일 사용됩니다. 저희는 Claude Code와 Codex CLI 비교에서 또 다른 성숙한 경쟁자와 비교했으며, 거기서도 생태계의 깊이가 결정적이었습니다.
반론: dsh의 발전 경로는 가파릅니다. 일주일 만에 약 16.9만 개의 별과 1.81만 개의 포크(8월 20일 기준)는 이례적인 커뮤니티 에너지를 의미하며, 커뮤니티 생태계는 기능 격차를 빠르게 메울 수 있습니다. 하지만 오늘날에는 "프리뷰"와 "제품"이라는 구분이 정확한 틀입니다.
확장성: 플러그인 커널 vs 플러그인 생태계
두 도구 모두 확장 가능합니다. 확장성이 존재하는 방식에서 차이가 있습니다.
dsh에서 플러그인은 추가 계층이 아니라 아키텍처 자체입니다. 하네스는 "시공간 구성 가능성을 위한 프로그래밍 패러다임" 논문에 설계가 설명된 플러그인 커널인 Cordis를 기반으로 구축되었습니다. 모델 어댑터, 도구 레지스트리, 세션 로그, 심지어 에이전트 루프 자체도 교체 가능한 플러그인입니다. 에이전트 루프가 실패한 도구 호출을 재시도하는 방식이 마음에 들지 않으면 루프를 교체할 수 있습니다. 커뮤니티 플러그인은 dsh-plugin GitHub 토픽을 통해 발견되며, 비공식 프로젝트(데스크톱 래퍼, 컨텍스트 관리자, 비전 라우터)는 이미 늘어나고 있습니다.
Claude Code는 내부 구조보다는 확장 지점을 노출합니다. 플러그인, 스킬, 훅, MCP 서버 및 서브 에이전트를 통해 잘 정의된 경계에서 동작을 사용자 지정할 수 있지만, 코어 루프는 Anthropic의 것입니다. 대부분의 팀에게는 이것으로 충분하며, 안전장치 덕분에 업그레이드가 사용자 정의를 거의 손상시키지 않습니다. 엔진을 재구축하려는 개조광들에게는 dsh만이 도구를 제공합니다.
권한: 정책 프롬프트 vs 여섯 가지 모드
파일을 편집하고 명령을 실행하는 에이전트에게는 제동 장치가 필요합니다.
dsh의 웹 UI는 사용자 가이드에 따라 "활성 권한 정책 하에 승인이 필요한" 작업 전에 요청합니다. 이것이 현재 공개적으로 문서화된 내용의 검증된 범위입니다. 정책 수준과 정확한 의미는 아직 가이드 색인에 자세히 설명되어 있지 않으며, 이는 프리뷰 단계 문서의 특징입니다.
Claude Code의 권한 시스템은 거의 관료적일 정도로 문서화되어 있습니다. 여섯 가지 모드(default, acceptEdits, plan, auto, dontAsk, bypassPermissions), 도구 및 명령별 세분화된 허용/거부 규칙, 작업 디렉터리 경계, 그리고 관리자가 조직 전체에 적용할 수 있는 관리형 정책이 있습니다. plan 모드는 에이전트가 편집 없이 탐색하도록 허용하고, auto 모드는 사용자에게 프롬프트 대신 백그라운드 분류기로 작업을 검토하며, bypassPermissions는 샌드박스 컨테이너를 위해 존재합니다.
권한의 세분화가 요구사항이라면(규제 대상 코드베이스, 주니어 개발자가 많은 팀, CI 자율성), Claude Code는 현재 문서화 및 제어 측면에서 확실히 앞서고 있습니다.
MCP: 네이티브 vs 커뮤니티 플러그인
모델 컨텍스트 프로토콜(MCP)은 코딩 에이전트가 외부 시스템(데이터베이스, 티켓 추적기, API 사양)에 접근하는 방식입니다. Claude Code는 MCP를 네이티브로 지원합니다. 서버 연결은 일등 시민이자 문서화된 흐름이며, MCP 도구는 다른 모든 것과 동일한 권한 규칙에 연결됩니다.
dsh에서 MCP 지원은 현재 코어의 일부가 아닙니다. 현재 존재하는 것은 커뮤니티 플러그인인 dsh-mcp-manager로, MCP용 설정 페이지를 추가하고, 원격 HTTP 및 로컬 stdio 서버를 지원하며, OAuth 또는 정적 토큰을 처리하고, 프로젝트별 서버 설정과 함께 도구를 mcp__<name>__*으로 등록합니다. 작동은 하지만, 공식이 아닌 커뮤니티에서 유지보수되며 프리뷰 시대의 변화 위험을 물려받습니다. dsh의 플러그인 우선 아키텍처를 고려할 때, 나중에 자체 MCP가 등장하더라도 놀라운 일은 아닐 것입니다. 단지 지금은 아직 없습니다.
이는 특히 API 작업에 중요합니다. Apidog MCP 서버는 코딩 에이전트에게 팀의 실제 API 사양에 대한 직접적인 접근 권한을 제공하여, 필드 이름을 잘못 생성하는 대신 실제 계약에 따라 클라이언트 코드를 생성합니다. Claude Code에서는 이 연결이 네이티브입니다. dsh에서는 커뮤니티 플러그인을 통해 라우팅됩니다. 어느 쪽이든, 테스트된 사양을 읽을 수 있는 에이전트는 더 나은 API 코드를 작성하며, Apidog를 다운로드하여 두 에이전트가 작업하는 동일한 프로젝트에 대해 MCP 서버를 실행할 수 있습니다. 이를 CI에서 Apidog CLI 회귀 테스트 실행과 결합하면, 어떤 에이전트가 평가에서 승리하든 동일한 안전망을 갖게 됩니다.
어떤 것을 선택해야 할까요?
여기서는 단 하나의 승자는 없습니다. 두 도구가 서로 다른 성숙도 단계에서 다른 방향을 제시하고 있기 때문입니다.
다음과 같은 경우 DeepSeek Harness를 선택하세요:
- 소스 코드가 필요합니다. MIT 라이선스, 감사 가능성, 포크 가능성은 일부 팀에게는 엄격한 요구사항이며, dsh만이 이를 제공하는 유일한 도구입니다.
- 모델 종속을 거부합니다. DeepSeek, OpenAI 호환 로컬 모델, 그리고 카탈로그 클라우드 제공업체를 구동하는 하나의 하네스는 dsh의 진정한 구조적 이점입니다.
- 개조를 좋아하는 사람입니다. Cordis의 '모든 것이 플러그인' 설계는 에이전트 자체를 재구성하려는 사람들에게 보상을 제공합니다.
- 오류 발생을 감수할 수 있습니다. README의 경고는 명확하며, 이를 믿어야 합니다.
다음과 같은 경우 Claude Code를 선택하세요:
- 완성된 제품을 원합니다. dsh가 아직 성장할 시간이 없었던 5가지 인터페이스, 성숙한 문서, 그리고 스킬, 훅, 서브 에이전트, 네이티브 MCP로 구성된 생태계가 있습니다.
- 엔터프라이즈 제어가 필요합니다. 문서화된 권한 모드, 관리형 정책, 클라우드 제공업체 라우팅은 로드맵 항목이 아니라 출시된 기능입니다.
- 예측 가능한 청구가 중요합니다. Pro 또는 Max 구독은 토큰당 청구가 제공하지 않는 방식으로 노출을 제한합니다.
- Claude 모델에 만족합니다. 그것이 이 거래의 조건이기 때문입니다.
실용적인 중간 경로: 많은 개발자들이 한동안 두 가지를 모두 실행할 것입니다. dsh는 시험해 보는 데 비용이 들지 않으며(npx @deepseek-ai/dsh web 명령어를 통해 바로 시작할 수 있습니다), Claude Code의 구독도 실험을 방해하지 않습니다. 어떤 것을 선택하든, Apidog를 사용하여 API 계층의 정직성을 유지하세요. 이는 하나의 테스트된 사양을 MCP를 통해 두 에이전트 중 하나에 제공하고, 에이전트가 작성한 변경 후에는 CLI 회귀 테스트 실행으로 검증하는 것입니다.
자주 묻는 질문
DeepSeek Harness는 Claude Code와 달리 실제로 오픈소스인가요?
네, 그렇습니다. dsh는 MIT 라이선스를 따르며, 에이전트 루프와 플러그인 커널을 포함한 소스 코드가 GitHub에 있습니다. Claude Code의 공개 리포지토리에는 Anthropic의 상업 약관에 따라 "모든 권리 보유" 공지가 있으며, 포크할 수 있는 소스 코드가 아니라 이슈와 문서를 호스팅합니다.
DeepSeek Harness는 Claude 모델을 사용할 수 있나요?
네, 가능합니다. dsh는 Anthropic, OpenAI, Bedrock, Vertex 및 Azure용 카탈로그 제공업체를 제공하며, settings.yaml을 통해 사용자 지정 OpenAI 호환 엔드포인트도 지원합니다. 그 반대는 사실이 아닙니다. Claude Code는 Anthropic에서 직접 제공되든 Bedrock, Vertex 또는 Foundry를 통하든 Claude 모델만 실행합니다.
DeepSeek Harness는 일상적인 작업에 충분히 안정적인가요?
이것은 개발자 프리뷰이며, README에는 호환성을 깨뜨리는 변경 사항이 있을 것이라는 대문자 경고가 있습니다. 실제 작업에 사용하기에 충분히 유용하지만, 설정과 플러그인 변경이 잦을 수 있습니다. 워크플로우를 다시 구축할 여유가 없다면 Claude Code가 더 안전한 선택입니다.
두 에이전트 모두 Apidog와 작동하나요?
네, 그렇습니다. Apidog의 MCP 서버는 모든 MCP 지원 에이전트에 API 사양을 노출합니다. Claude Code에서는 네이티브로, dsh에서는 커뮤니티 dsh-mcp-manager 플러그인을 통해 노출됩니다. Apidog CLI는 또한 어느 에이전트의 터미널 루프에서도 스크립트화된 회귀 테스트를 실행합니다. dsh 설정은 DeepSeek Harness에서 Apidog CLI 사용하기에서 자세히 설명합니다.