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

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

# Installieren

Eine Zeile auf macOS, Linux und WSL. Oder npm, überall wo Node.js läuft.

Auf dieser Seite

[Wie installiere ich Alran Code?](#installer) [Mit npm](#npm) [Windows](#windows) [Aktualisieren](#update) [Deinstallieren](#uninstall) [Aus dem Quellcode bauen](#source) [Häufige Fragen](#faq)

## Wie installiere ich Alran Code? {#installer}

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

Das Skript braucht nur `curl` (oder `wget`) und `tar`. Es:

1. Prüft dein System: macOS oder Linux auf x64 oder arm64. WSL zählt als Linux.
2. Nimmt dein Node.js, wenn die Version passt (22.19 oder neuer auf 22, 24.2 oder neuer auf 24, 25 oder 26). Sonst lädt es Node.js 24 von nodejs.org, prüft die SHA-256-Summe und legt es in den Installationsordner. Dein System-Node.js bleibt unberührt.
3. Installiert das Paket alran nach ~/.alran-code und legt den Starter unter ~/.alran-code/bin/alran ab.
4. Trägt den Ordner in die Startdatei deiner Shell in den PATH ein, markiert mit Alran Code CLI.

Öffne danach ein neues Terminal und führ `alran --version` aus.

| Variable | Was sie tut | Standard |
| `ALRAN_INSTALL_DIR` | Wohin Alran Code installiert wird | `~/.alran-code` |
| `ALRAN_VERSION` | Die Version, die installiert wird | `latest` |
| `ALRAN_NO_MODIFY_PATH` | `1` lässt deine Shell-Dateien in Ruhe | nicht gesetzt |

```bash
curl -fsSL https://alran.dev/install.sh | ALRAN_VERSION=0.6.9 bash
```

Lieber erst lesen? Herunterladen, lesen, dann ausführen: `curl -fsSL https://alran.dev/install.sh -o install.sh`, danach `less install.sh` und `bash install.sh`.

## Mit npm {#npm}

Node.js 22.19 oder neuer (22.x), 24.2 oder neuer (24.x), 25 oder 26. Node 24.0 und 24.1 werden nicht unterstützt.

```bash
npm install -g alran
alran --version
```

pnpm, yarn und bun funktionieren genauso: `pnpm add -g alran`, `yarn global add alran`, `bun add -g alran`. Lass optionale Abhängigkeiten an und erlaube das native SQLite-Installationsskript von `better-sqlite3` (npm tut das von sich aus). Gibt es für deine Node-Version kein fertiges Binary, brauchen native Abhängigkeiten Python und C/C++-Build-Tools.

## Windows {#windows}

Führ den Installer in WSL aus, oder installier mit npm in der PowerShell: `npm install -g alran`.

## Aktualisieren {#update}

| Installiert mit | Aktualisieren |
| npm, pnpm, yarn oder bun | `alran update` |
| Dem Installer | Den Installationsbefehl erneut ausführen. Er ersetzt die Version an Ort und Stelle. |

Alran Code sucht einmal pro Woche nach Updates und zeigt einen Hinweis. `ALRAN_NO_UPDATE_CHECK=1` schaltet den Hinweis ab.

## Deinstallieren {#uninstall}

Schließ vorher laufende Sitzungen, auch in Editoren.

```bash
# mit dem Skript installiert
rm -rf -- "$HOME/.alran-code"
# danach die Zeile "# Alran Code CLI" und die
# PATH-Zeile darunter aus deiner Shell-Datei entfernen

# mit npm installiert
npm uninstall -g alran
```

Anmeldung, Einstellungen und Sitzungen liegen getrennt in `~/.alran` und bleiben erhalten. Lösch den Ordner nur, wenn auch sie weg sollen.

## Aus dem Quellcode bauen {#source}

Du brauchst Git, Node.js (wie oben) und pnpm 9.12.0.

```bash
git clone https://github.com/Alran-AI/code.git
cd code
corepack enable
pnpm install --frozen-lockfile
pnpm build
pnpm alran --help
```

Einen Build aus dem Quellcode nutzt du in einem anderen Projekt über den absoluten Pfad: `node /absoluter/pfad/zu/code/dist/cli.js`.

## Häufige Fragen {#faq}

Wie installiere ich Alran Code unter macOS?

Führ im Terminal curl -fsSL https://alran.dev/install.sh | bash aus. Das Skript prüft, ob du macOS oder Linux auf x64 oder arm64 nutzt, installiert das alran-Paket nach ~/.alran-code, legt den Starter unter ~/.alran-code/bin/alran ab und trägt den Ordner in die PATH-Zeile der Startdatei deiner Shell ein. Wenn du lieber npm nimmst, funktioniert npm install -g alran überall dort, wo Node.js läuft.

Welche Node.js-Versionen unterstützt Alran Code?

Node.js 22.19 oder neuer auf 22.x, 24.2 oder neuer auf 24.x sowie 25 oder 26. Node 24.0 und 24.1 werden nicht unterstützt. Der Installer nimmt dein eigenes Node.js, wenn die Version passt, und lädt sonst Node.js 24 in den Installationsordner, ohne dein System-Node.js anzufassen.

Wie deinstalliere ich Alran Code, ohne meine Sitzungen zu verlieren?

Schließ zuerst laufende Sitzungen, dann lösch den Ordner ~/.alran-code (oder führ npm uninstall -g alran aus) und entferne die mit # Alran Code CLI markierte Zeile mitsamt der PATH-Zeile darunter aus der Startdatei deiner Shell. Anmeldung, Einstellungen und Sitzungen liegen getrennt in ~/.alran und bleiben erhalten, also lösch den Ordner nur, wenn auch sie weg sollen.

[WeiterSchnellstart](https://alran.dev/de/docs/quickstart)
