diagramme/claude-code-topologie.md

KI-Instanzen bei CK — wer läuft wo, und womit bediene ich sie

Stand 08.08.2026 (nach Einrichtung von Paseo) Quellen: dokumentation/15_systeme/40_claude_code_arbeitsmodell.md, 42_werkzeuge/65_mistral_vibe_mac.md, 42_werkzeuge/66_paseo_agent_orchestrator.md

---

1. Die Instanzen und ihre Zugangswege

Fünf Agenten-Instanzen auf zwei Rechnern. Die Unterscheidung, auf die es ankommt: wo der Agent läuft gegenüber womit ich ihn bediene — beides ist frei kombinierbar.

%%{init: {'flowchart': {'curve': 'step'}}}%%
flowchart LR
  subgraph OBER["Oberflächen"]
    direction TB
    TERM["Terminal<br/>ShellFish · WebSSH"]
    CAPP["Claude-App<br/>Mac · iPad · iPhone"]
    PAPP["Paseo-App<br/>Mac · iPad"]
    MAPP["Mistral-App"]
  end

  subgraph VPS["VPS sck-debian-nbg — 24/7"]
    direction TB
    CC1["Claude Code<br/>Terminal-Session cc"]
    CC2["Claude Code<br/>Bridge-Session"]
    CC3["Claude Code<br/>Paseo-Agenten (Test)"]
  end

  subgraph MAC["Mac ak-mba-15 — nur wenn wach"]
    direction TB
    CCM["Claude Code<br/>Paseo-Agenten"]
    VIBE["Mistral Vibe<br/>Paseo-Agenten"]
  end

  TERM -->|SSH| CC1
  CAPP -->|"Anthropic-Bridge"| CC2
  PAPP -->|"Paseo-Relay"| CC3
  PAPP -->|"Paseo-Relay"| CCM
  PAPP -->|"Paseo-Relay"| VIBE
  MAPP -. "kein Zugriff" .-x VIBE

  classDef host fill:#eef5ec,stroke:#6a9a5b
  classDef nogo fill:#f7ecec,stroke:#a66b5b
  class VPS,MAC,CC1,CC2,CC3,VIBE,CCM host
  class MAPP nogo

Instanz	Wo	Bedienung	Rolle
Claude Code — Terminal	VPS	SSH, tmux cc	Arbeit direkt am Rechner
Claude Code — Bridge	VPS	Claude-App	Hauptweg, auch mobil
Claude Code — Paseo	VPS	Paseo-App	Testinstallation, rückbaubar
Claude Code — Paseo	Mac	Paseo-App	für Mac-Themen
Mistral Vibe — Paseo	Mac	Paseo-App	Zweitagent, EU-Modelle

Die reinen Chat-Dienste (claude.ai, chat.mistral.ai) sind bewusst nicht abgebildet — sie führen keine Agenten aus, sondern nur Unterhaltungen ohne Zugriff auf Dateien und Systeme. Die Mistral-App ist genau deshalb im Diagramm rot: Sie erreicht die lokale Vibe-CLI nicht, ein Gegenstück zur Anthropic-Bridge gibt es dort nicht.

⚠️ Alle Instanzen führen getrennte Unterhaltungen. Auf demselben Rechner teilen sie Dateien, Zugänge und die CLAUDE.md — aber keinen Gesprächsverlauf.

⚠️ Nur eine Instanz schreibt. Memory und Doku hängen an Auto-Sync-Timern; paralleles Schreiben zerstört Änderungen (real passiert 07.06.2026). Konvention: Die Bridge-Session schreibt, Paseo-Agenten lesen. claude-instances-check.sh weist Agent-Sessions seit 08.08.2026 eigens aus.

---

2. Reichweite — wer erreicht welche Systeme

Die Netz-Reichweite unterscheidet sich kaum zwischen VPS und Mac; der Unterschied liegt in Verfügbarkeit und Werkzeugen.

%%{init: {'flowchart': {'curve': 'step'}}}%%
flowchart LR
  AGV["Agenten auf dem VPS"]
  AGM["Agenten auf dem Mac"]

  subgraph CK["CK-Netz"]
    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 HEIM["Heimnetz 192.168.178.0/24"]
    direction TB
    PI5["Pi5 · Home Assistant · Pi-hole"]
    MACH["Mac"]
  end

  FACH["Fachsysteme über API<br/>M365 · BC · CRM · FRB<br/>Brevo · Communi · Inopla"]
  WERK["MCP-Server · salto-sql<br/>14 Skills · 60 Memories"]

  AGV -->|OpenVPN| STDA
  AGV -->|OpenVPN| STDB
  AGV -->|WireGuard| PI5
  PI5 -->|ProxyJump| MACH
  AGV --> FACH
  AGV --> WERK

  AGM -->|"FritzBox-Route → Pi5"| STDA
  AGM -->|"FritzBox-Route → Pi5"| STDB
  AGM -->|SSH| PI5

  classDef host fill:#eef5ec,stroke:#6a9a5b
  class AGV,AGM host

Vom Mac aus sind Salto-Server, rpp1 und beide Firewalls direkt erreichbar — die FritzBox routet 10.128.0.0/16 zum Pi5, der als VPN-Gateway NATet. Was dem Mac fehlt, sind die Werkzeuge: MCP-Server, salto-sql, Skills und Memories liegen auf dem VPS.

---

3. Wo die Modelle rechnen

%%{init: {'flowchart': {'curve': 'step'}}}%%
flowchart LR
  PAPP2["Paseo-App"]
  REL["Paseo-Relay<br/>Fly.io · USA"]
  CCA["Claude Code<br/>VPS und Mac"]
  VIB["Mistral Vibe<br/>Mac"]
  ANT["Anthropic · USA<br/>Opus 5 · Sonnet 5"]
  MIS["Mistral · EU<br/>Devstral · Mistral Medium"]

  PAPP2 -. "Steuerung, Ende-zu-Ende<br/>verschlüsselt" .-> REL
  REL -. "Fernsteuerung" .-> CCA
  REL -. "Fernsteuerung" .-> VIB
  CCA -->|"Modell-API"| ANT
  VIB -->|"Modell-API"| MIS

  classDef cloud fill:#e8eef7,stroke:#5b7ba6
  classDef host fill:#eef5ec,stroke:#6a9a5b
  class ANT,MIS,REL cloud
  class CCA,VIB host

Die Agenten laufen lokal, die Modelle rechnen immer in der Cloud — Claude bei Anthropic (USA), Vibe bei Mistral (EU, mit AV-Vertrag). Der Paseo-Relay transportiert nur die Fernsteuerung, Ende-zu-Ende-verschlüsselt und für den Betreiber unlesbar; er läuft bei Fly.io in den USA. Bewusst akzeptierte Abweichung für die Erprobungsphase (Entscheidung AK 08.08.2026).

	Claude Code	Mistral Vibe
Läuft auf	VPS rund um die Uhr, zusätzlich Mac	nur Mac, nur wenn er wach ist
Bedienung	Terminal, Claude-App, Paseo-App	Terminal, Paseo-App
Modelle	Opus 5, Sonnet 5 (Standard)	Devstral, Mistral Medium — Auswahl nur in der Paseo-App, nicht per CLI
Wissensbasis	CLAUDE.md, ~60 Memories, 14 Skills, MCP	AGENTS.md, 2 Skills, Doku lesend
Rechtsraum Modell	USA	EU, mit AV-Vertrag