Claude-Setup¶

ComplianceOS nutzt Claude AI für KI-gestützte Funktionen: Chat-Beratung, Audit-Bewertungen und Policy-Generierung. Die Authentifizierung erfolgt per OAuth direkt im Browser.

Ohne Claude AI nutzbar

Claude AI ist optional. Alle Kernfunktionen (Audits, Findings, Remediation, Reports, Matrix-Analytik) funktionieren auch ohne KI-Anbindung.

Voraussetzung¶

Sie benötigen eine Claude Code Subscription von claude.ai. ComplianceOS verwendet die gleiche Authentifizierung wie die Claude CLI.

Setup-Seite¶

Beim ersten Start leitet ComplianceOS Sie automatisch auf die Setup-Seite weiter:

Authentifizierung starten¶

ComplianceOS unterstützt zwei OAuth-Flows, abhängig davon wie Sie auf die Anwendung zugreifen:

Flow 1: Lokaler Zugriff (localhost)¶

Wenn Sie ComplianceOS über localhost oder 127.0.0.1 öffnen, wird der Auto-Redirect-Flow verwendet:

Klicken Sie auf "Mit Claude verbinden"
Sie werden zu claude.ai weitergeleitet
Melden Sie sich an und autorisieren Sie den Zugriff
Der Browser leitet Sie automatisch zurück zu ComplianceOS
Die Authentifizierung ist abgeschlossen

Empfohlener Flow

Der Auto-Redirect ist der schnellste Weg. Er funktioniert nur bei lokalem Zugriff, da der OAuth-Callback an localhost zurückgeleitet wird.

Flow 2: Remote-Zugriff (Server-IP)¶

Wenn Sie ComplianceOS über eine Server-IP oder einen Hostnamen erreichen (z.B. http://10.0.0.42:8001), wird der Manuelle-Code-Flow verwendet:

Klicken Sie auf "Mit Claude verbinden"
Es öffnet sich ein neues Fenster/Tab zu claude.ai
Melden Sie sich an und autorisieren Sie den Zugriff
Claude zeigt Ihnen einen Autorisierungscode an
Kopieren Sie diesen Code
Fügen Sie den Code in das Eingabefeld auf der ComplianceOS-Seite ein
Klicken Sie auf "Code absenden"

Code-Gültigkeit

Der Autorisierungscode ist nur wenige Minuten gültig. Wenn er abläuft, starten Sie den Vorgang erneut über /setup.

Verbindung prüfen¶

Nach erfolgreicher Authentifizierung zeigt die Setup-Seite:

"Claude AI ist bereit" mit grünem Häkchen
Der Button "Zum Dashboard" wird sichtbar

In den Einstellungen sehen Sie den aktuellen Claude-Status unter dem Abschnitt "Claude AI":

Grün: "Claude AI ist authentifiziert und einsatzbereit"
Gelb: "Claude CLI installiert, aber nicht authentifiziert"
Rot: "Claude CLI nicht gefunden"

Technische Details¶

Token-Speicherung¶

Die OAuth-Tokens werden unter ~/.claude/.credentials.json gespeichert (gleicher Pfad wie die Claude CLI). Das Format ist kompatibel — wenn Sie bereits claude auth login ausgeführt haben, erkennt ComplianceOS die bestehende Authentifizierung.

Scopes¶

ComplianceOS fordert folgende OAuth-Scopes an:

Scope	Verwendung
`user:inference`	KI-Anfragen für Chat und Audit-Bewertungen
`user:profile`	Benutzername für Anzeige
`user:sessions:claude_code`	Session-Management

Token-Erneuerung¶

Access-Tokens werden automatisch per Refresh-Token erneuert. Eine manuelle Neu-Authentifizierung ist nur bei Widerruf oder nach längerer Inaktivität nötig.

Fehlerbehebung¶

"Session abgelaufen"¶

Die PKCE-Session (OAuth-Sicherheitsparameter) ist nach 15 Minuten abgelaufen. Starten Sie den Vorgang erneut über /setup.

"Code ungültig oder bereits verwendet"¶

Der Autorisierungscode kann nur einmal verwendet werden. Starten Sie den Vorgang erneut.

Claude CLI vs. ComplianceOS Auth¶

Wenn Sie die Claude CLI (claude auth login) bereits nutzen, müssen Sie sich nicht erneut authentifizieren — ComplianceOS liest die bestehenden Credentials aus ~/.claude/.credentials.json.

Nächste Schritte¶

Nach der Authentifizierung:

Erste Schritte — Projekt anlegen und ersten Audit durchführen
Chat — KI-gestützte Compliance-Beratung nutzen