Zum Hauptinhalt springen

Lokale Befehle sicher ausführen

In der Desktop-Anwendung kann der Assistent Befehle und Tests im Arbeitsordner Ihres Chats ausführen. Wie das im Chat funktioniert, lesen Sie unter Lokaler Dateizugriff. Auf dieser Seite legen Sie fest, wann das ohne Nachfrage erlaubt ist und wie abgeschirmt Befehle laufen.

Befehlseinstellungen öffnen​

Öffnen Sie in einem Chat den Bereich Befehle und wählen Sie Befehlseinstellungen für diesen Ordner. Die Einstellungen gelten pro Ordner.

Wann darf der Assistent einen Befehl ausführen?​

Wählen Sie einen dieser drei Modi:

  • Immer fragen: Sie genehmigen jeden Befehl.
  • Vertrauenswürdige Befehle automatisch: Befehle, die Sie gespeichert haben, starten ohne Nachfrage. Andere Befehle fragen weiterhin nach Zustimmung.
  • Automatisch in der Sandbox: Alles startet ohne Nachfrage, aber in einer abgeschirmten Umgebung.

In jedem Modus gelten außerdem diese Regeln:

  • Harmlose Befehle starten ohne Karte: mkdir, ls, cat, head, tail, wc, grep, find (ohne -exec oder -delete), touch, pwd, tree und Versionsabfragen (--version, -v oder -V von node, npm, npx, python, pip und aischool-python). Sie tun nicht mehr als die eingebauten Dateiwerkzeuge, die ohnehin ohne Nachfrage arbeiten. Sie laufen in der Sandbox ohne Netzwerk und nur mit Pfaden innerhalb des Arbeitsordners, auch nach dem Folgen von Links (keine absoluten Pfade, kein ~ oder ..). Zeigt ein Link aus dem Ordner hinaus, erscheint doch eine Karte. Dafür sind eine Sandbox (macOS und Linux) und lokale Befehle nötig, aber nicht Automatische Ausführung erlauben Ihres Administrators. Im Bereich Befehle steht dann Automatisch (harmloser Befehl). Auch eine Liste in geschweiften Klammern wie mkdir -p src/{components,utils} startet ohne Karte: Die App macht daraus einzelne Pfade und prüft jeden davon.
  • Jede Karte zeigt den genauen Befehl und, bei Online-Aktionen, die genaue Adresse. Darunter steht kleiner die Erklärung des Assistenten.
  • Ist die Sandbox verfügbar und erlaubt Ihr Administrator automatisches Ausführen, hat eine Karte für einen Befehl, der in der Sandbox läuft, zusätzlich die Schaltfläche Künftig automatisch in der Sandbox in diesem Ordner. Sie stellt den Ordner auf Automatisch in der Sandbox, sodass weitere Befehle ohne Karte starten. Befehle, die Netzwerk brauchen, fragen noch einmal nach, es sei denn, Paketinstallationen sind erlaubt.
  • Die erste Karte in einem Ordner, die in der Sandbox läuft und kein Netzwerk anfragt, zeigt einmalig Diesem Projekt vertrauen. Sie führt den Befehl aus, stellt den Ordner auf Automatisch in der Sandbox und schaltet Paketinstallationen ohne Nachfrage erlauben ein. Danach starten Tests und Builds wie npm test, npm run build und node --test ohne Karte, in der Sandbox ohne Netzwerk. Befehle, die sonst Netzwerk brauchen oder außerhalb der Sandbox laufen, fragen weiterhin. Nach Ausführen oder Ablehnen kommt die Frage in diesem Ordner nicht wieder; den Modus ändern Sie in den Befehlseinstellungen. Ist die automatische Ausführung ausgeschaltet, nennt jede Karte, ob Ihr Administrator oder die Geräterichtlinie dieses Computers das bewirkt.

Vertrauenswürdige Befehle speichern​

Wählen Sie bei einem Befehl In diesem Ordner immer erlauben und danach Genau diesen Befehl oder Alles, was damit beginnt. Gespeicherte Befehle starten künftig ohne Nachfrage. Befehle mit Sonderzeichen (wie ; | > $) fragen immer nach Zustimmung.

Die gespeicherten Regeln stehen in den Befehlseinstellungen unter In diesem Ordner immer erlaubt. Dort können Sie sie auch wieder entfernen.

Sandbox und Netzwerk​

  • Sandbox verwenden: Befehle können nur in diesem Ordner schreiben. Diese Option ist unter macOS und Linux standardmäßig eingeschaltet.
  • Netzwerk erlauben: legt fest, ob Befehle Internetzugang haben. Diese Option ist standardmäßig ausgeschaltet. Ohne Sandbox haben Befehle immer Netzwerkzugang.

