Base-URL-Fehler beheben: Protokoll, Pfad und Endpoint prüfen
Eine praktische Prüfreihenfolge für Base URLs: Protokoll, Domain, API-Version, Endpoint und Client-Konfiguration — mit einem kurzen Test nach jeder Änderung.
Wenn dein API-Key bereits erstellt ist, der Client aber 401, 404, 405, model not found meldet oder stattdessen eine Login-Seite öffnet, ändere nicht gleichzeitig Key, Modell und Adresse. Kläre zuerst, welchen Vertrag der Client erwartet — OpenAI-kompatibel oder Anthropic-kompatibel. Prüfe die Adresse dann Schicht für Schicht: https → Domain → Basispfad → Endpoint. Sende nach jeder Änderung genau einen kurzen Request. So siehst du, auf welcher Ebene die Konfiguration nicht mehr zusammenpasst.
Bei BetterToken ist diese Unterscheidung wichtig: OpenAI-kompatible Clients verwenden https://www.bettertoken.ai/v1%60?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-022&utm_content=base-url-oshibka-kak-proverit-put-i-protokol als Base URL. Claude Code verwendet die Anthropic-kompatible Base URL https://bettertoken.ai` und ergänzt den erforderlichen Pfad selbst. Das sind keine austauschbaren Varianten derselben Zeichenfolge. Prüfe die aktuellen Werte und Einschränkungen deines Tools immer in der BetterToken-Dokumentation.
Base URL und vollständige Request-URL unterscheiden
Die Base URL trägst du in das Provider-Feld oder die Konfigurationsdatei eines Clients ein. Die vollständige Request-URL entsteht erst, wenn eine Bibliothek oder CLI den Ressourcenpfad ergänzt.
Wenn du einen rohen Anthropic-Messages-Request selbst schreibst, lautet der vollständige Pfad https://www.bettertoken.ai/v1/messages%60.?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-022&utm_content=base-url-oshibka-kak-proverit-put-i-protokol Das ist aber nicht der Wert für das Base-URL-Feld von Claude Code. Bei OpenAI-kompatiblen Clients endet die Base URL normalerweise auf /v1`; den konkreten Endpoint ergänzt der Client. Das bestätigen die Anleitungen für Claude Code und Codex, geprüft am 15. August 2026.
Fünf Prüfungen in der richtigen Reihenfolge
Führe die Prüfungen nacheinander aus. Wiederhole nach jedem Punkt denselben kurzen Request, damit nicht mehrere Ursachen in einem Ergebnis vermischt werden.
- Bestimme das Protokoll, das dein Client erwartet.
- Trage nur die passende Base URL ohne Endpoint ein.
- Stelle sicher, dass
/v1genau einmal in der Request-URL vorkommt. - Starte einen minimalen Request ohne Streaming und Tools.
- Starte den Client vollständig neu und wiederhole den Test.
1. Prüfe das Protokoll, nicht den Modellnamen
Sieh dir im Tool selbst den Integrationstyp an. Codex, Cursor, Cline, OpenCode und viele weitere Clients nutzen eine OpenAI-kompatible Einstellung. Claude Code arbeitet mit dem Anthropic-kompatiblen Vertrag. Erwartet ein Client das eine Format und erhält das andere, behebt ein Modellwechsel den Fehler nicht: Server und Client benötigen andere Felder und andere Pfade.
Rate nicht anhand des Modellnamens. Öffne die Docs genau für dein Tool und suche dort nach Provider, API Key und Base URL.
2. Vergleiche die Base URL ohne zusätzlichen Pfad
Für eine OpenAI-kompatible Einstellung verwende die Adresse aus der Tool-Dokumentation:
Für Claude Code verwendest du die Base URL ohne /v1 und ohne /messages:
Ein häufiger Fehler: Eine vollständige URL aus einem curl-Beispiel wird in ein GUI-Feld für die Base URL kopiert. Der Client ergänzt dann seinen Endpoint und es entsteht eine nicht vorhandene Route. Heißt das Feld base_url, endpoint base oder API base, gehört dort normalerweise kein Ressourcenname hinein.
3. Prüfe, wer die Version /v1 setzt
Bei der OpenAI-kompatiblen BetterToken-Konfiguration ist die API-Version bereits Teil der Base URL. Wenn dein SDK ein separates Version-Prefix erlaubt, füge nicht ohne ausdrückliche SDK-Dokumentation ein zweites /v1 hinzu.
In Logs ist das leicht zu erkennen: .../v1/v1/... bedeutet fast immer, dass Pfade doppelt zusammengesetzt wurden. Fehlt /v1 bei einem OpenAI-kompatiblen Request, kann das zu 404 oder zu HTML statt JSON führen.
4. Prüfe den Endpoint mit einem Minimal-Request
Bevor du Streaming, Tools oder langen Kontext aktivierst, sende über denselben Client genau einen kurzen Request. Bei rohen OpenAI-kompatiblen Requests ist der Endpoint die Ressource nach der Base URL; bei Anthropic Messages lautet er /v1/messages.
Der Test sollte klein und sicher sein: ein kurzer Prompt, die aktuelle Model ID aus Setup oder Model Plaza und dein eigener API-Key. Kopiere den Key nicht in Issues, Screenshots oder Befehle, die du weitergibst. Liefert der Request JSON mit Erfolgsstatus, Modell und Usage, ist die Adressschicht geklärt. Erst dann solltest du Limits, Modell oder Aufgabenparameter prüfen.
5. Starte den Client nach Änderungen vollständig neu
Viele CLIs und Desktop-Apps lesen Variablen und Konfiguration nur beim Start. Eine Datei zu speichern reicht nicht: Beende den Prozess, öffne ein neues Terminal oder starte die App neu. Wiederhole dann denselben kurzen Test. Sonst testest du noch die alte Base URL, obwohl im Editor bereits die neue steht.
Typische Antworten richtig lesen
401 bedeutet nicht immer eine falsche Adresse, und 404 bedeutet nicht immer, dass ein Modell fehlt. Deshalb ist die Reihenfolge wichtig: zuerst URL, dann Authentifizierung, dann Modell und erst danach erweiterte Funktionen.
Schneller Ablauf für Codex und Claude Code
Wenn du Codex einrichtest, nutze einen OpenAI-kompatiblen Provider und folge der aktuellen Codex-Anleitung: Base URL `https://www.bettertoken.ai/v1%60,?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-022&utm_content=base-url-oshibka-kak-proverit-put-i-protokol dein eigener BetterToken-API-Key und eine aktuelle Model ID. Starte Codex neu und führe eine kleine Read-only-Aufgabe in einem Testverzeichnis aus. Im Dashboard kannst du Zeitpunkt, Status, Modell und Token-Verbrauch prüfen; es zeigt diese Felder, verspricht aber keine Speicherung des vollständigen Prompts oder der Antwort.
Wenn du Claude Code einrichtest, nutze die Claude-Code-Anleitung: Anthropic-kompatible Base URL https://bettertoken.ai, deinen eigenen Schlüssel und das in der aktuellen Anleitung genannte Modell. Übernimm weder das OpenAI-/v1 noch /messages in dieses Feld. Führe nach dem Neustart einen kleinen Request aus und aktiviere Tools oder MCP erst danach.
Was du vermeiden solltest
- Ändere Base URL, API-Key und Model ID nicht gleichzeitig; sonst verlierst du die Ursache des Fehlers.
- Verwende nicht dieselbe Adresse für jedes Tool; das Protokoll bestimmt der Client, nicht dein gewohntes URL-Muster.
- Übernimm keinen Pfad aus einer alten Anleitung, ohne Datum und Tool-Seite zu prüfen.
- Teste die Konfiguration nicht in einem echten Arbeits-Repository mit Schreibzugriff. Nutze für den ersten Request ein leeres Testverzeichnis und eine Read-only-Aufgabe.
- Sende dem Support niemals den vollständigen Key. Status, Uhrzeit, Toolname und eine bereinigte Request-URL reichen aus.
Nächster Schritt
Öffne die BetterToken-Dokumentation für dein Tool, erstelle in deinem BetterToken-Konto einen eigenen API-Key, kopiere nur die aktuelle Base URL für das gewählte Protokoll und führe einen kurzen Test aus. Wenn er funktioniert, kannst du im Dashboard Status, Modell und Token-Verbrauch vergleichen. Das ist zuverlässiger, als nur darauf zu vertrauen, dass ein Einstellungsformular gespeichert wurde.