Markdown 버전

AI-translated from English; not yet reviewed by a fluent editor.

# 격리된 작업 공간에서 DeepSeek Harness 사용해 보기

> 격리된 작업 공간에서 DeepSeek Harness를 처음 사용하는 방법을 문서에 따라 안내합니다. 모델 설정, 제공업체 요금, 세션 데이터, 미리 보기 버전의 안전 제한을 다룹니다.

By BIG CHANGE Editorial

Published: 2026-10-05T05:59:25.729Z
Updated: 2026-10-05T05:59:25.729Z
Canonical: https://bigchange.ai/blog/deepseek-harness-safe-workspace-setup-guide

![Conceptual charcoal illustration of a desktop monitor displaying one small unlabeled practice document, with a keyboard and a plain sheet in an orange tray on the table.](https://bigchange.ai/api/media/file/deepseek-harness-disposable-workspace-hero-v2.png)
AI-generated conceptual editorial illustration by BIG CHANGE.

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

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

## 큰 변화

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

## 환경과 첫 작업 준비

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

문서에 나온 웹 방식에는 [Node.js](https://github.com/deepseek-ai/deepseek-harness#run) 와 모델 계정 또는 API 자격 증명이 필요합니다. 격리된 디렉터리에서 터미널을 열고 DeepSeek README의 명령을 실행하세요.

```sh
npx @deepseek-ai/dsh web
```

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

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

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

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

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

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

```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.
```

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

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

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

## 세션 데이터 고려

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

## 출처 및 추가 자료

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

## Sources

- [DeepSeek Harness 공식 제품 페이지](https://www.deepseek.com/en/harness/) — 공개 미리 보기, 오픈 소스, 데스크톱/Web 모드를 설명합니다.
- [DeepSeek Harness GitHub 저장소](https://github.com/deepseek-ai/deepseek-harness) — 공식 저장소는 오픈 소스 하네스, 개발자 미리 보기, 호환성을 깨뜨릴 수 있는 변경을 설명합니다.
- [DeepSeek Harness 릴리스](https://github.com/deepseek-ai/deepseek-harness/releases) — 현재 GitHub에 표시된 사전 릴리스 목록으로, 설치된 npx 패키지 버전을 확인해 주지는 않습니다.
- [DeepSeek Harness 안전 공지](https://github.com/deepseek-ai/deepseek-harness/blob/master/SAFETY.md) — 실험 단계 상태, 실행 기능, 위험, 완화책, 샌드박스 한계.
- [모델 구성](https://deepseek-harness.github.io/deepseek-harness/en/guide/providers) — 모델 설정, 자격 증명 처리, 지원하지 않는 제공업체.
- [DeepSeek Harness 개인정보 처리방침](https://www.deepseek.com/en/harness/privacy/) — 세션 로그와 데이터 처리.
- [DeepSeek Harness 이용 약관](https://www.deepseek.com/en/harness/terms-of-use/) — 사용자 지정 모델 비용과 서비스 약관.
- [Web UI 사용](https://deepseek-harness.github.io/deepseek-harness/en/guide/quickstart) — 기본 시작 디렉터리, 필수 작업 공간 선택, 모델 키, 첫 세션 기능을 문서화합니다.