Jede Befehlskarte zeigt, ob Sandbox und Netzwerk eingeschaltet sind.

Ist Netzwerk erlauben ausgeschaltet und möchte der Assistent etwas herunterladen, zum Beispiel mit npm install, dann fragt die Befehlskarte, ob Sie genau diesen Befehl mit Netzwerk ausführen möchten. Sie müssen das Netzwerk also nicht für den ganzen Ordner einschalten.

Windows

Unter Windows ist noch keine Sandbox verfügbar.

Pakete installieren​

Die App bringt ein eigenes Node.js mit npm mit. Befehle wie node, npm und npx funktionieren daher auch, wenn Node.js nicht auf Ihrem Computer installiert ist. Haben Sie Node.js selbst installiert, verwendet die App diese Version. Ausnahme: Ein Projekt, das selbst Electron startet (electron .), braucht ein selbst installiertes Node.js.

Paketinstallationen ohne Nachfrage erlauben​

Schalten Sie in den Befehlseinstellungen für diesen Ordner den Schalter Paketinstallationen ohne Nachfrage erlauben ein. Installationen von Paketen mit Namen starten dann ohne Karte: npm install <name> und npm install aus package.json, pnpm, yarn oder bun mit install oder add sowie pip install <name> (auch über uv). Sie laufen immer in der Sandbox, mit Netzwerk. Andere Befehle folgen dem Modus, den Sie für den Ordner gewählt haben.

Diese Installationen zeigen weiterhin eine Karte:

  • Projektstarter wie npm create vite@latest und npx create-…, weil sie eigenen Code ausführen;
  • pip install ., pip install -r requirements.txt, Installationen aus einem anderen Register (--registry, -i, --index-url) und Pakete von einer Git-Adresse, URL oder einem Pfad.

Der Schalter funktioniert nur mit einer Sandbox (macOS und Linux) und wenn Ihr Administrator die automatische Ausführung erlaubt. Andernfalls können Sie ihn nicht einschalten.

Keine Installationsskripte

So installierte Pakete führen nie ihre eigenen Installationsskripte aus (npm läuft mit --ignore-scripts). Python-Pakete werden nur als fertige Wheels installiert.

Lokale Server und der integrierte Browser​

Der Assistent kann auch einen Entwicklungsserver starten, der weiterläuft, zum Beispiel npm run dev für ein kleines React-Projekt mit Vite. Dafür gelten dieselben Regeln wie für andere Befehle: Sie genehmigen den genauen Befehl, oder er startet über eine gespeicherte Regel oder automatisch in der Sandbox. Statt der maximalen Laufzeit steht auf der Karte "Läuft als lokaler Server weiter, bis Sie ihn stoppen."

Der Server läuft weiter, nachdem der Assistent geantwortet hat. Im Bereich Befehle zeigt die Karte den Status Server läuft mit den Schaltflächen Im Browser öffnen und Stoppen. Es können höchstens 4 Server gleichzeitig laufen. Server werden beendet, wenn Sie sie stoppen oder die App schließen.

In der Sandbox ohne Netzwerk darf ein Server nur auf diesem Computer lauschen (localhost). Wie der Assistent Pakete installiert, lesen Sie unter Pakete installieren.

Eine einfache Webseite anzeigen​

Für eine einfache Webseite (eine index.html mit CSS und JavaScript, ohne Build-Schritt) ist kein Befehl nötig. Der Assistent verwendet dann den integrierten Webserver der App:

  • Der Ordner ist nur auf diesem Computer sichtbar, unter http://127.0.0.1 mit einem zufälligen Port.
  • Versteckte Dateien wie .git und .env werden nie angezeigt.
  • Ändert sich eine Datei, lädt die Seite automatisch neu.

Dafür erscheint keine Genehmigungskarte. Der Server steht im Bereich Befehle, mit Im Browser öffnen und Stoppen, und zählt zum Maximum von 4 Servern.

Das Ergebnis sehen Sie im integrierten Browser: die Schaltfläche Browser (das Globus-Symbol) rechts in der oberen Leiste. Der Bereich öffnet sich neben dem Chat, mit Zurück, Vorwärts, Neu laden (Stoppen während des Ladens), einer Adressleiste und Im Standardbrowser öffnen.

  • Der Assistent öffnet den Browser selbst, um das Ergebnis eines lokalen Servers zu zeigen. Das geht nur mit lokalen Adressen wie http://localhost:5173.
  • Wenn Sie in einer Antwort auf einen localhost-Link klicken, öffnet er sich im integrierten Browser. Andere Links öffnen sich in Ihrem Standardbrowser.
  • Sie können auch selbst jede Webadresse eingeben.
  • Der Browser hat eine eigene, getrennte Sitzung: Sie sind dort nicht bei AI-Public angemeldet, Websites erhalten keine Berechtigungen wie Kamera oder Mikrofon, und Downloads sind nicht möglich.
  • Solange ein Menü oder Dialog der App geöffnet ist, wird die Seite vorübergehend ausgeblendet.

