DeepSeek Harness vs Claude Code: 당신의 기술 스택에 맞는 코딩 에이전트는?

DeepSeek Harness vs Claude Code: 개발자 관점의 실전 비교

DeepSeek Harness(dsh)는 2026년 8월 13일 출시되었습니다. VentureBeat의 출시 기사 헤드라인은 dsh를 DeepSeek V4-Pro와 함께 API로 출시된 “Claude Code의 오픈소스 경쟁자”라고 소개했습니다. 출시 일주일 후 GitHub 리포지토리는 8월 20일 기준 약 16.9만 개의 별을 기록했습니다.

오늘 Apidog를 사용해 보세요

하지만 별 수만으로는 실제 선택에 필요한 답을 얻기 어렵습니다.

• 내 코딩 에이전트를 DeepSeek Harness에서 실행해야 할까?
• Claude Code를 계속 사용하는 편이 나을까?
• 모델 선택권, 권한 관리, MCP, 비용은 어떻게 다를까?

두 도구는 방향이 다릅니다. DeepSeek Harness는 플러그인 커널과 로컬 웹 UI를 기반으로 한 MIT 라이선스 개발자 프리뷰입니다. Claude Code는 스킬, 훅, 네이티브 MCP, 서브 에이전트, 여러 실행 인터페이스를 제공하는 독점 제품입니다.

이 글에서는 라이선스, 인터페이스, 모델 선택권, 가격, 성숙도, 확장성, 권한, MCP를 실제 사용 관점에서 비교합니다. 허구의 벤치마크나 주관적인 성능 주장은 제외하고, 현재 문서화된 기능만 다룹니다.

dsh가 처음이라면 먼저 DeepSeek Harness가 무엇이며 어떻게 작동하는지를 확인한 뒤 돌아오세요.

💡 두 에이전트의 공통점은 API 코드를 작성한다는 것입니다. 에이전트가 참고하는 API 사양이 부정확하면 결과도 부정확해집니다. Apidog는 선택한 에이전트와 관계없이 API 사양을 테스트하고 최신 상태로 유지하는 데 사용할 수 있습니다.

한눈에 비교하기

항목	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 모델만 사용
가격	하네스 무료, 연결한 API의 토큰 비용 지불	Claude Pro/Max 구독 또는 콘솔 기반 사용량 청구
확장성	Cordis 플러그인 커널, 커뮤니티 dsh-plugin 토픽	플러그인, 스킬, 훅, 서브 에이전트, Agent SDK
권한	활성 권한 정책에 따른 웹 UI 승인 프롬프트	6가지 권한 모드와 세분화된 허용/거부 규칙
MCP	커뮤니티 플러그인 dsh-mcp-manager	네이티브 지원

표만으로는 실제 설정과 운영 방식의 차이를 알기 어렵습니다. 이제 항목별로 살펴보겠습니다.

오픈소스와 독점 모델: MIT 라이선스가 주는 것

DeepSeek Harness는 MIT 라이선스를 사용하며, 서드파티 종속성은 THIRD_PARTY_NOTICES.md에 기록되어 있습니다.

따라서 다음 작업이 가능합니다.

• 에이전트 루프와 플러그인 커널 코드 검토
• 필요한 부분 포크 또는 패치
• 상업 제품에 통합
• 네트워크 요청과 데이터 흐름 감사
• 자체 인프라에 맞춘 동작 수정

규정 준수가 중요한 팀이나, 공급업체가 기능을 중단할 가능성을 줄이고 싶은 플랫폼 팀에게는 큰 장점입니다.

Claude Code는 반대입니다. Anthropic의 공개 리포지토리에는 다음과 같은 안내가 있습니다.

© Anthropic PBC. 모든 권리 보유. 사용은 Anthropic의 상업 서비스 약관에 따릅니다.

공개 리포지토리는 이슈와 문서를 위한 공간이며, 포크할 수 있는 에이전트 소스 코드를 제공하지 않습니다. 따라서 Claude Code를 사용할 때는 완성된 제품과 이용 약관에 의존하게 됩니다.

다만 오픈소스가 항상 더 지속 가능한 것은 아닙니다. dsh의 MIT 라이선스는 사용, 수정, 배포에 대한 권리를 제공하지만 프로젝트가 장기적으로 유지된다는 보장은 아닙니다. 특히 dsh는 출시된 지 일주일밖에 되지 않은 개발자 프리뷰라는 점을 고려해야 합니다.

