MXterm Pro installieren und ersten Workspace erstellen
Diese Seite führt Sie vom Download bis zum laufenden Workspace: die App installieren, den Workspace-Composer ausfüllen und sich in Tabs, Fenstern und der Seitenleiste zurechtfinden. Lesen Sie den Abschnitt zum Bypass Mode, bevor Sie einen Agent starten.
Installation
Laden Sie MXterm Pro auf der Download-Seite herunter. Für den Mac erhalten Sie ein DMG, das nativ auf Apple Silicon und auf Intel läuft und macOS 10.15 oder neuer voraussetzt. Für Windows bietet die Download-Seite einen Installer für Windows 10 oder 11 auf x64 an; ein ARM64-Build existiert nicht. Der Rest dieser Seite wurde an der macOS-App geprüft; wo Windows bekanntermaßen abweicht, steht es im Text.
Nachdem Sie auf der Website einen Download-Button angeklickt haben, zeigt ein Popup Installation in drei Schritten die Schritte für die gewählte Datei. Es sind dieselben wie unten.
- Öffnen Sie das heruntergeladene DMG.
- Ziehen Sie MXterm Pro in Programme.
- Öffnen Sie MXterm Pro aus „Programme“.
- Fragt macOS, ob Sie eine aus dem Internet geladene App öffnen möchten, wählen Sie Öffnen.
Unter macOS ist die App mit einer Apple Developer ID signiert und von Apple notarisiert.
Unter Windows:
- Führen Sie die heruntergeladene
.exeaus. - Zeigt Windows SmartScreen Der Computer wurde durch Windows geschützt, klicken Sie auf Weitere Informationen und dann auf Trotzdem ausführen. Der Installer ist noch nicht signiert, deshalb zeigt Windows als Herausgeber „Unbekannter Herausgeber“ an.
- Folgen Sie den Schritten des Installers.
Erster Start
Beim ersten Öffnen der App erscheint eine Tour mit sechs Folien und dem Titel Willkommen bei MXterm Pro. Mit Weiter gehen Sie sie durch, mit Tour überspringen schließen Sie sie. Das Sprachmenü in ihrer Kopfzeile listet jede Sprache auf, die die App anbietet; wenn Sie eine auswählen, wechseln Tour und App in diese Sprache. Die Tour öffnet sich nur einmal von selbst und kommt nach dem Schließen nicht wieder; im Logo-Menü können Sie sie unter Willkommenstour erneut abspielen.
Hinter der Tour hat das Fenster einen einzelnen Tab, New Tab, der den Workspace-Composer zeigt. Die Oberfläche startet in der ersten Sprache aus der Sprachliste Ihres Systems, die die App anbietet, und auf Englisch, wenn keine davon angeboten wird; eine früher gewählte Sprache bleibt erhalten. Die App bietet English, Tiếng Việt, 简体中文, 日本語, 한국어, Español, Français, Türkçe, Bahasa Indonesia, Português (Brasil) und Deutsch an. Sie können sie später in den Einstellungen ändern, wo jede Sprache unter ihrem eigenen Namen steht.
Workspace erstellen
Ein Workspace ist ein Tab mit einem Raster aus Terminal-Panes, die alle in einem Ordner starten. Bis Sie ihn erstellen, läuft nichts.
- Geben Sie unter Arbeitsordner einen Pfad ein oder klicken Sie auf Durchsuchen. Die Auswahl beginnt in Ihrem Home-Ordner, und früher verwendete Ordner stehen unter Zuletzt verwendet.
- Wählen Sie unter Wie viele Terminals? 1, 2, 4, 6, 8, 9, 10, 12, 16 oder 20. Die Vorschau darunter zeigt das Raster, das Sie erhalten. Anordnung wechselt zwischen Horizontal (ein Raster) und Vertikal (eine Reihe hoher Spalten, die Panes nebeneinander). Vertikal bietet 1 bis 6 Panes, und eine Zahl, die nicht angeboten wird, fällt auf die größte Zahl darunter zurück.
- Stellen Sie unter KI-Agents mit den Schaltflächen − und + ein, in wie vielen Panes jeder Agent läuft. Die Liste beginnt mit Claude Code, Codex, Grok und Gemini CLI, dann folgt die Zeile Terminal (einfache Shell), danach OMP; die übrigen Agents schließen an, installierte zuerst. Ein Agent, dessen CLI die App nicht findet, ist als Nicht installiert markiert und hat eine Schaltfläche Installieren, die die Installationsanleitung dieses Agents öffnet; MXterm Pro führt die Installation nie für Sie aus. Bei Cursor Agent ist das die CLI
cursor-agent. Solange die App noch prüft oder wenn die Prüfung fehlgeschlagen ist (es erscheint ein Link Erneut versuchen), lässt sich kein Agent auswählen, und jedes Pane ist eine einfache Shell. - Panes, die Sie nicht zuweisen, führen eine einfache Shell aus. In der Zeile Terminal (Plain Shell) wählen Sie diese Shell und legen die Zahl der einfachen Panes ausdrücklich fest.
- Prüfen Sie die drei Optionen unter der Vorschau (siehe die Tabelle unten) und klicken Sie dann auf Workspace erstellen oder drücken Sie
Cmd+Enter(unter WindowsCtrl+Enter).
Der Composer bietet immer Claude Code, Codex, OpenCode, GitHub Copilot, Qwen Code, Amp, Gemini CLI, Cursor Agent, Antigravity, OMP (Oh My Pi) und Grok an. Weitere Agents, etwa Aider, Goose, Kimi Code und Devin, erscheinen erst, wenn MXterm Pro ihre CLI auf Ihrem Rechner findet. Der Composer beginnt mit 2 Terminals und belegt sie nur mit Agents, die Sie installiert haben. Sind Claude Code und Codex installiert, schlägt er je einen vor. Sonst teilen die ersten beiden installierten Agents der Liste die Panes unter sich auf, die Hälfte (aufgerundet) für den ersten; bei einem installierten Agent bekommt er die Hälfte, und die übrigen sind einfache Shells, und ohne installierten Agent ist jedes Pane eine einfache Shell. Wenn Sie auf Workspace erstellen klicken, merkt sich der Composer diese Auswahl (Agents, einfache Terminals, Anordnung und Zahl der Panes) und beginnt beim nächsten Mal damit, angepasst an die Zahl der Panes, die Sie wählen; ein gemerkter Agent, der nicht mehr installiert ist, wird zu einer einfachen Shell. Prüfen Sie die Zeilen unter KI-Agents, bevor Sie den Workspace erstellen.
| Option | Standard | Was sie bewirkt |
|---|---|---|
| Bypass-Modus aktivieren (CLI-Berechtigungen automatisch genehmigen) | Aus | Startet unterstützte Agents mit ihrem Flag zum Überspringen der Freigabe. Siehe Bypass Mode. |
| Features in git worktrees isolieren | Aus | Jedes Agent-Pane startet in einem eigenen git worktree mit eigenem Branch, angelegt unter .worktrees/ im Ordner. .worktrees/ wird der .gitignore des Ordners hinzugefügt. |
| Vorherige Sitzung fortsetzen (--resume / codex resume) | Aus | Startet Claude Code, Gemini CLI, OMP und Grok mit --resume und Codex mit codex resume, so wie jede CLI eine frühere Sitzung wieder öffnet. Grok öffnet seine letzte Sitzung im Ordner. Die übrigen Agents starten normal. |
Hat der Ordner bereits Agent-Sitzungen, erscheint unter dem Ordnerfeld eine Liste Sitzungen fortsetzen. Haken Sie eine Sitzung an, um sie in einem eigenen Pane wieder zu öffnen. Ein Workspace fasst höchstens 20 Panes, deshalb lässt sich nichts mehr anhaken, sobald Sie diese Zahl erreichen. Eine angehakte Sitzung hat für ihr Pane Vorrang vor der Option zum Fortsetzen.
Ist der Ordner ein git-Repository ohne Commits, committet Features in git worktrees isolieren zuerst eine leere .gitkeep als Initial commit, denn ein Worktree braucht einen Commit als Ausgangspunkt. Sonst wird im Ordner nichts gestaged oder committet.
Der Composer hat zwei Spalten, links den Arbeitsordner und rechts die Terminals, solange der Tab breit genug ist. Ist er es nicht, etwa bei geöffneter Seitenleiste und geöffnetem rechten Bereich, stapeln sich die Spalten zu einer einzigen.
Mehr zu Agents und Worktrees steht unter Agents und Control Room (früher War Room).
Der Bypass Mode ist standardmäßig aus
Der Bypass Mode weist Agents an, ihre Freigabeabfragen zu überspringen. Sie führen dann Befehle aus und ändern Dateien, ohne vorher zu fragen. Er ist aus, solange Sie ihn nicht einschalten: Standardmäßig halten Ihre Agents an und fragen nach.
Wenn Sie eine frühere Version genutzt haben, zeigt der Composer einen Hinweis, bis Sie ihn schließen oder das Kästchen ändern: Der Bypass-Modus ist jetzt standardmäßig aus. Agents fragen nach, bevor sie Befehle ausführen oder Dateien ändern. Mit dem Schalter unten schalten Sie ihn wieder ein. Haben Sie das Kästchen schon selbst an- oder abgehakt, bleibt Ihre eigene Wahl erhalten.
So schalten Sie ihn ein:
- Öffnen Sie den Composer: Drücken Sie
Cmd+T(unter WindowsCtrl+T) oder klicken Sie auf + am Ende der Tab-Leiste und wählen Sie Neuer Tab. - Haken Sie Bypass-Modus aktivieren (CLI-Berechtigungen automatisch genehmigen) an.
--dangerously-skip-permissions, Codex mit --dangerously-bypass-approvals-and-sandbox, Gemini CLI und Qwen Code mit --yolo und Grok mit --always-approve. Der Composer sagt das unter dem Kästchen: Agents führen Befehle aus und ändern Dateien, ohne zu fragen. Schalten Sie ihn nur in Ordnern ein, in denen Sie das hinnehmen.Bypass Mode fügt das eigene Flag zum Überspringen von Freigaben jedes unterstützten Agents hinzu, das MXterm Pro für 14 Agents kennt. Die übrigen, darunter OpenCode, GitHub Copilot, Amp, Cursor Agent, Antigravity und OMP, starten mit ihrem normalen Befehl, ob der Bypass Mode ein- oder ausgeschaltet ist.
Ihre Wahl wird gespeichert, sobald Sie sie ändern. Jedes danach gestartete Agent-Pane folgt ihr, auch Panes, die beim nächsten Start der App wieder geöffnet werden. Das Kästchen im Composer ist der Schalter für den Bypass per Flag. Goose hat kein Flag, daher ist sein Auto-Modus eine Umgebungsvariable, die nur in den Einstellungen angeboten wird.
Free und Pro
Alles auf dieser Seite funktioniert im Free-Tarif. Der Free-Tarif hat kein Pane-Limit: Sie können über alle Tabs und Fenster hinweg beliebig viele Panes öffnen. Neben den Panes begrenzt der Free-Tarif standardmäßig sechs Dinge, und eine Pro-Lizenz hebt alle auf. Pro bringt außerdem My Devices (Ihre anderen angemeldeten Macs ohne Code oder Passwort öffnen) und ein dauerhaftes Zugangspasswort (läuft nicht ab).
| Limit | Free | Pro |
|---|---|---|
| Gespeicherte SSH-Hosts | 5 | Unbegrenzt |
| Control Rooms mit Mitgliedern gleichzeitig | 1 | Unbegrenzt |
| Terminals in einem Control Room | 2 | Unbegrenzt |
| Gespeicherte Rechner | 1 | Unbegrenzt |
| Andere Computer, die diesen steuern | 1 | Unbegrenzt |
| Gleichzeitig für die Fernsteuerung geteilte Panes | 5 | Unbegrenzt |
Das sind die Standardwerte. mxterm.net kann sie für Free innerhalb fester Bereiche ändern, und eine Änderung kann ablaufen, danach gelten wieder die Standardwerte. Ein Limit wird geprüft, wenn Sie etwas hinzufügen: Ein niedrigeres Limit schließt nie, was bereits offen oder gespeichert ist, und wer im Free-Tarif einen zweiten Rechner hinzufügt, bekommt den Upgrade-Dialog, während die vorhandenen Rechner bleiben. Dasselbe gilt für einen zweiten Control Room mit Mitgliedern: Ein Raum ohne Mitglieder zählt nicht, und die Räume, die Sie schon haben, bleiben. Die App selbst setzt die Limits für Control Rooms und Rechner durch. Die MXterm-App auf dem Telefon (iPhone, iPad) zählt nicht zum Limit von 1 anderen Computer, der diesen Mac steuern kann. Nur andere Computer mit MXterm zählen, Browser nicht. Die beiden Limits der Fernsteuerung weisen nur Neues ab: Ein bereits gekoppelter Computer und ein bereits geteiltes Pane bleiben bestehen.
Der Fernzugriff hat noch eine Pro-Grenze: Im Free-Tarif lässt sich ein Zugangspasswort einschalten, das bis zu 8 Stunden gilt (Temporär); ein dauerhaftes Passwort (Dauerhaft) oder ein temporäres über 8 Stunden (bis zu 7 Tage) braucht Pro. Ein Passwort hat mindestens 6 Zeichen. Siehe Einstellungen.
Dateien über SFTP zu durchsuchen, zu bearbeiten, hoch- und herunterzuladen ist kostenlos, ebenso der Token Meter.
Wenn Sie ein Limit erreichen, nennt ein Dialog es und bietet MXterm Pro holen, Lizenzschlüssel eingeben oder Nicht jetzt an. Die Tarife stehen unter Preise; wie Sie einen Schlüssel aktivieren, beschreiben die Einstellungen.
Das Schließen des letzten Fensters beendet die App
Wer das einzige MXterm-Pro-Fenster schließt, beendet die App, auf jeder Plattform. Sie läuft nicht im Hintergrund weiter: Jedes Terminal und jeder Agent in jedem Tab wird gestoppt. Mit dem Beenden enden alle laufenden Verbindungen. MXterm Pro ist so gebaut, dass es Ihre Freigaben speichert und beim nächsten Start wiederherstellt, sobald dasselbe Pane wieder läuft; eine Freigabe, die sich nicht verifizieren lässt, wird verworfen, nie erweitert.
Haben Sie ein zweites Fenster geöffnet, ist das Schließen eines der beiden kein Beenden. Ein Fenster, in dem noch Terminals laufen, fragt zuerst Dieses Fenster schließen? und bietet an, seine Tabs ins andere Fenster zu verschieben, statt sie zu beenden. Nur das Schließen des letzten Fensters beendet die App.
Solange die App läuft, holt ihr Symbol in der Menüleiste (unter Windows im Infobereich der Taskleiste) per Klick das Fenster nach vorn, und sein Menü enthält Show MXterm Pro, Merge All Windows, Check for Updates… und Quit.
Öffnen Sie die App wieder, kommen Ihre Workspace-Tabs mit ihren Pane-Layouts zurück, und jedes Pane startet erneut in seinem Ordner. Ein Claude-Code-Pane öffnet seine eigene Unterhaltung über die ID wieder, wenn die App sich eine gemerkt hat, und startet sonst eine neue Unterhaltung. Panes mit Gemini CLI, OMP und Grok werden mit --resume gestartet und Codex-Panes mit codex resume, damit Sie die vorherige Unterhaltung wieder aufnehmen können; andere Panes starten neu. Tabs, die noch im Composer standen, werden nicht wiederhergestellt.
Die App merkt sich außerdem etwa alle 3 Sekunden, was jedes Pane ausführt. Bei Claude Code und OMP behält sie die geöffnete Unterhaltung, sodass das Pane genau diese wieder öffnet und weder eine Auswahl noch die letzte im Ordner. Existiert diese Unterhaltung nicht mehr, versuchen es Claude Code, OMP und Grok in den meisten Shells mit einfachem --resume erneut, statt an einem leeren Prompt stehen zu bleiben. Haben Sie selbst einen Agent in einem einfachen Terminal-Pane gestartet, kommt das Pane mit diesem Agent zurück, auf dieselbe Weise fortgesetzt, aber ohne sein Bypass-Mode-Flag. Unter Windows liest die App nicht aus, was ein Pane ausführt, daher findet dieses Merken dort nicht statt.