Claude Bridge

Ein MCP-Server, der die Zusammenarbeit zwischen Claude Code und Z.ai's GLM-Modellen ermöglicht – nutzen Sie Claude Opus für die Planung, während GLM die Implementierung übernimmt.

Kombinieren Sie die Stärken von Claude Code und Z.ai's GLM in einem Workflow. Dieser MCP-Server ermöglicht es Opus, die übergeordnete Planung zu übernehmen, während GLM die Implementierung durchführt – koordiniert über eine gemeinsame Aufgabenwarteschlange, die gleichzeitig in separaten Terminals läuft. Führen Sie Claude Code mit Ihrem Max-Abonnement oder API für die Architektur aus und Claude Code mit Z.ai (GLM) für die Ausführung – beides arbeitet gleichzeitig zusammen.

Inhaltsverzeichnis

• Warum gibt es das?

• Kurzes Beispiel

• Funktionen

• Wann man dies NICHT verwenden sollte

• Voraussetzungen

• Schnellstart

• Dokumentation

• Funktioniert auch mit anderen MCP-Clients

• Sicherheit

• Lizenz

Related MCP server: Herald

Warum gibt es das?

Sie haben ein Claude-Abonnement, stoßen aber an Limits. Ein zweites Claude-Abonnement ist teuer (oder ein Upgrade könnte zu kostspielig sein) – aber ein Z.ai-Abonnement kostet weniger und GLM programmiert genauso gut wie Sonnet.

Die Frage: Wie bringt man Claude und GLM dazu, zusammenzuarbeiten?

Die Antwort: Claude Bridge. Ein MCP-Server, der beide über eine gemeinsame Aufgabenwarteschlange koordiniert.

┌─────────────────────────┐                    ┌─────────────────────────┐
│   Terminal 1            │                    │   Terminal 2            │
│   Claude Opus           │                    │   Z.ai GLM              │
│   (Architect)           │                    │   (Executor)            │
│                         │    Claude Bridge   │                         │
│   • Plans features      │◄──────────────────►│   • Pulls tasks         │
│   • Designs architecture│    (Shared Queue)  │   • Writes code         │
│   • Makes decisions     │                    │   • Reports back        │
└─────────────────────────┘                    └─────────────────────────┘

Kurzes Beispiel

Terminal 1 (Opus): "Erstelle eine Aufgabe zur Implementierung der JWT-Authentifizierung"

Terminal 2 (GLM): "Nächste Aufgabe abrufen" → implementiert → "Aufgabe abschließen"

Terminal 1: "Was hat der Ausführende abgeschlossen?" → überprüft Ergebnisse

Funktionen

• Aufgabenwarteschlange — Prioritätsbasiert mit Abhängigkeiten und Kategorien

• Geteilter Status — Projektfokus und Entscheidungen für beide sichtbar

• Sitzungskontext — Dort weitermachen, wo Sie aufgehört haben

• Klärungen — Der Ausführende stellt Fragen, der Architekt antwortet

• Token-bewusst — Entwickelt, um die Opus-Nutzung zu minimieren

Wann man dies NICHT verwenden sollte

Wenn Sie ein Planungs-Framework wie Get-Shit-Done (GSD) verwenden, benötigen Sie diese Brücke nicht. Frameworks wie GSD speichern den Kontext in Projektdateien (.planning/), die beide Terminals direkt lesen können. Slash-Befehle wie /gsd:plan-phase und /gsd:execute-phase funktionieren in jedem Terminal.

Verwenden Sie Claude Bridge für:

• Ad-hoc-Aufgaben, schnelle Korrekturen, einmalige Recherchen

• Projekte ohne Planungs-Framework

• Sitzungskontinuität über Neustarts hinweg

Überspringen Sie die Brücke, wenn:

• Sie GSD oder ähnliche dateibasierte Planungs-Frameworks verwenden

• Beide Terminals das Projekt-Dateisystem teilen

Voraussetzungen

• Node.js 18+ — Download

• Claude Code CLI — Installation

• Z.ai-Konto — Für GLM-Zugriff (z.ai)

• Zwei Terminalfenster

Einrichtung des Terminal-Profils

