Claudia: GUI-Tool zur Verwaltung von Claude Code

Claudia ist eine Open-Source-Desktop-Anwendung, die für Benutzer von Claude Code entwickelt wurde. Es vereinfacht die Bedienung von Claude Code mit einer intuitiven grafischen Oberfläche (GUI), die den traditionellen Kommandozeilenansatz ersetzt. Benutzer können KI-Entwicklungsprojekte leichter verwalten, benutzerdefinierte Agenten erstellen, Hintergrundaufgaben ausführen und die Ressourcennutzung in Echtzeit anzeigen. Claudia verwendet das Tauri-Framework, kombiniert mit dem React-Frontend und dem Rust-Backend und unterstützt Linux-, macOS- und Windows-Systeme. Sein Ziel ist es, KI-Entwicklung effizienter und intuitiver für Entwickler, Forscher und KI-Enthusiasten zu machen. Das Projekt ist Open Source auf GitHub, mit aktiver Community-Unterstützung, Benutzer sind willkommen, Code oder Feedback beizutragen.

Funktionsliste

• Interaktive grafische Benutzeroberfläche zur Verwaltung von Claude Code-Sitzungen, die intuitives Durchsuchen und Bearbeiten von Projekten ermöglicht.
• Unterstützung für die Erstellung und gemeinsame Nutzung benutzerdefinierter KI-Agenten, um unterschiedlichen Entwicklungsanforderungen gerecht zu werden.
• Bietet Checkpoint- und Rollback-Funktionen, um die fehlenden Funktionen von Claude Code zu kompensieren.
• Unterstützt die Ausführung eines sicheren Backend-Agenten (experimentelle Funktion), um eine isolierte Entwicklungsumgebung zu gewährleisten.
• Überwachen Sie den Ressourcenverbrauch und den Projektstatus von Claude Code in Echtzeit mithilfe von Dashboards.
• Die Installation und Konfiguration von MCP (Model Control Protocol) kann ohne Code durchgeführt werden.
• Unterstützt den Betrieb auf mehreren Plattformen, einschließlich Linux-, macOS- und Windows-Systemen.

Hilfe verwenden

Einbauverfahren

Claudia muss aus dem Quellcode installiert werden, da noch keine vorkompilierte ausführbare Datei veröffentlicht wurde. Im Folgenden finden Sie detaillierte Installationsschritte für Linux-, macOS- und Windows-Systeme. Benutzer sollten sicherstellen, dass Git und die notwendigen Entwicklungswerkzeuge auf ihrem System installiert sind. Die folgenden Schritte gelten für Linux (Ubuntu/Debian) und sind für macOS und Windows ähnlich.

1. Installation von Systemabhängigkeiten
   • Stellen Sie sicher, dass Git installiert ist. Falls nicht, führen Sie den folgenden Befehl aus:

     sudo apt update
     sudo apt install -y git
     

   • Installieren Sie andere abhängige Pakete:

     sudo apt install -y libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev patchelf build-essential curl wget file libssl-dev libxdo-dev libsoup-3.0-dev libjavascriptcoregtk-4.1-dev
     

   • Für macOS-Benutzer ist das Xcode-Befehlszeilentool erforderlich:

     xcode-select --install
     

     Zusätzliche Abhängigkeiten können auch über Homebrew installiert werden (optional):

     brew install pkg-config
     

2. Klon Claudia Lagerhaus
   • Klonen Sie das Projekt lokal mit Git:

     git clone https://github.com/getAsterisk/claudia.git
     cd claudia
     

3. Einbau Brötchen
   • Claudia verwendet Bun als JavaScript-Laufzeitumgebung. Bun installieren:

     curl -fsSL https://bun.sh/install | bash
     

   • Vergewissern Sie sich, dass die Umgebungsvariable Bun hinzugefügt wurde (konfigurieren Sie sie gemäß den Anweisungen im Terminal).
