Umgebung

Der Bereich Umgebung legt einfache Umgebungsvariablen fest, die in jede Shell in der VM des Arbeitsbereichs exportiert werden. Dies sind nicht geheime Konfigurationsschalter — Log-Level, Feature-Flags, Build-Schalter —, die Sie in der Umgebung des Agenten vorfinden möchten, ohne eine Swap- oder Zugangsdaten-Mechanik einrichten zu müssen.

Die Beschriftung des Bereichs benennt sowohl, was er tut, als auch, wofür er nicht gedacht ist: Einfache KEY=VALUE-Paare, die über proxy.env (aus .bashrc geladen) in jede Shell in der VM exportiert werden. Keine Proxy-Substitution — Werte landen wortwörtlich auf der VM, legen Sie hier also keine Geheimnisse ab. Geeignet für Log-Level, Feature-Flags, Build-Schalter. Ohne Konfiguration steht dort Keine Umgebungsvariablen konfiguriert.

Wie Variablen exportiert werden

Jede Variable, die Sie hinzufügen, wird in proxy.env geschrieben, eine Datei auf der Metadaten-Freigabe des Arbeitsbereichs, die die verwaltete .bashrc für jede Shell lädt. Das bedeutet, dass der Wert in jedem Terminal-Tab vorhanden ist, bei jedem Befehl, den der Agent ausführt, und in jeder Login- und Nicht-Login-Shell — wortwörtlich, genau so, wie Sie ihn eingegeben haben. Es gibt keinen brm_…-Köder und keinen Wire-Swap: Dieser Bereich ist eine reine Durchleitung, was genau der Grund ist, warum Geheimnisse hier nichts zu suchen haben.

Wenn Sie möchten, dass die VM ein Token oder Passwort enthält, verwenden Sie stattdessen den Bereich Zugangsdaten. Alles, was dort definiert ist, wird als Köder eingeschleust und auf der Übertragungsstrecke gegen den echten Wert ausgetauscht; ein in den Bereich Umgebung eingegebenes Geheimnis würde hingegen im Klartext innerhalb der Sandbox landen.

Variablen hinzufügen und bearbeiten

Klicken Sie auf Variable hinzufügen, um eine Zeile anzuhängen. Jede Zeile besteht aus einem Feld Name und einem Feld Wert, mit einer Minus-Schaltfläche zum Entfernen.

Der Name wird gegen die Shell-Bezeichnerregel [A-Za-z_][A-Za-z0-9_]* validiert — er muss mit einem Buchstaben oder Unterstrich beginnen und darf nur Buchstaben, Ziffern und Unterstriche enthalten. Ein Name, der nicht passt, zeigt eine orangefarbene Inline-Warnung an und wird nicht exportiert. Der Wert ist unbeschränkt und wird genau so verwendet, wie er geschrieben ist.

Tipp: Gruppieren Sie zusammengehörige Schalter in einem Arbeitsbereich und lassen Sie einen Scratch-Arbeitsbereich leer. Da diese Variablen pro Arbeitsbereich gelten, bleibt ein für ausführliches Debugging abgestimmter Arbeitsbereich (RUST_LOG=debug, NODE_ENV=development) getrennt von einem, der für einen sauberen, produktionsähnlichen Build konfiguriert ist.

Live-Aktualisierung einer laufenden Sitzung

Das Bearbeiten und Sichern dieses Bereichs erfordert keinen VM-Neustart. Bromure Agentic Coding erhöht einen internen env.generation-Zähler und schreibt proxy.env neu; neue Shells, die nach dem Sichern geöffnet werden, laden sie erneut und sehen die aktualisierten Werte sofort. Ein bereits laufender Vordergrund-Agent behält die Umgebung, mit der er gestartet ist, bis er beendet wird — ein neuer Prompt (oder ein neuer Tab) übernimmt die Änderung.

Obwohl diese Werte per Absicht nicht geheim sind, werden sie beim Sichern dennoch im verschlüsselten secrets.enc-Blob des Arbeitsbereichs gespeichert, zusammen mit den übrigen Daten des Bereichs, statt in der Klartext-Datei profile.json.

Einstellungsreferenz

Verwandte Kapitel

• Zugangsdaten — wohin Geheimnisse gehören; als Köder eingeschleust und auf der Übertragungsstrecke ausgetauscht.
• MCP — Konfiguration von Tool-Servern, von denen einige Umgebungsvariablen lesen.
• Einstellungsreferenz — alle Bereiche auf einen Blick.