인터페이스: 로컬 웹 UI와 멀티플랫폼 지원

DeepSeek Harness 실행하기

dsh의 기본 진입점은 로컬 웹 UI입니다.

npx @deepseek-ai/dsh web

명령을 실행하면 http://127.0.0.1:3080에서 웹 UI가 시작되고 브라우저가 열립니다. 브라우저를 자동으로 열지 않으려면 다음과 같이 실행합니다.

npx @deepseek-ai/dsh web --no-open

웹 UI에서 작업 공간을 선택하고, dsh를 실행한 프로젝트 디렉터리를 지정한 뒤 작업을 진행합니다. UI는 호스팅 서비스가 아니라 로컬 장치에서 실행됩니다.

dsh는 프로필 기반 CLI 모드도 제공합니다.

dsh --profile <name>

프로필은 $DSH_HOME/profiles/<name> 아래에서 시작됩니다. 헤드리스 프로필은 영구 세션을 실행하고 최종 답변을 출력한 뒤 종료하는 방식으로 자동화에 사용할 수 있습니다.

관련 CLI 동작은 CLI README에서 확인할 수 있습니다.

dsh web은 웹 프로필의 단축 명령이며, dsh plugin은 pnpm을 통해 프로필 플러그인 관리를 전달합니다.

Claude Code 실행하기

Claude Code는 터미널 중심으로 시작해 다음 인터페이스로 확장되었습니다.

• 터미널 CLI
• VS Code 확장
• JetBrains 확장
• 독립형 데스크톱 앱
• 웹 브라우저
• 모바일 지원

자세한 내용은 공식 문서를 참고하세요.

헤드리스 실행은 CI, cron, 셸 파이프라인에 연결할 때 유용합니다.

claude -p "프로젝트의 테스트 실패 원인을 분석하고 수정안을 제안해줘"

하나의 기기에서 하나의 프로젝트에 집중한다면 dsh의 로컬 웹 UI가 간단합니다. 반대로 IDE, 터미널, CI, 모바일을 오가며 작업한다면 Claude Code의 인터페이스 범위가 더 넓습니다.

모델 선택권: dsh의 가장 큰 차이

두 도구의 철학이 가장 크게 갈리는 부분은 모델 선택권입니다.

dsh는 모델에 종속되지 않도록 설계되었습니다. 제공자 문서에 따르면 다음 제공자를 사용할 수 있습니다.

• DeepSeek
• Anthropic
• OpenAI
• Amazon Bedrock
• Google Vertex
• Microsoft Azure
• OpenAI 호환 엔드포인트

사용자 지정 OpenAI 호환 엔드포인트는 $DSH_HOME/settings.yaml에 등록할 수 있습니다.

providers:
  my-provider:
    apiKeyEnv: MY_PROVIDER_API_KEY
    api: openai-completions
    baseURL: https://example.com/v1
    models:
      - name: my-model

API 키는 별도의 .credentials.yaml 파일에 둘 수 있으므로 설정 파일을 공유할 때 인증 정보를 분리할 수 있습니다.

이 구조를 사용하면 다음과 같은 구성이 가능합니다.

• DeepSeek 자체 모델 사용
• 경쟁 연구소의 API 연결
• 사내 OpenAI 호환 모델 서버 연결
• 자체 GPU에서 실행하는 양자화 모델 연결

전체 설정은 DeepSeek Harness에서 모든 모델을 실행하는 방법에서 확인할 수 있습니다.

Claude Code는 Claude 모델만 실행합니다. Anthropic API 대신 Amazon Bedrock, Google Cloud의 에이전트 플랫폼, Microsoft Foundry를 통해 추론을 라우팅할 수 있지만 모델 자체는 Claude입니다.

따라서 다음처럼 선택하면 됩니다.

• 여러 모델을 비교하거나 교체해야 한다면 dsh
• 하네스와 모델이 긴밀하게 통합된 경험을 원한다면 Claude Code

모델 종속이 비용과 유연성에 미치는 영향을 중요하게 생각하는지에 따라 판단하면 됩니다.

가격: 토큰당 비용과 구독

