---
title: "Alran-Code-Doku: den KI-Agenten installieren, nutzen, automatisieren"
url: https://alran.dev/de/docs
locale: de
updated: 2026-11-16
---

# Alran-Code-Doku

Installieren, erste Aufgabe übergeben, nach deinen Regeln einrichten. Jede Seite kurz und auf den Punkt.

## Loslegen

- [Installieren](https://alran.dev/de/docs/install): Eine Zeile auf macOS, Linux und WSL. Oder npm, überall wo Node.js läuft.
- [Schnellstart](https://alran.dev/de/docs/quickstart): Von der Installation zur erledigten Aufgabe in fünf Schritten.
- [Anmelden und Konten](https://alran.dev/de/docs/auth): Alran Code meldet sich mit deinem Ottili-Konto an. Dein Passwort sieht es nie.

## Mit Alran arbeiten

- [Die Terminal-Oberfläche](https://alran.dev/de/docs/tui): Starte alran in einem Projektordner. Alles passiert auf einem Bildschirm: Gespräch, Plan, Arbeit und Status.
- [Plan-Modus und Berechtigungen](https://alran.dev/de/docs/plan-mode): Erst schauen, dann bauen, und selbst entscheiden, was es ausführen darf.
- [Goal Mode](https://alran.dev/de/docs/goal-mode): Setz eine Ziellinie. Alran arbeitet weiter, Runde um Runde, bis sie erreicht ist.
- [Subagents und Tasks](https://alran.dev/de/docs/subagents): Ein Agent? Mach ein Team daraus. Alran gibt Teile der Arbeit an Subagents ab, die nebeneinander laufen.
- [Sitzungen](https://alran.dev/de/docs/sessions): Jedes Gespräch ist eine Sitzung, gespeichert auf deinem Rechner. Fortsetzen, verzweigen, zurückspulen, exportieren.
- [Plugins, Skills und Hooks](https://alran.dev/de/docs/plugins): Skills bringen Alran eine Art Arbeit bei, Plugins bündeln Skills, MCP-Server und Hooks. Viele sind eingebaut.
- [MCP-Server](https://alran.dev/de/docs/mcp): Schließ eigene Werkzeuge und Dienste über das Model Context Protocol an, pro Projekt.

## Automatisieren

- [Headless und CI](https://alran.dev/de/docs/headless): alran exec erledigt eine Aufgabe ohne TUI: in Skripten, in der CI, in Stapelläufen.
- [Node.js und ACP](https://alran.dev/de/docs/sdk): Steuer Alran Code aus deinem eigenen Programm, oder schließ es an jeden Editor an, der das Agent Client Protocol spricht.
- [VS-Code-Erweiterung](https://alran.dev/de/docs/vscode): Derselbe Agent in VS Code, Cursor, Windsurf und VSCodium. Die Erweiterung steuert die echte CLI, also funktioniert alles gleich.

## Modelle

- [Modelle und Guthaben](https://alran.dev/de/docs/models): Standardmäßig Ottili Werk 1.1, Claude Sonnet 5.5 und Opus 5.5 einen Schalter entfernt. Werk läuft auf deinem Guthaben, Claude auf deinem eigenen Anthropic-Schlüssel.
- [Eigener Anbieter](https://alran.dev/de/docs/byok): Bring deinen eigenen Anbieter-Schlüssel mit. Diese Aufrufe gehen direkt zum Anbieter: Ottili sieht, misst und berechnet sie nicht.
- [Werk-API](https://alran.dev/de/docs/api): Werk 1.1 in deinem eigenen Produkt, über die Ottili AI Platform. OpenAI-kompatibel: Basis-URL und Modellnamen ändern.

## Referenz

- [CLI-Befehle](https://alran.dev/de/docs/cli): Alles, was alran in der Shell kann.
- [Slash-Befehle](https://alran.dev/de/docs/commands): Tipp / ins Eingabefeld und wähl einen Befehl. /help listet sie in der TUI.
- [Konfiguration und Daten](https://alran.dev/de/docs/config): Wo Alran Code seine Daten ablegt, und die Variablen, die das ändern.
- [Fehlercodes](https://alran.dev/de/docs/errors): Jeder Fehler, den das Terminal zeigt, trägt eine Nummer. Das ist, was jede bedeutet und was du dagegen tun kannst.
- [Fehlerbehebung](https://alran.dev/de/docs/troubleshooting): Die üblichen Verdächtigen, und wie du den Rest meldest.
