Zum Inhalt

Aktualisiert 2026-10-13

DeepSeek TUI wird mit dem aktuellen CodeWhale-Befehl eingerichtet

DeepSeek TUI und CodeWhale bezeichnen dasselbe Terminal-Projekt für Coding-Agenten. CodeWhale ist der aktuelle Paket- und Befehlsname; verwenden Sie ihn für neue Installationen. Diese Anleitung führt durch Installation, API-Schlüssel, Prüfung des Programmpfads und der Konfiguration, den ersten Start im Repository und die Fehlerdiagnose. Die verlinkte Projektübersicht ergänzt Informationen zu Namen, Kompatibilität, Funktionen und Grenzen.

1. Ein Installationsweg genügt für das aktuelle CodeWhale

Für viele Nutzer mit Node.js ist der npm-Wrapper der einfachste Einstieg. Er lädt die kompilierten Release-Dateien codewhale und codew herunter. Die aktuelle Anwendung führt die TUI im selben Prozess aus. Alternativ installiert Cargo das Paket codewhale-cli mit einer aktuellen Rust-Toolchain; das separate Paket codewhale-tui ist nicht mehr erforderlich.

Wählen Sie genau einen Installationsweg. Für Homebrew und plattformspezifische Schritte verwenden Sie die aktuelle Installationsanleitung des Projekts. Alte DeepSeek-TUI-Befehle sind kein verlässlicher Ausgangspunkt für eine neue Einrichtung.

# Option 1: npm
npm install -g codewhale

# Option 2: Cargo (anstelle von npm)
cargo install codewhale-cli --locked

codewhale --version

Quellen

2. Der Programmpfad zeigt konkurrierende Installationen

Prüfen Sie vor der Konfiguration alle passenden Befehle im PATH. Nach einem Umstieg von DeepSeek TUI können deepseek, deepseek-tui oder ein alter Wrapper weiterhin vor der aktuellen CodeWhale-Datei gefunden werden.

Paket und ausführbare Datei sollten aus derselben unterstützten Version stammen. Wenn npm und Cargo beide CodeWhale installiert haben, entfernen Sie die nicht mehr benötigte Installation mit dem jeweiligen Paketmanager. Öffnen Sie danach ein neues Terminal und prüfen Sie die Version erneut.

which -a codewhale
which -a deepseek 2>/dev/null || true
codewhale --version
npm -g ls codewhale 2>/dev/null || true
cargo install --list | grep -E "codewhale|deepseek" || true
codewhale doctor

3. Die aktive Schlüsselquelle entscheidet über die API-Anmeldung

In dieser Einrichtung arbeitet CodeWhale als API-Client. Speichern Sie Ihren DeepSeek-Schlüssel mit dem auth-Befehl oder setzen Sie DEEPSEEK_API_KEY in der Shell, die den Agenten startet. auth status zeigt die aktive Quelle an, ohne den vollständigen Schlüssel auszugeben.

Gespeicherte Einstellungen können eine Umgebungsvariable übersteuern. Prüfen Sie deshalb vor einem Schlüsselwechsel auth status --provider deepseek. doctor kontrolliert die lokale Konfiguration; doctor --probe-api prüft zusätzlich die Verbindung zum Anbieter und kann API-Kosten verursachen. Eine erfolgreiche lokale Prüfung bestätigt keinen gültigen API-Schlüssel.

codewhale auth set --provider deepseek
codewhale auth status --provider deepseek
codewhale doctor --probe-api

# Alternative: Umgebungsvariable
export DEEPSEEK_API_KEY="sk-..."
codewhale auth status --provider deepseek
codewhale doctor --probe-api

# Einen gespeicherten Schlüssel vor dem Wechsel entfernen
codewhale auth clear --provider deepseek

4. Alte Konfigurationsdateien können weiter wirksam sein

Neue CodeWhale-Konfigurationen liegen unter ~/.codewhale/config.toml. Für die Migration wird weiterhin die ältere Datei ~/.deepseek/config.toml unterstützt. Das kann erklären, warum nach einer neuen Paketinstallation ein alter Schlüssel oder Endpunkt verwendet wird.

Projektspezifische Einstellungen liegen im Verzeichnis .codewhale des Repositorys. Kopieren Sie keine geheimen API-Schlüssel in Projektdateien oder Git. Vergleichen Sie bei unerwartetem Verhalten beide Benutzerverzeichnisse und kontrollieren Sie mit auth status die aktive Schlüsselquelle.

ls -la ~/.codewhale 2>/dev/null || true
ls -la ~/.deepseek 2>/dev/null || true
codewhale auth status --provider deepseek
codewhale doctor --json

Quellen

5. Eine lesende Aufgabe prüft den Einstieg ins Projekt

Wechseln Sie in das Repository, das der Agent untersuchen soll, und starten Sie codewhale. Beginnen Sie mit einer rein lesenden Anfrage. So bleibt der Arbeitsbereich klar und falsche Annahmen werden sichtbar, bevor Dateien geändert werden.

