Umgebung
Der Bereich Umgebung setzt einfache Umgebungsvariablen, die in jede Shell in der VM der Maschine exportiert werden (eine Maschine ist ein Arbeitsbereich, im Einstellungseditor). Sie sind für nicht geheime Einstellungen — Log-Level, Feature-Flags, Build-Schalter — die Sie in der Umgebung des Agenten haben wollen, ohne jede Behandlung von Anmeldedaten.
Die Beschriftung sagt, was der Bereich tut und wofür er nicht gedacht ist: „Einfache KEY=VALUE-Paare, über proxy.env (aus .bashrc geladen) in jede Shell in der VM exportiert. Keine Ersetzung durch den Proxy — die Werte landen wortwörtlich auf der VM, legen Sie hier also keine Geheimnisse ab. Gut für Log-Level, Feature-Flags, Build-Schalter." Ist nichts konfiguriert, liest er Keine Umgebungsvariablen konfiguriert.
Wie Variablen exportiert werden
Jede Variable wird in proxy.env geschrieben, das die verwaltete .bashrc der Maschine für jede Shell lädt. Der Wert ist in jedem Terminal, in jedem Befehl, den der Agent ausführt, und in jeder Login- und Nicht-Login-Shell vorhanden, genau wie Sie ihn getippt haben. Es gibt keinen Stellvertreter und keinen Tausch auf dem Draht.
Für ein Token oder ein Passwort nutzen Sie stattdessen den Bereich Zugangsdaten: dort bekommt die VM nur einen Stellvertreter, und der echte Wert wird auf dem Draht eingesetzt. Ein Geheimnis, das in diesen Bereich getippt wird, landet im Klartext in der VM.
Variablen hinzufügen und bearbeiten
Variable hinzufügen hängt eine Zeile mit einem Namens- und einem Wertfeld an; die Minus-Schaltfläche entfernt sie. Der Name muss ein gültiger Shell-Bezeichner sein — ein Buchstabe oder Unterstrich, dann Buchstaben, Ziffern und Unterstriche. Ein Name, der nicht passt, zeigt eine orange Warnung und wird nicht exportiert. Der Wert wird so verwendet, wie er geschrieben ist.
Änderungen auf einer laufenden Maschine
Das Sichern greift ohne Neustart: proxy.env wird neu geschrieben, und Shells, die nach dem Sichern geöffnet werden, sehen die neuen Werte. Ein schon laufender Agent behält die Umgebung, mit der er gestartet ist; ein neuer Tab oder eine neue Sitzung nimmt die Änderung auf.
Die Werte liegen in der verschlüsselten secrets.enc der Maschine, wie die anderen Daten des Bereichs, nicht in profile.json.
Einstellungsreferenz
| Einstellung | Typ | Voreinstellung | Beschreibung |
|---|---|---|---|
| Variablenliste | Namens-/Wert-Zeilen | Leer | Jede Zeile exportiert eine Variable über proxy.env in jede Shell. Ungültige Namen zeigen eine Warnung und werden übersprungen. Werte werden wortwörtlich verwendet. |
| Variable hinzufügen | Schaltfläche | — | Hängt eine leere Zeile an. |
Verwandte Kapitel
- Zugangsdaten — wohin Geheimnisse gehören.
- MCP — MCP-Server, von denen manche Umgebungsvariablen lesen.
- Einstellungsreferenz — alle Bereiche auf einen Blick.