DeepSeek Harness는 컴퓨터의 웹 인터페이스에서 프로젝트 파일을 읽고, 모델을 사용하고, 도구를 실행할 수 있습니다. DeepSeek는 이 제품을 공개 미리 보기라고 부르지만, 저장소 는 호환성을 깨뜨리는 변경이 있을 수 있는 개발자 미리 보기 소프트웨어라고 설명합니다. 안전 공지 에 따르면 보안 감사를 받지 않았고 운영 환경에서 사용할 준비가 되지 않았습니다. 처음 실행할 때는 중요하지 않은 프로젝트를 격리된 환경에서 사용하세요.

공식 릴리스 목록 에는 10월 5일 확인 당시 v0.2.1-alpha.1 2026년 10월 3일자 사전 릴리스가 포함되어 있었습니다. 아래의 문서화된 npx 명령은 GitHub 사전 릴리스를 자동으로 선택하지 않으므로, 특정 버전 기능 안내를 따르기 전에 설치한 버전을 확인하세요. 10월 5일 보도로 이 도구를 알게 되기 전부터 DeepSeek는 데스크톱 빌드를 제공했습니다. 여기서는 문서에 나온 로컬 웹 인터페이스를 사용합니다.

큰 변화

DeepSeek는 이제 공개 미리 보기 중인 오픈 소스 에이전트 하네스를 제공합니다. 코드에서 실행하는 웹 인터페이스와 Apple silicon Mac 및 64비트 Windows용 공식 데스크톱 다운로드가 포함됩니다. 플러그인 시스템은 모델 접근, 도구 및 기타 에이전트 기능을 결합할 수 있습니다. 파일을 다루는 에이전트를 평가하려는 사용자에게 유용한 점은 회사 저장소나 실제 업무 데이터 대신 작은 로컬 작업 공간을 가져와 모델 제공업체를 선택할 수 있다는 것입니다. 이 실험에는 여전히 미리 보기 표시와 안전 공지가 적용됩니다. 에이전트는 명령을 실행하고 프로세스에 허용된 파일, 자격 증명, 네트워크에 접근할 수 있습니다. 작업 공간을 선택하고 승인 요청을 표시해도 격리가 보장되지는 않습니다.

환경과 첫 작업 준비

DeepSeek가 권고하듯작업에 필요한 최소 권한만 가진 격리된 가상 머신, 컨테이너 또는 전용 컴퓨터 계정을 사용하세요. 그 안에 잃어도 괜찮은 짧고 민감하지 않은 README.md 를 잃어도 괜찮은 짧고 민감하지 않은 내용만 둡니다. 개인 파일, 회사 저장소, 자격 증명, 브라우저 세션, 연결된 드라이브는 환경 밖에 두세요. 프로세스가 접근할 수 있는 모든 항목을 백업하세요. 디렉터리만으로 프로세스를 그 안에 가둘 수는 없습니다. 다른 항목에 대한 접근 범위는 기반 계정과 환경에 따라 달라집니다.

문서에 나온 웹 방식에는 Node.js 와 모델 계정 또는 API 자격 증명이 필요합니다. 격리된 디렉터리에서 터미널을 열고 DeepSeek README의 명령을 실행하세요.

Terminal
npx @deepseek-ai/dsh web

README에 따르면 README에 따르면 기본적으로 Web UI가 http://127.0.0.1:3080 기본적으로 로컬 브라우저에서 열립니다. 열리지 않으면 명령이 출력한 URL을 사용하세요. SSH로 실행할 때는 포워딩 방식이 다릅니다. 이 작업 중에는 공개 주소에 서비스를 노출하지 마세요. Web UI 안내 에 따르면 프로세스는 시작 디렉터리를 기본 파일 시스템 위치로 사용하지만, 새 인터페이스에는 선택된 작업 공간이 없습니다. 작업 공간을 선택하고 격리된 디렉터리를 추가한 뒤 선택하세요. 작업 공간을 선택하기 전에는 입력란을 사용할 수 없습니다.

모델 하나를 설정하고 요금 확인

에서 설정 → 모델공식 구성 안내 에 따라 DeepSeek API 키를 입력하고 저장할 수 있습니다. 안내에는 기본 제공되는 타사 제공업체 항목과 게이트웨이 또는 자체 호스팅 엔드포인트를 위한 사용자 지정 모델 API도 나옵니다. 타사 제공업체를 사용하려면 모델 제공업체 추가 설치된 목록에서 제공업체를 선택하고 API 키를 입력한 뒤 저장하세요. 그런 다음 세션 선택기에서 해당 모델을 선택합니다. 안내에 따르면 이 구성 방식은 Codex와 같은 OAuth 로그인 제공업체를 지원하지 않습니다. 제공업체가 목록에 없으면 사용자 지정 경로에 제공업체 ID, 기본 URL, 호환되는 API 프로토콜, 자격 증명, 최소 하나의 모델 ID가 필요합니다. 이는 별도의 통합 작업입니다.

