주요 콘텐츠로 건너뛰기
학습으로 돌아가기
05설치읽는 데 7분초급

초보자 가이드 · 첫 실행

DeepSeek Harness 빠른 시작

지정된 공식 Alpha 소스로 Harness를 빌드하고 로컬 주소에서 웹 UI를 여세요. 연습용 임시 작업 공간을 선택하고 모델과 권한을 확인한 뒤 첫 번째 작은 작업을 실행하세요.

마지막 검증
2026년 9월 6일
가이드 소스 기준
0.1.3-alpha.1
설치 상태
선택한 항목의 기록 확인
검증된 범위
  • 고정된 공식 Alpha 소스의 빌드와 실행
  • 공식 아키텍처 및 Web UI 가이드
  • 루프백 및 작업 공간 안전 경계
이 페이지에서
  1. 시작하기 전에
  2. 공식 Web UI 실행하기
  3. 작고 관찰 가능한 작업 하나 완료하기
  4. 첫 번째 작은 작업을 완료하세요

시작하기 전에

  • 지원되는 Node.js 환경과 안전하게 검사할 수 있는 프로젝트 폴더를 사용하십시오.
  • 비밀이나 변경하고 싶지 않은 파일이 있는 디렉토리에서 시작하지 마십시오.
  • Web UI를 로컬 네트워크에 노출하지 않고 기본 루프백 주소에서 유지하십시오.
  • 구성하려는 모델 제공자의 API 자격 증명을 준비하십시오.

공식 Web UI 실행하기

bash
mkdir -p "$HOME/.dsh-themes/runtimes" &&
git clone --depth 1 --branch dsh-v0.1.3-alpha.1 https://github.com/deepseek-ai/deepseek-harness.git "$HOME/.dsh-themes/runtimes/0.1.3-alpha.1" &&
cd "$HOME/.dsh-themes/runtimes/0.1.3-alpha.1" &&
test "$(git rev-parse HEAD)" = "d347e703908d0406b7a7ef80e3a0e594d86b2215" &&
corepack pnpm install --frozen-lockfile &&
corepack pnpm run build:official &&
corepack pnpm dsh web
Node.js 24, pnpm 11.7.0 순서대로 각 명령을 실행합니다.

작고 관찰 가능한 작업 하나 완료하기

  1. 01

    표시된 루프백 주소를 엽니다.

    기본값은 포트 3080의 브라우저 UI입니다. 프로세스에서 출력된 주소를 사용하고 터미널을 켠 상태로 유지하십시오.

  2. 02

    모델 구성

    설정을 열고 필요한 제공자 자격 증명을 추가하십시오. 자격 증명을 대화나 프로젝트 파일에 붙여넣지 마십시오.

  3. 03

    일회용 작업 공간 선택

    별도의 위치에 연습용 임시 프로젝트를 만들거나 작업할 자신의 프로젝트를 선택한 뒤 디렉터리를 추가하고 선택하세요. 공식 Harness 실행 소스 디렉터리를 Agent의 편집 작업 공간으로 사용하지 마세요. 작업 공간을 선택하면 메시지 입력란을 사용할 수 있습니다.

  4. 04

    읽기 전용 첫 작업 요청

    Agent에게 리포지토리를 요약하고 주요 패키지를 식별하도록 요청하는 것으로 시작하십시오. 수정 요청 전에 읽은 내용을 검토하십시오.

  5. 05

    모든 승인 프롬프트 읽기

    명령, 경로 및 의도된 효과를 확인하십시오. 선택된 작업 공간 외부에 접근하거나 작업에서 요구하지 않는 작업을 수행하는 작업은 거부하십시오.

첫 번째 실행 후

첫 번째 작은 작업을 완료하세요

고정 소스 빌드가 열린 후 모델을 구성하고 프로젝트를 명시적으로 선택하세요. README 수정을 요청하고, 차이점을 검사하고, 세션을 다시 열어도 대화가 유지되는지 확인하세요.

text
내 Node.js 및 pnpm 버전을 확인하고, 커밋 d347e703908d0406b7a7ef80e3a0e594d86b2215에서 DeepSeek Harness 0.1.3-alpha.1을 빌드하고, Web UI를 시작하세요. 설정에서 내 모델 자격 증명을 입력하도록 요청하세요. 인증 정보를 출력하거나 임의로 만들어 내지 마세요.
직접 써 볼 프롬프트

공식 1차 문서 읽기

일반 질문

변경하기 전에

형식, 호환성, 증거 및 롤백에 대한 답변

이 가이드에서는 무엇을 확인하나요?

이 가이드의 범위: 고정된 공식 Alpha 소스의 빌드와 실행, 공식 아키텍처 및 Web UI 가이드, 루프백 및 작업 공간 안전 경계

무엇부터 시작해야 하나요?

지정된 공식 Alpha 소스로 Harness를 빌드하고 로컬 주소에서 웹 UI를 여세요. 연습용 임시 작업 공간을 선택하고 모델과 권한을 확인한 뒤 첫 번째 작은 작업을 실행하세요.

가장 중요한 경계는 무엇인가요?

Node.js 24(저장소 지원 범위: ^22.19.0 또는 >=24.0.0)와 Corepack을 사용하세요. 공식 빌드에는 Corepack이 저장소의 pnpm 11.7.0을 선택하지만 하위 프로세스는 다른 pnpm 버전을 사용할 수 있습니다. 2026년 9월 6일 기준으로 이 Alpha의 정확한 npm 패키지와 릴리스 바이너리는 제공되지 않습니다. 아래에서 실제 검증한 소스 빌드는 $HOME/.dsh-themes/runtimes 아래의 독립 디렉터리를 사용합니다. 다른 프로젝트의 React 의존성을 잘못 불러오지 않도록 이 웹사이트 내부나 상위 경로에 node_modules가 있는 위치를 피하세요. 실행에 필요한 소스 디렉터리와 빌드 결과물은 보관하세요. 실행 후 작업 공간을 선택하고 설정 → 모델에서 자신의 모델을 구성하세요.

메시지 입력란을 사용할 수 없는 이유는 무엇인가요?

처음 실행한 Web UI에는 작업 공간이 선택되어 있지 않습니다. 프로젝트 디렉터리를 추가하고 선택한 다음 설정 → 모델에서 모델이 구성되어 있는지 확인하세요.

학습 계속하기

확인된 증거에서 계속하기

공개된 아티팩트를 비교하거나 설치 문서로 돌아가세요.