4. Erstellen und ausführen
   • Installieren Sie die Front-End-Abhängigkeiten und starten Sie den Entwicklungsserver:

     bun install
     bun run tauri dev
     

   • Wenn nur die Vorderseite ausgeführt wird:

     bun run dev
     

   • Erstellen Sie die Produktionsversion:

     bun run tauri build
     

   • Nach Abschluss des Builds befindet sich die ausführbare Datei:
     • Linux:src-tauri/target/release/bundle/
     • macOS:src-tauri/target/release/bundle/
     • Fenster:src-tauri/target/release/bundle/
5. Überprüfen der Installation von Claude Code
   • Claudia setzt voraus, dass Claude Code auf dem System installiert ist und dass sein Pfad in der Umgebungsvariablen PATH ein. Wenn Claudia die ausführbare Datei Claude nicht finden kann, prüfen Sie:

     which claude
     

     Stellen Sie sicher, dass ein gültiger Pfad zurückgegeben wird. Ist dies nicht der Fall, installieren Sie Claude Code manuell und fügen Sie ihn der PATH.

Funktion Betriebsablauf

1. die Projektleitung und die Sitzungen

Die Hauptschnittstelle von Claudia bietet einen intuitiven Projektbrowser. Benutzer können:

• Ein neues Projekt erstellenKlicken Sie auf die Schaltfläche "Neues Projekt" auf dem Bildschirm und geben Sie einen Namen und eine Beschreibung des Projekts ein, Claudia erstellt automatisch ein Arbeitsverzeichnis für das Projekt.
• Sitzungen verwaltenMehrere Sitzungen werden für jedes Projekt unterstützt, und die Benutzer können zwischen den Sitzungen wechseln, um den Verlauf der Vorgänge zu sehen. Klicken Sie auf die Registerkarte "Sitzungen" und wählen Sie eine bestehende Sitzung aus oder erstellen Sie eine neue Sitzung.
• Kontrollpunkte und Rollback: Claudia unterstützt das Speichern von Checkpoints während einer Sitzung. Benutzer können auf "Checkpoint speichern" klicken, um den aktuellen Zustand des Codes aufzuzeichnen, wenn er eine bestimmte Stufe erreicht. Wenn Sie ein Rollback benötigen, klicken Sie auf die Schaltfläche "Rollback" und wählen Sie den vorherigen Prüfpunkt aus, den Sie wiederherstellen möchten.

2. die Zollagenten

Claudia ermöglicht es Benutzern, eigene KI-Agenten zu erstellen:

• Erstellen eines ProxysKlicken Sie auf der Registerkarte "Agenten" auf "Neuer Agent". Geben Sie den Agentennamen, die Beschreibung und die Laufzeitparameter (z. B. Modelltyp, Aufgabentyp) ein. Claudia unterstützt Konfigurationsdateien im JSON-Format, die manuell bearbeitet oder über die Schnittstelle eingestellt werden können.
• Agent teilenNachdem Sie den Proxy erstellt haben, klicken Sie auf die Schaltfläche "Exportieren", um die Proxy-Konfigurationsdatei zu generieren und sie mit anderen Benutzern zu teilen. Andere Benutzer können den Agenten über die Funktion "Importieren" laden.
• Laufende AgentenNachdem Sie den Agenten ausgewählt haben, klicken Sie auf die Schaltfläche "Ausführen". Der Agent wird in einer Sandbox-Umgebung ausgeführt, um die Sicherheit zu gewährleisten.

3. dashboards in Echtzeit

Claudias Dashboard zeigt die Ressourcennutzung von Claude Code in Echtzeit an:

• Anzeige des RessourcenverbrauchsDashboards zeigen die CPU-, Speicher- und Netzwerkauslastung an, um den Benutzern die Überwachung der Leistung zu erleichtern.
• KostenverfolgungFür die kostenpflichtigen Funktionen von Claude Code zeigt das Dashboard die Kosten in Echtzeit an, so dass die Nutzer ihr Budget leicht kontrollieren können.
• BetriebsprotokollKlicken Sie auf die Schaltfläche "Log", um detaillierte Laufzeitprotokolle zur Fehlersuche und Optimierung anzuzeigen.