dsh 하네스 자체는 무료입니다. 실제 비용은 연결한 모델 API에서 발생합니다.

DeepSeek API를 사용한다면 DeepSeek의 토큰당 요금을 지불합니다. dsh와 같은 날 출시된 V4-Pro는 VentureBeat 보도에 따르면 이전 버전보다 높은 가격으로 출시되었습니다. DeepSeek V4-Pro-0813 API 사용 가이드에서는 모델 ID와 요청 형식을 다룹니다.

토큰당 요금의 특징은 다음과 같습니다.

• 사용하지 않으면 비용이 발생하지 않음
• 실제 사용량과 비용의 관계가 명확함
• 집중적인 에이전트 세션에서는 토큰 사용량이 커질 수 있음
• 고정된 비용 상한선이 없음

Claude Code는 주로 다음 방식으로 결제합니다.

• Claude Pro: 월 $20
• Claude Max: 월 $100 또는 $200
• Claude Console을 통한 사용량 기반 API 청구

구독은 토큰당 청구보다 예측하기 쉬운 대신 사용량 제한이 있습니다. Anthropic은 2026년 7월 주간 제한을 50% 인상했으며, 자세한 내용은 Claude Code 주간 제한 인상에 대한 기사에서 확인할 수 있습니다.

대략적인 기준은 다음과 같습니다.

• 간헐적이거나 가벼운 사용: 토큰당 요금이 유리할 수 있음
• 매일 집중적으로 사용: 고정 구독이 유리할 수 있음
• Anthropic 모델을 사용하되 하네스 선택권이 필요함: dsh에서 Anthropic API 사용 가능

성숙도: 개발자 프리뷰와 제품 생태계

dsh는 개발자 프리뷰입니다. README에는 호환성을 깨뜨리는 변경 사항이 있을 수 있다고 명시되어 있습니다.

따라서 dsh에 워크플로우를 구축할 때는 다음을 예상해야 합니다.

• 설정 형식이 변경될 수 있음
• 플러그인을 다시 작성해야 할 수 있음
• 문서가 변경되거나 부족할 수 있음
• 다음 버전에서 기존 자동화가 동작하지 않을 수 있음

이는 dsh의 단점이라기보다 프리뷰 단계의 특성입니다. 다만 프로덕션 워크플로우를 안정적으로 유지해야 한다면 중요한 위험 요소입니다.

Claude Code는 2025년 초부터 개발자에게 제공되어 왔으며, 다음 기능을 포함한 성숙한 생태계를 갖추고 있습니다.

• CLAUDE.md 프로젝트 메모리
• 자동 메모리
• 재사용 가능한 워크플로우를 위한 스킬
• 에이전트 작업 전후에 셸 명령을 실행하는 훅
• 리드 에이전트와 서브 에이전트
• 커스텀 에이전트를 위한 Agent SDK
• GitHub Actions 및 GitLab CI/CD 통합
• 예약 실행 루틴

관련 비교는 Claude Code와 Codex CLI 비교에서도 확인할 수 있습니다.

dsh는 짧은 기간에 약 16.9만 개의 별과 1.81만 개의 포크를 기록했습니다. 8월 20일 기준 수치이며, 커뮤니티의 관심과 성장 가능성을 보여줍니다. 하지만 현재 선택 기준은 명확합니다.

• 실험과 커스터마이징: dsh
• 안정성과 문서화된 생태계: Claude Code

확장성: 플러그인 커널과 확장 지점

두 도구 모두 확장할 수 있지만, 확장 방식이 다릅니다.

dsh: 코어 자체가 플러그인 구조

dsh는 Cordis 플러그인 커널을 기반으로 구축되었습니다. 모델 어댑터, 도구 레지스트리, 세션 로그, 에이전트 루프까지 교체 가능한 플러그인으로 구성됩니다.

예를 들어 기본 에이전트 루프의 동작이 요구사항에 맞지 않는다면 루프 자체를 교체하는 방향으로 확장할 수 있습니다.

커뮤니티 플러그인은 GitHub의 dsh-plugin 토픽에서 찾을 수 있습니다. 데스크톱 래퍼, 컨텍스트 관리자, 비전 라우터 같은 비공식 프로젝트도 이 구조를 활용할 수 있습니다.