저장한 후 모델 페이지에는 키가 가려진 설명이 표시됩니다. DeepSeek는 키를 $DSH_HOME/.credentials.yaml 에 저장하고 설정에 참조를 남긴다고 합니다. 해당 파일과 파일이 있는 환경을 보호하세요. 저장소는 MIT 라이선스이지만 모델 호출에는 비용이 들 수 있습니다. DeepSeek 이용 약관 에 따르면 사용자 지정 제공업체의 토큰 또는 구독 요금은 사용자가 부담하며, 입력 한 번이 지속적인 모델 호출을 유발할 수 있습니다. 작업을 보내기 전에 제공업체의 현재 가격과 사용량 제어를 확인하세요. 소프트웨어 라이선스만으로 고정 가격이나 무료 사용량을 추정할 수는 없습니다.

읽기 전용 요청을 보내고 실행 결과 확인

선택한 작업 공간에서 범위를 좁힌 요청으로 세션을 시작하세요.

Text
Summarize the README in this workspace. Do not run commands, edit files, install plugins or make network requests through tools. Ask before taking any other action.

이 제안 프롬프트는 에이전트에게 요청하는 도구 작업을 제한하지만, 설정된 원격 모델은 계속 제공업체와 통신합니다. 프롬프트는 보안 경계가 아닙니다. 공식 빠른 시작 안내 는 저장소 요약 작업을 사용하며 에이전트가 파일을 읽고 편집하고, 명령을 실행하고, 작업을 위임할 수 있다고 설명합니다. 현재 정책상 승인이 필요한 작업은 사용자에게 승인을 요청합니다.

응답이 작은 README를 정확히 설명하는지 확인하고 도구 호출이 작업에 맞는지 검토하세요. 승인하지 않은 명령이나 파일 변경은 거부하세요. 에이전트가 선택한 디렉터리 밖의 경로를 찾거나, 비밀 정보를 만나거나, 플러그인을 제안하거나, 설정된 모델 호출을 넘어서는 외부 도구 요청을 제안하면 세션을 중지하고 환경을 확인한 뒤 계속하세요. DeepSeek 안전 공지 는 승인 및 샌드박스 제어가 위험을 낮출 수 있지만 격리를 보장하지는 않는다고 설명합니다. 요약이 정확하더라도 더 긴 작업 흐름이 안정적으로 작동한다는 증거는 아닙니다.

예상되는 첫 출력은 파일 변경을 요청하지 않는 모델 요약입니다. BIG CHANGE는 이 버전을 설치하거나 실행하지 않았고, 실제 환경에서 프롬프트를 확인하거나 신뢰성을 측정하지 않았습니다. 이 단계는 DeepSeek 문서에 따른 보수적인 작업 설계이지 실제 테스트 결과가 아닙니다.

세션 데이터 고려

DeepSeek의 개인정보 처리방침은 9월 20일 업데이트되었으며 입력, 승인된 파일, 모델 출력, 도구 정보, 플러그인 설정이 포함될 수 있는 세션 로그를 설명합니다. 사용자 지정 모델의 경우 입력은 선택한 모델 제공업체로 직접 전송되어 해당 업체의 정책을 따르며, DeepSeek는 서버에 입력과 출력을 저장하지 않는다고 합니다. 모델과 활성화할 플러그인의 최신 정책을 읽고 첫 테스트에는 민감한 자료를 넣지 마세요.

출처 및 추가 자료

  • DeepSeek Harness 제품 페이지2026년 10월 5일 확인. 공개 미리 보기, 공식 데스크톱 다운로드 플랫폼,npx웹 방식을 설명합니다.
  • 공식 저장소 및 README2026년 10월 5일 확인. 개발자 미리 보기 상태, 로컬 Web UI 명령, 기본 주소, MIT 라이선스를 문서화합니다. 릴리스 목록에는 10월 3일v0.2.1-alpha.1사전 릴리스가 표시되지만,npx명령으로 설치된 버전을 확인할 수는 없습니다.
  • Web UI 빠른 시작 안내및모델 구성 안내2026년 10월 5일 확인. 작업 공간 선택, 제공업체 설정, 자격 증명 저장, 지원되는 구성 경로를 설명합니다.
  • 안전 공지2026년 10월 5일 확인. DeepSeek는 실험 단계 상태, 이용 가능한 시스템 기능, 승인 및 샌드박스 제어의 한계, 격리된 환경 권고를 설명합니다.
  • 개인정보 처리방침및이용 약관모두 2026년 9월 20일 최종 업데이트, 10월 5일 확인. 처리방침은 세션 로그와 사용자 지정 제공업체로 가는 데이터 경로를 설명하고, 약관은 사용자 지정 모델 비용을 사용자가 부담한다고 명시합니다.