llm-gateway.md +0 −96 deleted
File Deleted View Diff
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# LLM-Gateways
6
7> Leiten Sie Claude Code über ein LLM-Gateway für zentralisierte Authentifizierung, Nutzungsverfolgung und Kostenkontrollen weiter. Behandelt die Verbindung von Claude Code mit einem Gateway, die Bereitstellung für Ihre Organisation, was Claude Code an ein Gateway sendet und wie Gateways mit claude.ai-Abonnements interagieren.
8
9Ein LLM-Gateway ist ein Proxy, den Ihre Organisation zwischen Claude Code und einem Modelleanbieter betreibt. Claude Code sendet API-Verkehr an das Gateway, und das Gateway leitet ihn mit einem Anmeldedaten weiter, das Ihre Organisation kontrolliert, an den Anbieter.
10
11<Note>
12 * Wenn Sie ein Entwickler sind, der sich mit einem vorhandenen Gateway verbindet: [Verbinden Sie Claude Code mit Ihrem Gateway](/de/llm-gateway-connect)
13 * Wenn Sie ein Administrator sind, der ein Gateway für Ihre Organisation bereitstellt: [Stellen Sie ein Gateway bereit und verteilen Sie es](/de/llm-gateway-rollout)
14 * Wenn Sie ein Gateway-Produkt konfigurieren: die [Gateway-Protokoll-Referenz](/de/llm-gateway-protocol)
15</Note>
16
17<h2 id="what-a-gateway-provides">
18 Was ein Gateway bietet
19</h2>
20
21Ein Gateway gibt Ihrer Organisation einen Ort zur Verwaltung von:
22
23* **Anmeldedaten**: Der Anbieter-Schlüssel bleibt serverseitig; Entwickler halten stattdessen Gateway-Anmeldedaten
24* **Nutzungsverfolgung**: Attributieren Sie die Nutzung nach Entwickler oder Team, unabhängig davon, welcher Anbieter die Anfrage bedient
25* **Kostenkontrollen**: Erzwingen Sie Budgets und Ratenlimits an einem Ort
26* **Audit-Protokollierung**: Protokollieren Sie jede Modellanfrage zur Compliance
27* **Anbieter-Wechsel**: Ändern Sie den Anbieter in der Gateway-Konfiguration, ohne Entwicklermaschinen zu berühren
28
29Alle diese außer dem Anbieter-Wechsel gelten, ob der Upstream die API von Anthropic oder ein [Cloud-Anbieter](/de/third-party-integrations) ist.
30
31Der Kompromiss besteht darin, dass das Gateway zu einer Infrastruktur wird, die Ihre Organisation betreibt. Claude Code fügt mit jeder Version Funktionen hinzu, und ein Gateway, das diese nicht weiterleitet, bricht die entsprechenden Funktionen, daher muss das Gateway-Produkt aktualisiert werden, wenn sich Claude Code entwickelt. Die [Gateway-Protokoll-Referenz](/de/llm-gateway-protocol) behandelt, was weitergeleitet werden soll.
32
33<h2 id="how-a-gateway-works">
34 Wie ein Gateway funktioniert
35</h2>
36
37Standardmäßig sendet Claude Code Anfragen direkt an die API von Anthropic unter `api.anthropic.com`. Um über ein Gateway zu leiten, setzen Sie `ANTHROPIC_BASE_URL` auf die Adresse des Gateways; Claude Code sendet stattdessen die gleichen Anfragen dorthin. Das Gateway authentifiziert den Entwickler, fügt die Anmeldedaten des Anbieters Ihrer Organisation an und leitet jede Anfrage an den Anbieter weiter, für den es konfiguriert ist.
38
39`ANTHROPIC_BASE_URL` ist die Adressvariable für die meisten Gateways. Ein Gateway, das einen bestimmten Cloud-Anbieter wie Bedrock, Vertex, Foundry oder die Claude Platform auf AWS frontet, verwendet stattdessen die Basis-URL-Variable dieses Anbieters; [API-Formate](/de/llm-gateway-protocol#api-formats) listet auf, welche Variable zu jeder Konfiguration passt.
40
41<Frame>
42 <img src="https://mintcdn.com/claude-code/-uq-4JE0W_JO5Er5/images/llm-gateway-flow.svg?fit=max&auto=format&n=-uq-4JE0W_JO5Er5&q=85&s=1c1a8dcc0cfcc3a58652cc8e28cd3e20" alt="Diagramm, das zeigt, wie Claude Code über ein LLM-Gateway geleitet wird. In einer Zone für Entwicklermaschinen senden die Claude Code CLI, VS Code-Erweiterung und CI- oder Agent SDK-Clients Anfragen an das Gateway, wobei die Basis-URL-Variable für das API-Format des Gateways darauf verweist und jeder Entwickler ein Pro-Entwickler-Anmeldedaten hält, und die Desktop-App erreicht das gleiche Gateway über organisationsweit verteilte Konfiguration. In einer Zone mit der Bezeichnung Ihre Infrastruktur verwaltet das LLM-Gateway Authentifizierung, Nutzungsverfolgung, Budgets und Routing und leitet Anfragen mit den Anmeldedaten Ihrer Organisation weiter. In einer Zone für Modelleanbieter führt ein durchgehender Pfeil zum Anbieter, den Sie konfigurieren, dargestellt als die Anthropic API, und gestrichelte Pfeile führen zu anderen Anbieteroptionen, dargestellt mit Amazon Bedrock, Google Vertex AI und Microsoft Foundry als Beispiele." width="780" height="322" data-path="images/llm-gateway-flow.svg" />
43</Frame>
44
45Zwei Arten von Anmeldedaten sind beteiligt:
46
47* **Entwickler-Anmeldedaten**: Jeder Entwickler hält seine eigenen, vom Gateway ausgestellt. Es authentifiziert ihn beim Gateway und identifiziert ihn in der Nutzungsverfolgung
48* **Anbieter-Anmeldedaten**: Das Gateway hält ein Anmeldedaten für Ihr Anbieterkonto, geteilt von allem weitergeleitetem Verkehr. Sie stellen keine Anbieter-Schlüssel pro Entwickler bereit
49
50Das Gateway leitet jede Anfrage an den Anbieter weiter, den Sie konfigurieren, wie die Anthropic API, [Amazon Bedrock](/de/amazon-bedrock), [Google Vertex AI](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry) oder die [Claude Platform auf AWS](/de/claude-platform-on-aws). Da Claude Code nur mit dem Gateway spricht, ist die Anbieterauswahl die Konfiguration des Gateways, nicht die des Clients.
51
52<h2 id="roll-out-a-gateway">
53 Ein Gateway bereitstellen
54</h2>
55
56Wenn Sie bereit sind, ein LLM-Gateway für Ihre Organisation bereitzustellen, ist die Abfolge gleich, welches Gateway-Produkt Sie auch wählen:
57
581. Stellen Sie das Gateway bereit und geben Sie ihm Ihre Anbieter-Anmeldedaten, damit es die Anfragen authentifizieren kann, die es weiterleitet.
592. Geben Sie jedem Entwickler ein Gateway-Anmeldedaten aus, damit die Nutzung dem Entwickler zugeordnet wird und das Offboarding ein Anmeldedaten widerruft.
603. Verteilen Sie die Konfiguration über eine [verwaltete Einstellungsdatei](/de/settings#settings-files) und Ihre Secrets-Tools, damit jede Maschine die Basis-URL und ein Anmeldedaten erhält. Wenn beide verteilt werden, konfigurieren Entwickler nichts. Wenn Sie keine Einstellungsverteilung haben, folgen Entwickler der [Verbindungsseite](/de/llm-gateway-connect), um die Variablen selbst zu setzen.
614. Lassen Sie jeden Entwickler [die Konfiguration in Claude Code überprüfen](/de/llm-gateway-connect#check-for-an-existing-configuration), damit Verteilungsprobleme auftauchen, bevor sie vom Gateway abhängig sind.
62
63[Ein LLM-Gateway für Ihre Organisation bereitstellen](/de/llm-gateway-rollout) führt jeden Schritt durch und zeigt die Konfigurationsdateien, die bei jedem verteilt werden sollen. Das Gateway ist ein Teil der Organisationseinrichtung; für Richtliniendurchsetzung, Nutzungssichtbarkeit und Datenbehandlungsentscheidungen siehe [Claude Code für Ihre Organisation einrichten](/de/admin-setup).
64
65<h2 id="third-party-gateways">
66 Gateways von Drittanbietern
67</h2>
68
69Jedes Gateway, das ein [unterstütztes API-Format](/de/llm-gateway-protocol#api-formats) bereitstellt, funktioniert. Anthropic befürwortet, wartet oder prüft keine Gateway-Produkte von Drittanbietern. Stellen Sie sie nach ihrer eigenen Dokumentation bereit, und schließen Sie dann die Claude Code-Seite der Bereitstellung mit den [Bereitstellungsschritten](/de/llm-gateway-rollout) ab.
70
71<h2 id="subscriptions-and-gateways">
72 Abonnements und Gateways
73</h2>
74
75Während eine [Gateway-Anmeldedaten-Variable](/de/llm-gateway-connect#set-the-credential-variable) oder `apiKeyHelper` aktiv ist, wird das claude.ai-Abonnement eines Entwicklers nicht verwendet: Das Anmeldedaten ersetzt die Abonnement-Anmeldung für diese Sitzung, und die Nutzungslimits des Abonnements gelten nicht. Dieser Verkehr wird pro Token dem Besitzer des Anmeldedaten, das das Gateway weiterleitet, wie Ihr Anthropic Console-Konto der Organisation oder Ihr Bedrock-, Vertex- oder Foundry-Konto, wenn das Gateway dorthin leitet, in Rechnung gestellt.
76
77Das Setzen nur von `ANTHROPIC_BASE_URL` ohne Gateway-Anmeldedaten ersetzt das Abonnement nicht. Anfragen werden immer noch über das Gateway geleitet, aber eine gespeicherte claude.ai-Anmeldung bleibt das aktive Anmeldedaten, daher gelten seine Nutzungslimits und Abrechnung. Gateways, die diesen Verkehr an Anthropic weitergeben, müssen die OAuth-Fähigkeit in `anthropic-beta` weiterleiten; siehe die [Request-Header-Referenz](/de/llm-gateway-protocol#request-headers).
78
79<h2 id="configure-separately-from-the-gateway">
80 Separat vom Gateway konfigurieren
81</h2>
82
83Ein Gateway bestimmt, wohin Modell-API-Anfragen gesendet werden. Modellauswahl, der Rest des Netzwerkverkehrs von Claude Code und Unternehmens-Proxies werden separat konfiguriert:
84
85* **Modellauswahl**: Die Basis-URL entscheidet, wohin Anfragen gehen, nicht welches Modell sie beantwortet. Wählen Sie das Modell mit dem `/model`-Befehl oder den Modell-Umgebungsvariablen; siehe [wie Sie Ihr Modell setzen](/de/model-config#setting-your-model)
86* **Client-seitiger Verkehr**: Versionsprüfungen und optionale Client-Telemetrie, beide deaktiviert mit [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/de/env-vars), und Anmeldungsverkehr, wenn eine claude.ai- oder Console-Anmeldung verwendet wird, gehen zu den Update- und Authentifizierungsendpunkten von Anthropic statt zum Gateway. Siehe [Netzwerkzugriffsanforderungen](/de/network-config#network-access-requirements) für die Domänen
87* **Unternehmens-Proxies**: Ein mit `HTTPS_PROXY` gesetzter Proxy sitzt zwischen Claude Code und jedem Server, mit dem es spricht, einschließlich des Gateways. Wenn Ihr Netzwerk einen Proxy erfordert, konfigurieren Sie beide; siehe [Proxy-Konfiguration](/de/network-config#proxy-configuration)
88
89<h2 id="related-pages">
90 Verwandte Seiten
91</h2>
92
93* [Verbinden Sie Claude Code mit einem LLM-Gateway](/de/llm-gateway-connect): Setzen Sie die Basis-URL und das Anmeldedaten auf Ihrer eigenen Maschine, mit Pro-Surface-Konfiguration und einer Fehlerbehebungstabelle
94* [Ein LLM-Gateway für Ihre Organisation bereitstellen](/de/llm-gateway-rollout): Die Admin-Checkliste für die Bereitstellung eines Gateways, die Ausstellung von Entwickler-Anmeldedaten und die Verteilung verwalteter Einstellungen
95* [Gateway-Protokoll-Referenz](/de/llm-gateway-protocol): Was Claude Code an ein Gateway sendet, für Operatoren, die eines konfigurieren, mit Endpunkten, Headern zum Weiterleiten und Feature-Pass-Through
96* [Claude Code für Ihre Organisation einrichten](/de/admin-setup): Die breiteren Bereitstellungsentscheidungen, von denen ein Gateway ein Teil ist, einschließlich Richtliniendurchsetzung und Nutzungssichtbarkeit