DeepSeek GUI: 높은 토큰 ROI를 추구하는 DeepSeek 모델 로컬 AI 에이전트 작업대

9bow · 6월 14, 2026, 2:30오전

DeepSeek GUI 소개

DeepSeek GUI는 터미널 안에서만 쓰던 AI 에이전트 경험을 데스크톱 앱으로 옮겨, DeepSeek 모델을 실제 프로젝트 작업에 안정적으로 투입하려는 로컬 작업대입니다. 작업 디렉토리를 고르고 작업을 시작하면 추론 과정과 도구 호출, 파일 변경이 실시간으로 흘러나오고, 민감한 동작은 필요할 때 승인하거나 되돌릴 수 있습니다. 개발자와 AI를 자주 쓰는 사용자가 명령줄에 머무르지 않고도 에이전트와 함께 일할 수 있도록 만든 것이 목표입니다.

이 프로젝트의 핵심은 또 하나의 채팅 껍데기를 만드는 것이 아니라, Kun 이라는 단일 로컬 런타임 위에서 동작한다는 점입니다. 개발팀은 Kun의 가장 큰 장점으로 "높은 토큰 ROI(token ROI)" 를 내세웁니다. 같은 컨텍스트 예산을 반복되는 프롬프트 접두부나 거대한 도구 목록, 통제되지 않는 출력에 덜 쓰고, 작업을 실제로 진전시키는 정보에 더 쓴다는 설계 방향입니다. 단발성 질문보다는 프로젝트를 읽고 쓰며 도구를 반복 호출하고 긴 세션 동안 맥락을 이어가는 실제 워크플로에 맞춰져 있습니다.

Kun이라는 이름은 "북쪽 바다에 물고기가 있으니 그 이름이 곤(鯤)이다" 라는 장자(莊子)의 구절에서 따왔습니다. 임시 채팅 셸이 아니라 더 긴 맥락과 풍부한 도구, 지속적인 프로젝트 협업을 감당하는 깊이 있는 로컬 런타임을 지향한다는 의미입니다. DeepSeek GUI는 이 런타임을 데스크톱 앱으로 감싸 자동 시작·관리하고, 다중 세션 채팅 작업대와 파일 변경 검토 화면, 설정·로그·업데이트 입구를 함께 제공합니다.

DeepSeek GUI의 두 작업대: Code 모드와 Write 모드

DeepSeek GUI는 Code 와 Write 라는 두 작업대를 중심으로 구성되며, 같은 Kun 런타임과 설정을 공유하되 세션·작업 공간·레이아웃은 분리해 작업 종류에 따라 전환할 수 있습니다.

Code 모드는 실제 코드베이스를 위한 개발 작업대입니다. 로컬 프로젝트 디렉토리를 연결해 파일을 읽고 편집하며 명령을 실행하고 변경을 검토합니다. 작업 공간별로 여러 에이전트 세션을 정리하고, 추론·도구 호출·파일 변경을 한 화면에서 스트리밍으로 봅니다. 인라인 diff와 변경 검토 패널, 읽기 전용부터 전체 접근까지의 권한 모드를 제공하며, 새 요구사항 초안과 /plan, 우측 Plan 패널, 스레드 todo, /goal 이 복잡한 작업을 명확화에서 계획, 실행으로 이어줍니다. /review 는 커밋되지 않은 변경이나 기준 브랜치 diff, 특정 커밋을 검토하고 결과를 검토 카드로 보여줍니다.

Write 모드는 코드·채팅 작업대와 분리된 마크다운 글쓰기 전용 공간입니다. ~/.deepseekgui/write_workspace 와 사용자 정의 작업 공간을 왼쪽 파일 트리에서 관리하고, Live / Source / Split / Preview 보기를 전환하며 글을 씁니다. 현재 문서를 도구 모음에서 HTML / PDF / DOC / DOCX 로 내보낼 수 있고, DeepSeek FIM 기반의 짧은 완성·영감 완성, 선택 영역 기반 인라인 에이전트 동작, 우측 글쓰기 어시스턴트(요약·개요·다듬기)를 함께 씁니다.

Kun 런타임이 토큰 ROI를 높이는 방식

Kun은 토큰 절약을 사후 보정이 아니라 에이전트 루프의 기본 동작으로 만듭니다. 단순히 텍스트를 압축하는 데 그치지 않고, 매 호출 전에 어떤 정보가 컨텍스트에 들어갈 가치가 있는지를 판단합니다. 개발팀이 설명하는 네 가지 축은 다음과 같습니다.