Beispiel:

Erstelle in diesem Ordner eine kleine React-App mit Vite mit einem Zähler. Installiere die Abhängigkeiten, starte den Entwicklungsserver und zeige das Ergebnis im Browser.

Den Assistenten mitschauen lassen​

Bittest du den Assistenten, sich die Seite im integrierten Browser anzusehen, liest er die Adresse, den Titel, den sichtbaren Text, einen Screenshot und die letzten Fehlermeldungen der Seite. Diese gehen an das KI-Modell.

  • Eine Seite auf diesem Computer (localhost oder 127.0.0.1) sieht sich der Assistent ohne Nachfrage an.
  • Bei jeder anderen Website, zum Beispiel einer Seite, auf der du angemeldet bist, zeigt der Assistent zuerst eine Karte: „Der Assistent möchte onedrive.live.com ansehen.“ Klicke auf Ansehen erlauben oder Ablehnen. Er fragt jedes Mal neu.
  • Wechselt die Seite nach deiner Zustimmung zu einer anderen Website, liest der Assistent nichts.
  • Nur auf einer Seite auf diesem Computer klickt und tippt der Assistent selbst, um zu testen, was er gebaut hat. Auf anderen Websites klickt, tippt und navigiert er nicht. Er erhält keine Cookies oder Passwörter.
  • Im Offline-Modus sieht sich der Assistent nur Seiten auf diesem Computer an.

Versionen und GitHub​

Der Assistent hat ein integriertes Git. Sie müssen Git also nicht installieren, auch nicht unter Windows. Der Assistent kann Versionen speichern, zeigen, was sich geändert hat, Branches anlegen und ein Projekt online stellen.

  • Aktionen in diesem Ordner, etwa eine Version speichern, starten ohne Nachfrage. Dateien, die nach Geheimnissen aussehen (wie .env-Dateien oder Schlüssel und Tokens im Code, auch Google-API-Schlüssel, die mit AIza beginnen), landen nie in einer Version. Der Assistent meldet es, wenn er etwas überspringt.
  • Online-Aktionen (ein Projekt herunterladen, die neueste Version abrufen, online stellen und ein GitHub-Repository anlegen) zeigen zuerst eine Karte mit der genauen Adresse und den Labels In die App eingebaut und Netzwerk an. Ist die Adresse nicht github.com oder wird ein neues Repository öffentlich, warnt die Karte. Beim Online-Stellen zeigt die Karte, welche Dateien gesendet werden. Wählen Sie Ausführen oder Ablehnen.
  • Auch das Verbinden eines Repositorys außerhalb von github.com fragt zuerst nach Zustimmung.

Wie Sie GitHub verbinden und ein Projekt online stellen, lesen Sie unter Vibe Coding.

Offline-Modus

Im Offline-Modus laufen Befehle immer in der Sandbox ohne Netzwerk. Paketinstallationen mit Netzwerk und die Online-Aktionen des eingebauten Git (herunterladen, abrufen, hochladen und GitHub) funktionieren dann nicht. Versionen speichern und eine einfache Webseite anzeigen funktionieren weiterhin.

Einstellungen für Administratoren​

Administratoren können lokale Befehle oder die automatische Ausführung für alle in der Umgebung ausschalten. Das tun sie in der Verwaltung unter Funktionen (auf Ebene der Umgebung), in der Karte Desktop-App:

  • Lokale Befehle erlauben: Ist dies ausgeschaltet, kann der Assistent keine Befehle ausführen. Auch die Online-Aktionen des integrierten Git funktionieren dann nicht. Versionen speichern und Branches funktionieren aber weiter: Sie ändern nur Dateien im Ordner, genau wie die Dateiwerkzeuge.
  • Automatische Ausführung erlauben: Ist dies ausgeschaltet, fragt jeder Befehl nach Zustimmung, und Sie können Paketinstallationen ohne Nachfrage erlauben nicht einschalten.
  • Python der App für Office-Dateien erlauben: für Vorlagen, Diagramme und Analysen. Dieses Python arbeitet ohne Internet, schreibt nur in den Arbeitsordner und kann keine anderen Programme starten. Ist nichts eingestellt, folgt es Lokale Befehle erlauben. Ohne Sandbox (Windows) ist es nur verfügbar, wenn lokale Befehle eingeschaltet sind, und fragt jedes Mal um Erlaubnis.

Auf dieser Seite