Zum Hauptinhalt springen

Umgebungsvariablen

IaC Code liest die Konfiguration aus CLI-Argumenten, Umgebungsvariablen und Konfigurationsdateien. Die Rangfolge ist:

CLI-Argumente > Umgebungsvariablen > Konfigurationsdateien

Umgebungsvariablen sind nuetzlich fuer CI/CD-Pipelines, Container und einmalige Ueberschreibungen, ohne Konfigurationsdateien bearbeiten zu muessen.

LLM-Konfiguration

VariableBeschreibung
IAC_CODE_PROVIDERName des Modellanbieters (Gross-/Kleinschreibung wird nicht beachtet). Gueltige Werte: DashScope, DashScope Token Plan, OpenAI, Anthropic, DeepSeek, Gemini, Azure OpenAI, ModelScope, Kimi CN, Kimi Intl, MiniMax CN, MiniMax Intl, ZhiPu CN, ZhiPu Intl, Volcengine CN, SiliconFlow CN, SiliconFlow Intl, Aliyun CodingPlan, Aliyun CodingPlan Intl, ZhiPu CN CodingPlan, ZhiPu Intl CodingPlan, Volcengine CodingPlan, OpenAPI Compatible, Anthropic Compatible, OpenRouter, Ollama, LM Studio
IAC_CODE_MODELModellname
IAC_CODE_BASE_URLAPI-Endpunkt nur fuer OpenAI Compatible; wird fuer andere Anbieter ignoriert (mit einer Warnung)
IAC_CODE_API_KEYAPI-Schluessel des Anbieters; ueberschreibt den Schluessel des aktiven Anbieters in .credentials.yml

Siehe LLM-Anbieter fuer Anbieterdetails.

Alibaba Cloud-Anmeldedaten

VariableBeschreibung
ALIBABA_CLOUD_ACCESS_KEY_IDAccessKey-ID
ALIBABA_CLOUD_ACCESS_KEY_SECRETAccessKey-Secret
ALIBABA_CLOUD_SECURITY_TOKENSTS-Token; wechselt den Anmeldedatenmodus zu STS, wenn gesetzt
ALIBABA_CLOUD_REGION_IDStandardregion

Siehe Alibaba Cloud-Anmeldedaten fuer weitere Details.

Telemetrie

VariableBeschreibung
IAC_CODE_DISABLE_NONESSENTIAL_TRAFFICAuf 1 / true / yes / on setzen, um nicht-essentiellen Telemetrie-Datenverkehr zu deaktivieren
DISABLE_TELEMETRYAuf 1 / true / yes / on setzen, um die gesamte Telemetrie zu deaktivieren
IAC_CODE_TELEMETRY_ENDPOINTBasis-OTLP-Endpunkt; einzelne Signalendpunkte verwenden standardmaessig diesen Wert
IAC_CODE_TELEMETRY_TRACES_ENDPOINTUeberschreibungsendpunkt fuer Traces
IAC_CODE_TELEMETRY_METRICS_ENDPOINTUeberschreibungsendpunkt fuer Metriken
IAC_CODE_TELEMETRY_LOGS_ENDPOINTUeberschreibungsendpunkt fuer Protokolle
IAC_CODE_TELEMETRY_HEADERSBenutzerdefinierte OTLP-Header (JSON- oder key=value-Format)

Sonstiges

VariableBeschreibung
IAC_CODE_CONFIG_DIRUeberschreibt das Laufzeitkonfigurationsverzeichnis (Standard ~/.iac-code/); unterstuetzt ~- und $VAR-Erweiterung. Alle persistierten Artefakte (Anmeldedaten, Einstellungen, Verlauf, projects, image-cache, skills, telemetry usw.) folgen diesem Verzeichnis
IAC_CODE_LOG_DIRUeberschreibt das lokale Verzeichnis fuer Start-/Debug-Logs (Standard <config-dir>/logs/); unterstuetzt ~- und $VAR-Erweiterung. Berechtigungsauditdatensaetze folgen dem Sitzungslayout und werden durch diese Variable nicht verschoben
IAC_CODE_PERMISSION_AUDIT_INCLUDE_TOOL_INPUTUeberschreibt permissions.audit.include_tool_input; auf 1 / true / yes / on setzen, um die Form der Tool-Eingabe in Berechtigungsauditdatensaetze aufzunehmen, mit Typ/Laenge/Fingerprint statt roher fachlicher Payload-Strings und mit Fingerprints fuer Feldnamen ausserhalb der Whitelist
IAC_CODE_ENVBezeichnung der Bereitstellungsumgebung (Standard: production)
IAC_CODE_TENANT_IDMandantenkennung fuer Telemetrie; wird automatisch mit iac_tenant_ vorangestellt, wenn nicht bereits vorhanden
IAC_CODE_GIT_BASH_PATHPfad zu Git Bash bash.exe unter Windows, wenn nicht im PATH
IAC_CODE_A2A_PUSH_KEYRINGUmgebungsgesteuerter verschluesselter A2A-Push-Secret-Keyring (JSON-Format)
OTEL_EXPORTER_OTLP_ENDPOINTStandard-OpenTelemetry-Endpunkt; aktiviert den OTLP-Export, wenn gesetzt
OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENTGenAI-Nachrichten-/Tool-Inhalte auf Spans erfassen: SPAN_ONLY, EVENT_ONLY, SPAN_AND_EVENT

Sitzungsbackup

VariableBeschreibung
IAC_CODE_CONFIG_BACKUP_DIROptionales Verzeichnis fuer Sitzungsbackups; unterstuetzt ~- und $VAR-Expansion sowie %VAR%-Expansion unter Windows. In PowerShell eine konkrete Pfadangabe uebergeben oder $env:VAR vor dem Start von iac-code durch die Shell expandieren lassen. In Sandbox-Deployments ist dies haeufig ein gemounteter OSS-Pfad, muss aber unabhaengig von IAC_CODE_CONFIG_DIR und jeder Sitzungsquelle sein, darf sich nicht ueberschneiden und sollte fuer kritische Checkpoints niedrige Latenz bieten. UNC-Pfade, gemappte Laufwerke und gemountete OSS-Pfade muessen .backup-lock-Dateisperren, atomare Replace-Semantik und Dateimetadaten ausreichend fuer inkrementelles Spiegeln erhalten; vermeiden Sie Symlink-, Junction- oder reparse-point-Vorfahren fuer die aktive Sitzungsquelle, den Backup-Root und gespiegelte Sitzungen. Wenn aktiviert, spiegeln Checkpoints jede v2-Sitzung nach <backup>/projects/<project>/<session_id>/ und behalten die gleiche Verzeichnisstruktur wie die aktive Sitzung bei; .backup-state.json und .backup-lock bleiben lokal und werden nicht kopiert. Normale Chat-Turn-End-Backups verwenden normal_turn_end und blockieren die Antwort nicht; nur Fehler bei critical=true-Checkpoints blockieren die Veroeffentlichung. Gemeinsame A2A task/context-Indizes koennen separat gemountet werden.