Claude API Key: Console, Aufladung, Aufruf und Proxy (2026)

Die Claude API ist die Modellschnittstelle von Anthropic und wird häufig für lange Texte, Code, Agenten und komplexe Schlussfolgerungen eingesetzt. Viele Entwickler verwechseln bei der ersten Einrichtung drei Dinge: das Claude-Webabo, Claude Code und die Claude API.

Dieser Artikel erklärt, wie Sie einen Claude API Key erhalten, wie Sie ihn aufrufen, wie Sie Claude Code anbinden und welche zwei Wege es für den Zugang gibt.

Hinweis: Claude und Anthropic sind Marken ihrer jeweiligen Rechteinhaber. Dieser Artikel bezieht sich auf die üblichen Versionen vom Oktober 2026; Schnittstellen und Preise richten sich nach den offiziellen Angaben und den Angaben auf unserer Website.

1. Drei Dinge auseinanderhalten

Bezeichnung	Was es ist	Verwendung
Claude Web/App	Chat-Produkt	Abo für Endnutzer
Claude Code	Kommandozeilen-Werkzeug für Programmierung	Ruft Modelle über die API auf
Claude API	Modellschnittstelle	Key für Aufrufe an `/v1/messages`

Dieser Artikel behandelt den Claude API Key. Er ist kein Web-Konto und ein Web-Abo kann nicht direkt als API verwendet werden.

2. Weg A: Offizieller Key über die Anthropic Console

Öffnen Sie die Anthropic Console.
Registrieren Sie sich oder melden Sie sich an.
Rufen Sie die Seite API Keys auf.
Erstellen Sie einen Key, benennen Sie ihn und speichern Sie ihn.
Hinterlegen Sie eine Zahlungsmethode und prüfen Sie das Kontingent.
Kopieren Sie den Key und speichern Sie ihn in einem Passwortmanager.

Die Aufrufadresse des offiziellen Keys ist üblicherweise:

https://api.anthropic.com

Die Anfrage benötigt die Header x-api-key und anthropic-version. Maßgeblich ist die offizielle Dokumentation.

3. Weg B: Key über das ZSQH Gateway

Wenn der Zugang zur offiziellen Schnittstelle instabil ist oder eine einheitliche Rechnung beziehungsweise mehrere Modelle benötigt werden:

Öffnen Sie das ZSQH AI Gateway und registrieren Sie sich.
Rufen Sie „API-Keys“ auf und erstellen Sie einen Key.
Legen Sie Obergrenze und Gültigkeitsdauer fest.
Zahlen Sie Guthaben in der Wallet auf.
Kopieren Sie den Key.

Das Gateway bietet zwei übliche Nutzungsarten:

Anthropic-kompatibel: für Claude Code und andere Werkzeuge, die das Anthropic-Protokoll verwenden.
OpenAI-kompatibel: für OpenAI SDK, Cursor, Chatbox, Dify und ähnliche Werkzeuge; Base URL https://ai.zhongshangqihang.com/v1.

4. Native Anthropic-Schnittstelle mit curl aufrufen

export ANTHROPIC_API_KEY="sk-ihr-schluessel"

curl "https://ai.zhongshangqihang.com/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "Erklären Sie in drei Sätzen, was ein API-Gateway ist"}
    ]
  }'

Der Modellname richtet sich nach den Modellpreisen. Falls der Anthropic-kompatible Einstiegspunkt des Gateways einen anderen Pfad verwendet, gelten die Einbindungshinweise auf der Website.

5. Claude mit dem OpenAI SDK aufrufen

Viele Werkzeuge unterstützen nur das OpenAI-Protokoll. Verwenden Sie dann den OpenAI-kompatiblen Einstiegspunkt des Gateways:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "Antworte nur mit OK"}],
)
print(resp.choices[0].message.content)

Wichtig: Die native Anthropic-Schnittstelle und die OpenAI-kompatible Schnittstelle verwenden unterschiedliche Anforderungsformate. Mischen Sie sie nicht.

6. Anbindung an Claude Code

Claude Code verwendet das Anthropic-Protokoll. Übliche Konfiguration:

export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_API_KEY="sk-ihr-schluessel"
claude

Wenn der Client ANTHROPIC_AUTH_TOKEN verlangt, ersetzen Sie die Variable gemäß der Client-Dokumentation. Detaillierte Schritte finden Sie in der Anleitung zur Einrichtung von Claude Code.

7. Häufige Fehlermeldungen

Fehler	Ursache	Behandlung
`401`	Falscher oder abgelaufener Key, falscher Header	`x-api-key` oder Bearer prüfen
`404`	Falsche Base URL oder falscher Pfad	Nativ `/v1/messages`; OpenAI-kompatibel `/v1`
`model not found`	Falscher Modellname	Aus der Preisseite kopieren
`429`	Ratenlimit oder Kontingent	Parallelität senken, wiederholen, Kontingent erhöhen
`insufficient quota`	Guthaben reicht nicht	Aufladen
Fehler zu `anthropic-version`	Versionsheader fehlt	`anthropic-version: 2023-06-01` ergänzen

8. Sicherheitsempfehlungen

Keys nicht im Frontend offenlegen.
Ein Key pro Person, Limits pro Projekt.
Gültigkeitsdauer festlegen und regelmäßig rotieren.
Keys nicht in Git einchecken.
In der Produktion Umgebungsvariablen oder einen Secret-Manager verwenden.

9. Direkte Verbindung oder Gateway

Dimension	Direkte Verbindung	ZSQH Gateway
Zugang	Vom Netzwerk abhängig	Auf stabilen Zugang ausgerichtet
Zahlung	Offizielle Zahlungswege	Aufladung im Konto
Modelle	Nur Claude	Zusätzlich GPT, Gemini, DeepSeek
Rechnung	Offizielles Backend	Einheitliches Kontrollzentrum
Wechsel	Anbieterwechsel erfordert Codeänderung	Modellname ändern genügt

Wenn Sie nur Claude nutzen und der offizielle Zugang stabil ist, ist die direkte Verbindung eine Option. Bei Bedarf an stabilem Zugang und zentraler Multi-Modell-Verwaltung ist ein Gateway geeigneter.

Häufige Fragen

Sind der Claude API Key und der Key für Claude Code derselbe?

Claude Code verwendet einen Claude API Key oder einen kompatiblen Gateway-Key. Ein Web-Abo ist kein API Key.

Kann ein Key mehrere Claude-Modelle aufrufen?

Ja, das Modell wird im Anforderungsparameter angegeben. Welche Modelle verfügbar sind, steht auf der Preisseite.

Warum läuft der Code aus der offiziellen Dokumentation nicht?

Häufig passen Base URL, Anfrageheader und Modellname nicht zusammen. Native Schnittstelle und OpenAI-kompatible Schnittstelle müssen getrennt konfiguriert werden.

Nächster Schritt

Für stabilen Zugang oder einen einheitlichen Multi-Modell-Zugang können Sie sich zunächst beim ZSQH AI Gateway registrieren, einen Test-Key erstellen und die erste Anfrage gemäß diesem Artikel ausführen. Modelle und Preise entnehmen Sie den Modellpreisen.

Weiterlesen: