TabbitBlog

DeepSeek Chat Demo 로컬 실행 방법

공식 저장소에서 DeepSeek Chat Demo를 실행하고 호스팅 및 로컬 경로, API 키, 브라우저 저장, 데이터 흐름을 확인하세요.

이 글의 목차
  1. 핵심 요약
  2. 올바른 경로 선택
  3. 공식 저장소 실행
  4. 키와 데이터 흐름
  5. 문제 해결
  6. FAQ
  7. DeepSeek Chat Demo는 DeepSeek Chat과 같은가요?
  8. API 키 없이 쓸 수 있나요?
  9. 로컬 실행에 백엔드가 필요한가요?
  10. 채팅은 어디에 저장되나요?
  11. 내 API 키로 공개 배포해도 되나요?
  12. 출처

공식 DeepSeek Chat Demo 저장소는 브라우저에서 설정된 API 서비스에 직접 요청하는 정적 채팅 클라이언트입니다. 로컬 실행에는 Node.js 22.12 이상, pnpm, API 키가 필요합니다. 저장소를 복제하고 의존성을 설치한 뒤 개발 서버를 시작하세요. 이는 일반 사용자용 DeepSeek Chat 웹사이트 로그인과 다릅니다. 이 글은 2026년 11월 16일 확인한 공식 README와 API 문서에 근거하며, 키 입력이나 앱 실행은 하지 않았습니다.

핵심 요약

  • deepseek-ai/chat-demo는 오픈소스 프런트엔드이며 모델 호스팅 서비스나 완성형 서버 앱이 아닙니다.

  • 공식 온라인 데모와 GitHub 소스는 별도 경로입니다.

  • 로컬 실행에는 Node.js 22.12+, pnpm, 인터넷, API 키가 필요합니다. 기본 주소는 http://localhost:8090입니다.

  • 키와 설정은 localStorage, 대화와 원본 첨부 파일은 IndexedDB에 저장됩니다. 브라우저 키를 공개 서비스 비밀로 취급할 수 없습니다.

올바른 경로 선택

경로설명필요한 항목적합한 경우
DeepSeek Chat일반 사용자용 채팅 사이트. 현재 로그인 화면사이트 접근호스팅된 Chat 제품 사용. 계정 로그인은 API 키가 아닙니다.
공식 호스팅 데모DeepSeek가 공개한 프런트엔드데모와 API가 받는 키소스를 복제하지 않고 UI 체험.
로컬 저장소내 컴퓨터에서 실행할 프런트엔드 코드Node 22.12+, pnpm, 인터넷, 키참조 클라이언트 검토 및 수정.

11월 13일 공식 공지는 온라인 데모, 저장소, Build a Chatbot 가이드를 연결합니다. 모두 API 관련 자료입니다. API 빠른 시작에는 API 키가 필요합니다. Chat 로그인에 API 사용량이 포함되거나 요금과 데이터 처리가 같다고 가정하지 마세요.

README와 로컬 실행 명령이 보이는 공식 deepseek-ai chat-demo GitHub 저장소
README는 호스팅 데모와 로컬 소스 실행 절차를 구분합니다.

공식 저장소 실행

현재 README의 절차입니다. 이 글을 위해 명령을 실행하지 않았습니다.

  1. Node.js 22.12 이상과 pnpm을 설치한 뒤 node --version, pnpm --version으로 확인합니다.

  2. 저장소를 복제하고 폴더로 이동합니다.

    git clone https://github.com/deepseek-ai/chat-demo.git
    cd chat-demo
    pnpm install
    pnpm dev
  3. http://localhost:8090을 엽니다. 정적 프런트엔드만 제공하며 앱 백엔드는 시작되지 않습니다.

  4. Settings에 DeepSeek API 플랫폼에서 받은 키를 입력합니다. 공개 이슈, 공유 녹화, 소스 코드나 공개 클라이언트 설정에 키를 넣지 마세요.

  5. 민감하지 않은 질문을 보내고 답변을 확인합니다. 실패하면 키, API 엔드포인트와 선택 모델 권한을 확인하세요. 이 글은 가격, 계정 자격, 지역별 사용 여부를 검증하지 않았습니다.

README는 pnpm build로 dist/를 만들고 Release의 index.html을 직접 여는 방식도 설명합니다. file:// 저장과 교차 출처 요청은 브라우저와 API에 따라 달라지므로 처음에는 로컬 서버나 공식 데모를 권합니다. 예산은 DeepSeek API 가격 안내를 확인하세요.

키와 데이터 흐름

README에 따르면 키와 설정은 localStorage, 대화와 원본 첨부 파일은 IndexedDB에 저장되며 브라우저 프로필과 사이트 출처별로 분리됩니다. 메시지, 파일, 음성 기능의 내용은 API로 전송될 수 있습니다. 로컬 채팅을 지워도 이미 API에 업로드한 파일은 삭제되지 않습니다.

브라우저가 API에 직접 연결하므로 키는 해당 프로필의 클라이언트에서 사용됩니다. 개인 테스트에는 편리하지만 공개 서비스의 키 보호에는 부족합니다. 공개 프런트엔드에 비공개 키를 넣지 마세요. 프로덕션에는 서버 측 자격 증명 관리, 접근 제어, 사용량 제한과 데이터 보존 규칙이 필요합니다. 공식 챗봇 안내는 API 기능 설명이지 보안 감사가 아닙니다.

목표시작 경로고려 사항
호스팅된 채팅 제품 사용DeepSeek Chat제품 로그인 필요, 저장소와 다름.
UI 빠르게 확인공식 데모API 자격 증명 필요.
코드 학습·수정저장소의존성과 브라우저 키를 관리.
공개 다중 사용자 앱API 문서와 자체 서버데모는 완성된 다중 사용자 서비스가 아님.

웹 검색이나 URL 읽기가 필요하면 공식 API 안내에서 기능을 확인하세요. 모델 호출만으로 전체 브라우저 에이전트 흐름이 되지는 않습니다. 도구 사용 추론, 연구 인용 확인, AI 브라우저 비교, 에이전틱 브라우저 설명, DeepSeek Harness 플러그인을 참고하세요.

문제 해결

  • pnpm을 찾을 수 없음: 공식 안내로 설치하고 새 터미널에서 확인합니다.

  • 페이지는 열리지만 응답이 없음: 키, 계정 권한, API 주소와 네트워크를 확인합니다.

  • Chat 비밀번호를 입력함: API 플랫폼에서 별도 키를 관리하세요.

  • 배포에 프런트엔드 키를 요구함: 공개하지 말고 서버에서 관리합니다. 로컬 웹앱 검증도 참고하세요.

  • 오류를 공유해야 함: 비밀을 제거하고 버전, 브라우저, endpoint, 모델을 기록한 뒤 인용 검토 방법처럼 출처를 확인합니다.

명령줄 브라우저 제어는 agent-browser CLI 튜토리얼도 참고하세요.

FAQ

DeepSeek Chat Demo는 DeepSeek Chat과 같은가요?

아닙니다. Chat 웹사이트는 소비자 제품이고, 저장소는 설정된 API를 호출하는 프런트엔드입니다.

API 키 없이 쓸 수 있나요?

README는 첫 채팅 전에 Settings에 키를 입력하도록 안내합니다. Chat 웹사이트 로그인이 이를 대신하지 않습니다.

로컬 실행에 백엔드가 필요한가요?

아닙니다. 개발 서버가 정적 UI를 제공하고 브라우저가 API에 직접 연결합니다.

채팅은 어디에 저장되나요?

키와 설정은 localStorage, 대화와 첨부 파일은 IndexedDB에 저장됩니다. 요청 데이터는 설정된 API로 전송됩니다.

내 API 키로 공개 배포해도 되나요?

공개 클라이언트에 비공개 키를 넣지 마세요. 프로덕션에는 서버 측 키 관리와 접근 제어가 필요합니다.

출처

2026년 11월 16일 확인: 공식 README, package scripts, API 설정, API 빠른 시작, Build a Chatbot, 11월 13일 공지. Reddit, X, YouTube를 확인했지만 기준에 맞는 사용자 의견을 검증하지 못해 초안으로 남깁니다.

자주 묻는 질문

DeepSeek Chat Demo와 DeepSeek Chat은 같은 제품인가요?

아닙니다. chat.deepseek.com은 일반 사용자용 제품입니다. chat-demo 저장소는 설정된 API 서비스로 요청을 보내는 프런트엔드이며 호스팅 데모는 별도 체험 경로입니다.

API 키 없이 데모를 사용할 수 있나요?

공식 README는 첫 채팅 전에 Settings에 API 키를 입력하도록 안내합니다. 소비자 웹사이트 로그인은 별도 서비스이며 API 키를 대신하지 않습니다.

로컬 실행에 백엔드가 필요한가요?

개발 명령은 정적 프런트엔드를 제공하므로 앱 백엔드는 필요하지 않습니다. 브라우저가 설정된 API 서비스에 직접 연결됩니다.

채팅과 설정은 어디에 저장되나요?

README는 키와 설정을 localStorage에, 대화와 원본 첨부 파일을 IndexedDB에 저장한다고 설명합니다. 요청 데이터는 설정된 API 서비스로 전달됩니다.

내 API 키로 고객에게 데모를 공개해도 되나요?

공개 클라이언트에 비공개 키를 노출하지 마세요. 브라우저 저장과 직접 API 호출은 개인 평가에 적합하며 프로덕션에는 서버 측 키 관리와 접근 제어가 필요합니다.

다음 단계

Tabbit 과 함께 일하세요.

탭 간 조사를 하고, 반복적인 브라우저 작업을 자동화하며, 모든 맥락을 손이 닿는 곳에 두세요.