RagnaIDE von A bis Z

1 · Installation

RagnaIDE läuft auf Windows 10 und 11 (64-Bit). Lade das Setup von der Produktseite und führe es aus. Die App landet in deinem Benutzerprofil, Adminrechte braucht der Installer nicht.

Das WebView2-Runtime, das die Oberfläche darstellt, ist auf aktuellen Windows-Installationen bereits vorhanden. Fehlt es, holt der Installer es automatisch nach.

Prüfsumme vergleichen

Get-FileHash .\RagnaIDE_0.1.0_x64-setup.exe -Algorithm SHA256

Der Wert muss mit dem auf der Download-Seite angezeigten übereinstimmen.

2 · Anmeldung

RagnaIDE braucht einen Claude-Zugang, um zu arbeiten. Es gibt zwei Wege — beide funktionieren vollwertig, sie unterscheiden sich nur in der Abrechnung.

Weg	Wofür	Abrechnung
Claude-Konto	Anmeldung im Browser, du nutzt dein bestehendes Abo.	Über dein Claude-Abo
API-Schlüssel	Schlüssel aus der Anthropic Console hinterlegen.	Guthaben der Console-Organisation

Beim ersten Start bietet das Chat-Panel rechts die Anmeldung an. Wählst du das Konto, installiert RagnaIDE bei Bedarf die Anthropic-CLI selbst (rund 7 MB, einmalig) und öffnet danach den Browser. Den API-Schlüssel gibst du stattdessen unter Einstellungen → Konto ein; er wird nur lokal gespeichert.

3 · Erste Schritte

1. Ordner öffnen. Im Explorer links auf 📂 klicken oder einen Ordner ins Fenster ziehen. Der Agent arbeitet immer innerhalb dieses Ordners.
2. Aufgabe stellen. Rechts ins Chat-Feld schreiben, etwa „Schau dir das Projekt an und erklär mir die Architektur" oder „Der Login wirft einen 500er — finde und behebe den Fehler".
3. Zusehen. Jeder Schritt erscheint als Zeile im Chat und lässt sich aufklappen. Änderungen an Dateien landen sofort im Editor.

Beim nächsten Start stellt RagnaIDE den zuletzt geöffneten Ordner samt Gesprächsverlauf wieder her.

4 · Die Oberfläche

Bereich	Was dort passiert
Leiste ganz links	Umschalter zwischen Explorer, Suche und Einstellungen.
Explorer	Dateibaum mit Kontextmenü: Anlegen, Umbenennen, in den Papierkorb legen, per Drag & Drop verschieben.
Editor	Monaco — derselbe Kern wie in VS Code. Tabs, Syntax-Highlighting, Autovervollständigung über Sprachserver.
Terminal	Klappt von unten auf. Echte PowerShell, mehrere Sitzungen über die Leiste rechts.
Chat rechts	Der Agent. Darüber erscheinen bei Bedarf Plan- und Agenten-Panel.
Statusleiste	Aktive Datei, Sprachserver-Status, Verbrauch und Kosten, laufende Subagents, Update-Hinweis.

Die Breiten von Explorer und Chat sowie die Höhe des Terminals lassen sich ziehen.

5 · Wie der Agent arbeitet

Der Unterschied zu einem Chat-Fenster neben dem Editor ist, was nach der Antwort passiert. RagnaIDE gibt dem Modell Werkzeuge und lässt es in einer Schleife arbeiten:

1. Du stellst eine Aufgabe.
2. Das Modell entscheidet, welche Werkzeuge es braucht — suchen, lesen, ändern, ausführen.
3. RagnaIDE führt sie aus und reicht die Ergebnisse zurück.
4. Das wiederholt sich, bis die Aufgabe erledigt ist.

Jeder Schritt erscheint als graue Zeile im Chat. Ein Klick klappt die Ausgabe auf — du siehst also nicht nur dass etwas passiert ist, sondern was.

Der Verlauf inklusive aller Werkzeug-Ergebnisse bleibt über deine Fragen hinweg erhalten. Was der Agent einmal gelesen hat, muss er nicht erneut lesen.

6 · Werkzeuge

