> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

## 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://www.bettertoken.ai`    |
| Codex CLI / OpenAI-kompatibel      | `https://www.bettertoken.ai/v1` |
| Cursor, Cline, OpenCode, OpenClaw  | `https://www.bettertoken.ai/v1` |

Errate den Pfad nicht. API Key, Base URL und Modell-ID müssen vom selben Anbieter oder Gateway stammen.

## 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                         |

Der gleiche Modellname bedeutet nicht, dass dieselbe Base URL überall funktioniert. Toolprotokoll, Base URL, API Key, Anbieter und Modell-ID müssen zusammenpassen.

## Schnellübersicht

| Tool                   | Empfohlene Konfiguration                                             |
| ---------------------- | -------------------------------------------------------------------- |
| Claude Code            | `https://www.bettertoken.ai` mit einem BetterToken API Key           |
| Claude Desktop Gateway | Folge der Gateway-Seite einschließlich des Authentifizierungsschemas |
| Codex CLI              | `https://www.bettertoken.ai/v1` mit einem BetterToken API Key        |
| Cursor                 | `https://www.bettertoken.ai/v1` mit einem BetterToken API Key        |
| Cline                  | `https://www.bettertoken.ai/v1` mit einem OpenAI Compatible-Anbieter |
| OpenCode / OpenClaw    | `https://www.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`                                                   | Die Modell-ID gehört nicht zum aktuellen Anbieter                                                 |
| `invalid_api_key`                                                   | API Key und Base URL stammen von unterschiedlichen Diensten                                       |
| Authentifizierung funktioniert, aber das Modell ist nicht verfügbar | Anbieter und Modell-ID passen nicht zusammen                                                      |
| Anfragen schlagen weiterhin fehl                                    | Eine Anthropic-kompatible Adresse wurde in einem OpenAI-kompatiblen Tool verwendet oder umgekehrt |

## Empfohlene Reihenfolge zur Fehlerbehebung

1. Prüfe, ob das Tool eine OpenAI- oder Anthropic-kompatible API erwartet.
2. Prüfe, ob die Base URL zu diesem Protokoll passt.
3. Prüfe, ob der API Key vom selben Dienst stammt.
4. Prüfe, ob die Modell-ID aus dem <a href={"https://bettertoken.ai/pricing"}>model plaza</a> stammt und zum aktuellen Anbieter gehört.
5. Sende eine minimale Testanfrage, beispielsweise `hello`.

## Codebeispiele

OpenAI-kompatible Tools verwenden normalerweise die Adresse `/v1`:

```python theme={null}
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://www.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:

```python theme={null}
import anthropic

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

message = client.messages.create(
    model="your-claude-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://www.bettertoken.ai`; Codex CLI, Cursor, Cline, OpenCode und OpenClaw verwenden `https://www.bettertoken.ai/v1`.

## Verwandte Dokumentation

* [Was ist der Unterschied zwischen OpenAI- und Anthropic-kompatiblen APIs?](/de/faq/concepts/openai-compatible-vs-anthropic-compatible)
* [Wie wähle ich das richtige KI-Modell?](/de/faq/model-calling/model-selection-guide)
* [Was bedeuten model\_provider, base\_url und wire\_api in Codex CLI?](/de/faq/codex/model-provider-base-url-wire-api)
* [Wie konfiguriere ich eine OpenAI-kompatible API in Cline?](/de/faq/cline/openai-compatible-api)
