Meridian: Claude Max über eine lokale Anthropic-API an fremde Coding-Tools anbinden

Welche Lücke Meridian schließt

Das Claude Agent SDK, früher Claude Code SDK, bietet programmatischen Zugriff auf Claude. Die meisten Coding-Tools erwarten dagegen einen Endpunkt nach Anthropic- oder OpenAI-Protokoll und lassen sich über eine Basis-URL umbiegen. Zwischen beiden Welten liegt ein Formatunterschied, den Meridian auflöst. Der Proxy läuft lokal, nimmt Standard-API-Anfragen entgegen und leitet sie über die SDK-Funktion `query()` an Claude weiter. Die Zielgruppe sind Entwickler mit Claude-Max-Abo, die ihre gewohnte Oberfläche behalten wollen: OpenCode, Crush, Cline, Aider, Droid, Pi, Jcode, Open WebUI und weitere. Der Nutzen liegt nicht in zusätzlichen Modellfähigkeiten, sondern in der Wahlfreiheit des Frontends.

Datenfluss: vom Editor durch query() zum Client

Jede Anfrage durchläuft denselben Pfad. Ein Client schickt einen Anthropic-kompatiblen Request an `http://127.0.0.1:3456`. Meridian übersetzt ihn in einen Aufruf von `query()`, die dokumentierte Funktion des Claude Agent SDK. Die Antwort kommt im Format von Claude Code zurück und wird in das Standard-Anthropic-Format gebracht. Sitzungen bleiben über Einzelanfragen hinweg erhalten, überstehen Compaction und Undo und werden nach einem Neustart des Proxys fortgesetzt. Streaming läuft als SSE. Für Tools, die nur das OpenAI-Protokoll sprechen, existieren `/v1/chat/completions` und `/v1/models`, inklusive `image_url` für Data-URLs. Bemerkenswert ist die Arbeitsteilung: Prompt-Caching, Kontextfensterverwaltung, Kompaktierung, Ratenbegrenzung und Authentifizierung bleiben beim SDK und damit bei Anthropic. Meridian beschreibt sich selbst als Präsentations- und Interoperabilitätsschicht, nicht als Umgehung. Das ist die zentrale Designentscheidung des Projekts und erklärt, warum kein OAuth-Token abgegriffen und keine Binärdatei gepatcht wird.

Installation und Konfiguration in der Praxis

Die README gibt eine vierstufige Schnellstartsequenz vor. Zuerst `npm install -g @rynfar/meridian`. Danach einmalig `claude login` zur Authentifizierung. OpenCode-Nutzer führen anschließend `meridian setup` aus, für die V2-Beta existiert `meridian setup --v2 --opencode-bin ~/.local/bin/opencode2`. Gestartet wird der Proxy mit `meridian`, er lauscht auf `http://127.0.0.1:3456`. Ein Client wird per Umgebungsvariable umgebogen: `ANTHROPIC_API_KEY=x ANTHROPIC_BASE_URL=http://127.0.0.1:3456 opencode`. Der Schlüsselwert ist ein Platzhalter, denn authentifiziert wird über das SDK, nicht über API-Schlüssel. Viele Tools verlangen das Feld dennoch. Weitere Umgebungsvariablen, Endpunkte, SDK-Schalter und der Passthrough-Modus sind in `docs/configuration.md` dokumentiert. Preise für die Kostenschätzung lassen sich in `~/.config/meridian/model-pricing.json` überschreiben oder über die Oberfläche unter `/settings` bearbeiten. Metriken stehen unter `/telemetry` bereit.

Sitzungen, Profile und Subagenten

Meridian verwaltet mehrere Claude-Konten parallel, ohne Neustart. Opt-in Sticky-Session-Routing verteilt Sitzungen über Konten und hält dabei den Prompt-Cache je Konto warm, was in `docs/profiles.md` beschrieben wird. Adapter-Instanzen erlauben, dieselbe Konfiguration mehrfach nebeneinander zu betreiben, etwa mit abweichendem Thinking, System-Prompt oder Passthrough, ausgewählt über Header oder Match-Regeln. Bei Subagenten greift eine Modellwahl: Primäragenten erhalten ein Kontextfenster von 1M, Subagenten 200k, um das Ratenlimit-Budget zu schonen. Abgelaufene OAuth-Token werden automatisch erneuert, laufende Anfragen sollen ohne Unterbrechung fortgesetzt werden. Diese Punkte sind aus der Feature-Liste und den verlinkten Dokumenten abgeleitet, nicht aus eigenem Betrieb.

Wo der Ansatz an seine Grenzen stößt

