Meta açıklama: DeepSeek-TUI kurulum adım adım: iki zorunlu binary, API key ayarı, sağlayıcı seçimi (DeepSeek, NVIDIA NIM, Fireworks, SGLang), V4-Pro vs V4-Flash kararı ve ilk Plan, Agent, YOLO seansını çalıştırma — her tuzak açıklamasıyla.
Bu rehberin sonunda DeepSeek-TUI canlı bir DeepSeek V4 modeliyle çalışıyor olacak; iki binary'nin neden gerekli olduğunu ve birinin eksik olduğunda ne bozulduğunu anlayacak ve en az bir Plan, Agent ve YOLO seansını tamamlamış olacaksın. Rust zaten kurulysa yirmi dakika. Rust'ı ilk kez kuruyorsan otuz-kırk dakika.
Bir şeyi baştan netleştirmek gerekiyor: DeepSeek-TUI iki zorunlu binary ile geliyor. Kurulum sürtüşmesinin büyük kısmı bunu önceden bilmemekten kaynaklanıyor. Rehber bunu doğrudan ele alıyor.
Sonunda Çalışıyor Olacaklar
- Canlı bir V4 modeliyle çalışan DeepSeek-TUI (Pro veya Flash, seçim senin)
- Hiçbir dosya yazmadan bir repo'yu keşfeden eksiksiz bir Plan seansı
- Araç çağrısı onay kapılarıyla bir Agent seansı
- Otomatik onaylı bir YOLO seansı (ve ne zaman kullanılmaması gerektiğine dair net anlayış)
- En az bir skill kurulu ve bir MCP server doğrulanmış
Ön Koşullar
Rust 1.85+ (Cargo yolu için) veya Node.js 18+ (npm yolu için)
Rust versiyonunu kontrol et:
rustc --version
# Gerekli: rustc 1.85.0 veya üstü
# Eksik veya eski: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | shKaynaktan derleme yerine npm tercih ediyorsan Node.js 18+ yeterli. npm paketi GitHub Releases'den önceden derlenmiş binary'leri indiriyor — hiçbir şey derlenmeyecek.
DeepSeek API key'i
platform.deepseek.com'a kaydol, kredi ekle ve API key'ini kopyala. Minimum yatırım 5 dolar. Key'i hazır tut — kimlik doğrulama adımında ayarlayacaksın.
DeepSeek API'sini doğrudan kullanmıyorsan alternatifler: NVIDIA NIM ve Fireworks AI her ikisi de DeepSeek V4 host ediyor. Self-hosted için SGLang çalışıyor. Sağlayıcı kurulumu aşağıdaki Sağlayıcı Seçimi bölümünde.
Terminal notları
macOS/Linux: Her modern terminal çalışıyor. TUI alternate-screen modunda tam ekranı devralıyor.
WSL: Destekleniyor. Alternate-screen modunu temiz işleyen bir terminal kullan (Windows Terminal iyi çalışıyor; eski ConEmu varyantlarında render sorunları olabilir).
PowerShell/Windows native: v0.8.8'den itibaren destekleniyor. Scoop ile kur (scoop install deepseek-tui) veya önceden derlenmiş binary'leri doğrudan indir.
Kurulum Yolu A — Cargo (Her İki Crate Zorunlu)
Bu kaynak derleme yolu. Daha uzun sürer ama tam platformuna optimize edilmiş binary'ler üretir.
# Adım 1: dispatcher'ı kur (`deepseek` komutunu sağlar)
cargo install deepseek-tui-cli --locked
# Adım 2: runtime'ı kur (`deepseek-tui` komutunu sağlar)
cargo install deepseek-tui --locked
# Her ikisinin PATH'inde olduğunu doğrula:
deepseek --version
deepseek-tui --version--locked'ı atlama. Bağımlılık versiyonlarını lockfile'a sabitler. Olmadan Cargo, derlenen ama çalışma zamanında yanlış davranan uyumsuz geçişli bağımlılıklar çekebilir.
Her iki binary neden gerekli (MISSING_COMPANION_BINARY açıklaması)
deepseek (deepseek-tui-cli'dan): dispatcher — kimlik doğrulama, config, model seçimini üstlenir, ardından gerçek agent runtime ve TUI için deepseek-tui'ye devreder. deepseek-tui PATH'inde yokken deepseek çalıştırırsan şunu görürsün:
Error: MISSING_COMPANION_BINARY
The `deepseek-tui` binary was not found. Both binaries must be installed.Yalnızca deepseek-tui'yi dispatcher olmadan kurmak tersi sonucu üretir — TUI binary'sini doğrudan başlatabilirsin ama temiz giriş noktasını, kimlik doğrulama yönetimini ve config iletimini kaybedersin. Her ikisini de kur.
Kurulum Yolu B — npm Wrapper
npm yolu GitHub Releases'den önceden derlenmiş Rust binary'lerini indiriyor. Derleme yok. Kurulum sırasında Node.js 18+ gerekiyor, ama çalışma zamanında değil — binary'ler native çalıştırılabilirler.
npm install -g deepseek-tuiPostinstall script'i platformun için doğru binary çiftini indiriyor, SHA-256 manifest'ini doğruluyor ve hem deepseek'i hem de deepseek-tui'yi PATH'ine yerleştiriyor.
npm ne zaman tercih edilir
- Rust kurulu değil ve kurmak istemiyorsun
- Derlemenin yavaş veya kısıtlı olduğu bir makinedeysin
- En hızlı çalışan kurulumu istiyorsun
Çin anakarası notu: Yavaş indirmeleri önlemek için registry mirror ekle:
npm install -g deepseek-tui --registry=https://registry.npmmirror.comKurulum Yolu C — Önceden Derlenmiş Binary'ler
GitHub Releases'den doğrudan indir. Hem deepseek hem de deepseek-tui binary'leri platformun için indirilmeli ve PATH'teki aynı dizine yerleştirilmeli.
Mevcut platformlar: Linux x64, Linux ARM64, macOS x64, macOS ARM64 (Apple Silicon), Windows x64.
SHA-256 doğrulaması
# Binary'lerinin yanında manifest'i indir:
curl -L -o /tmp/deepseek-artifacts-sha256.txt \
https://github.com/Hmbown/DeepSeek-TUI/releases/latest/download/deepseek-artifacts-sha256.txt
# Linux:
( cd ~/.local/bin && sha256sum -c /tmp/deepseek-artifacts-sha256.txt --ignore-missing )
# macOS:
( cd ~/.local/bin && shasum -a 256 -c /tmp/deepseek-artifacts-sha256.txt --ignore-missing )Mirror URL (DEEPSEEK_TUI_RELEASE_BASE_URL)
GitHub Releases ağından yavaşsa:
export DEEPSEEK_TUI_RELEASE_BASE_URL=https://mirror.example.com/releases
npm install -g deepseek-tui # npm indirici bu env var'ı takip ederİlk Çalıştırma Kimlik Doğrulaması
# DeepSeek API key'ini ayarla:
deepseek auth set --provider deepseek --api-key "DEEPSEEK_API_KEY'IN"
# Saklandığını doğrula:
deepseek auth statusConfig nerede duruyor?
~/.deepseek/config.tomlConfig dosyası dispatcher ve TUI runtime arasında paylaşılıyor. deepseek auth set --api-key ... deepseek-tui'nin doğrudan okuduğu api_key alanına yazıyor.
Ortam değişkeni alternatifi
Kimlik bilgilerini diske yazmayı tercih etmiyorsan:
export DEEPSEEK_API_KEY="api-key'in"
deepseek # env var'ı otomatik olarak alırCI/CD pipeline'ları veya Docker ortamları için env var enjeksiyonu doğru yaklaşım. Config dosyası yolu kullanıcı home tabanlı ve container'lı bağlamlarda varsayılan olarak mevcut değil.
Sağlayıcı Seçimi
Doğrudan DeepSeek (varsayılan)
deepseek auth set --provider deepseek --api-key "KEY'İN"
deepseek # varsayılan olarak api.deepseek.com kullanırNVIDIA NIM
deepseek auth set --provider nvidia-nim --api-key "NVIDIA_KEY'İN"
deepseek --provider nvidia-nimNIM bazı yapılandırmalarda belirli bir base URL gerektirir. NIM'e özgü ayarlar için repo'daki docs/CONFIGURATION.md'ye bak.
Fireworks AI
deepseek auth set --provider fireworks --api-key "FIREWORKS_KEY'İN"
deepseek --provider fireworks --model accounts/fireworks/models/deepseek-v4-proSelf-hosted SGLang
# SGLang yerel çalışıyor — varsayılan olarak API key gerekmez
deepseek --provider sglang # localhost:30000/v1 varsayarÖzel bir SGLang base URL için ~/.deepseek/config.toml'da [profiles.sglang] altında ayarla.
Model Seçimi — V4-Pro mu V4-Flash mi?
deepseek --model deepseek-v4-pro # amiral gemisi, daha yüksek maliyet, derin akıl yürütme
deepseek --model deepseek-v4-flash # daha hızlı, ucuz, hafif akıl yürütmeConfig'de varsayılanı da ayarlayabilirsin:
# ~/.deepseek/config.toml
default_text_model = "deepseek-v4-flash"Hangisini ne zaman varsayılan yapmalı?
V4-Flash varsayılanı yap:
- Ne soracağını çözdüğün keşif seansları
- Çalışma başına maliyetin önemli olduğu yüksek hacimli agentic döngüler
- RLM subagent child'ları (Flash, RLM varsayılanı ve bu bilinçli)
V4-Pro'ya geç:
- Akıl yürütme derinliğinin önemli olduğu karmaşık çok dosyalı refactoring'ler
- Flash'ta yanlış varsayımlarla başarısız olan görevler
- Kapsamlılığın maliyeti geride bıraktığı mimari ve tasarım seansları
Her Modda İlk Seansını Çalıştır
Plan modu — yazmadan repo keşfi
Plan modu agent'ı okuma işlemleriyle kısıtlıyor. Dosya yazma yok, shell yürütme yok. Agent'ın ne yapacağını yapmadan önce anlamak için kullan.
deepseek plan "Bu repo'nun yapısını açıkla ve ana giriş noktalarını tespit et"Ya da TUI'yi başlatıp seans içinde geçiş yap:
deepseek # TUI'yi aç
# sonra: Plan modunu açmak/kapatmak için Shift+TabPlan modunda agent dosyaları okuyor, codebase'i arıyor ve yapılandırılmış bir analiz döndürüyor. Çalışma ağacında hiçbir şey değişmiyor. Agent seansına geçmeden önce ilk geçiş olarak kullan.
Agent modu — onaylarla varsayılan döngü
Agent modu varsayılan. Durumu değiştiren her araç çağrısı açık onayını gerektiriyor.
deepseek # varsayılan olarak Agent modunda açılırTUI içinde çalışmadan önce her önerilen araç çağrısını göreceksin:
┌─ Araç Çağrısı ────────────────────────────────┐
│ bash: git diff HEAD~1 --stat │
│ [A]onayla [S]kip [D]üzenle [Ç]ık │
└───────────────────────────────────────────────┘Minimal bir ilk seans:
> README'yi oku ve projenin amacını üç cümleyle özetleAgent README'de read_file çağıracak. Onay prompt'unu göreceksin. A basarak onayla. Agent özetiyle yanıt verir. Hiçbir dosya yazılmaz.
YOLO modu — ne zaman (ve ne zaman kullanılmamalı)
YOLO modu tüm araç çağrılarını prompt'suz otomatik onaylıyor.
deepseek --yolo # YOLO modunda başlatYa da seans içinde geçiş yap (klavye kısayolu versiyona göre değişiyor — TUI'deki footer key binding'lerini kontrol et).
YOLO ne zaman uygun: Görev kapsamını zaten incelediğin güvenilir workspace'ler, agent iyi tanımlanmış ve daha önce çalıştığını gördüğün bir görevi yürütüyor ve kesintisiz yürütme istiyorsun.
YOLO ne zaman uygun değil: git commit, dosya silme, ağ istekleri veya incelemediğin yan etkileri olan shell komutlarını içeren her görev. YOLO onay kapısını tamamen atlıyor — agent bir şeyi rm -rf yapmaya ya da commit atmaya karar verirse yapar. v0.8.8'deki bir bug düzeltmesi özellikle workspace güven kontrolü olmadan YOLO'nun git -C ...'ı otomatik onayladığını ele aldı; bu bug sınıfını tanımadık görevlerde YOLO modunda çalışırken aklında bulundur.
Skill'ler ve MCP Server'lar Ekleme
Community skill'i kur
# GitHub'dan kur (backend servisi gerekmez):
/skill install github:owner/repo-name
# Kurulu skill'leri listele:
/skills
# Geçerli seans için bir skill etkinleştir:
/skill skill-adimDeepSeek-TUI aynı zamanda workspace dizinlerinden skill'leri otomatik keşfediyor. Claude Code kullanımından .claude/skills/ dizinin varsa o skill dosyalarını da bulacak.
MCP server kur
# MCP dizin yapısını başlat:
deepseek-tui mcp init
# MCP server bağlantısını doğrula:
/mcp validateMCP server'lar ~/.deepseek/config.toml'da [mcp.servers] altında yapılandırılıyor. Server girdisi ekledikten sonra TUI'yi yeniden başlat ve bağlantıyı onaylamak için /mcp validate çalıştır.
Yaygın Hatalar ve Düzeltmeler
MISSING_COMPANION_BINARY
Error: MISSING_COMPANION_BINARYDüzeltme: Eksik binary'yi kur. deepseek kurulu ama deepseek-tui yoksa:
cargo install deepseek-tui --locked
# veya: npm install -g deepseek-tui (her ikisini yeniden kurar)Her iki binary de aynı dizinde ya da PATH'te olmalı. npm aracılığıyla kurmak bunu otomatik halleder; Cargo varsayılan olarak ~/.cargo/bin/'a kurar, yani her ikisi doğru yere gider.
aarch64 / arm64 uyumsuzluğu (eski sürümlerde)
Linux ARM64'tesin ve npm installer'dan Unsupported architecture: arm64 görüyorsan:
Error: Unsupported architecture: arm64Bu v0.8.7 ve öncesini etkiliyor — Linux ARM64 önceden derlenmiş binary yayımlanmıyordu. Düzeltme: v0.8.8 veya sonrasına güncelle (hem deepseek-linux-arm64 hem de deepseek-tui-linux-arm64 yayımlanıyor), ya da kaynaktan derle:
git clone https://github.com/Hmbown/DeepSeek-TUI.git
cd DeepSeek-TUI
cargo install --path crates/cli --locked
cargo install --path crates/tui --lockedAlt shell'lerde API key alınmıyor
DEEPSEEK_API_KEY'i shell'inde ayarladın ve TUI başlarken tanınmıyor:
# Var'ın export edilip edilmediğini kontrol et (sadece set değil):
echo $DEEPSEEK_API_KEY
# Boşsa, düzgün export et:
export DEEPSEEK_API_KEY="key'in"
# Ya da oturumlar arası kalıcı için auth komutunu kullan:
deepseek auth set --provider deepseek --api-key "key'in"Config dosyası yaklaşımı terminal oturumları, shell'ler ve kendi alt process'lerini başlatan editörler genelinde daha güvenilir.
Self-updater arch-name bug'ı (v0.8.x uyarısı)
v0.8.7 civarındaki sürümlerdeki self-updater, release asset adlandırma kuralı (arm64, x64) yerine ham Rust mimari sabitlerini (aarch64, x86_64) kullandı. Bu, ARM64 sistemlerde self-update'in "binary bulunamadı" hatasıyla başarısız olmasına yol açtı. Düzeltme v0.8.8'de geldi (update.rs artık release asset adlandırmasını kullanıyor).
deepseek update bir asset resolution hatasıyla başarısız olursa, orijinal kurulum komutunu yeniden çalıştırarak veya doğrudan GitHub Releases'den indirerek manuel güncelle.
Sık Sorulan Sorular
Gerçekten hem deepseek hem de deepseek-tui binary'lerine ihtiyacım var mı?
Evet. Birbirinin yerine geçmiyorlar. deepseek dispatcher (kimlik doğrulama, config, model seçimi) ve deepseek-tui runtime (TUI render, agent döngüsü, araç yürütmesi). Dispatcher açıkça runtime'a devreder; herhangi birini yalnız çalıştırmak başlangıçta başarısız olur.
OpenAI veya Anthropic'e yönlendirebilir miyim?
Hayır. Desteklenen sağlayıcılar — doğrudan DeepSeek, NVIDIA NIM, Fireworks, SGLang — hepsi DeepSeek modellerini sunuyor. Araç genel amaçlı bir OpenAI uyumlu wrapper değil. Claude veya GPT-5.5'i backend olarak istiyorsan Claude Code veya model-agnostic bir agent kullan.
Seans ortasında model nasıl değiştirilir?
Başlangıçta deepseek --model flag'i aracılığıyla ya da farklı bir modelle yeniden başlatarak. TUI şu an yeniden başlatmadan aktif modeli değiştirmek için /model slash komutu sunmuyor. V4-Flash'ı varsayılan olarak kullan ve derin akıl yürütme gerektiren görevler için --model deepseek-v4-pro ile yeniden başlat.
Seanslar ve snapshot'lar nerede saklanıyor?
~/.deepseek/sessions/ # seans meta verisi ve transkriptler
~/.deepseek/state/ # runtime durumu, checkpoint'ler dahil
~/.deepseek/memory/ # proje belleği (context sıfırlamalarından sağ kurulur)Önceki bir seansı devam ettirmek için deepseek-tui resume kullan. Snapshot'tan bir seansı fork'lamak için deepseek-tui fork kullan.
VS Code'un entegre terminali içinde çalışıyor mu?
Evet, ama uyarılarla. Alternate-screen TUI, macOS ve Linux'ta VS Code entegre terminalinde düzgün render ediyor. VS Code entegre terminali aracılığıyla Windows çalışıyor ama scroll yakalama çakışmaları olabilir — TUI varsayılan olarak mouse girişini yakalıyorsa (tui.mouse_capture = true) ve VS Code'un terminal geri kaydırmasını kullanmak istiyorsan devre dışı bırak:
# ~/.deepseek/config.toml
[tui]
mouse_capture = falseYa da başlangıçta --no-mouse-capture geç.
Net konuşmak gerekirse: iki binary meselesi önceden bilinince kurulum düşündüğünden çok daha kısa. npm yolu en hızlısı; Cargo yolu platform optimize edilmiş binary'ler üretir. V4-Flash'ı varsayılan yap, derinlik gerektiğinde Pro'ya geç ve YOLO'yu yalnızca görev kapsamını baştan gördüğün workspace'lerde kullan.
İyi kodlamalar.