Werkzeug	Was es tut
list_dir	Verzeichnisinhalt auflisten.
read_file	Datei lesen, auch abschnittsweise bei sehr großen Dateien.
search	Projektweite Volltextsuche.
edit_file	Gezielte Textersetzung. Ist die Stelle nicht eindeutig, bricht das Werkzeug ab statt zu raten.
write_file	Datei neu anlegen oder vollständig ersetzen.
run_command	Shell-Befehl ausführen — nur nach deiner Freigabe.
plan_write / plan_update	Plan anlegen und Schritte abhaken.
spawn_agents	Subagents für unabhängige Teilaufgaben starten.
ask_user	Rückfrage an dich, wenn eine Entscheidung wirklich dir gehört.
remember	Notiz zum Projekt merken, die auch in späteren Sitzungen gilt.
screenshot_page	Webseite rendern, inklusive Konsolen- und Netzwerkfehlern.

7 · Sicherheitsgrenzen

Ein Agent, der Dateien schreibt und Befehle ausführt, braucht Grenzen. RagnaIDE zieht sie im Rust-Backend, nicht in der Oberfläche — eine manipulierte Anfrage kommt also nicht daran vorbei.

• Dateizugriffe nur im Projektordner. Pfade werden aufgelöst und geprüft; ein .., ein absoluter Fremdpfad oder ein Symlink nach außen wird abgewiesen.
• Befehle nur mit Freigabe. Vor jedem run_command erscheint eine Karte mit dem exakten Befehl: Ausführen, Immer erlauben oder Ablehnen. „Immer erlauben" gilt für die laufende Sitzung.
• Zeitlimit. Befehle werden nach einer Frist abgebrochen — samt Kindprozessen, damit nichts im Hintergrund weiterläuft.
• Freigaben bleiben lokal. Über die Fernsteuerung kannst du standardmäßig keine Befehle freigeben. Ein übernommener Browser-Tab ist damit kein Shell-Zugriff auf deinen Rechner. Umschaltbar unter Einstellungen → Konto.

8 · Zwischenrufe

Du musst nicht warten, bis der Agent fertig ist. Tippst du, während er arbeitet, passiert eines von beidem:

• Steht eine Rückfrage offen, ist deine Eingabe die Antwort darauf.
• Sonst landet sie im Postfach und wird beim nächsten Schritt eingespeist — der Agent liest sie also, ohne dass die laufende Arbeit abbricht.

Der Knopf heißt in diesem Zustand Einwerfen statt Senden, und wartende Zwischenrufe werden über dem Eingabefeld angezeigt. Dasselbe gilt in der Weboberfläche.

9 · Plan & Subagents

Plan

Bei größeren Aufgaben legt der Agent zuerst einen Plan an und hakt die Schritte während der Arbeit ab. Das Panel erscheint automatisch über dem Chat. Du siehst damit, wo er steht — nicht nur, dass er beschäftigt ist.

Subagents

Sind Teilaufgaben voneinander unabhängig, startet der Agent mehrere parallel. Jede Karte im Agenten-Panel zeigt Status, Modell, Laufzeit, Schrittzahl und die aktuelle Tätigkeit.

Ein Klick auf eine Karte öffnet einen eigenen Reiter mit dem mitlaufenden Transkript und einem Eingabefeld. Läuft der Agent noch, wird deine Nachricht beim nächsten Schritt eingespeist; ist er fertig, setzt sie ihn fort. Das Modell lässt sich pro Agent jederzeit umschalten, stoppen geht einzeln oder für alle.

10 · Terminal

Strg+Ö oder der Knopf rechts in der Statusleiste klappt die Konsole auf. Es ist eine echte Shell — auf Windows PowerShell 7, falls installiert, sonst Windows PowerShell. Startverzeichnis ist der geöffnete Projektordner.

Über die Leiste rechts legst du mit + weitere Sitzungen an. Der Verlauf bleibt beim Umschalten und beim Ausblenden erhalten.

Das Terminal ist deins. Was der Agent ausführt, läuft getrennt davon und erscheint als Werkzeug-Schritt im Chat.

11 · Modelle & Denktiefe

Im Kopf des Chat-Panels sitzt ein Chip mit Modell und Denktiefe. Dahinter wählst du:

Modell	Wofür
Opus 5	Das stärkste Modell — für schwierige Aufgaben und größere Umbauten.
Fable 5	Sehr stark, gut für lange, eigenständige Arbeit.
Sonnet 5	Guter Ausgleich aus Tempo und Können.
Haiku 4.5	Schnell und günstig für einfache, klar umrissene Aufgaben.

Die Denktiefe von low bis max steuert, wie lange das Modell vor der Antwort nachdenkt. Mehr Tiefe hilft bei kniffligen Problemen und kostet mehr Zeit und Token. Für Subagents lässt sich ein eigenes Standardmodell setzen.