Claude Code: 안정적인 경계에서 확장

Claude Code는 코어 루프를 수정하는 대신 다음 확장 지점을 제공합니다.

• 플러그인
• 스킬
• 훅
• MCP 서버
• 서브 에이전트
• Agent SDK

대부분의 팀에는 이 방식이 더 적합합니다. 코어를 직접 수정하지 않기 때문에 업그레이드 시 사용자 지정이 깨질 가능성을 줄일 수 있습니다.

반면 에이전트 엔진 자체를 다시 설계하려는 경우에는 dsh가 더 많은 자유를 제공합니다.

권한 관리: 승인 정책과 세분화된 모드

파일을 편집하고 명령을 실행하는 에이전트에는 권한 제어가 필요합니다.

dsh 웹 UI는 활성 권한 정책에 따라 승인이 필요한 작업 전에 승인 요청을 표시합니다. 다만 현재 공개 문서에서는 정책 수준과 각 정책의 정확한 의미가 충분히 자세히 설명되어 있지 않습니다.

Claude Code의 권한 시스템은 더 세분화되어 있습니다. 문서화된 권한 모드는 다음과 같습니다.

• default
• acceptEdits
• plan
• auto
• dontAsk
• bypassPermissions

또한 도구와 명령별 허용·거부 규칙, 작업 디렉터리 경계, 조직 전체에 적용할 수 있는 관리형 정책을 제공합니다.

예를 들어 plan 모드는 파일을 수정하지 않고 탐색과 계획에 집중하게 할 수 있습니다. bypassPermissions는 샌드박스 컨테이너와 함께 사용하는 시나리오를 위한 모드입니다.

다음 요구사항이 있다면 현재는 Claude Code가 더 적합합니다.

• 규제 대상 코드베이스
• 팀 단위의 세밀한 권한 관리
• CI 환경에서의 에이전트 자율성
• 관리자가 통제하는 정책
• 명확하게 문서화된 승인 흐름

MCP: 네이티브 지원과 커뮤니티 플러그인

모델 컨텍스트 프로토콜(MCP)은 에이전트가 데이터베이스, 이슈 트래커, API 사양 같은 외부 시스템에 접근하는 표준 방식입니다.

Claude Code는 MCP를 네이티브로 지원합니다. 서버 연결과 도구 사용이 공식 흐름에 포함되어 있으며, MCP 도구도 다른 도구와 동일한 권한 규칙을 적용받습니다.

dsh의 MCP 지원은 현재 코어 기능이 아닙니다. 대신 커뮤니티 플러그인인 dsh-mcp-manager를 사용할 수 있습니다. 이 플러그인은 다음 기능을 제공합니다.

• MCP 설정 페이지
• 원격 HTTP 서버 연결
• 로컬 stdio 서버 연결
• OAuth 및 정적 토큰 처리
• 프로젝트별 서버 설정
• mcp__<name>__* 형식의 도구 등록

기능은 동작하지만 공식 코어가 아니라 커뮤니티에서 유지보수됩니다. 따라서 dsh 프리뷰의 변경 위험과 플러그인 유지보수 위험을 함께 고려해야 합니다.

API 개발에서 MCP가 중요한 이유

API 코드를 생성할 때 에이전트가 실제 API 사양을 참조하지 않으면 다음 문제가 발생할 수 있습니다.

• 필드 이름 오류
• 잘못된 요청 형식
• 누락된 인증 헤더
• 오래된 엔드포인트 사용
• 실제 응답과 맞지 않는 타입 생성

Apidog MCP 서버는 코딩 에이전트가 팀의 API 사양을 직접 참조하도록 연결할 수 있습니다.

• Claude Code: 네이티브 MCP 연결
• dsh: dsh-mcp-manager를 통한 연결

또한 Apidog 다운로드 후 두 에이전트가 작업하는 동일한 프로젝트에 MCP 서버를 구성할 수 있습니다.

에이전트가 코드를 수정한 뒤에는 Apidog CLI를 사용해 회귀 테스트를 실행할 수 있습니다. 그러면 어떤 에이전트를 선택하더라도 동일한 API 사양과 테스트 기준을 적용할 수 있습니다.

어떤 도구를 선택해야 할까?

