Zum Inhalt

PowerShell Shortcuts für Claude Code

Claude Code wird über die Kommandozeile gestartet und kennt verschiedene Permission-Modi. Statt bei jedem Aufruf lange Flags zu tippen, lassen sich in PowerShell Kurzbefehle definieren.

Warum Shortcuts?

# Standard - fragt bei jeder Aktion nach Erlaubnis
claude

# Keine Permission-Prompts - alles wird automatisch erlaubt
claude --dangerously-skip-permissions

--dangerously-skip-permissions jedes Mal einzutippen ist mühsam. Ein PowerShell-Shortcut macht das einfacher.

Der claude+ Shortcut

# Claude Code - Enhanced: claude+ [dangerous|safe]
function claude+ {
    param(
        [ValidateSet('dangerous', 'safe')]
        [string]$Mode = 'dangerous'
    )
    $remaining = $args
    switch ($Mode) {
        'dangerous' { claude --dangerously-skip-permissions @remaining }
        'safe'      { claude @remaining }
    }
}

Zwei Modi

claude+ — Dangerous-Modus (Default)

claude+
claude+ dangerous

Überspringt alle Permission-Abfragen. Jede Datei-Änderung und jeder Shell-Befehl wird ohne Rückfrage ausgeführt.

Nur für vertrauenswürdige Aufgaben

Dieser Modus gibt Claude Code volle Kontrolle über das System. Nur verwenden, wenn das Risiko akzeptabel ist (z.B. eigene Projekte, isolierte Umgebungen).

claude+ safe — Standard-Modus

claude+ safe

Startet Claude Code normal — jede Aktion muss bestätigt werden.

Vergleich

Aufruf Flag Sicherheit
claude+ safe (keines) Hoch — alles wird abgefragt
claude+ --dangerously-skip-permissions Niedrig — keine Abfragen

Was ist mit Auto-Modus?

Claude Code kennt --permission-mode auto, der nur bei kritischen Aktionen nachfragt. Stand März 2026 ist dieser Modus aber nur für bestimmte Pläne verfügbar. Problematisch: Das Flag wird ohne Fehler akzeptiert, auch wenn der Modus nicht freigeschaltet ist — Claude läuft dann stillschweigend im Standard-Modus. Sobald Auto-Modus zuverlässig funktioniert, kann er als dritter Modus ergänzt werden.

Zusätzliche Argumente

Alle weiteren Argumente werden an Claude Code durchgereicht:

# Dangerous-Modus mit Prompt (default)
claude+ "Erstelle eine REST API"

# Safe-Modus
claude+ safe "Fix den Bug in app.py"

# Dangerous-Modus mit Resume
claude+ --resume

Installation

Automatisch

Installations-Script herunterladen und ausführen:

Install-ClaudeShortcuts.ps1

# Script ausführen
.\Install-ClaudeShortcuts.ps1

# Profil neu laden
. $PROFILE

Das Script:

  • Erstellt das PowerShell-Profil falls es nicht existiert
  • Prüft ob der Shortcut bereits installiert ist
  • Fügt die Funktion am Ende des Profils ein

Manuell

  1. PowerShell-Profil öffnen:

    # Pfad anzeigen
    $PROFILE
    
    # Öffnen (erstellt die Datei falls nötig)
    if (-not (Test-Path $PROFILE)) { New-Item -Path $PROFILE -Force }
    notepad $PROFILE
    
  2. Folgende Zeilen am Ende einfügen:

    # Claude Code - Enhanced: claude+ [dangerous|safe]
    function claude+ {
        param(
            [ValidateSet('dangerous', 'safe')]
            [string]$Mode = 'dangerous'
        )
        $remaining = $args
        switch ($Mode) {
            'dangerous' { claude --dangerously-skip-permissions @remaining }
            'safe'      { claude @remaining }
        }
    }
    
  3. Profil neu laden:

    . $PROFILE
    

Eigene Shortcuts erstellen

Das Prinzip lässt sich auf beliebige Claude Code Flags anwenden:

# Beispiel: Claude mit spezifischem Modell starten
function claude-haiku {
    claude --model claude-haiku-4-5-20251001 @args
}

# Beispiel: Claude im Plan-Modus starten
function claude-plan {
    claude --permission-mode plan @args
}

So funktioniert es

  1. function <name> — Definiert einen neuen Befehl in PowerShell
  2. param() — Parameter mit Validierung (ValidateSet schränkt auf erlaubte Werte ein)
  3. $args — Zusätzliche Argumente, die an Claude weitergereicht werden
  4. switch — Wählt das richtige Flag basierend auf dem Parameter

Warum Funktionen statt Aliases?

PowerShell-Aliases (Set-Alias) können keine zusätzlichen Parameter mitgeben. Für Shortcuts mit Flags sind Funktionen nötig. Mit param() und ValidateSet gibt es Tab-Vervollständigung und Eingabevalidierung dazu.

Naming-Konvention

Muster Beispiel Beschreibung
claude+ Permission-Shortcut + Zeichen für erweiterte Rechte
claude-<modus> claude-plan Bindestrich für Modi
claude-<modell> claude-haiku Bindestrich für Modell-Auswahl

Tipps

  • Profil-Pfad prüfen: $PROFILE zeigt den aktiven Pfad — bei OneDrive-Sync kann dieser abweichen
  • Änderungen testen: Nach dem Editieren mit . $PROFILE neu laden, kein Neustart nötig
  • Tab-Completion: Dank ValidateSet funktioniert Tab-Vervollständigung für den $Mode Parameter
  • Fehler im Profil: Falls das Profil einen Fehler hat, startet PowerShell trotzdem — die Fehlermeldung zeigt die problematische Zeile

Zusammenfassung

claude+ ersetzt das Eintippen von --dangerously-skip-permissions. Default ist dangerous, mit safe startet der normale Modus. ValidateSet liefert Tab-Completion und Eingabevalidierung.