# Sicherheit ## Fremde Skills Skills sind Anleitungen für Claude und können Scripts enthalten. claude-session behandelt sie deshalb als nicht vertrauenswürdig: - **Import nur** von github.com (HTTPS) oder aus lokalen Ordnern; `git fetch --depth 1` ohne Hooks, Submodule und LFS. Git-Refs werden geprüft (nie mit `-` beginnend, `git check-ref-format`) und nach `--` übergeben. - **Prüfbericht vor dem Import:** Symlinks, Grösse, Scripts, `allowed-tools` und `hooks` in jeder Schreibweise (auch `"hooks":`, `'allowed-tools':`, `allowed-tools :`, eingerückt oder in `{…}`), Befehle der Form `` !`…` ``, Code-Blöcke mit `` ```! `` bzw. `~~~!`, Frontmatter ohne schliessendes `---`, verdächtige Muster (curl | sh, Schlüsselbund, launchctl …), unsichtbare Unicode-Zeichen. - Symlinks werden nie kopiert, Pfade mit `..` abgelehnt, Ausführungsrechte entfernt, beim Import wird nichts ausgeführt. Steuerzeichen in Namen und Beschreibungen werden vor der Ausgabe im Terminal entfernt. - **In Sessions entschärft (Frontmatter-Allowlist):** Bei nicht vertrauenswürdigen Skills wird das Original-Frontmatter der temporären Session-Kopie **verworfen und neu geschrieben**. Erhalten bleiben nur: - `name` (= Skill-ID) und `description` (aus den Metadaten, als YAML-String in Anführungszeichen), - `argument-hint` und `license` (einzeilig, als String in Anführungszeichen), - `user-invocable` und `disable-model-invocation` (nur `true`/`false`). Alles andere – `hooks`, `allowed-tools`, `model`, eingerückte oder `{…}`-Felder – fällt weg. Fehlt das schliessende `---`, gilt die ganze Datei als Text. In der ganzen Datei werden `` !`…` `` und Code-Blöcke mit `` ```! `` bzw. `~~~!` (würden beim Laden ausgeführt) unschädlich gemacht. `claude-session skills trust ` hebt das nach eigener Prüfung auf; jedes Update setzt es zurück. - Der Session-Prompt stellt klar, dass Skill-Inhalte keine Sicherheitsregeln oder Freigaben aufheben. ## Telegram (optional) - **Kopplung mit Zufallscode:** Beim Einrichten erzeugt claude-session einen zufälligen Code und öffnet `t.me/?start=`. Verbunden wird nur ein **privater** Chat, der genau diesen Code schickt – auch bei `telegram connect` ohne Rückfrage. Wer nur den Bot-Namen kennt, kann sich nicht eintragen. - **Freigaben per Handy sind standardmässig aus** (`telegram_approve=0`). Einschalten nur ausdrücklich (`claude-session telegram feature approve on` oder im Menü); eine bestehende Einstellung wird nicht verändert. - Freigabe-Anfragen zeigen den Befehl bzw. bei Edit/Write auch den Inhalt; unsichtbare Unicode-/Bidi-/Steuerzeichen werden sichtbar ersetzt (z. B. `⟦U+202E⟧`). Wird gekürzt, steht deutlich **„⚠️ GEKÜRZT – N Zeichen nicht angezeigt“** da und es gibt nur den Knopf **Ablehnen** – erlaubt werden kann dann nur am Mac. - Ein Auftrag vom Handy, der mit `-` beginnt, wird abgelehnt (könnte als Option gelesen werden). ## Projektversionen - Beim Sichern und Zurückstellen werden Symlinks nie verfolgt: Ein verlinktes `CLAUDE.md` wird nicht gesichert und beim Zurückstellen durch die Datei ersetzt (das Link-Ziel bleibt unverändert); ein verlinktes `.claude` wird nicht angefasst. ## Weitergabe-Paket (`claude-session package`) - Enthält frische Einstellungen (nie die eigenen, keine Telegram-Chat-ID), Skill-Metadaten nur mit unbedenklichen Feldern und überall `trusted=0`. - Bricht ab (statt nur zu warnen), wenn der eigene Benutzerpfad, die Telegram-Chat-ID oder Token-Muster im Paket stehen. ## Zugangsdaten - Claude-Logins: verwaltet Claude Code (macOS-Schlüsselbund bzw. unter Linux/WSL dessen eigene Ablage, je Konto ein eigener Konfigurationsordner). claude-session liest oder kopiert keine Tokens. Die Statuszeile wird nur aus den eigenen Einstellungen übernommen, nie aus `/.claude/settings*.json`. - Telegram-Token: macOS-Schlüsselbund; unter Linux/WSL im Schlüsselring über `secret-tool` (libsecret), falls vorhanden, sonst in `~/.config/claude-session/secrets/telegram-token` (Datei 600, Ordner 700 – nur dein Benutzer). Nie in Argumenten oder im Log; an curl über eine Config-Datei aus Prozess-Substitution übergeben (nicht in `ps` sichtbar). Der Bot reagiert nur auf den gekoppelten Chat. - Das Log schreibt einen Eintrag je Zeile; Zeilenumbrüche in Werten werden ersetzt. ## Bekannte Risiken - **Telegram-Fernbedienung = Kontrolle über Claude.** Wer Zugriff auf den gekoppelten Telegram-Chat hat (entsperrtes Handy, Telegram Desktop/Web, übernommenes Telegram-Konto), kann Sessions starten, Text und Tasten ins Claude-Fenster tippen, Dateien schicken und – wenn Freigaben eingeschaltet sind und der Modus «weg» aktiv ist – Aktionen von Claude auf dem Mac erlauben. **Empfehlung:** In Telegram die Code-Sperre (Einstellungen → Datenschutz und Sicherheit → Code-Sperre) und die zweistufige Bestätigung aktivieren; Freigaben per Handy nur bei Bedarf einschalten. - **Lokale Steuerdateien:** Die Antworten auf Freigaben (`perm`) und die Tasten-Warteschlange der Fernbedienung (`keyq`) liegen als Dateien unter `~/.config/claude-session/` und sind nur durch die Ordnerrechte (700, nur dein Benutzer) geschützt. Ein Programm, das unter deinem Benutzer läuft, könnte sie schreiben. - Die Entschärfung fremder Skills wirkt nur in Sessions, die über claude-session gestartet werden. Wer einen Skill-Ordner von Hand nach `~/.claude/skills` kopiert, umgeht sie. ## Windows über WSL / Linux (Beta) - Gleiche Codebasis wie auf dem Mac. Abgeschaltet (mit Meldung statt Fehler): Screenshot, Fenster-Fernbedienung (TIOCSTI/AppleScript), Starten vom Handy, „wach halten“ und Akku-Anzeige. - Der Telegram-Dienst läuft als `systemd --user`-Dienst, falls verfügbar – sonst nur, solange ein Terminal mit `claude-session telegram daemon` offen ist. - Ohne Schlüsselring liegt das Telegram-Token als Datei (600) in deinem Benutzerordner. Wer unter deinem Linux-Benutzer Programme ausführen kann, kann es lesen. ## Lücke melden Bitte vertraulich melden, nicht öffentlich. Der Kontakt steht auf der Website (https://claudemanager.pages.dev), sobald er eingerichtet ist.