---
title: "VS-Code-Erweiterung · Alran-Code-Doku"
url: https://alran.dev/de/docs/vscode
locale: de
updated: 2026-11-16
---

[Doku](https://alran.dev/de/docs)Automatisieren

# VS-Code-Erweiterung

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

Auf dieser Seite

[Wie installiere ich die VS-Code-Erweiterung?](#install) [Anmelden](#signin) [Was sie mitbringt](#features) [Plugins und Skills](#store) [Modelle, Guthaben und Fehler](#models) [Slash-Befehle](#commands) [Remote-Entwicklung und andere Editoren](#remote) [Einstellungen](#settings) [Tastenkürzel](#shortcuts) [Wenn etwas nicht funktioniert](#troubleshooting) [Häufige Fragen](#faq)

## Wie installiere ich die VS-Code-Erweiterung? {#install}

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 {#signin}

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](https://alran.dev/de/docs/byok)). Dein Ottili-Konto erscheint im **Konten**-Menü des Editors, und beim Abmelden dort wird die Sitzung widerrufen. Mehr unter [Anmelden und Konten](https://alran.dev/de/docs/auth).

## Was sie mitbringt {#features}

- **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 {#store}

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](https://alran.dev/de/docs/plugins#store).

## Modelle, Guthaben und Fehler {#models}

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](https://alran.dev/de/docs/models)).

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 {#commands}

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](https://alran.dev/de/docs/commands)). 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 {#remote}

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 {#settings}

| Einstellung | Zweck |
| `alran.executablePath`, `alran.nodePath` | Welche CLI und welches Node.js laufen |
| `alran.env` | Zusä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.mcpServers` | MCP-Server, die zu diesen Sitzungen hinzukommen |
| `alran.chat.enterWhileRunning` | Ob Enter während einer Aufgabe lenkt oder einreiht |
| `alran.context.includeActiveFile` | Die aktuelle Datei standardmäßig mitgeben |
| `alran.notifications.when`, `alran.notifications.events` | Benachrichtigungen für fertige Schritte und Anfragen |
| `alran.confirmFullAccess` | Vor Full Access bestätigen |

Anbieter, Berechtigungsregeln und alles andere bleiben in `config.yaml`, geteilt mit dem Terminal ([Konfiguration und Daten](https://alran.dev/de/docs/config)).

## Tastenkürzel {#shortcuts}

| macOS | Linux | Windows | Aktion |
| Cmd+Alt+A | Ctrl+Alt+A | Ctrl+Shift+Alt+A | Chat öffnen |
| Cmd+Alt+N | Ctrl+Alt+N | Ctrl+Shift+Alt+N | Neue Sitzung |
| Cmd+Alt+L | Ctrl+Alt+L | Ctrl+Shift+Alt+L | Auswahl in den Chat |
| Cmd+Alt+E | Ctrl+Alt+E | Ctrl+Shift+Alt+E | Auswahl erklären |
| Cmd+Alt+M | Ctrl+Alt+M | Ctrl+Shift+Alt+M | Modell wählen |
| Cmd+Alt+P | Ctrl+Alt+P | Ctrl+Shift+Alt+P | Plan-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 {#troubleshooting}

| Problem | Was 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 fertig | **Alran: 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 Chat | Sie werden beim Start eines Chats geladen. Einen **New Chat** öffnen. |
| Sonst | **Alran: Show Logs** zeigt die Details; **Alran: Reload Agent** startet den Agenten neu. |

Mehr: [Fehlerbehebung](https://alran.dev/de/docs/troubleshooting).

## Häufige Fragen {#faq}

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.

[ZurückNode.js und ACP](https://alran.dev/de/docs/sdk) [WeiterModelle und Guthaben](https://alran.dev/de/docs/models)
