DeepSeek-TUI — 터미널에서 실행하는 DeepSeek 코딩 에이전트

DeepSeek-TUI — 터미널에서 실행하는 DeepSeek 코딩 에이전트

tags: AI,DeepSeek,코딩에이전트,터미널,Rust,LLM,개발도구

DeepSeek-TUI는 터미널에서 직접 실행되는 Rust 기반 코딩 에이전트입니다. 파일 읽기·편집, 셸 명령어 실행, Git 관리, 웹 검색, 병렬 서브에이전트 운영까지 가능합니다. 별도의 브라우저나 GUI 없이, 개발자의 커맨드라인 워크플로우 안에서 DeepSeek V4의 강력한추리 능력을 활용할 수 있습니다.

GitHub 스타 27,300개를 돌파하며 올해 가장 빠르게 성장한 오픈소스 AI 개발 도구 중 하나입니다.

---

핵심 특징: DeepSeek-TUI가 특별한 이유

1. Claude Code와 동일한Loop, 다른Economics

DeepSeek-TUI는 Claude Code나 Codex CLI와 동일한 코딩 에이전트 루프를 따릅니다. 에이전트가 코드를 읽고, 편집하고, 테스트를 실행하고, 결과를 보고하는 방식입니다. 다만 백본 모델이 DeepSeek V4 family라는 점이 결정적인 차입니다.

가장 주목할 만한 수치들:

• 1M 토큰 컨텍스트 윈도우 — Claude Code(~200K)의 5배

• 가격: Claude 대비 1~5% 수준 — DeepSeek V4 Pro 입력 토큰 100만 개에 $0.435 (캐시 미스 기준)

• 캐시 히트 입력 토큰 — 100만 개에 단 $0.003625

개발자 Hunter Bown이 만든 독립 프로젝트이며, DeepSeek 사와 무관합니다.

2. 세 가지 운영 모드: Plan · Agent · YOLO

DeepSeek-TUI는 자율 수준이 다른 세 모드를 제공합니다. TUI 안에서 Tab 키로 전환하거나,명령행 플래그로 지정할 수 있습니다.

모드	파일 읽기	파일 쓰기	명령어 실행	승인 필요
Plan	가능	불가	불가	없음 (읽기 전용)
Agent	가능	가능	가능	각 액션마다
YOLO	가능	가능	가능	없음 (자동 승인)

Plan 모드는 익숙하지 않은 코드를 탐색하거나, 에이전트에 작성 권한을 부여하기 전에 리포트를 받고 싶을 때 적합합니다. Agent 모드가일상공작의 중심이며, 각 도구 호출마다 승인대화프레임이 나타납니다. YOLO 모드는 검증된 저위험 작업(린터 실행, 정형화된 일괄 수정 등)에만 사용하는 것이 좋습니다.

3. RLM — 병렬추리의 Revolutionary한 구조

DeepSeek-TUI의 RLM(rlm_query) 기능은 가장 흥미로운 기술적 특징입니다. Pro 모델이 전략을 오케스트레이션하는 동안, 최대 16개의 cheap deepseek-v4-flash 자식 에이전트가 문제를 병렬로 분석합니다.

"Pro가 큰일을, Flash가 작은일을 한다"는 아키텍처입니다. 비싼 모델은 짧게 오케스트레이션만 하고, 싼 모델이 병렬로grunt work를 처리합니다. 코드베이스 전체 리팩토링, 멀티파일 버그 조사, 일괄 코드 리뷰에 이상적입니다.

4. 1M 토큰 컨텍스트 — 무엇이 가능한가

DeepSeek V4의 100만 토큰 컨텍스트는 기존 에이전트와 비교해 극명한 차이를 만듭니다. entire 코드베이스를 한 번에 메모리에 올리고 분석할 수 있습니다. 전체 리포지터리를 컨텍스트로 넘기면, "이 파일은 어떻게 연결되어 있나요?" 같은 질문에 별도의 리핏고소그녀 없이 즉시 답변합니다.

5. Skills 시스템 — Claude Code 스킬과 호환

DeepSeek-TUI의 Skills 시스템은 GitHub나 로컬 디렉터리에서 설치 가능한 명령어 팩입니다. SKILL.md 파일이 포함된 디렉터리 형태이며, 백엔드 서비스가 필요 없습니다.

스킬 검색 경로: .agents/skills → skills → .opencode/skills → .claude/skills → ~/.deepseek/skills

핵심: 기존 Claude Code 스킬을 수정 없이 그대로 사용할 수 있습니다. 해당 디렉터리에 심링크나 복사만 하면 됩니다.

# 커뮤니티 스킬 설치/skill install github:/# 새 스킬 스캐폴딩/skill new# 스킬 레지스트리 동기화/skills sync

6. 세션 관리와 롤백

