Claude API: API Key erstellen und die erste Anfrage testen

1. BetterToken API Key erstellen

1. Melden Sie sich im BetterToken Workspace an.
2. Erstellen Sie einen neuen API Key für die dokumentierte Claude-kompatible Key-Gruppe.
3. Kopieren Sie den Schlüssel einmal und speichern Sie ihn in einem Secret Manager oder einer lokalen Umgebungsdatei, die von Git ausgeschlossen ist.
4. Prüfen Sie in der aktuellen API-Dokumentation und auf der Preisseite die derzeitige Model ID und Verfügbarkeit.

Fügen Sie den Schlüssel weder in Quellcode, einen Prompt, einen Screenshot, eine Support-Nachricht noch in ein öffentliches Repository ein. BetterToken-Nutzer arbeiten mit ihren eigenen Konten und Schlüsseln; der Dienst stellt keinen Anthropic-Console-Schlüssel aus und verkauft keinen Zugang zu einem gemeinsam genutzten Claude.ai-Konto.

2. Anthropic-kompatiblen Endpoint verwenden

Für das Anthropic SDK oder Claude Code lautet die BetterToken Base URL:

https://bettertoken.ai/

Ergänzen Sie diese Base URL nicht um /v1. Für eine direkte HTTP-Messages-Anfrage gilt dagegen der vollständige Ressourcenpfad:

POST https://www.bettertoken.ai/v1/messages

Diese Unterscheidung ist wichtig: SDKs hängen den Ressourcenpfad selbst an, während ein direkter curl-Befehl die vollständige URL benötigt. OpenAI-kompatible Tools verwenden eine andere Base URL und sollten ihrer eigenen Einrichtungsanleitung folgen.

3. Erste Anfrage senden

Speichern Sie den BetterToken-Schlüssel in einer lokalen Umgebungsvariable. Der Variablenname folgt der Konvention des Anthropic SDK, ihr Wert bleibt jedoch Ihr BetterToken API Key.

export ANTHROPIC_API_KEY="your_api_key"
export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export CLAUDE_MODEL_ID="YOUR_MODEL_ID"

curl --fail-with-body "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d "{
    \"model\": \"$CLAUDE_MODEL_ID\",
    \"max_tokens\": 64,
    \"messages\": [{\"role\": \"user\", \"content\": \"Return only the word pong.\"}]
  }"

Ersetzen Sie die beiden Platzhalter ausschließlich in Ihrer lokalen Shell. Verwenden Sie eine exakte aktuelle Model ID aus den BetterToken Docs oder von der Preisseite; Modellnamen und Verfügbarkeit können sich ändern.

4. Antwort und Nutzungsdatensatz prüfen

Eine erfolgreiche Anfrage liefert HTTP 200 und ein JSON-Nachrichtenobjekt. Prüfen Sie:

• type hat den Wert message;
• content enthält die Modellantwort;
• usage enthält die Anzahl der Input- und Output-Token.

Die offizielle Anthropic-Messages-Referenz definiert die Protokollstruktur. Dadurch wird ein von BetterToken ausgestellter Schlüssel nicht zu einem Anthropic-Schlüssel; die Referenz dokumentiert lediglich das kompatible Anfrage- und Antwortformat.

Öffnen Sie anschließend den BetterToken Workspace und ordnen Sie die Anfrage anhand des Zeitpunkts zu. Prüfen Sie Modell, Status, Input-/Output-/Cache-Token, sofern zutreffend, und die zugehörigen Kosten. Der Workspace zeigt Nutzungsmetadaten und Abrechnungsdatensätze; gehen Sie nicht davon aus, dass dort der vollständige Prompt oder die vollständige Antwort gespeichert wird.

5. Häufige Fehler bei der ersten Anfrage beheben

• 404 oder falscher Pfad: Direkte HTTP-Anfragen verwenden /v1/messages; /messages allein ist unvollständig.
• 400: Prüfen Sie anthropic-version, content-type, Model ID, max_tokens und das Array messages.
• 401 oder 403: Prüfen Sie BetterToken-Schlüssel, Key-Gruppe, Base URL und versehentliche Leerzeichen. Senden Sie den Schlüssel nicht an den Support.
• 429: Lesen Sie den Antworttext, halten Sie die angegebene Wartezeit ein und prüfen Sie gleichzeitige Anfragen sowie aktuelle Limits, bevor Sie es erneut versuchen.
• Kein Workspace-Datensatz: Stellen Sie sicher, dass die Anfrage die BetterToken Base URL und nicht einen in Ihrer Umgebung verbliebenen anderen Anbieter verwendet hat.

Wenn Werte eines anderen Anbieters in der Shell verblieben sind, entfernen Sie sie vor einem neuen Versuch:

unset ANTHROPIC_API_KEY
unset ANTHROPIC_BASE_URL
unset CLAUDE_MODEL_ID

Setzen Sie die drei Werte anschließend erneut anhand der aktuellen BetterToken-Einrichtungsinformationen und senden Sie genau eine Anfrage — keine Wiederholungsschleife.

Nächster Schritt

Nachdem die minimale Anfrage funktioniert, verschieben Sie den Schlüssel in den Secret Store Ihrer Anwendung, legen Sie ein endliches Timeout fest und verwenden Sie begrenzte Wiederholungen nur bei vorübergehenden Fehlern. Prüfen Sie die aktuellen BetterToken Docs und lassen Sie den Workspace geöffnet, während Sie die erste echte Integration testen.