DEEN

DokuAutomatisieren

VS-Code-Erweiterung

Derselbe Agent in VS Code, Cursor, Windsurf und VSCodium. Die Erweiterung steuert die echte CLI, also funktioniert alles gleich.

Wie installiere ich die VS-Code-Erweiterung?

  1. Die CLI installieren: npm install -g alran oder curl -fsSL https://alran.dev/install.sh | bash (siehe Installieren). Die Erweiterung braucht Alran Code 0.9.0 oder neuer und funktioniert ohne die CLI nicht.
  2. Die Erweiterung in VS Code 1.90 oder neuer installieren: in der Erweiterungsansicht nach Alran Code suchen. Cursor, Windsurf und VSCodium beziehen sie von Open VSX.
  3. Den Chat mit Ctrl+Alt+A öffnen.

Die Erweiterung findet alran im PATH, im PATH deiner Login-Shell oder in den üblichen Installationsordnern. alran.executablePath zeigt auf einen anderen Build. Fehlt die CLI, sagt die Erweiterung das direkt nach dem Start und bietet die Installation an.

Anmelden

Der Browser öffnet die Ottili-Anmeldeseite; in einem Remote- oder Web-Fenster bestätigst du stattdessen einen kurzen Code. Neue Konten erhalten Willkommensguthaben für Ottili Werk. Du kannst auch einen Ottili-API-Schlüssel einfügen oder ohne Konto einen eigenen Anbieter verbinden (Eigener Anbieter). Dein Ottili-Konto erscheint im Konten-Menü des Editors, und beim Abmelden dort wird die Sitzung widerrufen. Mehr unter Anmelden und Konten.

Was sie mitbringt

  • Chat mit gestreamten Antworten, Reasoning, Werkzeugaufrufen mit Inline-Diffs und mehreren Sitzungen in Tabs, auch als Editor-Tab.
  • Kontext: @ fügt Dateien und Plugins hinzu, Ctrl+Alt+L die Auswahl, Bilder lassen sich einfügen oder hineinziehen.
  • Entscheidungen als Karten mit Vorschau und einem Knopf Open diff. Im Standardmodus fragt Alran, bevor es außerhalb deines Projekts schreibt.
  • Änderungsansicht mit echtem Diff von allem, was eine Sitzung geändert hat, und Rücknahme pro Datei oder komplett.
  • Plan-Modus, Berechtigungsmodus, Modell und Aufwand im Eingabefeld und in der Statusleiste.
  • Konto-Ansicht mit Firma, Projekt, Standardmodell, Guthaben und dem Verbrauch dieses Monats.
  • @alran in der Chat-Ansicht von VS Code, ein Terminalprofil Alran Code, Quick Fixes und *Add to chat* in den Kontextmenüs.

Plugins und Skills

Der Plugin Store und die Skill-Bibliothek sind eingebaut. Öffne sie mit Alran: Browse Plugin Store… oder Alran: Browse Skill Library…, über die Gruppe Plugins der Capabilities-Ansicht oder im Chat mit /plugin (auch /plugins und /store) und /skills library.

  • Eine Liste der Plugins, die Skill-Bibliothek, das Installierte und die Stores. Die Titelleiste wechselt zwischen ihnen.
  • Tippen zum Suchen. Enter installiert oder aktualisiert, wenn der Store eine neuere Version anbietet. Knöpfe zeigen Details, schalten ein Plugin an oder aus und entfernen es.
  • Ein Plugin, das Befehle ausführt oder sich mit Diensten verbindet, wird nie sofort installiert: Die Erweiterung listet jeden MCP-Server-Befehl, jeden Hook und jeden Connector auf und wartet auf deine Freigabe. Ein Plugin, das nur Skills enthält, wird sofort installiert.
  • Alran: Add Plugin Store… fügt einen weiteren Store hinzu. Ein Store, der sich nicht lesen lässt, wird in der Liste gemeldet; die anderen funktionieren weiter.
  • Skills und Plugins werden beim Start eines Chats geladen, deshalb bietet die Erweiterung nach einer Änderung einen New Chat an.

Dieselben Befehle gibt es im Terminal: Plugins, Skills und Hooks.

Modelle, Guthaben und Fehler

Die Modellauswahl zeigt den Preis jedes Modells und ob du es jetzt nutzen kannst; der Stern macht ein Modell zum Standard für neue Sitzungen. Willkommensguthaben deckt Ottili Werk; Claude läuft auf deinem eigenen Anthropic-Schlüssel, den du einmal auf der Ottili AI Platform hinterlegst — der Befehl Alran: Add or Replace Your Anthropic Key öffnet die Seite (Modelle und Guthaben).

Geht etwas schief, sagt eine Karte, was passiert ist, und bietet den nächsten Schritt an: Anthropic-Schlüssel hinterlegen, zu Ottili Werk wechseln, Guthaben aufladen, neu anmelden, nach einem Rate-Limit erneut versuchen oder ein Gespräch verdichten, das nicht mehr passt. Die ursprüngliche Meldung bleibt unter Details.

Slash-Befehle

Ein / im Chat, oder Alran: Slash Commands…, zeigt jeden Befehl und jeden Skill. Jeder Slash-Befehl der Terminal-Oberfläche funktioniert im Chat (Slash-Befehle). Befehle, die nur die Terminal-Oberfläche ausführen kann, etwa /rewind oder /theme, öffnen die aktuelle Sitzung in der echten TUI in einem integrierten Terminal und verbinden sich wieder, wenn es sich schließt.

Remote-Entwicklung und andere Editoren

