DocsKonfigurationUmgebungsvariablen
Zurück zur Doku
Konfiguration

Umgebungsvariablen

YeePilot-Einstellungen per Umgebungsvariable überschreiben: für temporäre Änderungen, Automatisierung und sichere Geheimnisverwaltung.

Zuletzt aktualisiert: 12. Mai 2026

Warum Umgebungsvariablen sinnvoll sind

Umgebungsvariablen eignen sich, wenn Sie:

  • Geheimnisse nicht in config.yml speichern möchten
  • eine Änderung nur für eine Shell-Sitzung brauchen
  • YeePilot in Automatisierung oder CI ausführen
  • einen Standardwert temporär überschreiben wollen

Umgebungsvariablen haben Vorrang vor ~/.yeepilot/config.yml.

Namensschema

Die Regel lautet:

  1. mit YEEPILOT_ beginnen
  2. den Konfigurationsschlüssel groß schreiben
  3. Punkte durch Unterstriche ersetzen

Beispiele:

KonfigurationsschlüsselUmgebungsvariable
ai.providerYEEPILOT_AI_PROVIDER
ai.modelYEEPILOT_AI_MODEL
ai.vibe_codingYEEPILOT_AI_VIBE_CODING
security.modeYEEPILOT_SECURITY_MODE
sandbox.network_accessYEEPILOT_SANDBOX_NETWORK_ACCESS
tui.themeYEEPILOT_TUI_THEME
vault.auto_lock_durationYEEPILOT_VAULT_AUTO_LOCK_DURATION
update.channelYEEPILOT_UPDATE_CHANNEL

Besonders nützliche Overrides

Anbieter und Modell

bash
export YEEPILOT_AI_PROVIDER=openai
export YEEPILOT_AI_MODEL=gpt-4o

API-Endpunkt und Limits

bash
export YEEPILOT_AI_BASE_URL=http://localhost:11434/v1
export YEEPILOT_AI_MAX_TOKENS=4096
export YEEPILOT_AI_TOKEN_MODE=saver
export YEEPILOT_AI_THINK_MODE=medium

Lokaler Schalter für Coding-Agent-Funktionen

bash
export YEEPILOT_AI_VIBE_CODING=false

Das ist der lokale Geräteschalter für Coding-Agent-Funktionalität, sofern Ihr aktueller Plan sie erlaubt.

Sicherheit und Sandbox

bash
export YEEPILOT_SECURITY_MODE=strict
export YEEPILOT_SECURITY_REQUIRE_CONFIRMATION=true
export YEEPILOT_SANDBOX_ENABLED=true
export YEEPILOT_SANDBOX_NETWORK_ACCESS=false

TUI und Dateiverhalten

bash
export YEEPILOT_TUI_THEME=dark
export YEEPILOT_TUI_LIVE_STREAM_PANEL_ENABLED=true
export YEEPILOT_FILES_CLIPBOARD_PASTE_MODE=auto

Updates

bash
export YEEPILOT_UPDATE_CHANNEL=public
export YEEPILOT_UPDATE_AUTO_CHECK=true

Geschützte Canary-Nutzung:

bash
export YEEPILOT_UPDATE_CHANNEL=canary
export YEEPILOT_UPDATE_CHANNEL_TOKEN=ihr-token

Anbieterspezifische API-Key-Variablen

YeePilot versteht zusätzlich die üblichen Provider-Variablen:

VariableAnbieter
OPENAI_API_KEYOpenAI
ANTHROPIC_API_KEYAnthropic
OPENROUTER_API_KEYOpenRouter

Wenn YEEPILOT_AI_API_KEY gesetzt ist, hat dieser Vorrang.

Praktische Kurzbeispiele

Nur für eine Shell-Sitzung anderen Anbieter nutzen

bash
YEEPILOT_AI_PROVIDER=anthropic \
YEEPILOT_AI_MODEL=claude-sonnet-4-20250514 \
ANTHROPIC_API_KEY=... \
yeepilot

Strikte lokale Freigaben erzwingen

bash
export YEEPILOT_SECURITY_MODE=strict
export YEEPILOT_AI_AUTONOMY_PROFILE=strict_review

Lokale Coding-Tools auf diesem Gerät deaktivieren

bash
export YEEPILOT_AI_VIBE_CODING=false

Beispiel für CI und Automatisierung

bash
export YEEPILOT_AI_PROVIDER=openai
export YEEPILOT_AI_MODEL=gpt-4o
export OPENAI_API_KEY="$OPENAI_SECRET"
export YEEPILOT_SECURITY_MODE=strict
 
yeepilot exec "Prüfe die Datenträgerbelegung und fasse das Ergebnis zusammen"

Worauf Endnutzer heute nicht mehr setzen sollten

In älteren Materialien taucht ai.agent_mode auf. Dieser Schlüssel ist nur noch Legacy-Kompatibilität und sollte nicht Ihr zentraler Endnutzer-Schalter sein. Nutzen Sie stattdessen:

  • /plan
  • /autonomy
  • ai.vibe_coding

für modernes Alltagsverhalten.