단 하나의 승자를 고르기보다 프로젝트 요구사항에 맞춰 선택하는 편이 정확합니다.

DeepSeek Harness를 선택할 때

다음 조건이라면 dsh를 검토할 만합니다.

• 소스 코드 검토와 포크가 필요함
• MIT 라이선스가 필수임
• 특정 모델 공급업체에 종속되고 싶지 않음
• DeepSeek, OpenAI 호환 모델, 클라우드 카탈로그를 하나의 하네스로 사용하고 싶음
• 에이전트 루프와 플러그인 커널 자체를 수정하고 싶음
• 프리뷰 단계의 호환성 변경을 감수할 수 있음

다음 명령으로 바로 시작할 수 있습니다.

npx @deepseek-ai/dsh web

Claude Code를 선택할 때

다음 조건이라면 Claude Code가 더 적합합니다.

• 바로 사용할 수 있는 안정적인 제품이 필요함
• 터미널, IDE, 데스크톱, 웹, 모바일을 오가며 작업함
• 스킬, 훅, 서브 에이전트, 네이티브 MCP가 필요함
• 세분화된 권한 모드와 관리형 정책이 필요함
• CI/CD 통합이 중요함
• Claude 모델 사용에 만족함
• 구독 기반의 예측 가능한 비용을 선호함

두 도구를 함께 사용하는 방법

두 도구를 모두 실행하는 것도 현실적인 선택입니다. dsh는 하네스 자체가 무료이고 다음 명령으로 즉시 실험할 수 있습니다.

npx @deepseek-ai/dsh web

두 도구를 함께 사용할 때는 API 계층을 공통 기준으로 관리하는 것이 중요합니다.

1. Apidog에서 API 사양을 작성하고 최신 상태로 유지합니다.
2. MCP를 통해 동일한 사양을 Claude Code 또는 dsh에 제공합니다.
3. 에이전트가 생성하거나 수정한 코드를 저장합니다.
4. Apidog CLI로 회귀 테스트를 실행합니다.
5. 실패한 테스트 결과를 다시 에이전트에 전달합니다.

이 구조를 사용하면 에이전트의 모델이나 하네스가 바뀌어도 API 계약과 테스트 기준은 유지할 수 있습니다.

자주 묻는 질문

DeepSeek Harness는 Claude Code와 달리 실제로 오픈소스인가요?

네. dsh는 MIT 라이선스를 따르며, 에이전트 루프와 플러그인 커널을 포함한 소스 코드가 GitHub에 공개되어 있습니다.

Claude Code의 공개 리포지토리는 이슈와 문서를 위한 공간입니다. Anthropic의 상업 약관이 적용되며, 포크할 수 있는 에이전트 소스 코드는 제공되지 않습니다.

DeepSeek Harness에서 Claude 모델을 사용할 수 있나요?

네. dsh는 Anthropic, OpenAI, Bedrock, Vertex, Azure 같은 카탈로그 제공자를 지원하며, settings.yaml을 통해 사용자 지정 OpenAI 호환 엔드포인트도 등록할 수 있습니다.

반대로 Claude Code는 Claude 모델만 사용합니다. Anthropic에서 직접 제공하든 Bedrock, Vertex, Foundry를 통해 제공하든 모델은 Claude입니다.

DeepSeek Harness는 일상적인 작업에 충분히 안정적인가요?

dsh는 개발자 프리뷰이며, README에 호환성을 깨뜨리는 변경 사항이 있을 수 있다고 명시되어 있습니다.

실제 작업에 사용할 수는 있지만 설정과 플러그인이 변경될 가능성을 고려해야 합니다. 워크플로우를 자주 수정할 수 없다면 Claude Code가 더 안전한 선택입니다.

두 에이전트 모두 Apidog와 작동하나요?

네. Apidog MCP 서버는 MCP를 지원하는 에이전트에 API 사양을 노출할 수 있습니다.

• Claude Code: 네이티브 MCP 사용
• dsh: 커뮤니티 dsh-mcp-manager 플러그인 사용

Apidog CLI는 두 에이전트의 터미널 워크플로우에서 스크립트화된 회귀 테스트를 실행하는 데 사용할 수 있습니다. dsh 설정은 DeepSeek Harness에서 Apidog CLI 사용하기에서 자세히 확인할 수 있습니다.