Mit codewhale doctor --json erhalten Sie einen maschinenlesbaren lokalen Diagnosebericht für Fehlermeldungen oder eigene Werkzeuge. Beginnen Sie erst dann mit umfangreichen Aufgaben, wenn Installation, Zugangsdaten und Projektumfang geklärt sind.

cd /path/to/project
codewhale

# Beispiel für die erste Anfrage
# Untersuchen Sie dieses Repository, erklären Sie die Struktur und ändern Sie keine Dateien.

6. Plan, Work und Operate trennen Planung, Umsetzung und Koordination

Plan dient der lesenden Untersuchung und eignet sich für ein unbekanntes Repository. Work ist der normale Modus für Codeänderungen mit Freigaberegeln. Operate unterstützt zusätzlich parallele Aufgaben und Hintergrundkoordination; die aktiven Berechtigungsregeln bleiben dabei bestehen.

Mit /mode wählen Sie den Modus. Full Access ist eine separate Berechtigungseinstellung und kein zusätzlicher Modus: Aktionen können ohne Rückfrage ausgeführt werden. Verwenden Sie diese Einstellung nur für klar begrenzte, rückgängig zu machende Aufgaben in vertrauten Repositorys. Prüfen Sie weiterhin Diff und Tests.

Die aktuellen CodeWhale-Arbeitsmodi
ModusSchreibt DateienFührt Befehle ausFreigabe
PlanNeinLesende UntersuchungNur lesend
WorkJaJaAktive Berechtigungsregeln
OperateJaJa, einschließlich KoordinationAktive Berechtigungsregeln

7. Programmpfad, Anmeldung und Konfiguration erklären häufige Fehler

codewhale: command not found: Öffnen Sie ein neues Terminal, prüfen Sie PATH und kontrollieren Sie, ob das Programmverzeichnis des Paketmanagers enthalten ist.

MISSING_COMPANION_BINARY: Ein alter Dispatcher wird noch über PATH gestartet. Installieren Sie mit einem aktuellen unterstützten Verfahren neu und prüfen Sie die tatsächlich ausgeführte Datei. Die aktuelle einzelne Programmdatei benötigt keine separate TUI-Laufzeit.

Anmeldefehler: Führen Sie codewhale auth status --provider deepseek aus. Entfernen Sie einen veralteten gespeicherten Schlüssel oder einen alten Wert von DEEPSEEK_API_KEY. Öffnen Sie danach ein neues Terminal und testen Sie mit doctor --probe-api erneut.

Unerwarteter Endpunkt oder falsche Einstellungen: Prüfen Sie ~/.codewhale und das ältere ~/.deepseek. Behalten Sie nach überprüfter Migration nur die Konfiguration, die Sie tatsächlich verwenden möchten.

which -a codewhale
codewhale --version
codewhale auth status --provider deepseek
codewhale doctor
codewhale doctor --json

Quellen

Häufige Fragen

Sind DeepSeek TUI und CodeWhale verschiedene Projekte?

Nein. CodeWhale ist der aktuelle Name desselben Projekts. Diese Anleitung verwendet die aktuellen Befehle; die verlinkte DeepSeek-TUI-Übersicht bietet den ergänzenden Projekteinstieg.

Soll ich bei einer neuen Installation den Befehl deepseek verwenden?

Nein. Beginnen Sie mit codewhale. deepseek, deepseek-tui und .deepseek sind ältere Namen, die bei der Diagnose vorhandener Installationen noch relevant sein können.

Läuft DeepSeek V4 damit lokal?

Bei der hier beschriebenen API-Verbindung laufen Agent und Werkzeuge lokal, Modellanfragen gehen an die DeepSeek API. Lokale Modellinferenz benötigt eine eigene Einrichtung; Hinweise finden Sie unter /local-deployment (EN).

Wie erkenne ich den verwendeten API-Schlüssel?

codewhale auth status --provider deepseek zeigt, ob der aktive Schlüssel aus der Konfiguration, dem lokalen Geheimnisspeicher oder DEEPSEEK_API_KEY stammt. Der vollständige Schlüssel wird dabei nicht ausgegeben.

Mit welchem Modus sollte ich beginnen?

Untersuchen Sie ein unbekanntes Repository zunächst mit Plan. Verwenden Sie danach Work für überprüfte Änderungen. Operate ergänzt die Koordination; Full Access ist eine separate Berechtigung für vertraute, begrenzte Aufgaben.

Für eine verlässliche Einrichtung installieren Sie das aktuelle CodeWhale-Paket, prüfen den Programmpfad, konfigurieren eine eindeutige DeepSeek-Schlüsselquelle und kontrollieren das aktive Konfigurationsverzeichnis. Beginnen Sie anschließend mit einem kontrollierten Arbeitsmodus. Ältere DeepSeek-TUI-Namen bleiben für Migration und Fehlerdiagnose relevant.

Weitere Modellvergleiche

Lesen Sie weiter in unseren englischen DeepSeek-Modellvergleichen mit Tabellen, Empfehlungen zur Modellauswahl und Preisübersichten.