VibeHandler › Ratgeber

VibeHandler auf dem Mac öffnen

Der Mac-Build von VibeHandler ist ad-hoc signiert, aber von Apple noch nicht notarisiert. Deshalb zeigt macOS beim ersten Start eine Warnung: „Apple konnte nicht überprüfen, ob ‚VibeHandler' frei von Schadsoftware ist." Das ist bei Apps außerhalb des App Stores völlig normal — und in unter einer Minute erledigt. So geht's.

Voraussetzungen

• Mac mit Apple Silicon (M1–M4). Der aktuelle Build ist arm64; eine Intel-Version gibt es noch nicht.
• Claude-Code-CLI installiert und angemeldet (claude im PATH). VibeHandler ist nur die Oberfläche für die CLI und läuft über dein eigenes Anthropic-Claude-Abo — es ersetzt es nicht.

Methode 1 — Systemeinstellungen (macOS Sonoma & Sequoia)

Auf neuen macOS-Versionen ist der alte Rechtsklick-Trick weg; du gibst die App einmal in den Einstellungen frei:

1. Die geladene .dmg öffnen und VibeHandler in den Ordner „Programme" ziehen.
2. Auf VibeHandler doppelklicken. Es erscheint „Apple konnte nicht überprüfen…" — auf Fertig klicken (nicht „In den Papierkorb bewegen").
3. Systemeinstellungen → Datenschutz & Sicherheit öffnen.
4. Nach unten zum Abschnitt Sicherheit scrollen. Dort steht „‚VibeHandler' wurde blockiert, um deinen Mac zu schützen." Auf Trotzdem öffnen klicken.
5. Mit Touch ID oder Passwort bestätigen, dann im letzten Dialog auf Öffnen.

macOS merkt sich das — ab jetzt startet VibeHandler ganz normal per Doppelklick.

Methode 2 — Rechtsklick → Öffnen (macOS Ventura und älter)

Auf älteren macOS-Versionen geht es direkt aus dem Finder:

1. In „Programme" mit Rechtsklick (oder Ctrl-Klick) auf VibeHandler.
2. Öffnen wählen und im Dialog nochmals Öffnen.

Methode 3 — Terminal (ein Befehl)

Das entfernt die „Quarantäne"-Markierung, die macOS bei Downloads setzt — dann kommt gar keine Warnung. App vorher nach „Programme" ziehen, dann:

xattr -dr com.apple.quarantine "/Applications/VibeHandler.app"

Jetzt VibeHandler ganz normal per Doppelklick öffnen.

Ist das sicher? Warum die Warnung kommt

Die Warnung heißt nicht, dass die App unsicher ist — sie heißt, dass Apple sie noch nicht notarisiert hat. VibeHandler ist ad-hoc signiert und völlig transparent darin, was es ist: eine Desktop-Oberfläche für die offizielle Claude Code-CLI. Die Notarisierung würde die Meldung ganz entfernen, benötigt aber einen kostenpflichtigen Apple-Developer-Account; sie steht auf unserer Roadmap. Bis dahin bringt dich jede der Methoden oben in Sekunden hinein.

Problembehebung: „VibeHandler ist beschädigt"

Falls du einen sehr frühen Build geladen hattest, kam evtl. „…ist beschädigt und kann nicht geöffnet werden." Diese ältere Datei war komplett unsigniert. Lade den aktuellen Build neu (ad-hoc signiert) oder repariere eine vorhandene Kopie mit:

xattr -cr "/Applications/VibeHandler.app"
codesign --force --deep --sign - "/Applications/VibeHandler.app"

Was auf dem Mac heute schon läuft

Der Kern — viele Claude Code-Sessions in einem Fenster, der Dirigent-Agent und die crash-sichere Session-Wiederherstellung — läuft auf dem Mac. Spracheingabe / Push-to-Talk gibt es auf dem Mac noch nicht (vorerst nur Windows). Alles andere verhält sich wie unter Windows.

Für Apple Silicon (M1–M4) Für Intel-Mac

Unsicher? Apple-Menü › Über diesen Mac: „Apple M…“ = Apple Silicon, „Intel“ = Intel. ~96 MB · läuft über dein Claude-Abo · auch für Windows verfügbar.