매 턴마다 자동 스냅샷이 생성됩니다. side-git 메커니즘으로, project's .git 디렉터리를 건드리지 않으면서 작업 공간 상태를 추적합니다. 에이전트가 실수를 해도 /restore로 이전 스냅샷으로 롤백할 수 있습니다.

# 가장 최근 세션 재개deepseek resume --last# 저장된 모든 세션 목록deepseek sessions# 일괄 태스크용 자동 승인 모드deepseek --yolo "run cargo clippy and fix all warnings"

---

설치 방법 — 30초 만에 시작하기

npm (가장 간단)

npm install -g deepseek-tui

npm 패키지는 매칭되는 사전 빌드 바이너리를 다운로드하는 얇은 인스톨러입니다. Node.js 런타임 의존성이 도구 자체에 추가되지 않습니다.

Cargo (Rust 필수)

cargo install deepseek-tui-cli --locked# 또는cargo install deepseek-tui --locked

Rust 1.88+가 필요합니다.

그 외

• 바이너리 직접 다운로드: GitHub Releases 페이지에서 플랫폼별 바이너리 다운로드

• Windows: scoop install deepseek-tui

---

API 키 설정

첫 실행 시 DeepSeek API 키 입력을 요청합니다. 수동 설정도 가능합니다.

# API 키 저장deepseek auth set --provider deepseek# 환경 변수 방식export DEEPSEEK_API_KEY="sk-..."# 연결 확인deepseek doctor

API 키는 ~/.deepseek/config.toml에 저장됩니다. 프로젝트별 오버라이드는 /.deepseek/config.toml에 설정 가능하며, 보안상 api_key와 base_url은 프로젝트 수준에서 거부됩니다.

---

활용 시나리오

대규모 코드베이스 분석

코드베이스 전체를 탐색하고 아키텍처를 파악해야 할 때, Plan 모드로 리포트를 먼저 받습니다. 읽기 전용이므로 예기치 않은 파일 변경 걱정 없이 조사할 수 있습니다.

병렬 버그 조사

16개 Flash 서브에이전트를 동시에 떠 넣어, 여러 파일의 버그 원인을 동시에 분석합니다. RLM으로 구성하면 Pro 모델의 비용을 최소화하면서 병렬 분석의 깊이를 확보합니다.

반복적인 코드 수정 일괄 처리

YOLO 모드에서 검증된 린트 수정이나 정형화된 일괄 변경을 실행합니다. 작업 전에 /restore 포인트로 세션을 저장해 두면 문제가 생겼을 때 즉시 롤백할 수 있습니다.

자동화 워크플로우

# HTTP API 서버 모드로 실행 (헤드리스 워크플로우)deepseek serve --http

백그라운드 태스크를 지원하는 내구성 있는 태스크 큐가 포함되어 있어, 재시작 후에도 작업이 계속됩니다.

---

Claude Code와 비교

항목	DeepSeek-TUI	Claude Code
컨텍스트 윈도우	1M 토큰	~200K 토큰
입력 토큰당 비용	$0.435/1M (DeepSeek V4 Pro)	Claude보다 20~100배 비쌈
캐시 히트 비용	$0.003625/1M	—
지원 모델	DeepSeek V4 family, NIM, Fireworks, SGLang	Claude 모델 family
스킬 시스템	Claude Code와 호환	Claude Code 네이티브
개발 주체	독립 개발자 (Hunter Bown)	Anthropic (1차_party)

DeepSeek-TUI가 비용과 컨텍스트 길이에서 압도적이지만, Claude Code는 reasoning 깊이와 Anthropic 생태계 통합에서 우위입니다. 대규모 컨텍스트 작업이 필요한 경우 DeepSeek-TUI가 현명한 선택입니다.

---

요약

DeepSeek-TUI는 터미널에 코딩 에이전트를 가져오는 Rust 기반 도구입니다. 핵심을 정리하면:

• 27,300+ GitHub 스타 — 올해 가장 주목받는 오픈소스 AI 도구

• 1M 토큰 컨텍스트 — 코드베이스 전체를 한 번에 분석

• 3단계 운영 모드 (Plan/Agent/YOLO) — 작업 성격에 맞게 자율성 조절

• RLM 병렬추리 — Pro 비용으로 Flash 병렬 처리

• Claude Code 스킬 호환 — 기존 에이전트 자산을 그대로 활용

• 자동 세션 스냅샷/롤백 — 실패해도 안전

• DeepSeek V4 Pro 대비 Claude 1~5% 수준 비용

DeepSeek API 키만 있으면 30초 만에 설치하고 코딩을 시작할 수 있습니다. 대규모 리팩토링, 코드베이스 탐색, 반복 수정 작업에 관심이 있다면일시험해볼 가치 있습니다.

---

📚 출처

• DeepSeek TUI 공식 사이트

• GitHub - Hmbown/DeepSeek-TUI

• DeepSeek-TUI 완벽 가이드

---

📚 출처

• https://news.hada.io/topic?id=29447