DEEN

DokuLoslegen

Schnellstart

Von der Installation zur erledigten Aufgabe in fünf Schritten.

1. Installieren

bash
curl -fsSL https://alran.dev/install.sh | bash

Andere Wege, Updates und Deinstallation: Installieren.

2. Anmelden

bash
alran auth login     # öffnet die Ottili-Anmeldung im Browser
alran auth status    # wer, welches Unternehmen, welches Projekt

Neue Konten bekommen Startguthaben für Ottili Werk 1.1. Über SSH bestätigst du stattdessen einen Code in einem beliebigen Browser. Mehr unter Anmelden und Konten.

3. Aufgabe übergeben

Öffne das Projekt und starte Alran. Sag in einem Satz, was du brauchst.

bash
cd ~/code/mein-projekt
alran

Oder gib die Aufgabe gleich mit:

bash
alran "Finde den roten Test, repariere den Code und führ die Tests aus."

Alran liest das Projekt, zeigt eine To-do-Liste und arbeitet sie ab. Schritte mit Wirkung außerhalb deines Arbeitsordners warten auf dein OK. Drück vor dem Senden Shift+Tab, dann siehst du zuerst nur den Plan.

4. Projektleitfaden schreiben

bash
alran init .

Alran untersucht die Codebasis und schreibt AGENTS.md: wie gebaut und getestet wird und worauf zu achten ist. Jede spätere Sitzung liest die Datei zuerst. Du bearbeitest sie wie jede andere Datei.

5. Weitermachen, wo du aufgehört hast

bash
alran --continue     # die letzte Sitzung in diesem Ordner
alran --session      # aus einer Liste wählen

In der Terminal-Oberfläche findet /sessions frühere Sitzungen, und /help zeigt alle Befehle.

Weiter

  • Goal Mode: Ziel setzen, Alran arbeitet weiter, bis es erreicht ist.
  • Subagents: die Arbeit auf ein Team von Agenten verteilen.
  • Headless und CI: alran exec in Skripten und Pipelines.
  • Modelle und Guthaben: Werk auf deinem Guthaben, Claude Sonnet 5.5 und Opus 5.5 auf deinem eigenen Anthropic-Schlüssel.

Häufige Fragen

Wie starte ich mit Alran Code?

Installiere Alran Code mit dem Installer-Skript, melde dich mit alran auth login an und öffne dann deinen Projektordner, um Alran in einem Satz zu sagen, was du brauchst. Alran liest das Projekt, zeigt eine To-do-Liste und arbeitet sie ab. Neue Konten bekommen Startguthaben für Ottili Werk 1.1.

Was macht alran init und was ist AGENTS.md?

Führ alran init in deinem Projekt aus, dann untersucht Alran die Codebasis und schreibt AGENTS.md. In der Datei steht, wie gebaut und getestet wird und worauf zu achten ist, und jede spätere Sitzung liest sie zuerst. Du bearbeitest sie wie jede andere Datei.

Fragt Alran Code nach, bevor es etwas außerhalb meines Projekts tut?

Ja. Alran zeigt eine To-do-Liste und arbeitet sie ab, aber Schritte mit Wirkung außerhalb deines Arbeitsordners warten auf dein OK. Drück vor dem Senden Shift+Tab, dann siehst du zuerst nur den Plan.