README.de.md

Ein Open-Source-Coding-Agent für dein Terminal, der mit jedem Modell arbeitet.

Gib Codewhale eine Aufgabe, und es liest das Repository, bearbeitet Dateien und führt Befehle aus, bis die Aufgabe erledigt ist oder es eine Eingabe von dir braucht. Es arbeitet mit mehr als 40 eingebauten Anbietern, standardmäßig mit DeepSeek V4.1 Flash, und mit Modellen, die auf deinem eigenen Rechner laufen. /receipts listet die Dateien auf, die es geändert hat, die Befehle, die es ausgeführt hat, und die Web- und MCP-Aufrufe, die es gemacht hat.

Website · Dokumentation · Changelog · Mitwirken

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català

_{Ein Entwicklungs-Build von 0.10.2 mit einem geskripteten Testmodell, in Full Access in einem Wegwerf-Arbeitsbereich. Die Änderung, drei Tests und ein Review durch einen Sub-Agenten liefen wirklich.}

Angebot von Codewhale × OrcaRouter ansehen. Codewhale erhält eine Empfehlungsprovision von OrcaRouter.

Installation

macOS und Linux:

curl -fsSL https://codewhale.net/install.sh | sh

Das Installationsskript legt codewhale und den kurzen Alias codew nach Prüfsummenkontrolle in ~/.local/bin ab. Meldet deine Shell danach command not found, führe die PATH-Zeile aus, die das Skript ausgibt (Details). codewhale update aktualisiert es. Diese Befehle installieren das neueste Release. Diese Seite folgt main; eine mit einer Version markierte Funktion kommt also mit diesem Release, und der Changelog listet, was jedes Release hinzufügt.

Windows, npm, Cargo und weitere Installationswege

winget install HunterBown.CodeWhale  # Windows x64 (or Scoop, or the installer from GitHub Releases)
npm install -g codewhale            # wraps the same release binaries
cargo install codewhale-cli --locked  # crates.io; can trail GitHub Releases

Vorkompilierte Binärdateien gibt es für Linux, macOS und Windows auf x64 und arm64. Nix, Homebrew unter Linux, Android/Termux (Vorschau) und manuelle Downloads beschreibt die Installationsanleitung, Container die Seite Docker. Bleib pro Rechner bei einer Installationsmethode; sonst landen zwei Kopien im PATH, und es gewinnt die, die zuerst kommt.

Schnellstart

1. Committe oder stashe deine Arbeit und starte dann codewhale im Wurzelverzeichnis eines Git-Repositorys. Standardmäßig wendet es dort Dateiänderungen an, ohne zu fragen, und zeigt dir den Diff.
2. Führe /provider aus (oder drücke F3), wähle einen Anbieter, füge seinen API-Schlüssel ein und wähle ein Modell. DeepSeek ist der Standardanbieter. Ohne Schlüssel wählst du stattdessen eine lokale Runtime. Ist kein Anbieter konfiguriert und stellt Ollama bereits ein Chat-Modell bereit, verwendet Codewhale es automatisch; ab 0.10.2 bietet es dir das Modell an, sobald du deine erste Nachricht sendest.
3. Gib eine Aufgabe ein:

Fix the failing tests and explain what changed.

Befehle, die nur lesen, laufen sofort. Bei jedem anderen Shell-Befehl fragt Codewhale vorher: y führt ihn einmal aus, a erlaubt ähnliche Befehle für den Rest der Unterhaltung, n lehnt ab. /undo macht deine letzte Anfrage samt ihren Dateiänderungen rückgängig. /help listet Befehle und Tasten auf.

Für Skripte und CI führt codewhale exec eine Aufgabe ohne Oberfläche aus. Standardmäßig nutzt --auto Full Access: Tools laufen ohne Nachfrage, Shell-Befehle haben keine Codewhale-Sandbox, und der Vertrauensmodus erlaubt Datei-Tools, außerhalb des Arbeitsbereichs zu schreiben. Füge --sandbox workspace-write hinzu, um die Shell-Sandbox und die Beschränkung der Datei-Tools auf den Arbeitsbereich beizubehalten, bei ausgeschaltetem Vertrauensmodus:

codewhale exec --auto --sandbox workspace-write "fix the failing tests and explain what changed"

Modi und Berechtigungen

Eine neue Installation startet im Work-Modus mit der Berechtigung Ask.

	Wechseln mit	Optionen
Modus	Tab (bei leerer Eingabe) oder /mode	Plan liest und durchsucht, ändert aber nichts. Work bearbeitet Dateien und führt Befehle aus. Operate hat dieselben Zugriffsrechte wie Work, behandelt deine Anfrage als Ziel und arbeitet weiter, bis das Ziel überprüft ist oder es eine Eingabe von dir braucht.
Berechtigung	Shift+Tab	Ask wendet Dateiänderungen in deinem Repository an, ohne zu fragen, und fragt vor Shell-Befehlen, die nicht nur lesen. Auto-Review lässt Regeln und ein Prüfmodell Routineaufrufe freigeben und lehnt Aufrufe mit hohem Risiko ab; wechsle zu Ask, um diese selbst freizugeben. Full Access fragt nie und schaltet die Sandbox von Codewhale ab; Repository-Regeln und verwaltete Richtlinien gelten weiterhin.

Details stehen in der Anleitung zu Modi und Berechtigungen.

Was es kann

Neu in 0.10.2

• /pet on verwandelt dein Terminal in einen animierten Wal, der zeigt, was der Agent gerade tut, während das Nachrichtenfeld weiter benutzbar bleibt. Seine 980 Partikel schreiben den aktuellen Schritt auf Englisch, Chinesisch oder Japanisch.
• /workbar terminal zeigt die Shells, die der Agent ausführt, während sie laufen. Tippe in eine davon, oder drücke Ctrl+N für eine eigene Shell (macOS und Linux).
• /undo macht deine gesamte letzte Anfrage in einem Schritt rückgängig, einschließlich jeder Datei, die sie geändert hat, und /diff funktioniert in Ordnern ohne Git.
• Wenn ein Plan bereit ist, fragt Codewhale, ob es Work mit Ask oder Auto-Review starten oder weiterplanen soll.
• /color gibt jedem Chat eine eigene Farbe für das Nachrichtenfeld, die mit der Sitzung gespeichert wird.
• web_search kann die neue Search API von DeepSeek verwenden: setze [search] provider = "deepseek" mit einem DeepSeek-Schlüssel.
• Außerhalb von Full Access läuft ein curl oder wget, das Zugangsdaten hochladen würde, nie ohne deine Freigabe, und ein Befehl, der unsichtbares Unicode versteckt, wird abgelehnt. write ersetzt keine Datei mehr, die der Agent nicht gelesen hat oder die sich geändert hat, nachdem er sie gelesen hat.

Modelle

Mehr als 40 Anbieter sind eingebaut, darunter Anthropic, OpenAI, DeepSeek, Google, Mistral, Moonshot, OpenRouter und xAI. Jeder OpenAI-kompatible Endpunkt funktioniert, ebenso lokale Modelle über Ollama, vLLM oder SGLang. Standard ist deepseek-flash von DeepSeek, das DeepSeek am 2026-10-17 auf DeepSeek-V4.1-Flash-1017 umgestellt hat; 0.10.1 nutzt es ohne Update (Details).

/model wechselt das Modell zwischen den Turns, und /model auto wählt für jeden Turn eines aus (/router legt fest, wie). /turn inspect zeigt, welches Modell ein Turn verwendet hat, was er gekostet hat und wie lange er gedauert hat. Mit codewhale auth chatgpt kannst du statt eines API-Schlüssels ein ChatGPT-Abo verwenden (experimentell). Siehe Anbieter.

Belege und Rückgängigmachen

/receipts, oder nach dem Beenden codewhale receipts --last, listet geänderte Dateien, ausgeführte Befehle, Web- und MCP-Aufrufe, gestartete Agenten, Freigaben und wer sie erteilt hat sowie Fehlschläge auf. /undo macht deine letzte Anfrage und ihre Dateiänderungen in einem Schritt rückgängig, ohne Vertrauensmodus. /restore setzt den gesamten Arbeitsbereich auf einen früheren Snapshot zurück; weil dabei spätere Änderungen überschrieben werden, braucht es /trust on oder Full Access. Siehe Belege.

Exec-Läufe, die Tools anbieten, werden in jedem Ausgabeformat gespeichert, sodass codewhale receipts --last nach exec --auto funktioniert, auch mit --json. Läufe, die nur antworten, werden im Textformat und mit --json nur beim Fortsetzen oder beim Beginn der Gesprächskompaktierung gespeichert; verwende --output-format stream-json, um sie immer für Belege oder exec --continue zu speichern.

Längere Arbeit

/goal setzt ein Ziel, das über mehrere Turns bestehen bleibt. Codewhale kann Arbeit auf Sub-Agenten verteilen, eine Flotte von Agenten betreiben oder einem im Repository eingecheckten Workflow folgen.

Umstieg von einem anderen Agenten

Codewhale liest AGENTS.md von selbst. Anweisungsdateien für andere Tools wie CLAUDE.md, .cursorrules oder .github/copilot-instructions.md werden nur geladen, wenn du sie mit project_instruction_imports = ["claude"] (oder "cursor", "cline", "windsurf", "copilot", "all") in deiner Konfiguration aktivierst; siehe config.example.toml. Codewhale warnt, wenn es eine findet, die es nicht geladen hat.

/import-claude bereitet einen Import deiner Claude-Code-Einstellungen und MCP-Server vor, den du prüfen kannst. /plugin install nimmt Claude-Code-Plugins mit Skills, Befehlen, Agentenprofilen und MCP-Servern an und lehnt Plugins ab, die Hooks oder LSP-Server brauchen (Details).

Erweiterungen

Verbinde MCP-Server, füge Skills und Plugins hinzu und führe Hooks bei Sitzungs- und Tool-Ereignissen aus. Der Code-Modus (experimentell, standardmäßig eingeschaltet) lässt das Modell ein einziges execute_tools-Programm schreiben, das mehrere MCP- und Plugin-Tools aufruft; jeder Aufruf unterliegt weiterhin deinen Freigaberegeln und behält seinen Beleg. Das unabhängig installierte Plugin Computer Use (experimentell, nur macOS) kann andere Apps beobachten und bedienen. Es bleibt ausgeschaltet, bis du seine Zugriffsrechte geprüft und es aktiviert hast (Anleitung).

Wege, es auszuführen

Befehl	Was er tut
codewhale	Die interaktive Terminal-App
codewhale exec "…"	Eine Aufgabe ohne Oberfläche. Ohne weitere Optionen antwortet es, ohne Tools zu verwenden; --auto aktiviert Tools standardmäßig mit Full Access, --sandbox workspace-write schränkt sie ein, und --output-format stream-json streamt Ereignisse als JSON
codewhale web	Eine lokale Web-Oberfläche auf 127.0.0.1 (Anleitung)
codewhale review --pr N	Ein beratendes Review eines GitHub-Pull-Requests. Die GitHub-Bot-Einrichtung erzeugt einen gepinnten Workflow für automatische Reviews und @codewhale review, mit deinem eigenen Modellschlüssel und optionaler App-Identität
codewhale app-server --http	Die Runtime API, eine lokale HTTP-API für Threads, Ereignisse, Freigaben und die Dateiänderungen jedes Turns
codewhale serve --acp	Das Agent Client Protocol über stdio, für Editoren wie Zed

Die Terminal-App, exec, web und die Runtime API teilen sich eine Engine (Architektur). Eine von der Community gepflegte VS-Code-Erweiterung verbindet sich aus der Seitenleiste damit (Quellcode). Eine native Desktop-App auf Basis der Runtime API ist in Entwicklung; einen öffentlichen Download gibt es noch nicht.

Kosten und Konten

Codewhale ist kostenlos und unter MIT lizenziert. Mit deinem eigenen API-Schlüssel bezahlst du den Anbieter direkt; lokale Modelle brauchen keinen Schlüssel. Die Fußzeile und /cost zeigen, was eine Sitzung gekostet hat, wenn der Preis bekannt ist; ein unbekannter Preis wird als unbekannt angezeigt, nie als kostenlos.

Du brauchst kein Konto. Schlüssel, die du mit /provider hinzufügst, bleiben auf deinem Rechner.

Sicherheit und Datenschutz

In Ask und Auto-Review laufen Befehle in einer Betriebssystem-Sandbox, sofern das System eine hat: Seatbelt unter macOS und bubblewrap unter Linux, wenn es installiert ist. Windows hat noch keine Betriebssystem-Sandbox, und Full Access schaltet die Sandbox ab. In der Sandbox können Shell-Befehle keine Speicherorte für Zugangsdaten wie ~/.ssh, ~/.aws und .env-Dateien lesen; ab 0.10.2 gilt dieselbe Regel auch für Terminalsitzungen und weitere Datei-Tools. /preview-request zeigt eine geschwärzte Vorschau der nächsten Anfrage, ohne sie zu senden.

Telemetrie ist standardmäßig eingeschaltet. Sie sendet aggregierte Zählwerte (Version und Plattform, Sitzungsdauer und -ergebnis, welche eingebauten Anbieter du verwendet hast, Funktions- und Fehlerzähler) mit einer zufälligen Installations-ID, die alle 90 Tage wechselt, und niemals Unterhaltungen, Code, Prompts, Modellnamen, Datei- oder Repository-Namen oder Zugangsdaten. codewhale config set telemetry false schaltet sie ab. Beim Start prüft Codewhale außerdem auf GitHub, ob es ein neues Release gibt; setze CODEWHALE_NO_UPDATE_CHECK=1, um das zu überspringen. Mehr dazu unter Autorisierungsreihenfolge, Sandboxing und Telemetrie.

Dokumentation

Zum Einstieg	Referenz
Installation	Konfiguration
Anbieter und lokale Modelle	Architektur
Modi und Berechtigungen	Runtime API
Tastenbelegung	Plugins entwickeln
GitHub-PR-Review	Gesamte Dokumentation

Community

Fehlt ein Anbieter oder ist ein Workflow umständlich, eröffne ein Issue oder sende einen Pull Request. Wer beiträgt, behält die Anerkennung für die Arbeit, die übernommen wird, und die Repository-Struktur zeigt, wo was liegt.

Chatte auf Discord, oder füge den Maintainer Hunter auf WeChat (hunterbown) hinzu und bitte darum, in die Gruppe Whale Brothers aufgenommen zu werden.

Geschichte und Lizenz

Codewhale begann als deepseek-tui und liest weiterhin die Konfiguration und die Sitzungen dieses Projekts. Es wird unabhängig gepflegt und ist weder mit DeepSeek noch mit einem anderen Modellanbieter verbunden. Danke an alle, die beigetragen haben.

MIT. Code, der aus anderen Open-Source-Projekten übernommen wurde, ist in den Hinweisen zu Drittanbietern aufgeführt.