Helicone-Migration: So wechselst du zu Spanlens nach der Übernahme

Am 3. März 2026 gab das Unternehmen Helicone bekannt, dass es von Mintlify übernommen wurde. Für Nutzer:innen, die Helicone produktiv einsetzen, ist die zentrale Frage nicht, ob die Übernahme vorteilhaft ist, sondern welche konkreten Auswirkungen sie hat und ob Handlungsbedarf besteht.

Diese Anleitung klärt auf, was sich tatsächlich ändert, zeigt eine praktische Migrations-Checkliste und gibt Empfehlungen für die Auswahl zukünftiger Tools – damit du nicht erneut vor einer unerwarteten Situation stehst.

Was sich mit der Übernahme geändert hat

Die Gründer von Helicone sind nun Teil von Mintlify, und die eigenständige Weiterentwicklung des Helicone-Produkts wurde eingestellt. Laut Unternehmensaussagen werden weiterhin Sicherheitsupdates, Fehlerbehebungen und die Unterstützung neuer Modelle bereitgestellt. Neue Funktionen und die Roadmap-Planung sind jedoch vorerst gestoppt.

Für viele Teams ändert sich zunächst wenig: Ein funktionierender Logging-Proxy läuft weiter, auch wenn keine neuen Features hinzukommen. Zwei Szenarien können jedoch einen Wechsel beschleunigen:

• Nutzer:innen der gehosteten Lösung möchten wissen, ob die Entwicklung langfristig gesichert ist.
• Teams, die selbst gehostete Instanzen betreiben und auf zukünftige Funktionen angewiesen waren, müssen nach Alternativen suchen.

In den letzten Monaten wurden gleich drei Beobachtbarkeitstools übernommen. ClickHouse übernahm Langfuse, Cisco kaufte Galileo – und nun Helicone. Diese Häufung sollte bei der Auswahl eines Ersatzes bedacht werden.

Wann ein Wechsel jetzt sinnvoll ist

Zunächst eine klare Antwort: Nutzer:innen, die Helicone selbst hosten und mit der aktuellen Lösung zufrieden sind, müssen nicht sofort handeln. Die Software läuft weiter, und ein Wechsel kann nach eigenem Zeitplan erfolgen.

Ein früherer Wechsel empfiehlt sich jedoch in folgenden Fällen:

• Du nutzt die gehostete Version von Helicone.
• Du bist auf die Unterstützung neuer Modelle und Anbieter angewiesen.
• Du bevorzugst, jetzt einmalig zu wechseln, statt später unter Zeitdruck entscheiden zu müssen.

Falls eine dieser Situationen auf dich zutrifft, hilft dir die folgende Checkliste bei der Migration.

Schritt-für-Schritt-Anleitung: Von Helicone zu Spanlens wechseln

Helicone und Spanlens funktionieren beide als Proxy-Lösungen. Die technische Migration ist daher überschaubar und beschränkt sich im Wesentlichen auf die Anpassung von URLs und Headern. Die eigentliche Arbeit liegt in der Identifikation aller Stellen, an denen dein Code die Basis-URL oder Metadaten setzt.

1. Die Basis-URL anpassen

Dieser Schritt ist zwingend erforderlich. Ersetze die Helicone-URL durch die Spanlens-URL in deinem Code. Achte darauf, auch den API-Schlüssel zu aktualisieren.

// Vor der Migration (Helicone)
const openai = new OpenAI({
  baseURL: '
  apiKey: process.env.HELICONE_API_KEY,
});

// Nach der Migration (Spanlens)
const openai = new OpenAI({
  baseURL: '
  apiKey: process.env.SPANLENS_API_KEY,
});

2. Metadaten-Header umstellen

Falls du in deinen Anfragen Nutzer:innen-IDs, Sitzungs- oder Prompt-Kennungen mitführst, findest du in dieser Tabelle die passenden Header-Namen für Spanlens:

• Helicone-User-Id → x-spanlens-user
• Helicone-Session-Id → x-spanlens-session
• Helicone-Prompt-Id → x-spanlens-prompt-version

3. API-Schlüssel serverseitig hinterlegen

Ein Unterschied zwischen beiden Lösungen: Bei Spanlens registrierst du deinen OpenAI-, Anthropic- oder anderen Anbieter-Schlüssel einmalig im Dashboard. Deine Anwendung sendet dann nur noch den Spanlens-Schlüssel. Das reduziert die Anzahl sensibler Daten in deinen Requests.

4. Weitere Anbieter aktualisieren

Falls du neben OpenAI auch andere Modelle wie Anthropic, Google Gemini oder Azure nutzt, musst du auch deren Basis-URLs anpassen. Eine vollständige Liste sowie kopierfertige Code-Beispiele findest du im offiziellen Migrationsleitfaden von Spanlens.

5. Validierung vor dem Löschen

Bevor du Helicone vollständig deaktivierst, leite einen Tag lang echten Traffic über Spanlens um. Vergleiche die Kosten- und Token-Abrechnung mit deiner Provider-Rechnung, um sicherzustellen, dass die Migration korrekt funktioniert. Führe beide Systeme während dieser Testphase parallel aus – das ist ein Schritt, den viele überspringen und später bereuen.

Der richtige Umgang mit Übernahmen: Datenhoheit und Flexibilität

Drei Beobachtbarkeitstools wurden in einem Quartal übernommen. Das wirft eine wichtige Frage auf: Was passiert mit deinen Daten, wenn dasselbe noch einmal passiert?

Bevor du dich für ein neues Tool entscheidest, prüfe zwei kritische Punkte:

• Kannst du deine Rohdaten ohne Support-Ticket exportieren?
• Kannst du die Lösung selbst hosten, sodass ein Wechsel deiner Kontrolle unterliegt und nicht von externen Entscheidungen abhängt?

Spanlens ist aus diesem Grund MIT-lizenziert und selbst hostbar – ein Docker-Befehl genügt. Doch diese Überlegungen gelten unabhängig von der gewählten Lösung. Sichere dir die Exit-Option, bevor du sie brauchst.

Falls du Spanlens und Helicone vergleichen möchtest, bietet die detaillierte Gegenüberstellung einen Überblick zu Preisgestaltung, Hosting-Optionen und Instrumentierungsmöglichkeiten.

Spanlens steht als Open-Source-Lösung kostenlos zur Verfügung. Du kannst es in einem Schritt ausprobieren oder dich zunächst im Migrationsleitfaden informieren. Falls die Lösung für dich nützlich ist, hilft ein GitHub-Stern anderen, das Projekt zu entdecken.