Verbrauch und geschätzte Kosten laufen live in der Statusleiste mit.

12 · Fernsteuerung über RagnaID

Verbindest du deine RagnaID, meldet sich die IDE beim RagnaSoftware-Relay an. Danach erreichst du sie unter ragnasoftware.net/ide von jedem Gerät.

1. In der IDE: Einstellungen → Konto → Mit RagnaID verbinden. Dein Passwort tippst du nur auf der RagnaID-Seite.
2. Im Browser: ragnasoftware.net/ide öffnen und mit derselben RagnaID anmelden.
3. Dein Rechner erscheint in der Geräteliste.

Von dort aus kannst du live mitlesen, Aufgaben geben, Rückfragen beantworten, dazwischenrufen, Modell und Denktiefe umschalten und laufende Arbeit stoppen.

Wie die Zuordnung funktioniert

Deine IDE sitzt hinter dem Router — eine Website kann sie nicht direkt erreichen. Deshalb ruft die IDE heraus und hält eine WebSocket-Verbindung zum Relay. Beide Seiten weisen sich mit einem RagnaID-Token aus; die Zuordnung läuft über deine Mitglieds-ID. Du siehst ausschließlich deine eigenen Geräte.

13 · Updates

RagnaIDE sieht beim Start still nach, ob es etwas Neues gibt. Findet es etwas, erscheint ein Hinweis in der Statusleiste — installiert wird erst auf deinen Klick unter Einstellungen → Über.

Jedes Update wird vor der Installation gegen den in der App hinterlegten Signaturschlüssel geprüft. Eine veränderte oder untergeschobene Datei wird abgelehnt, nicht installiert.

Kein Netz beim Start ist kein Fehler: die Prüfung scheitert dann still, die IDE startet normal.

14 · Tastenkürzel

Kürzel	Aktion
Strg+S	Aktive Datei speichern
Strg+Ö / Strg+`	Terminal ein- und ausblenden
Strg+Umschalt+F	Projektweite Suche
Strg+Umschalt+E	Explorer
F2	Im Explorer umbenennen
Entf	In den Papierkorb legen
Strg+X / C / V	Im Explorer verschieben und kopieren
Enter / Umschalt+Enter	Im Chat senden / Zeilenumbruch

15 · Was wohin geht

• An Anthropic geht das, was der Agent für die Aufgabe liest — Dateiausschnitte, Suchtreffer, Befehlsausgaben — als Teil der Anfrage. Genau wie bei jedem anderen Claude-Client.
• An RagnaSoftware geht nichts, solange du die Fernsteuerung nicht verbindest. Ist sie an, läuft der Chat-Verlauf über das Relay, damit du ihn im Browser siehst; der Relay hält nur die letzte Momentaufnahme im Speicher und schreibt sie nicht weg.
• Lokal bleiben dein Code, dein API-Schlüssel, das RagnaID-Refresh-Token und die Sitzungsverläufe.

16 · Fehlerbehebung

Der Agent antwortet nicht mehr / bleibt stehen

Vorübergehende Fehler — Rate-Limit, Überlastung, ein Netzhänger — werden automatisch wiederholt (nach 5, 15, 45 und 90 Sekunden). Der Chat zeigt dabei, worauf gewartet wird. Bleibt es dabei, hilft Stop und eine neue Nachricht.

„Anthropic-CLI nicht gefunden"

Sollte nicht mehr vorkommen — die CLI installiert sich beim Anmelden selbst. Scheitert der Download (Proxy, Virenscanner), kannst du stattdessen einen API-Schlüssel hinterlegen.

Die Weboberfläche zeigt „Warte auf Verbindung zur IDE…"

Dann ist die IDE gerade nicht am Relay. Prüfe unter Einstellungen → Konto, ob RagnaID verbunden und die Fernsteuerung aktiv ist. Der Status api.ragnasoftware.net/ide/health zeigt, ob Geräte angemeldet sind.

Sprachserver-Funktionen fehlen

RagnaIDE spricht das Language-Server-Protokoll, bringt die Server aber nicht mit. Ist für deine Sprache keiner installiert, zeigt die Statusleiste das an — der Editor funktioniert weiterhin, nur ohne Sprung zur Definition und ohne Diagnosen.

Änderungen des Agenten erscheinen nicht im Editor

Offene Tabs mit ungespeicherten Änderungen werden bewusst nicht überschrieben — dort steckt deine Arbeit. Speichere oder verwirf sie, dann zieht der Tab nach.