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.

%%{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

%%{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.

%%{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