DeepSeek Anleitung · Stand:
DeepSeek TUI verstehen und mit CodeWhale arbeiten
Wer nach DeepSeek TUI sucht, findet heute das weiterentwickelte CodeWhale-Projekt. Es ist ein unabhängig gepflegter Coding Agent für das Terminal. Hier erfahren Sie, was der Namenswechsel bedeutet, wie Sie einen DeepSeek-Zugang einrichten und welche Punkte bei älteren Installationen wichtig sind.
1. DeepSeek TUI und CodeWhale gehören zur selben Projektgeschichte
CodeWhale ging aus deepseek-tui hervor. Ältere Artikel, Befehle und Konfigurationsverzeichnisse verwenden deshalb weiterhin den DeepSeek-TUI-Namen. Die aktuelle Entwicklung liegt im Repository codewhale-hq/Codewhale; ältere GitHub-Adressen können dorthin weiterleiten.
Das Projekt ist inzwischen anbieterneutral und kann mit unterschiedlichen gehosteten oder lokalen Modellen arbeiten. Für eine neue Einrichtung verwenden Sie die aktuelle CodeWhale-Dokumentation und deren Paketnamen. DeepSeek bleibt ein möglicher Modellanbieter, ist aber nicht der Hersteller dieses unabhängigen Agenten.
Wenn Sie eine ältere Installation haben, identifizieren Sie zuerst das tatsächlich gestartete Programm. Ein alter Befehl auf PATH kann weiterhin auf eine andere Version zeigen als das gerade installierte Paket.
2. Was lokal läuft und was der Modellanbieter übernimmt
Der Agent arbeitet in Ihrem Projekt: Er kann Dateien lesen, Änderungen vorschlagen oder ausführen und Befehle starten. Das Sprachmodell wird über die ausgewählte Modellverbindung angesprochen. Bei einer direkten DeepSeek API-Verbindung verlassen die für die Anfrage verwendeten Inhalte den Rechner und werden beim Anbieter verarbeitet.
Die Installation der Terminaloberfläche lädt keine DeepSeek-Modellgewichte auf Ihren Rechner. Ein lokal gehostetes Modell ist eine separate Konfiguration mit eigenen Anforderungen. Wählen Sie bewusst, ob Sie den direkten DeepSeek-Zugang, einen anderen Provider oder einen lokalen Modellserver verwenden.
Für Ihre Entscheidung zählen die benötigten Arbeitsabläufe: ein einzelner Dateischritt, ein größerer Refactor oder wiederkehrende Aufgaben. Prüfen Sie erst einen kleinen Ablauf mit Ihrem Modell, bevor Sie zusätzliche Tools oder Automatisierungen einrichten.
3. Aktuelle Installation und Version prüfen
Für macOS und Linux dokumentiert das Projekt einen Installer über codewhale.net. Er installiert veröffentlichte Binärdateien; eine Beschreibung im Entwicklungszweig main kann bereits Funktionen einer noch nicht veröffentlichten Version enthalten. Vergleichen Sie daher die installierte Version mit der passenden Dokumentation.
Alternativ beschreibt das Projekt npm, Release-Downloads und einen Build aus dem Quellcode. Wählen Sie einen Weg. Mehrere parallele Installationen erschweren die Diagnose. Die Plattformdetails für Windows stehen in der verlinkten Installationsanleitung; verwenden Sie dort keine macOS-Befehle unverändert.
Nach der Installation helfen --version und doctor bei der Prüfung. Ein erfolgreicher Diagnoselauf ist noch kein Nachweis, dass der API key funktioniert oder eine kostenpflichtige Modellanfrage erfolgreich war.
curl -fsSL https://codewhale.net/install.sh | sh
# Anschließend in einem neuen Terminal:
codewhale --version
codewhale doctor4. Einen lokalen DeepSeek API key einrichten
Für eine direkte DeepSeek-Verbindung können Sie den Schlüssel über die lokale Authentifizierungsfunktion eingeben. Der Befehl fragt ihn interaktiv ab. Kontrollieren Sie danach den gemeldeten Status, ohne den Schlüssel auszugeben.
Ein CodeWhale-Konto mit dort gespeicherten Provider-Schlüsseln ist ein anderer Zugangsweg. Die folgenden Befehle verwenden den lokalen DeepSeek-Zugang und erfordern nicht, dass Sie Ihren Schlüssel zuerst in ein CodeWhale-Konto hochladen.
Wählen Sie in der Modell- und Provider-Auswahl der installierten Version DeepSeek sowie eine verfügbare Modell-ID. Für die aktuelle offizielle API heißen die Modelle deepseek-flash und deepseek-v4-pro. Bei einem anderen Anbieter oder Coding Plan sind dessen unterstützte Verbindung und gelieferte Modell-IDs maßgeblich.
codewhale auth set --provider deepseek
codewhale auth status --provider deepseek
cd /pfad/zu/ihrem/testprojekt
codewhale5. Mit einer kleinen Aufgabe im passenden Modus beginnen
Starten Sie in einem Testprojekt mit einem bekannten Ausgangszustand. Bitten Sie den Agenten zunächst, eine Datei zu erklären, und prüfen Sie die sichtbaren Lesevorgänge. Wechseln Sie erst danach zu einer kleinen Änderung mit klaren Akzeptanzkriterien.
Die aktuelle Dokumentation unterscheidet Plan, Work und Operate. Plan ist auf Planung und erlaubte Lesezugriffe ausgelegt; Work dient der Ausführung. Die Berechtigungsstufe ist eine eigene Einstellung. Prüfen Sie den tatsächlich angezeigten Modus und die Dokumentation Ihrer Version, statt aus dem Namen eine vollständige Schutzwirkung abzuleiten.
Begutachten Sie Änderungen im Diff und führen Sie die passenden Tests aus. Eine Antwort wie „fertig“ allein bestätigt nicht, dass die Aufgabe erfolgreich abgeschlossen wurde. Bewerten Sie das Ergebnis anhand der geänderten Dateien und der Testausgabe.
| Schritt | Was Sie prüfen |
|---|---|
| Verbindung | Kurze Modellantwort und passende Anfrage in den verfügbaren Nutzungsdaten. |
| Dateien lesen | Die Antwort bezieht sich auf tatsächlich gelesene Projektdateien. |
| Kleine Änderung | Nur die vereinbarte Aufgabe wurde umgesetzt; Diff kontrollieren. |
| Test | Passender Test lief wirklich, und seine Ausgabe stimmt mit dem Bericht überein. |
| Weitere Aufgaben | Erst nach diesem Ablauf Umfang und Tool-Zugriffe erweitern. |
6. Ältere Konfigurationen und PATH-Konflikte erkennen
CodeWhale berücksichtigt weiterhin Konfigurationen und Sitzungen aus der DeepSeek-TUI-Projektgeschichte. Alte Dateien können deshalb erklären, warum nach einer Neuinstallation noch ein anderer Schlüssel, Endpunkt oder Modellwert wirksam ist.
Vergleichen Sie aktuelle Verzeichnisse unter ~/.codewhale mit vorhandenen Altbeständen unter ~/.deepseek. Löschen oder verschieben Sie diese nicht pauschal. Prüfen Sie zuerst die Konfigurationsregeln Ihrer Version und sichern Sie benötigte Einstellungen, bevor Sie eine Migration vornehmen.
Wenn sich die Version unerwartet verhält, kontrollieren Sie auf macOS/Linux mit which -a codewhale und which -a deepseek alle gefundenen Programme. Unter Windows zeigt Get-Command codewhale -All passende Treffer. Aktualisieren Sie über den verwendeten Installationsweg und prüfen Sie danach erneut die Version.
7. Kosten, Datenschutz und Alternativen abwägen
Der Agent ist Open Source; ein kostenpflichtiger Modellanbieter kann trotzdem API-Gebühren berechnen. Bei mehreren Tool-Schritten und Wiederholungen zählt der gesamte Ablauf. Prüfen Sie außerdem die Telemetrie- und Kontoeinstellungen in der aktuellen Projektdokumentation.
Claude Code bietet einen anderen Terminalablauf, Claude Desktop eine grafische App und Hermes einen weiteren Agent-Ansatz. Vergleichen Sie diese Werkzeuge möglichst mit demselben Modell und derselben Aufgabe. Ein Tool-Wechsel und ein gleichzeitiger Modellwechsel lassen sich sonst schwer getrennt bewerten.
Wenn Sie vor allem DeepSeek Pro gegen Flash auswählen möchten, nutzen Sie den verlinkten Modellvergleich. Wenn Sie einen Coding Plan benötigen, prüfen Sie vorab API-Format, Endpunkt und Verfügbarkeit; nicht jedes Tool unterstützt jede gelieferte Verbindung auf dieselbe Weise.
Häufige Fragen
Sind DeepSeek TUI und CodeWhale zwei unabhängige Produkte?
CodeWhale ging aus deepseek-tui hervor und liest weiterhin ältere Konfigurationen und Sitzungen. Der aktuelle Projektname und die heutige Dokumentation sind CodeWhale.
Wird CodeWhale von DeepSeek entwickelt?
Nein. Das Projekt wird unabhängig gepflegt und ist inzwischen anbieterneutral. DeepSeek ist eine mögliche Modellverbindung.
Läuft DeepSeek nach der Installation lokal?
Nicht automatisch. Die Terminaloberfläche läuft lokal; mit einem DeepSeek API key verwenden Sie das gehostete Modell. Ein lokaler Modellserver muss separat eingerichtet werden.
Brauche ich ein CodeWhale-Konto für meinen lokalen API key?
Der dokumentierte lokale Authentifizierungsweg ist von kontobasierten Provider-Schlüsseln getrennt. Die Befehle in dieser Anleitung verwenden den lokalen Weg.
Warum ist trotz Neuinstallation noch eine alte Einstellung aktiv?
Prüfen Sie konkurrierende Programme auf PATH und aktuelle sowie ältere Konfigurationsverzeichnisse. Die aktive Version und die Quelle der Einstellung sind entscheidend.
Bedeutet doctor erfolgreich, dass meine API-Verbindung funktioniert?
Nein. Ergänzen Sie die lokale Diagnose durch eine kleine Modellanfrage und einen separaten Tool-Test.
Quellen
Passende Anleitungen
DeepSeek Coding Plans prüfen
Vergleichen Sie Preis, Nutzungsgrenzen und aktuellen Bestand. Bei einem Coding Plan gelten die mit dem Angebot gelieferten Zugangsdaten, Base URL und Modell-IDs. Ein Kauf ist nur bei verfügbarem Bestand möglich.
Preise und Verfügbarkeit ansehen