diff --git a/.claude/aria-vm.env.example b/.claude/aria-vm.env.example
new file mode 100644
index 0000000..8b62fdd
--- /dev/null
+++ b/.claude/aria-vm.env.example
@@ -0,0 +1,15 @@
+# Wo erreicht die Dev-Maschine die aria-wohnung VM?
+# Kopiere diese Datei nach .claude/aria-vm.env und passe die IP an.
+# .claude/aria-vm.env ist gitignored (lokal pro Maschine).
+#
+# Verwendung in Bash:
+#   source .claude/aria-vm.env
+#   curl -s "$ARIA_BRAIN_URL/memory/stats"
+#
+# Im docker-compose-Netz aria-net laufen die Hostnamen ohnehin direkt
+# (aria-brain, aria-bridge, aria-qdrant). Diese Datei brauchen nur
+# Hosts AUSSERHALB der VM (z.B. die Dev-Maschine wo Claude Code laeuft).
+
+ARIA_VM_HOST=192.0.2.1
+ARIA_DIAG_URL=http://192.0.2.1:3001
+ARIA_BRAIN_URL=http://192.0.2.1:3001/api/brain
diff --git a/.gitignore b/.gitignore
index 0634ff6..ed5c75e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -10,6 +10,12 @@
 !.env.example
 !.env.*.example
 
+# Lokale Dev-Maschinen-Settings fuer Claude Code (z.B. wie erreicht die
+# Dev-Maschine die aria-wohnung-VM). .example ist Repo-Inhalt, echte
+# Werte pro Maschine selbst pflegen.
+.claude/*.env
+!.claude/*.env.example
+
 # Privater User-Profile-Snippet (Tool-Stack, interne URLs) —
 # liegt jetzt in brain-import/ (frueher aria-data/config/USER.md).
 # USER.md.example ist Repo-Inhalt, USER.md lokal selbst anlegen.