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.
SmartScreen-Warnung beim ersten Start
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.
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.
„Credit balance too low“, obwohl du ein Abo hast
Erste Schritte
- Ordner öffnen. Im Explorer links auf 📂 klicken oder einen Ordner ins Fenster ziehen. Der Agent arbeitet immer innerhalb dieses Ordners.
- 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“.
- 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.
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.
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:
- Du stellst eine Aufgabe.
- Das Modell entscheidet, welche Werkzeuge es braucht — suchen, lesen, ändern, ausführen.
- RagnaIDE führt sie aus und reicht die Ergebnisse zurück.
- 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.
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. |
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_commanderscheint 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.
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.
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.
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.
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.
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.
- In der IDE: Einstellungen → Konto → Mit RagnaID verbinden. Dein Passwort tippst du nur auf der RagnaID-Seite.
- Im Browser: ragnasoftware.net/ide öffnen und mit derselben RagnaID anmelden.
- 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.
Befehlsfreigaben aus dem Browser sind aus
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.
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 |
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; das 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.
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.
Etwas fehlt hier?