Dasselbe Abonnement in beiden Terminals? Führen Sie einfach claude in jedem aus – keine Profileinrichtung erforderlich.

Claude + Z.ai GLM? Fügen Sie diese Funktion zu Ihrem Shell-Profil hinzu:

Windows PowerShell (notepad $PROFILE):

function use-glm {
    $env:ANTHROPIC_BASE_URL = "https://api.z.ai/api/anthropic"
    $env:ANTHROPIC_AUTH_TOKEN = "your_zai_api_key_here"
    Write-Host ">>> GLM ACTIVE (Executor mode)" -ForegroundColor Cyan
}

macOS/Linux (~/.bashrc oder ~/.zshrc):

use-glm() {
    export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
    export ANTHROPIC_AUTH_TOKEN="your_zai_api_key_here"
    echo ">>> GLM ACTIVE (Executor mode)"
}

Verwendung:

• Terminal 1: Führen Sie einfach claude aus (nutzt Ihr Claude-Abonnement)

• Terminal 2: Führen Sie use-glm aus, dann claude (nutzt Z.ai API)

Siehe GUIDE.md für vollständige Einrichtungsdetails.

Schnellstart

# 1. Clone and build
git clone https://github.com/Joncik91/claude-bridge-server.git
cd claude-bridge-server
./setup.sh          # or setup.bat on Windows

# 2. Configure MCP (see GUIDE.md for details)
claude mcp add --scope user --transport stdio claude-bridge -- node /path/to/server/dist/index.js

Dokumentation

GUIDE.md — Vollständige Einrichtung, Terminalkonfiguration, Verwendung und Fehlerbehebung

Funktioniert auch mit anderen MCP-Clients

Obwohl die Brücke für Claude + GLM konzipiert ist, ist sie ein Standard-MCP-Server – sie funktioniert mit jedem MCP-kompatiblen CLI:

• Zwei Claude Code-Instanzen (gleiche oder unterschiedliche Abonnements)

• Gemini CLI

• OpenCode

• Qwen Code

• Jeder andere MCP-Client

Sicherheit

Claude Bridge sitzt zwischen zwei CLIs, die echte API-Token halten. Drei Implikationen, die explizit erwähnt werden sollten.

• API-Token gelangen niemals durch die Brücke. Das Protokoll des Servers überträgt Aufgaben, Status und Ergebnisse – keine Anmeldedaten. Jedes Terminal authentifiziert sich direkt bei seinem eigenen Anbieter (Ihr Claude-Abonnement auf der einen Seite, Ihr Z.ai-Schlüssel auf der anderen). Das Shell-Profil-Muster in Voraussetzungen dient dazu, dass die Terminalsitzung ANTHROPIC_AUTH_TOKEN setzt – die Brücke liest es niemals.

• Committen Sie use-glm nicht mit einem echten Schlüssel. Die Shell-Profil-Schnipsel in dieser README und GUIDE.md verwenden einen Platzhalter – ersetzen Sie ihn durch ${ZAI_API_KEY} oder Ähnliches und laden Sie das Geheimnis aus einem Passwort-Manager / System-Schlüsselbund. Ein echter Schlüssel in ~/.bashrc ist ein echter Schlüssel in jedem Backup Ihres Home-Verzeichnisses.

• Die gemeinsame Aufgabenwarteschlange ist lokal für den Brückenprozess. Aufgaben, Klärungen und Prüfernotizen leben im Arbeitsspeicher der Brücke. Richten Sie nicht zwei unabhängige Projekte auf dieselbe Brückeninstanz aus – die Warteschlange ist konzeptionsbedingt für einen einzelnen Mandanten ausgelegt.

Für die Teamnutzung: Jedes Paar aus Architekt- und Ausführenden-Terminals sollte seinen eigenen Brückenprozess ausführen, nicht einen teilen. Der MCP-Transport erfolgt über stdio auf dem lokalen Computer; es lauscht nichts an einem Netzwerkport.

Lizenz

MIT – siehe LICENSE.

Danksagungen

• Erstellt für Claude Code von Anthropic

• Entwickelt für Z.ai GLM-Integration