DeepSeek Harness(dsh) 연동 튜토리얼

DeepSeek Harness는 DeepSeek가 오픈소스로 공개한 에이전트 실행 프레임워크(명령어 dsh)로, 핵심 이념은 '모든 것이 플러그인'입니다. 모델, 도구, 세션 등의 기능을 모두 플러그인으로 제공합니다. 'Custom model API'를 통해 어떤 게이트웨이에든 연동할 수 있으며, NextHub의 GPT-Azure 그룹 안내에서도 DSH를 지원하는 서드파티 도구로 소개하고 있습니다.

연동 단계

1. 설치 및 실행

Node.js가 설치되어 있어야 합니다(공식 최신 LTS 버전 권장). npx로 Web UI를 바로 실행하거나, 전역 설치 후 실행하세요:

npx @deepseek-ai/dsh web

npm install -g @deepseek-ai/dsh
dsh web

실행이 끝나면 브라우저에 로컬 관리 화면이 자동으로 열립니다.

2. 커스텀 Provider 추가(Claude 채널)

설정 → 모델으로 이동한 뒤 Add Provider 버튼을 클릭하고, 카드를 Custom model API로 전환한 뒤 아래 표대로 입력합니다:

필드	입력 내용	설명
Provider ID	nexthub	소문자이며, 생성 후에는 변경할 수 없습니다
기본 URL	https://api.nexthub.cc	Anthropic 프로토콜은 루트 도메인을 입력하며 /v1을 붙이지 않습니다
API 프로토콜	Anthropic Messages	Anthropic Messages 프로토콜 엔드포인트에 해당합니다
자격 증명(API Key)	당신의 NextHub ApiKey	Claude 계열 그룹
모델	claude-opus-5-5 등	최소 하나 이상. Fetch available models 버튼을 누르면 자동으로 가져올 수 있습니다

저장한 뒤 대화창의 모델 목록에서 방금 추가한 모델을 선택하면 사용할 수 있습니다.

3. GPT 채널 연동(선택 사항)

Provider 하나에는 프로토콜 하나만 설정할 수 있으므로, GPT가 필요하면 Provider를 하나 더 만드세요. Provider ID에는 nexthub-gpt를 입력하고, API 프로토콜은 OpenAI Chat Completions(또는 OpenAI Responses)를 선택하며, 기본 URL에는 https://api.nexthub.cc/v1(/v1 포함)를 입력합니다. API Key에는 GPT-Azure / GPT-Pro 그룹의 API 키를 사용하고, 모델에는 gpt-5.6, gpt-6-astra 등을 입력합니다.

4. 검증

대화창에서 NextHub 모델을 선택해 메시지를 하나 보내고, 응답이 정상적으로 오면 연동에 성공한 것입니다.

설정 파일 방식(선택 사항)

위 설정은 최종적으로 $DSH_HOME/profiles/web/cordis.patch.yml에 기록됩니다(DSH_HOME 기본값은 ~/.dsh). 이 파일을 직접 편집해도 됩니다:

- id: llm-pi-ai
  config:
    providers:
      nexthub:
        apiKeyEnv: NEXTHUB_API_KEY
        api: anthropic-messages
        baseURL: https://api.nexthub.cc
        models:
          - id: claude-opus-5-5
          - id: claude-fable-5

apiKeyEnv에는 환경 변수명을 입력하며, API 키 자체는 해당 환경 변수에서 읽어옵니다. 화면에서 저장한 API 키는 $DSH_HOME/.credentials.yaml에 보관됩니다. 수정 후에는 재시작할 필요가 없으며, 다음 요청부터 바로 적용됩니다.

시각 모델은 입력 타입을 선언해야 합니다

수동으로 입력한 모델은 기본적으로 순수 텍스트로 처리됩니다. 모델에 이미지를 보내려면 해당 모델의 Model options에서 Input types의 Image를 체크하세요(설정값 input: [text, image]에 해당). 그렇지 않으면 이미지 전송은 보내기 전에 거부됩니다.