Windows에서 DeepSeek Harness: 경로·권한·터미널

Windows는 다른 제품이 아닙니다

Windows용 공식 DeepSeek Harness 데스크톱 설치 프로그램은 없습니다. Windows에서 DeepSeek Harness는 여전히 Node.js + npx @deepseek-ai/dsh web, 그리고 브라우저의 http://127.0.0.1:3080/입니다. 명령은 설치, npx 빠른 시작과 같습니다. 달라지는 것은 주변 환경: 어느 셸이 PATH를 갖는지, Git Bash/WSL에서의 경로 표기, 제어된 폴더 액세스가 쓰기를 조용히 막는지.

이 글은 Windows 전용 보완입니다. 프로세스가 바인드되지 않거나 3080이 점유됐다면 npx / 포트 3080 사다리로 가세요. OS 한 줄 설명을 다시 읽지 마세요.

정확한 플래그는 업스트림 몫입니다. 공식 README와 충돌하면 README가 이깁니다.

셸 하나를 고르고 그 PATH만 보세요

같은 PC에 PowerShell, Windows Terminal(PowerShell/cmd 탭), cmd, Git Bash, WSL이 공존합니다. 보이는 node는 서로 다를 수 있고 — 아예 없을 수도 있습니다.

1. 첫 한 시간에 쓸 셸을 정하세요. 문서에 맞추려면 PowerShell 또는 Windows Terminal의 PowerShell 탭.
2. 그 창에서만 node -v와 npm -v를 실행. 업스트림 프리뷰는 Node ^22.19.0 또는 >=24.0.0.
3. 여기엔 node가 없고 다른 창엔 있다면 PATH가 셸별로 갈라진 것입니다. 다른 창을 고쳐도 여기는 안 됩니다.
4. 섞지 마세요: PowerShell에서 Node를 설치하고, 아직 Node 18 PATH인 옛 Git Bash에서 npx를 돌리지 마세요.

Git Bash는 PATH가 맞으면 쓸 수 있지만 따옴표와 드라이브 표기가 다릅니다(D:\demo vs /d/demo). 첫 평가는 셸 하나에 고정하고 npx @deepseek-ai/dsh web가 로컬 URL을 찍을 때까지.

같은 창에서 Node가 보이게 설치

1. nodejs.org LTS 또는 winget install OpenJS.NodeJS.LTS(설치 Windows 한 줄).
2. 터미널을 닫았다가 다시 열기 — 설치 프로그램은 사용자 PATH를 갱신하지만 열린 탭은 옛 환경입니다.
3. npx를 돌릴 같은 셸에서 node -v 확인.
4. 버릴 수 있는 폴더(예: D:\scratch\dsh-demo)로 cd한 뒤:

npx @deepseek-ai/dsh web

터미널은 열어 두세요. 닫으면 로컬 서버가 멈춥니다. 회사 프록시 MITM은 제품 버그처럼 보입니다. 미러가 늦으면 공식 registry — 자세한 내용은 문제 해결.

경로, 워크스페이스, 제어된 폴더 액세스

에이전트는 UI에서 고른 루트만 봅니다. Windows에서는 일상 습관과 충돌합니다:

• 첫날은 고정 드라이브의 짧은 경로(D:\scratch\...)를 우선. OneDrive 동기화되는 깊은 Documents는 피하세요.
• 첫 세션을 사용자 프로필 전체에 두지 마세요. 홈에는 비밀·메일·클라우드가 섞여 있습니다.
• 제어된 폴더 액세스(Windows 보안 → 바이러스 및 위협 방지 → 랜섬웨어 보호)는 UI는 열리는데 쓰기가 실패/멈출 수 있습니다. 터미널은 멀쩡한데 “못 쓴다”면 편집기/Node 허용 여부를 보거나, 보호 밖 버릴 저장소로 먼저 시험하세요.
• 실행 정책은 주로 직접 짠 PowerShell 스크립트용 — npx 자체를 거의 막지 않습니다. 시험하려고 전역 Bypass를 켜지 마세요.

UI가 뜨면: 설정에 DeepSeek 플랫폼 API 키, 버릴 워크스페이스, 저위험 프롬프트(최상위 목록). 로컬 UI는 대개 제어면이며 기본 오프라인 가중치가 아닙니다.

포트 3080과 localhost 브라우저

기본 Web UI는 루프백 http://127.0.0.1:3080/. Windows에서 점유 확인:

netstat -ano | findstr :3080

작업 관리자에서 PID를 끝내거나 taskkill /PID <pid> /F, 또는 업스트림 포트 플래그. 첫 시험은 localhost — 0.0.0.0은 보안 결정입니다. 터미널은 멀쩡한데 빈 화면이면 깨끗한 브라우저 프로필; 확장 기능이 로컬 스크립트를 막을 수 있습니다.

WSL은 PATH와 파일에 대해 다른 머신입니다

WSL Ubuntu는 “친절한 Windows 프롬프트”가 아닙니다. Windows의 Node는 WSL에 자동으로 안 나오고 반대도 같습니다. WSL 안에서 DSH를 돌리면 워크스페이스는 Linux 파일 시스템에 — /mnt/c/...는 권한·성능 함정이 늘어납니다. 네이티브 PowerShell에 고정했다면 같은 디버깅에서 WSL Node를 쫓지 마세요.

이 글이 아닌 것

• 두 번째 전체 빠른 시작이 아님 — 서사는 npx 빠른 시작.
• 모든 실행 실패 결정 트리가 아님 — npx와 포트 3080.
• 비공식 “DeepSeek Harness Desktop” 래퍼 추천이 아님. 커뮤니티 런처는 같은 Node 서버의 선택적 껍데기일 뿐입니다.
• macOS 전용이 아님 — macOS에서 DeepSeek Harness.

다음에 갈 곳

1. OS 한 줄과 검증: 설치.
2. 첫 한 시간: npx 빠른 시작.
3. 증상 사다리: 문제 해결과 3080 글.
4. 돌린 뒤 모드를 고른 다음 커뮤니티 플러그인.