diff --git a/README.md b/README.md
index a1f17fb..9ba3dbe 100644
--- a/README.md
+++ b/README.md
@@ -4,5 +4,6 @@ draw.io-Quelldateien + Mermaid-Varianten.
 - **SCK-Organigramm-2608.drawio** — aktuelles Organigramm (kanonisch); 2604/2605 = ältere Snapshots.
 - **SCK-IT-Infrastruktur.drawio** — IT-Topologie.
 - **chormusical_die_huette.drawio** — Rechte-/Lizenzkette.
+- **claude-code-topologie.md** — Mermaid: Bedienwege (Terminal vs. App-Bridge), Reichweite des VPS-Agenten, Vergleich Claude Code ↔ Mistral Vibe.
 
 Editiert auf dem Mac (draw.io Desktop). **Auto-Sync:** LaunchAgent `de.creativekirche.diagramme-autosync` (alle 15 min commit+push nach Gitea). Script `~/scripts/diagramme-autosync.sh`, Log `~/Library/Logs/diagramme-autosync.log`.
diff --git a/claude-code-topologie.md b/claude-code-topologie.md
new file mode 100644
index 0000000..95bcbea
--- /dev/null
+++ b/claude-code-topologie.md
@@ -0,0 +1,153 @@
+# Claude Code — wer bedient was, wo läuft was
+
+> Stand 08.08.2026 · Quelle: `dokumentation/15_systeme/40_claude_code_arbeitsmodell.md`
+> und `42_werkzeuge/65_mistral_vibe_mac.md`
+
+---
+
+## 1. Bedienwege und Ausführung
+
+Die zentrale Unterscheidung: **das Modell rechnet in der Cloud, der Agent läuft auf
+dem VPS.** Zum VPS-Agenten führen zwei voneinander unabhängige Türen — sie teilen
+Dateien und Zugänge, aber **nicht** den Gesprächsverlauf.
+
+```mermaid
+%%{init: {'flowchart': {'curve': 'step'}}}%%
+flowchart LR
+  subgraph BED["Bedienung"]
+    direction TB
+    IPAD["iPad<br/>Claude-App"]
+    MACAPP["Mac<br/>Claude-App"]
+    TERM["ShellFish / WebSSH<br/>Terminal"]
+  end
+
+  subgraph VPS["VPS sck-debian-nbg — läuft rund um die Uhr"]
+    direction TB
+    BRIDGE["claude-rc.service<br/>Bridge"]
+    SAPP["Tür B<br/>App-Session"]
+    SCC["Tür A<br/>tmux-Session cc"]
+    BASIS["Wissensbasis<br/>CLAUDE.md · 60 Memories<br/>14 Skills · Doku · MCP"]
+  end
+
+  CLOUD["Anthropic Cloud<br/>Opus 5 · Sonnet 5"]
+
+  IPAD --> BRIDGE
+  MACAPP --> BRIDGE
+  BRIDGE --> SAPP
+  TERM -->|SSH| SCC
+
+  SAPP --- BASIS
+  SCC --- BASIS
+  SAPP -->|API| CLOUD
+  SCC -->|API| CLOUD
+
+  SAPP -. "getrennte Verläufe" .- SCC
+
+  classDef cloud fill:#e8eef7,stroke:#5b7ba6
+  classDef host fill:#eef5ec,stroke:#6a9a5b
+  class CLOUD cloud
+  class VPS,BRIDGE,SAPP,SCC,BASIS host
+```
+
+| Element | Bedeutung |
+|---|---|
+| Tür A | Terminal über SSH, Sitzung lebt in tmux `cc` |
+| Tür B | Claude-App auf iPad/Mac/iPhone, bedient über die Bridge |
+| getrennte Verläufe | kein Live-Mirror, kein gemeinsamer Gesprächsverlauf |
+| Wissensbasis | liegt auf Platte, beide Türen sehen dieselben Dateien |
+| Anthropic Cloud | nur das Sprachmodell; stirbt die Verbindung, steht der Agent |
+
+---
+
+## 2. Reichweite des VPS-Agenten
+
+```mermaid
+%%{init: {'flowchart': {'curve': 'step'}}}%%
+flowchart LR
+  AGENT["Claude Code<br/>auf dem VPS"]
+
+  subgraph HEIM["Heimnetz 192.168.178.0/24"]
+    PI5["Pi5 raspip5<br/>Home Assistant · Pi-hole"]
+    MAC["Mac ak-mba-15"]
+  end
+
+  subgraph CK["CK-Netz über OpenVPN"]
+    direction TB
+    STDA["Standort A 10.128.40.0/24<br/>XGS · SaltoServer · rpp1"]
+    STDB["Standort B 10.128.30.0/24<br/>XGS · NAS-CRK-02"]
+  end
+
+  subgraph FACH["Fachsysteme über API"]
+    direction TB
+    M365["Microsoft 365<br/>zwei Tenants"]
+    ERP["Business Central<br/>Dynamics CRM"]
+    REST["FundraisingBox · Brevo<br/>Communi · Inopla"]
+  end
+
+  AGENT -->|WireGuard| PI5
+  PI5 -->|ProxyJump| MAC
+  AGENT -->|OpenVPN| STDA
+  AGENT -->|OpenVPN| STDB
+  AGENT --> M365
+  AGENT --> ERP
+  AGENT --> REST
+
+  classDef host fill:#eef5ec,stroke:#6a9a5b
+  class AGENT host
+```
+
+Der Mac ist über den Sprung via Pi5 erreichbar — ein direkter Weg scheitert am
+DS-Lite-Anschluss.
+
+---
+
+## 3. Claude Code und Mistral Vibe nebeneinander
+
+Die Asymmetrie ist der Kern: Bei Claude sitzt der Agent auf einer Maschine, die immer
+läuft, und ist von überall bedienbar. Vibe ist an den Mac gebunden — **die Mistral-App
+erreicht die lokale CLI nicht.**
+
+```mermaid
+%%{init: {'flowchart': {'curve': 'step'}}}%%
+flowchart TB
+  subgraph CLAUDE["Claude Code"]
+    direction TB
+    C_BED["iPad · Mac · iPhone<br/>Terminal"]
+    C_AG["Agent auf dem VPS<br/>24/7"]
+    C_MOD["Anthropic Cloud<br/>USA"]
+    C_ZIEL["VPS · CK-Netz · Heimnetz<br/>Mac · Fachsysteme"]
+    C_BED --> C_AG --> C_MOD
+    C_AG --> C_ZIEL
+  end
+
+  subgraph VIBE["Mistral Vibe"]
+    direction TB
+    V_BED["nur Mac-Terminal"]
+    V_APP["Mistral-App<br/>iPad · iPhone"]
+    V_AG["vibe-CLI auf dem Mac<br/>nur wenn der Mac wach ist"]
+    V_MOD["Mistral Cloud<br/>EU"]
+    V_CHAT["chat.mistral.ai"]
+    V_ZIEL["Mac · was per SSH<br/>von dort erreichbar ist"]
+    V_BED --> V_AG --> V_MOD
+    V_AG --> V_ZIEL
+    V_APP --> V_CHAT
+    V_APP -. "nicht möglich" .-> V_AG
+  end
+
+  classDef cloud fill:#e8eef7,stroke:#5b7ba6
+  classDef host fill:#eef5ec,stroke:#6a9a5b
+  classDef nogo fill:#f7ecec,stroke:#a66b5b
+  class C_MOD,V_MOD,V_CHAT cloud
+  class C_AG,V_AG host
+  class V_APP nogo
+```
+
+| | Claude Code | Mistral Vibe |
+|---|---|---|
+| Läuft auf | VPS, rund um die Uhr | Mac, nur wenn er wach ist |
+| Bedienbar von | Terminal, App, Browser | nur Mac-Terminal |
+| Reichweite | VPS, CK-Netz, Heimnetz, Mac, Fachsysteme | Mac und was per SSH von dort geht |
+| Wissensbasis | CLAUDE.md, ~60 Memories, 14 Skills, Doku, MCP | AGENTS.md, 2 Skills, Doku lesend |
+| Verlauf | JSONL auf dem VPS, 10 Jahre | lokal unter `~/.vibe/` |
+| Abrechnung | Max-Abo, pauschal | API-Key, pay-per-use |
+| Rechtsraum | USA | EU, mit AV-Vertrag |