4. die Back-Office-Agenten (experimentell)

• Starten des Backend-AgentenAuf der Registerkarte "Agenten" wählen Sie den Modus "Im Hintergrund ausführen"; Claudia führt den Agenten in einer Sandbox-Umgebung aus, um die Hauptaufgabe nicht zu beeinträchtigen.
• Agentenstatus überwachenWenn der Hintergrund-Agent läuft, zeigt das Dashboard seinen Status und die Ressourcennutzung an.

5. die MCP-Konfiguration

Claudia bietet MCP (Model Control Protocol) Konfiguration ohne Code:

• automatische InstallationIn der Registerkarte "Einstellungen" klicken Sie auf "MCP-Installation" und Claudia wird die Umgebung automatisch erkennen und konfigurieren.
• manuelle EinstellungBenutzer können MCP-Parameter wie die Modellauswahl, den API-Schlüssel usw. über die Schnittstelle anpassen.

caveat

• Wenn Sie die Fehlermeldung "Installation von Claude kann nicht überprüft werden" erhalten, vergewissern Sie sich, dass Claude Code korrekt installiert wurde und dass der Pfad im Verzeichnis PATH Mitte.
• Windows- und macOS-Benutzer müssen möglicherweise zusätzliche Umgebungsvariablen konfigurieren, siehe die GitHub README.md.
• Derzeit gibt es keine Unterstützung für das Ziehen und Ablegen von Bildern oder das Abbrechen laufender Prozesse, die Community arbeitet an diesen Funktionen.

Anwendungsszenario

1. KI-Entwickler
   Claudia ist für Entwickler gedacht, die Claude Code häufig verwenden müssen. Es bietet eine intuitive Schnittstelle zur Verwaltung komplexer Projekte und spart Zeit in der Kommandozeile. Die Checkpointing-Funktion hilft Entwicklern bei Experimenten, schnell ein Rollback durchzuführen, was für schnelle Iterationen geeignet ist.
2. Teamarbeit
   Teammitglieder können benutzerdefinierte Agenten über Claudia gemeinsam nutzen, um die Entwicklungsumgebung zu vereinheitlichen. Echtzeit-Dashboards helfen den Teams, die Ressourcennutzung zu überwachen und sicherzustellen, dass die Projekte im Rahmen des Budgets laufen.
3. Studium und Forschung
   KI-Anfänger oder Forscher können Claudia verwenden, um die Lernkurve von Claude Code zu vereinfachen. Die codefreie MCP-Konfiguration und eine visuelle Schnittstelle verringern die Schwierigkeiten beim Einstieg.

QA

1. Welche Betriebssysteme werden von Claudia unterstützt?
   Claudia wird auf Linux, macOS und Windows unterstützt. Benutzer müssen aus dem Quellcode bauen, siehe das GitHub-Repository für Installationsanweisungen.
2. Wie lässt sich das Problem "Die ausführbare Datei Claude kann nicht gefunden werden" lösen?
   Sicherstellen, dass Claude Code installiert und dem System hinzugefügt wird PATH. ausführen. which claude Überprüfen Sie den Pfad. Falls nicht gültig, installieren Sie Claude Code neu oder geben Sie den Pfad manuell an.
3. Unterstützt Claudia mehrere Konten?
   Die Verwaltung mehrerer Konten wird in der aktuellen Version nicht explizit unterstützt, daher wird Benutzern empfohlen, eine Anfrage auf GitHub zu stellen oder in der Community nach Updates zu suchen.
4. Wie kann ich Code beisteuern?
   Nachdem Sie das Lager geklont haben, sehen Sie sich die CONTRIBUTING.md Die Community freut sich über Funktionsvorschläge und Fehlerbehebungen.