Die Erweiterung läuft dort, wo dein Code liegt: über Remote SSH, in WSL, in Dev-Containern und in Codespaces. Installiere die CLI auf dieser Maschine; die Anmeldung nutzt dann einen Code, den du in deinem lokalen Browser bestätigst. @alran braucht einen Editor mit der Chat-Ansicht von VS Code; alles andere funktioniert in Cursor, Windsurf und VSCodium genauso.

Einstellungen

EinstellungZweck
alran.executablePath, alran.nodePathWelche CLI und welches Node.js laufen
alran.envZusätzliche Umgebung für den Agenten, etwa ALRAN_DATA_DIR oder ALRAN_STORE_URL
alran.systemPrompt, alran.appendSystemPrompt (und File-Varianten)Prompt-Überschreibungen für Sitzungen aus diesem Editor
alran.mcpServersMCP-Server, die zu diesen Sitzungen hinzukommen
alran.chat.enterWhileRunningOb Enter während einer Aufgabe lenkt oder einreiht
alran.context.includeActiveFileDie aktuelle Datei standardmäßig mitgeben
alran.notifications.when, alran.notifications.eventsBenachrichtigungen für fertige Schritte und Anfragen
alran.confirmFullAccessVor Full Access bestätigen

Anbieter, Berechtigungsregeln und alles andere bleiben in config.yaml, geteilt mit dem Terminal (Konfiguration und Daten).

Tastenkürzel

macOSLinuxWindowsAktion
Cmd+Alt+ACtrl+Alt+ACtrl+Shift+Alt+AChat öffnen
Cmd+Alt+NCtrl+Alt+NCtrl+Shift+Alt+NNeue Sitzung
Cmd+Alt+LCtrl+Alt+LCtrl+Shift+Alt+LAuswahl in den Chat
Cmd+Alt+ECtrl+Alt+ECtrl+Shift+Alt+EAuswahl erklären
Cmd+Alt+MCtrl+Alt+MCtrl+Shift+Alt+MModell wählen
Cmd+Alt+PCtrl+Alt+PCtrl+Shift+Alt+PPlan-Modus an oder aus

Unter Windows ist Ctrl+Alt dieselbe Taste wie AltGr, die Zeichen wie @ und € tippt; die Windows-Kürzel nehmen Shift dazu, damit sie nie im Weg sind. Im Eingabefeld: Enter lenkt eine laufende Aufgabe, Ctrl+Enter reiht die nächste ein, Esc stoppt, Shift+Tab schaltet den Plan-Modus.

Wenn etwas nicht funktioniert

ProblemWas tun
*Alran CLI not found*Alran: Install or Locate the Alran CLI… ausführen oder alran.executablePath setzen.
*Alran CLI is older than this extension needs*npm install -g alran oder Alran: Update Alran CLI. Erforderlich ist 0.9.0 oder neuer.
*Alran needs a newer Node.js*Die CLI braucht Node.js 22.19 oder neuer (22.x), 24.2+, 25 oder 26. Das Installationsskript bringt ein eigenes mit.
Die Anmeldung wird nicht fertigAlran: Sign In with a Code nutzen; es braucht keinen Rückruf an diese Maschine.
*Claude needs your Anthropic key*Den Schlüssel mit Alran: Add or Replace Your Anthropic Key hinterlegen oder zu Ottili Werk wechseln.
Der Plugin Store ist leer und nennt einen Store, der sich *nicht lesen ließ*Der Host des Stores ist von dieser Maschine nicht erreichbar. Netzwerk prüfen oder einen anderen Store hinzufügen.
Ein Plugin oder Skill fehlt in einem ChatSie werden beim Start eines Chats geladen. Einen New Chat öffnen.
SonstAlran: Show Logs zeigt die Details; Alran: Reload Agent startet den Agenten neu.

Mehr: Fehlerbehebung.

Häufige Fragen

Was brauche ich für die VS-Code-Erweiterung?

Installiere zuerst die CLI mit npm install -g alran, dann die Erweiterung in VS Code 1.90 oder neuer, indem du in der Erweiterungsansicht nach Alran Code suchst. Die Erweiterung braucht Alran Code 0.9.0 oder neuer und funktioniert ohne die CLI nicht. Cursor, Windsurf und VSCodium beziehen sie von Open VSX, und mit Ctrl+Alt+A öffnest du den Chat.

Wie melde ich mich in der VS-Code-Erweiterung an?

Der Browser öffnet die Ottili-Anmeldeseite, und in einem Remote- oder Web-Fenster bestätigst du stattdessen einen kurzen Code. Neue Konten erhalten Willkommensguthaben für Ottili Werk, du kannst auch einen Ottili-API-Schlüssel einfügen oder ohne Konto einen eigenen Anbieter verbinden. Dein Ottili-Konto erscheint im Konten-Menü des Editors, und beim Abmelden dort wird die Sitzung widerrufen.

Wie komme ich in VS Code an den Plugin Store und die Skills?

Der Plugin Store und die Skill-Bibliothek sind in die Erweiterung eingebaut. Öffne sie mit Alran: Browse Plugin Store… oder Alran: Browse Skill Library…, über die Gruppe Plugins der Capabilities-Ansicht oder im Chat mit /plugin (auch /plugins und /store) und /skills library. Ein Plugin, das Befehle ausführt oder sich mit Diensten verbindet, wird nie sofort installiert: Die Erweiterung listet jeden MCP-Server-Befehl, jeden Hook und jeden Connector auf und wartet auf deine Freigabe.