Erste Schritte
Installieren Sie ccmux auf dem Computer, auf dem Ihre Agenten ausgeführt werden. Erstellen Sie nach der Einrichtung ein Projekt und hängen Sie es an die erste Sitzung an.
Anforderungen
- macOS, Linux oder Windows über WSL2 (siehe Windows-Anleitung auf GitHub – nativer Windows wird als offenes TODO verfolgt)
- Einer von: Homebrew (macOS / Linuxbrew), Curl + eine POSIX-Shell oder Go 1.26+ für den Quellpfad
tmuxundgit. Homebrew installiert die Laufzeitabhängigkeiten; Das Download-Skript installiert nur ccmux-Binärdateien. Laufccmux setup, um Abhängigkeiten zu prüfen oder zu verwendenmake bootstrapbeim Erstellen aus dem Quellcode.
Installieren
Wählen Sie das Download-Skript oder Homebrew. Verwenden Sie den Quell-Build, wenn Sie ccmux selbst entwickeln möchten.
Skript herunterladen
curl -fsSL https://ccmux.ai/install | sh
ccmux setup
Das Skript installiert die Binärdateien der neuesten Version in ~/.local/bin/. Fügen Sie dieses Verzeichnis zum PATH Ihrer Shell hinzu, wenn Sie vom Installationsprogramm dazu aufgefordert werden. Du kannst Überprüfen Sie das Installationsskript , bevor Sie es ausführen.
Der Setup-Assistent prüft Abhängigkeiten, hilft bei der Konfiguration Ihrer Agent-CLIs und installiert den Hintergrunddämon. Melden Sie sich bei Ihrem gewählten Agenten an, bevor Sie eine Sitzung beginnen. Für den Fernzugriff schließen Sie Ihre Geräte ebenfalls an Tailscale an.
Homebrew
brew trust --tap skzv/tap
brew install skzv/tap/ccmux
ccmux setup
Vertrauen Sie dem Tap einmal pro Maschine. Homebrew installiert ccmux und seine Paketabhängigkeiten, einschließlich tmux, Mosh und ripgrep.
Alternative: aus der Quelle
mkdir -p ~/Projects && cd ~/Projects
git clone https://github.com/skzv/ccmux.git
cd ccmux && make bootstrap
make bootstrap überprüft Ihre Build-Kette und bietet an, alles Fehlende zu installieren und dann zu verketten make setup. Verwenden Sie dies, wenn Sie nachverfolgen möchten main oder ccmux selbst hacken.
Sie können den Setup-Assistenten später erneut ausführen, um Ihre Konfiguration zu überprüfen.
Erster Lauf
ccmux
Der TUI startet mit einer ersten Tour. Drücken Sie ? auf einem beliebigen Bildschirm für die vollständige Tastaturbelegung.
Tastenkombinationen
| Schlüssel | Aktion |
|---|---|
1–7 |
Bildschirme wechseln (Sitzungen, Projekte, Gespräche, Notizen, Agenten, Einstellungen, Netzwerk) |
Enter |
An ausgewählte Sitzung anhängen |
? |
Kontexthilfe |
T |
Führen Sie die erste Tour noch einmal durch |
j / k oder ↑ / ↓ |
Durch Listen navigieren |
x |
Ausgewählte Sitzung beenden |
Ihr erstes Projekt
Im TUI: drücken 2 für Projekte also n , um das Formular „Neues Projekt“ zu öffnen. Geben Sie den Namen ein, wählen Sie einen Agenten aus (Claude / Codex / Antigravity / Cursor / pi / Grok) und drücken Sie Enter. ccmux erstellt das Verzeichnis darunter projects.root und startet sofort die Agentensitzung.
Von der Shell:
ccmux new my-app
Erstellt das Verzeichnis und startet die Sitzung mit Ihrem Standardagenten. Der TUI öffnet sich automatisch auf dem Startbildschirm, wo Sie eine Verbindung herstellen können Enter.
Siehe Tutorial 1 für eine vollständige Anleitung.
Nächste Schritte
- Mehrere Sitzungen verwalten und trennen Sie die Verbindung, ohne einen Agenten anzuhalten.
- Stellen Sie eine Verbindung über Ihr Telefon her oder Fügen Sie eine weitere Maschine hinzu.
- Verbinden Sie einen MCP-Client , um Sitzungen Ihres Agenten zu überprüfen.
- Wenn das Setup fehlschlägt, führen Sie es aus
ccmux doctorund befolgen Sie die Anweisungen Wartungshandbuch.
Hilf mit, ccmux zu verbessern
Fehler gefunden, eine Anleitung unklar oder eine Übersetzung verbesserungswürdig? Auch kleine Beiträge sind willkommen. Erstelle ein Issue oder einen Pull Request.
Haben Sie einen Fehler entdeckt oder ist etwas veraltet? Bearbeiten Sie diese Seite auf GitHub.