Modellaufrufe

Wie trage ich die Base URL richtig ein?

Erfahre, wie Base URL, /v1-Pfade, API Key und Modell-ID in Claude Code, Codex CLI, Cursor, Cline und anderen Tools zusammenpassen. Praktische Hinweise.

Kurzantwort

Die Base URL muss zum Protokoll passen, das dein Tool erwartet. Claude Code verwendet normalerweise die Anthropic-kompatible Stammadresse. Codex CLI, Cursor, Cline, OpenCode, OpenClaw und andere externe Tools verwenden normalerweise die OpenAI-kompatible Adresse /v1.

Bei BetterToken:

Anwendungsfall	Base URL
Claude Code / Anthropic-kompatibel	`https://bettertoken.ai`
Codex CLI / OpenAI-kompatibel	`https://bettertoken.ai/v1`
Cursor, Cline, OpenCode, OpenClaw	`https://bettertoken.ai/v1`

Verwenden Sie https://bettertoken.ai für Claude Code und https://bettertoken.ai/v1 für Codex CLI und OpenAI-kompatible Tools. Die Adresse richtet sich nach dem Protokoll des Clients.

Warum es unterschiedliche Base URLs gibt

SDKs hängen Pfade auf unterschiedliche Weise an.

Protokoll- oder Tooltyp	Übliches Verhalten
OpenAI-kompatibles SDK	Ruft Ressourcen wie chat completions oder responses normalerweise unter `/v1` auf
Anthropic-kompatibles SDK	Hängt Pfade für Nachrichtenendpunkte normalerweise selbst an. Füge `/v1` daher nicht erneut hinzu
Integrierter Toolanbieter	Kann Pfade automatisch anhängen oder eine vollständige Base URL verlangen

Verwenden Sie https://bettertoken.ai für Claude Code und https://bettertoken.ai/v1 für Codex CLI und OpenAI-kompatible Tools. Die Adresse richtet sich nach dem Protokoll des Clients.

Schnellübersicht

Tool	Empfohlene Konfiguration
Claude Code	`https://bettertoken.ai` mit einem BetterToken API Key
Claude Desktop Gateway	Folge der Gateway-Seite einschließlich des Authentifizierungsschemas
Codex CLI	`https://bettertoken.ai/v1` mit einem BetterToken API Key
Cursor	`https://bettertoken.ai/v1` mit einem BetterToken API Key
Cline	`https://bettertoken.ai/v1` mit einem OpenAI Compatible-Anbieter
OpenCode / OpenClaw	`https://bettertoken.ai/v1` mit einem BetterToken API Key

Häufige Fehler

Fehler oder Symptom	Mögliche Ursache
`404 Not Found`	Der Pfad der Base URL entspricht nicht dem vom SDK erwarteten Pfad
`model not found`	Prüfe die genaue Model ID in der model plaza und trage sie in den Modelleinstellungen des Clients ein.
`invalid_api_key`	API Key und Base URL stammen von unterschiedlichen Diensten
Authentifizierung funktioniert, aber das Modell ist nicht verfügbar	Prüfe die genaue Model ID in der model plaza und trage sie in den Modelleinstellungen des Clients ein.
Anfragen schlagen weiterhin fehl	Eine Anthropic-kompatible Adresse wurde in einem OpenAI-kompatiblen Tool verwendet oder umgekehrt

Empfohlene Reihenfolge zur Fehlerbehebung

Prüfe, ob das Tool eine OpenAI- oder Anthropic-kompatible API erwartet.
Prüfe, ob die Base URL zu diesem Protokoll passt.
Prüfe, ob der API Key vom selben Dienst stammt.
Kopieren Sie die genaue Model ID aus der model plaza.
Sende eine minimale Testanfrage, beispielsweise hello.

Codebeispiele

OpenAI-kompatible Tools verwenden normalerweise die Adresse /v1:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://bettertoken.ai/v1"
)

response = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role": "user", "content": "hello"}]
)

Claude- oder Anthropic-kompatible Konfigurationen verwenden normalerweise die Stammadresse:

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://bettertoken.ai"
)

message = client.messages.create(
    model="your-model-id",
    max_tokens=1024,
    messages=[{"role": "user", "content": "hello"}]
)

Über BetterToken

BetterToken bietet Anthropic- und OpenAI-kompatiblen Zugriff. Du kannst API Keys, Guthaben und Nutzungsdaten im selben Dashboard verwalten. Jeder Client benötigt jedoch die Adresse des unterstützten Protokolls.

Einfache Regel: Claude Code verwendet https://bettertoken.ai; Codex CLI, Cursor, Cline, OpenCode und OpenClaw verwenden https://bettertoken.ai/v1.