DMG laden, Wizard starten,
losprompten.
Du brauchst macOS, einen Anthropic-Account und ein paar Terminal-Befehle. Diese Anleitung führt dich durch.
macOS 12 Monterey oder neuer (Apple Silicon oder Intel) · Anthropic-Account mit Claude Max oder API Key · ca. 1 GB freier Speicher (App ~140 MB, Voice Models optional ~530 MB)
Setup. Schritt für Schritt.
App installieren, Setup-Wizard ausführen, Claude Code einloggen. Der Wizard erkennt, was fehlt.
App installieren
Standard-DMG-Flow — herunterladen, öffnen, in Applications ziehen.
- 1
- 2 DMG öffnen
Doppelklick → cipher-mux.app in Applications ziehen - 3 macOS-Sperre aufheben
Einmalig im Terminal:xattr -cr /Applications/cipher-mux.app - 4 Starten
Spotlight → cipher-mux → Enter
- cipher-mux ist Open Source, aber noch nicht mit einem Apple-Zertifikat signiert. macOS blockiert deshalb den ersten Start — das ist normales Sicherheitsverhalten.
- Der xattr -cr Befehl entfernt die Quarantäne-Markierung. Die App wird dabei nicht verändert. Einmalig.
Setup-Wizard
Beim ersten Start erkennt die App automatisch, was auf deinem System fehlt. Du entscheidest, was installiert wird — ein Klick auf „Setup starten“, der Rest läuft automatisch.
Der Standard-Paketmanager für macOS. Falls schon vorhanden, wird der Schritt übersprungen. Ein Terminal-Fenster öffnet sich automatisch — dort dein macOS-Passwort eingeben.
Terminal-Multiplexer — die unsichtbare Infrastruktur, auf der cipher-mux aufbaut. Jede Claude-Session läuft in einer eigenen tmux-Session. Ohne tmux startet keine einzige Session.
JavaScript-Runtime für Claude Code CLI und die TTS-Engine. Falls über NVM, Volta oder Homebrew schon da, wird es erkannt.
Anthropics KI-Coding-Assistant — die Kernfunktion von cipher-mux. Wird via npm installiert. Danach einmalig claude login im Terminal.
Lokales Speech-to-Text. Sprache steuern, ohne Cloud. Komplett offline. Kann jederzeit später nachinstalliert werden.
Lokale Sprachausgabe für deutsch. Zusammenfassungen, Status-Updates, Meilensteine — gesprochen statt nur geschrieben.
- Voice ist ein Upgrade, kein Muss. Ohne Whisper und Piper funktioniert cipher-mux vollständig — Chat, Sessions, alle Entities, der gesamte Workflow.
- Der Wizard zeigt dir live, was gerade installiert wird. Nach Abschluss startet die App automatisch.
- Wenn Homebrew und tmux bereits installiert sind, erscheint ein „Überspringen“-Link — der Wizard ist dann optional.
Hub einrichten
Beim allerersten Start erscheint ein Overlay: cipher-mux braucht einen Projektordner. Ein Klick, dann geht’s weiter.
- 1 App startet → Overlay erscheint
Das normale Grid ist blockiert — erst Hub wählen, dann weiter. - 2 Pfad bestätigen oder ändern
Vorschlag: ~/cipher-mux/. Über „Durchsuchen…“ kannst du jeden Ort wählen. - 3 „Anlegen“ klicken
cipher-mux erstellt den Ordner (inkl. projects/-Unterordner), merkt sich den Pfad, Dialog verschwindet.
- Der Hub ist ein normaler Ordner — kein Git-Repo, keine versteckten Dateien. Projekte darin können eigenständige Git-Repos sein.
- Der alte Project Scanner ist entfallen. Statt automatisch Verzeichnisse zu durchsuchen, wählst du Projekte jetzt direkt per Ordner-Picker.
- Bestandsnutzer: Beim ersten Start nach dem Update erscheint der Dialog einmalig. Wähle deinen bestehenden Projektordner — danach kommt die Frage nicht wieder.
Claude Code einloggen
Der Setup-Wizard installiert Claude Code CLI automatisch. Danach einmalig im Terminal einloggen:
- Du brauchst einen Anthropic-Account mit Claude Code Zugang. Welches Abo das einschließt: anthropic.com
Der Companion lernt dich kennen.
Beim ersten Start fragt der Companion nach deinem Hintergrund. Drei kurze Fragen, dann passt sich das System an dein Level an.
- 1App öffnet → leeres Grid
Ein 1×1 Layout zur Begrüßung. Der Companion belegt die erste Zelle. - 2/startup eingeben
Der Companion fragt nach deinem Hintergrund, deiner KI-Erfahrung und deinem Vorhaben. Kein Multiple-Choice — einfach antworten. - 3Profil wird erstellt
Deine Antworten werden als user-profile.json gespeichert. Alle Entities passen ihren Detailgrad ab jetzt an dein Level an. - 4Workspace anlegen
Name vergeben, Projektordner hinterlegen — fertig. Alle Sessions im Workspace wissen ab jetzt, woran gearbeitet wird.
Weiter geht’s wie du willst. Der Companion begleitet dich.
Drei Guides zum gezielten Vertiefen — vom Erstkontakt bis zu LLM-Grundlagen.
First Steps
Was ist cipher-mux, wie startest du, erste Session. Der Einstieg.
Daily Workflow
Sessions anlegen, Tasks verteilen, Notes nutzen, Grid konfigurieren.
Prompting Fundamentals
Kontext verstehen, Prompts schreiben, typische Fehler vermeiden.
Bereit? Lad's runter.
macOS 12+ · Apple Silicon oder Intel. Linux & Windows: kommt.