Skip to content

README.de.md

Latest commit

 

History

History
174 lines (131 loc) · 9.12 KB

README.de.md

File metadata and controls

174 lines (131 loc) · 9.12 KB
Raw
Codewhale

Der Open-Source-Coding-Agent, der mit jedem Modell arbeitet.

Codewhale liest dein Projekt, bearbeitet Dateien, führt Befehle aus und prüft seine eigene Arbeit — in deinem Terminal, mit einem gehosteten oder lokalen Modell deiner Wahl.

CI crates.io npm License: MIT Discord

Website · Dokumentation · Changelog · Mitwirken

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

Eine Codewhale-Terminalsitzung

Echte Terminalaufnahme einer frischen Installation — keine inszenierte Ausgabe.

Installation

macOS und Linux:

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

Das Installationsskript lädt Binärdateien mit geprüfter Prüfsumme nach ~/.local/bin. Meldet codewhale danach „command not found“, führe die eine PATH-Zeile aus, die das Skript ausgibt, oder siehe Zum PATH hinzufügen. Aktualisieren kannst du jederzeit mit codewhale update.

Windows, npm, Cargo und weitere Wege 
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  # build from crates.io

Docker, Nix, Homebrew unter Linux, Android/Termux, manuelle Downloads mit Prüfsummenkontrolle und der optionale CNB-Mirror sind in der Installationsanleitung beschrieben. Wähle einen Weg: Mehrere Installationen auf einem Rechner streiten sich am Ende um den PATH.

Schnellstart

  1. Öffne dein Projekt. Starte codewhale in dem Ordner, an dem du arbeiten willst.
  2. Verbinde ein Modell. Starte /provider (oder drücke F3), um einen gehosteten Schlüssel hinzuzufügen oder eine lokale Runtime zu wählen. Läuft Ollama bereits mit einem Chat-Modell, wechselt Codewhale von selbst dorthin. Mit /model wechselst du das Modell.
  3. Gib ihm eine konkrete Aufgabe.
Fix the failing tests and explain what changed.

Dieselbe Aufgabe läuft ohne Oberfläche aus einem Skript oder CI-Job:

codewhale exec "fix the failing tests and explain what changed"

Mit /help siehst du Befehle und Tastenkürzel.

Wege, es auszuführen

Jeder Client steuert dieselbe lokale Codewhale Runtime, daher verhalten sich Sitzungen, Tools und Berechtigungen überall gleich.

Befehl Was er tut
codewhale Die interaktive Terminaloberfläche
codewhale exec "…" Ein Durchlauf ohne Oberfläche aus einem Skript oder der CI, mit JSON-Streaming
codewhale web Der mitgelieferte lokale Browser-Client auf 127.0.0.1
codewhale review --pr N Ein beratendes Pull-Request-Review; das Veröffentlichen ist optional
Runtime API Eine lokale HTTP-API für Threads, Ereignisse und Freigaben

Eine native Desktop-App (GPUI) wird als Produkt-Client für angemeldete Nutzer entwickelt; Informationen zur Verfügbarkeit findest du auf der Produktseite. Die von der Community gepflegte VS Code-Erweiterung verbindet sich aus einer Seitenleiste mit derselben Runtime (Quellcode).

Was es kann

  • Jedes Modell, ohne Lock-in. Über 40 eingebaute Anbieter-Routen — Anthropic, DeepSeek, Google, Mistral, Moonshot, OpenAI, OpenRouter, xAI und weitere — dazu jeder OpenAI-kompatible Endpunkt und lokale Modelle über Ollama, vLLM oder SGLang. Anbieter
  • Du behältst die Kontrolle. Der Plan-Modus erkundet, ohne etwas zu ändern; Work und Operate nehmen Änderungen vor. Freigabe-Haltungen entscheiden, wann ein Tool-Aufruf deine Zustimmung braucht, /undo und /restore stellen Änderungen im Arbeitsbereich wieder her, und /receipts listet jede Datei, jeden Befehl und jede Freigabe einer Sitzung auf. Modi · Belege
  • Gebaut für lange Aufgaben. Setze ein dauerhaftes /goal, delegiere abgegrenzte Arbeit an Sub-Agenten, betreibe beaufsichtigte Agententeams mit einer Prüfung vor dem Ausgeben, oder skripte sie als eingecheckte Workflows.
  • Erweitere, was du schon nutzt. Verbinde MCP-Server, installiere Skills und Plugins, führe Hooks bei Sitzungs- und Tool-Ereignissen aus und lade vorhandene Claude-Code-Plugins.
  • Computer Use. Ein mitgeliefertes Plugin fügt Tools zum Beobachten und Bedienen anderer Anwendungen hinzu. Prüfe seine Zugriffsrechte und aktiviere es vor der Nutzung. Anleitung

Modi und Berechtigungen

Auswahl mit Optionen
Modus — was der Agent gerade tut Tab oder /mode Plan (erkunden, keine Änderungen) · Work (bearbeiten und ausführen) · Operate (ein Ziel über geplante, geprüfte Schritte verfolgen)
Haltung — wann er vorher fragt Shift+Tab Ask · Auto-Review · Full Access

Full Access respektiert weiterhin die harten Richtliniengrenzen. Die Anleitung zu Modi und Berechtigungen erklärt jede Option.

Sicherheit

Codewhale läuft auf deinem Rechner mit den Zugriffsrechten, die du ihm gibst. Freigabe-Haltungen und Repository-Regeln begrenzen, was der Agent tun darf, und Befehle laufen, wo unterstützt, in einer Betriebssystem-Sandbox (Seatbelt unter macOS; bubblewrap unter Linux ist optional). /preview-request zeigt die exakte, geschwärzte Anfrage, bevor etwas gesendet wird. Unbekannte Modellpreise bleiben unbekannt, statt als kostenlos ausgewiesen zu werden.

Siehe Autorisierungsreihenfolge, Sandboxing und Telemetrie — Nutzungszähler sind standardmäßig aktiv, und codewhale config set telemetry false schaltet sie ab.

Dokumentation

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

Community

Fehlerberichte, Funktionsideen und Pull Requests sind willkommen — ob du Codewhale seit Monaten nutzt oder es zum ersten Mal ausprobierst. Fehlt ein Anbieter oder ist ein Workflow umständlich, eröffne ein Issue oder sende einen Pull Request. Erste Beiträge sind willkommen, und wer beiträgt, behält die Anerkennung für die übernommene Arbeit. Die Repository-Struktur ist ein guter Einstieg.

Tritt dem Discord bei, oder füge 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 ist inzwischen anbieterneutral, wird unabhängig gepflegt und ist mit keinem Modellanbieter verbunden. Danke an alle Mitwirkenden und an die Open-Source-Communities, die zu seinem Wachstum beigetragen haben.

MIT. Aus anderen Open-Source-Projekten übernommene Teile sind in den Hinweisen zu Drittanbietern verzeichnet.