Suchst du die native Mac-App? Wenn du den Agenten auf diesem Mac ausführen möchtest, lade die native Desktop-App herunter — das ist die empfohlene Option. Diese Seite beschreibt, wie du den iOS-Client auf einem Mac verwendest, um einen Agenten zu steuern, der auf einem anderen Computer läuft.
Überblick
Die Btelo Coding iOS-App kann auf Apple Silicon Mac (M1, M2, M3, M4) ausgeführt werden — der App Store ermöglicht die Installation der gleichen iOS-Binärdatei direkt. Du erhältst genau dieselben Sitzungen, den gleichen Chat und dieselben Steuerelemente wie auf dem iPhone — nativ in einem Desktop-Fenster mit echter Tastatur. Sie fungiert als Client und steuert einen Agenten, der anderswo läuft (deine Desktop-App, ein CLI-Agent oder ein VPS).
Es gibt keine separate Mac-Codebasis für diesen Client. Der Mac-Client ist die iOS-App.
Was du auf dem Mac bekommst:
- Nahezu vollständige Funktionsparität mit iOS. Dateien durchsuchen, chatten, Sitzungen steuern, KI-Anbieter wechseln, Connectors und Crons verwalten — fast jede iOS-Funktion funktioniert auf dem Mac genauso.
- Für Desktop-Eingabe optimiert. Physische Tastaturkürzel, Trackpad-Scrollen, freie Fenstergröße und Kopieren/Einfügen verhalten sich wie von einer Desktop-App erwartet.
- Live-Sync mit iPhone. Chat- und Sitzungsstatus streamen in Echtzeit über das Relay. Sende eine Nachricht auf dem Mac, sieh sie sofort auf dem iPhone landen — wechsle Geräte mitten in einem Gespräch, ohne den Kontext zu verlieren.
- Geräte- und netzwerkübergreifend. Die Mac-App steuert jeden Agenten, den das Relay erreichen kann: deinen Heimcomputer, einen VPS, den Rechner eines Kollegen — in verschiedenen Netzwerken oder Städten. Wechsle während einer Sitzung zwischen WLAN, Ethernet und Hotspot — das Relay hält die Verbindung aufrecht.
- Mehr als das bloße Terminal. Im Vergleich zum direkten Ausführen von Claude oder Codex in einem Terminal bleibt jede Chat-Nachricht zwischen Mac und iPhone synchronisiert, und du kannst mehrere Arbeitsverzeichnisse und Sitzungen in separaten Fenstern nebeneinander verwalten.
Voraussetzungen
- Ein Mac mit Apple Silicon (Intel-Macs können keine iOS-Apps aus dem App Store installieren)
- macOS 11 Big Sur oder neuer
- Eine Apple-ID, die im App Store angemeldet ist
In vier Schritten installieren
- Öffne den App Store auf deinem Mac (Dock oder Launchpad).
- Suche nach
Btelo Coding. - Wechsle in den Ergebnissen zum Tab iPhone & iPad Apps. Dort befinden sich iOS-Apps auf dem Mac.
- Klicke auf „Laden" und installiere. Die App erscheint in deinem Applications-Ordner und im Launchpad.
Anmelden
Der einfachste Weg zur Verbindung ist das Scannen oder Einfügen einer Connector-URL vom Agenten, den du steuern möchtest:
- Öffne auf dem Agenten dessen Kopplungs-QR-Code — das Connect-Panel in der Desktop-App, oder den Dashboard-Tab im CLI-TUI (drücke r zum Aktualisieren, y zum Kopieren der URL).
- Öffne die Mac-App, gehe zur Connect-Seite und scanne den QR-Code oder füge die URL ein. Fertig.
Sitzungen synchronisieren sich über das Relay, sodass du eine Sitzung auf dem Mac starten und auf dem Telefon fortsetzen kannst — und umgekehrt.
Client vs. Agent
| Rolle | Was es ist | Wo es läuft |
|---|---|---|
| Client (Mac-App oder iOS-App) | Das, womit du steuerst | Dein Mac oder iPhone |
| Agent (Desktop-App oder CLI) | Das, was gesteuert wird | Dein Heimcomputer / VPS |
Das sind verschiedene Rollen. Der iOS-auf-Mac-Client führt den Agenten nicht aus — du benötigst weiterhin einen Agenten (die Desktop-App auf Mac/Windows oder den CLI-Agenten), der auf dem Computer läuft, den du steuern möchtest.
Intel-Macs
Der App Store bietet keine iOS-Apps auf Intel-Macs an. Um einen Agenten auf einem Intel-Mac auszuführen, verwende den CLI-Agenten (er läuft auf macOS 10.15+ amd64) und verbinde dich stattdessen von deinem iPhone aus.
Einschränkungen
- Das Fenster lässt sich frei skalieren, aber das Layout folgt iPad/iPhone-Idiomen — es ist keine neu gestaltete macOS-UI.
- Einige iOS-exklusive Systemfunktionen (Haptik, Live Activities) sind auf dem Mac nicht verfügbar.
- Push-Benachrichtigungen funktionieren über APNs nur auf dem offiziellen Relay. Selbst gehostete Relays liefern keine Benachrichtigungen.
Native Desktop-App vs. dieser
Es gibt eine native Desktop-App für Mac und Windows — sie spielt jedoch eine andere Rolle. Die Desktop-App führt den Agenten auf diesem Computer aus. Der hier beschriebene iOS-auf-Mac-Client steuert einen Agenten, der anderswo läuft. Verwende die Desktop-App, um diesen Mac zum gesteuerten Computer zu machen; verwende den iOS-Client auf dem Mac, um einen anderen Computer von hier aus zu steuern.