diagramme/claude-code-topologie.md

# 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 liegt **nicht** in der Netz-Reichweite, sondern in Verfügbarkeit und
Bedienbarkeit: 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.**

⚠️ **Korrektur 08.08.2026 (Befund von Vibe selbst, nachgeprüft):** Eine frühere Fassung
zeigte Vibes Reichweite als „Mac und was per SSH von dort geht" und unterschätzte sie damit.
Tatsächlich routet der Mac `10.128.0.0/16` über die FritzBox zum Pi5, der als VPN-Gateway
ins CK-Netz NATet — **beide Standorte sind vom Mac aus direkt erreichbar** (verifiziert:
Salto-Server und rpp1 per SSH, XGS Standort B auf Port 4444). Dazu liegen SSH-Schlüssel für
`vps`, `raspip5`, `rpp1` und `salto` in der Mac-Konfiguration. Netzseitig kommt Vibe also fast
überall hin, wo Claude Code hinkommt — nur solange der Mac wach und im Heimnetz ist.

```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_Z1["Mac lokal"]
    V_Z2["CK-Netz beide Standorte<br/>Salto · XGS · rpp1"]
    V_Z3["VPS · Pi5<br/>per SSH-Key"]
    V_BED --> V_AG --> V_MOD
    V_AG --> V_Z1
    V_AG -->|"FritzBox-Route → Pi5"| V_Z2
    V_AG -->|SSH| V_Z3
    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 Netz | VPS, CK-Netz, Heimnetz, Mac, Fachsysteme | **nahezu gleich** — CK-Netz über FritzBox-Route + Pi5, SSH-Keys für VPS/Pi5/rpp1/Salto |
| Reichweite Werkzeuge | MCP-Server für Postgres und Prometheus, `salto-sql`, Graph-Token | nur Shell und SSH — keine MCP-Anbindung |
| 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 |