Meridian hängt vollständig am Claude Agent SDK. Ändert Anthropic die Funktion `query()`, die Authentifizierung oder die Ratenbegrenzung, wirkt sich das unmittelbar auf den Proxy aus. Die README formuliert das ausdrücklich als Philosophie: innerhalb der SDK-Grenzen arbeiten, nicht daran vorbei. Das ist ehrlich, aber es bedeutet auch, dass Meridian keine Kontrolle über Durchsatz, Kontingente oder Modellverfügbarkeit hat. Wer Claude über einen eigenen API-Schlüssel abrechnet, ist nicht die Zielgruppe; der Umweg über ein Abo bringt dort nichts. Ebenso ungeeignet ist der Proxy für serverseitige Mehrbenutzerumgebungen, denn er bindet an `127.0.0.1` und an eine lokale Anmeldung. Ein weiterer Punkt: Das Repository gibt keine Lizenz in den Metadaten an, während die README ein MIT-Badge zeigt. Diese Differenz sollte vor einer Weitergabe oder Einbettung geklärt werden. Eine rechtliche Bewertung ist hier nicht möglich und auch nicht beabsichtigt.

Abgrenzung zu LiteLLM und ähnlichen Gateways

LiteLLM ist ein Gateway, das viele Anbieter hinter einer einheitlichen OpenAI-Schnittstelle bündelt und die Übersetzung selbst vornimmt. Meridian verfolgt einen anderen Weg: Es gibt keine Anbieter-Matrix und keine eigene Modellverwaltung. Stattdessen setzt es genau auf das Claude Agent SDK und übersetzt dessen Ausgabe in das Anthropic-Format. Für die OpenAI-kompatible Seite genügen `/v1/chat/completions` und `/v1/models`, laut README ohne LiteLLM dazwischen. Wer mehrere Anbieter mischen will, ist bei einem Gateway besser aufgehoben. Wer ausschließlich Claude nutzt und dessen Sitzungs- und Caching-Verhalten erhalten will, spart mit Meridian eine Übersetzungsschicht, die dieses Verhalten nicht kennt.

Wartung, Aktualisierung und Lizenzfrage

Das Projekt wird aktiv gepflegt. Die Release-Historie zeigt Versionen im Abstand von Tagen bis Wochen, zuletzt meridian-v1.69.0, v1.68.0 und v1.67.0. Updates laufen über npm, also `npm install -g @rynfar/meridian` erneut ausführen. Ein separater Migrationsschritt ist aus dem Material nicht ersichtlich. Für den Dauerbetrieb existieren laut Dokumentationsübersicht NixOS- und Home-Manager-Dienste sowie Docker-Images in `docs/deployment.md`; Telemetrie lässt sich optional persistent speichern. Die Lizenzlage bleibt der offene Punkt: Das README zeigt ein MIT-Badge, die Repository-Metadaten nennen keine Lizenz. Wer Meridian in ein Produkt einbettet oder weiterverteilt, muss diese Angabe vorab beim Maintainer klären.

Für wen sich der Betrieb lohnt

Der Fall ist klar umrissen. Ein Entwickler mit Claude-Max-Abo, der OpenCode, Crush, Cline, Aider oder ein anderes Anthropic-kompatibles Werkzeug weiterverwenden möchte, bekommt mit Meridian einen lokal laufenden Adapter, der auf dokumentierten SDK-Aufrufen beruht und Sitzungen, Streaming und Prompt-Caching dem SDK überlässt. Wer stattdessen API-Schlüssel nutzt, mehrere Anbieter bündeln will oder eine zentrale Instanz für ein Team braucht, sollte zu einem Gateway greifen oder direkt gegen die Anthropic-API arbeiten. Vor dem ersten Start sind drei Dinge zu prüfen: ob `claude login` auf der Zielmaschine möglich ist, ob die gewünschte Client-Version das Anthropic- oder OpenAI-Protokoll spricht, und ob der Lizenzstatus des Repositories für den geplanten Einsatz ausreicht.

Redaktionelles Fazit

Wer bereits ein Claude-Max-Abo besitzt und OpenCode, Crush, Cline oder Aider weiterverwenden will, findet in Meridian einen lokal laufenden Adapter, der auf dokumentierten SDK-Aufrufen beruht. Wer Claude ohne Abo über API-Schlüssel abrechnet, braucht ihn nicht. Vor dem ersten Start ist zu klären, ob ein `claude login` auf der Zielmaschine möglich ist und ob der Lizenzstatus des Repositories für den geplanten Einsatz ausreicht, denn die README nennt MIT, die Repository-Metadaten keine Lizenzangabe.

Offizielle Quellen

1. Issues
2. Project website
3. README
4. Releases
5. rynfar/meridian on GitHub