캐시 우선 에이전트 루프(Cache-first agent loop): 시스템 프롬프트와 도구 스키마, 불변 접두부를 안정적으로 유지해 DeepSeek 네이티브 캐시 적중을 쉽게 만듭니다. 덕분에 긴 세션에서 같은 배경 정보에 반복 비용을 치르지 않습니다.
필요할 때만 도구 컨텍스트 제공: MCP 도구 목록이 클 때 매 턴마다 전체 도구 스키마를 프롬프트에 넣는 대신, mcp_search 로 관련 도구를 먼저 찾고 mcp_describe 와 mcp_call 로 대상 도구만 설명·호출합니다.
컨텍스트 위생(Context hygiene): 지나치게 긴 도구 결과, 긴 인자, base64 페이로드, 반복되는 도구 루프, 가치가 낮은 이력은 경계를 두어 압축하되, 코드·경로·오류·결정·미해결 과제는 보존합니다.
보이는 사용량 절감: 런타임이 캐시 적중/실패와 토큰 사용량, 절감 추정치를 추적하고, GUI가 이 토큰 이코노미(token economy)의 이득을 표시해 비용 대비 효과를 장기간 관찰할 수 있게 합니다.

개발팀은 이 캐시 우선 설계가 Reasonix 프로젝트에서 검증된 참조 구현을 빌려온 것이라고 밝히고 있으며, 불변 프롬프트 접두부(sha256 지문), 추가 전용 세션 로그, TTL/LRU 캐시, 중단 가능한 승인 흐름 같은 특성의 설계 근거를 저장소의 docs/kun-architecture.md에 정리해 두었습니다. Kun의 확장 기능은 기능 플래그로 제어되어, MCP 연결(capabilities.mcp), 웹 패치·검색(capabilities.web), 스킬 탐색(capabilities.skills), 이미지 첨부(capabilities.attachments), 세션 간 기억(capabilities.memory), 위임된 하위 에이전트(capabilities.subagents)를 설정으로 켤 수 있습니다.

DeepSeek GUI의 휴대폰 연결과 예약 작업

DeepSeek GUI는 일반 데스크톱 채팅과 별개로 백그라운드 자동화를 함께 돌릴 수 있는 휴대폰 연결(Connect phone) 기능을 제공합니다. Feishu, Lark, WeChat 같은 채널마다 전용 에이전트를 프로필·기본 모델·작업 공간과 함께 구성하고, 각 IM 에이전트가 자기 스레드를 가져 GUI 안에서 응답과 도구 호출을 직접 디버깅할 수 있습니다. 팀 워크플로나 개인 자동화를 위한 로컬 웹훅·릴레이도 지원합니다. 예약 작업은 한 번, 매일, 일정 간격, 수동 중에서 고를 수 있고, 각 작업이 전용 Kun 스레드를 만들어 컴퓨터가 켜져 있는 동안 설정된 프롬프트를 실행합니다.

DeepSeek GUI 설치 및 사용법

미리 빌드된 패키지는 GitHub Releases에서 받을 수 있습니다. macOS는 .dmg 또는 .zip(Intel·Apple Silicon), Windows는 NSIS 기반 .exe(x64), Linux는 .AppImage(x64)를 제공합니다. 첫 실행 시 DeepSeek API 키를 입력하며, DeepSeek/OpenAI 호환 엔드포인트를 쓴다면 설정에서 사용자 정의 Base URL을 지정할 수 있습니다.

소스에서 직접 실행하려면 다음과 같이 빌드합니다. Node.js 20 이상과 DeepSeek API 키가 필요합니다.

git clone https://github.com/XingYu-Zhong/DeepSeek-GUI.git
cd DeepSeek-GUI
npm install
npm run dev

런타임 자체는 GUI 없이도 kun run, kun chat, kun exec 명령으로 실행할 수 있어, 데스크톱 앱과 명령줄 사용을 함께 활용할 수 있습니다. 설정은 설정 → Agent runtime 에서 바이너리 경로, 포트, 자동 시작, API 키, Base URL, 데이터 디렉토리, 모델, 승인 정책, 샌드박스 모드를 관리합니다.

DeepSeek GUI의 라이선스

DeepSeek GUI는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.

DeepSeek GUI 공식 홈페이지

DeepSeek GUI 프로젝트 GitHub 저장소

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다!
텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다.

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~