---
title: "Plan-Modus und Berechtigungen · Alran-Code-Doku"
url: https://alran.dev/de/docs/plan-mode
locale: de
updated: 2026-11-16
---

[Doku](https://alran.dev/de/docs)Mit Alran arbeiten

# Plan-Modus und Berechtigungen

Erst schauen, dann bauen, und selbst entscheiden, was es ausführen darf.

Auf dieser Seite

[Wie sehe ich den Plan, bevor Alran baut?](#plan) [Berechtigungsmodi](#modes) [Einen Schritt freigeben](#approve) [In Skripten](#headless) [Häufige Fragen](#faq)

## Wie sehe ich den Plan, bevor Alran baut? {#plan}

Drück Shift+Tab (oder `/plan on`), und Alran untersucht und plant nur: Es liest das Projekt und schreibt einen Plan, ändert aber nichts. Lies den Plan, pass ihn im Gespräch an, schalte den Plan-Modus aus und lass bauen.

| Befehl | Was er tut |
| `/plan on` | Plan-Modus an |
| `/plan off` | Zurück zum normalen Modus |
| `/plan status` | Aktuellen Modus anzeigen |
| `/plan view` | Den letzten Plan öffnen |

## Berechtigungsmodi {#modes}

Der Berechtigungsmodus bestimmt, welche Schritte dein OK brauchen. Wechsel mit Alt+M oder `/permission`.

| Modus | Was passiert |
| **Ask** | Jeder Schritt mit Wirkung fragt vorher. |
| **Auto** | Routineschritte in deinem Arbeitsordner laufen; Schritte mit Wirkung nach außen warten auf dein OK. |
| **Full Access** | Alles läuft ohne Rückfrage. Nutz das in einer Sandbox oder einer Wegwerf-Umgebung. |

## Einen Schritt freigeben {#approve}

Ein Schritt, der dein OK braucht, zeigt eine Karte mit dem, was er tun will. Antworte dort, oder tipp:

| Befehl | Was er tut |
| `/allow` | Diesen Schritt einmal erlauben |
| `/always` | Diese Art Schritt immer erlauben |
| `/deny` | Ablehnen |
| `/permissions` | Alle offenen Anfragen zeigen |
| `/decision` | Das Freigabe-Panel wieder öffnen |

## In Skripten {#headless}

`alran exec` hat niemanden zum Fragen und nimmt deshalb eine Richtlinie: `--permission smart` (Standard), `full` oder `off`. Siehe [Headless und CI](https://alran.dev/de/docs/headless).

Berechtigungen und Sandbox senken das Risiko, sie ersetzen keine Prüfung. Schau dir fremde Plugins, MCP-Server und Shell-Befehle an, bevor du sie erlaubst.

## Häufige Fragen {#faq}

Wie sehe ich den Plan, bevor Alran baut?

Drück Shift+Tab oder nutz den Befehl /plan on, und Alran untersucht und plant nur: Es liest das Projekt und schreibt einen Plan, ändert aber nichts. Lies den Plan, pass ihn im Gespräch an, schalte den Plan-Modus aus und lass bauen.

Welchen Berechtigungsmodus soll ich nutzen?

Ask fragt vor jedem Schritt mit Wirkung, Auto lässt Routineschritte in deinem Arbeitsordner laufen und wartet bei Schritten mit Wirkung nach außen, und Full Access lässt alles ohne Rückfrage laufen. Wechsel mit Alt+M oder dem Befehl /permission. In Skripten nimmt alran exec stattdessen eine Richtlinie: --permission smart ist Standard, dazu full oder off.

Wie gebe ich einen Schritt frei, der mein OK braucht?

Antworte auf der Karte, die zeigt, was der Schritt tun will, oder nutz /allow für diesen Schritt einmal, /always für diese Art Schritt und /deny zum Ablehnen. Der Befehl /permissions zeigt alle offenen Anfragen.

[ZurückDie Terminal-Oberfläche](https://alran.dev/de/docs/tui) [WeiterGoal Mode](https://alran.dev/de/docs/goal-mode)
