SpyBara
Go Premium

gateways.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 19 additions and 16 deletions.

2026
Wed 9 22:58

Claude Code über ein Gateway ausführen

Leiten Sie Claude Code über ein selbstgehostetes Gateway für zentralisierte Anmeldedaten, Nutzungsverfolgung und Kostenkontrolle weiter. Behandelt die Architektur, Anthropics Claude-Apps-Gateway und die Verwendung anderer Gateway-Produkte.

Ein Gateway ist ein Proxy, den Ihre Organisation zwischen Claude Code und einem Modellanbietern betreibt. Claude Code sendet API-Traffic an das Gateway statt direkt an den Anbieter, und das Gateway leitet ihn mit einem Anmeldedatum weiter, das Ihre Organisation hält. Entwickler authentifizieren sich beim Gateway statt Anbieter-Anmeldedaten zu halten, sodass Authentifizierung, Nutzungsverfolgung, Budgets und Audit-Protokollierung an einem Ort stattfinden, den Sie kontrollieren.

Claude Code enthält ein selbstgehostetes Gateway, Claude-Apps-Gateway, in der claude-Binärdatei, sodass Sie kein separates Gateway-Produkt einführen müssen, um eines auszuführen. Wenn Ihre Organisation bereits ein LLM-Gateway betreibt, funktioniert Claude Code auch damit.

Diese Seite behandelt:

Wie ein Gateway funktioniert

Jedes Claude Code eines Entwicklers sendet seine Anfragen an die Adresse des Gateways und authentifiziert sich mit einem vom Gateway ausgegebenen Anmeldedatum.

Das Gateway authentifiziert den Entwickler, wendet alle Zugriffs- und Budgetregeln an, die Sie konfigurieren, und leitet die Anfrage mit dem Anmeldedatum Ihrer Organisation an Ihren Anbieter weiter. Der Anbieter kann die API von Anthropic oder ein Cloud-Anbieter wie Amazon Bedrock, Google Clouds Agent Platform oder Microsoft Foundry sein; die Konfiguration des Gateways entscheidet. Mit Claude-Apps-Gateway oder einem anderen Gateway, das einen einzelnen Anthropic-Format-Endpunkt verfügbar macht, erfordert ein Anbieterwechsel keine Änderungen an Entwicklermaschinen.

Diagramm, das zeigt, wie Claude Code über ein Gateway weitergeleitet wird. In einer Zone für Entwicklermaschinen senden die Claude Code CLI und die VS Code-Erweiterung Anfragen an die Gateway-Adresse mit einem Pro-Entwickler-Anmeldedatum. In einer Zone mit der Bezeichnung Ihre Infrastruktur verarbeitet das Gateway Authentifizierung, Nutzungsverfolgung, Budgets und Routing und leitet Anfragen mit dem Anmeldedatum Ihrer Organisation weiter. In einer Zone für Modellanbietern führt ein durchgehender Pfeil zum konfigurierten Anbieter, dargestellt als Anthropic API, und gestrichelte Pfeile führen zu anderen Anbieteroptionen, dargestellt mit Amazon Bedrock, Google Cloud und Microsoft Foundry als Beispiele.

Zwei Arten von Anmeldedaten sind beteiligt:

  • Entwickler-Anmeldedatum: Jeder Entwickler hält sein eigenes, das vom Gateway ausgestellt wird. Es authentifiziert ihn beim Gateway und identifiziert ihn in der Nutzungsverfolgung
  • Anbieter-Anmeldedatum: Das Gateway hält ein Anmeldedatum für Ihr Anbieterkonto, das von allem weitergeleitetem Traffic gemeinsam genutzt wird

Wählen Sie ein Gateway

Claude Code funktioniert mit Anthropics eigenem Gateway oder mit einem Gateway, das Ihre Organisation bereits betreibt.

Claude-Apps-Gateway

Claude-Apps-Gateway ist Anthropics selbstgehostetes Gateway, das in der claude-Binärdatei enthalten ist. Es leitet zu Amazon Bedrock, Claude Platform auf AWS, Google Cloud, Microsoft Foundry oder der Anthropic API als Upstream weiter. Entwickler melden sich über /login mit Ihrem Unternehmensidentitätsanbieter an, das Gateway erzwingt Modellzugriff und verwaltete Einstellungen nach IdP-Gruppe, und es gibt OpenTelemetry Protocol (OTLP)-Nutzungsmetriken an Ihren eigenen Observability-Stack aus.

Da es zusammen mit jeder Claude Code-Version erstellt und getestet wird, leitet es die Header und Anfragfelder weiter, die Claude Code sendet. Ein separat verwaltetes Gateway muss seine Weiterleitungsregeln aktualisieren, wenn sich diese Header und Felder mit jeder Version ändern; Claude-Apps-Gateway wird mit der CLI veröffentlicht, sodass es keine Liste gibt, die aktuell gehalten werden muss. Siehe Verfügbarkeit und Einschränkungen für die kleine Menge von Funktionen, die sich in einer Gateway-Sitzung unterschiedlich verhalten.

Die Gateway-Anmeldung ist ein Browser-SSO-Schritt, und es gibt keinen Service-Token-Flow, sodass eine CI-Pipeline ohne einen Entwickler, der die Anmeldung genehmigt, sich nicht über sie authentifizieren kann; konfigurieren Sie diese direkt gegen Ihren Anbieter. Agent SDK-Sitzungen und claude -p-Läufe auf einer Maschine, auf der sich ein Entwickler angemeldet hat, verwenden die Gateway-Sitzung dieser Maschine und werden durch ihre Richtlinien geregelt. Siehe CI-Pipelines und Remote-Maschinen.

Siehe Claude-Apps-Gateway, um es bereitzustellen.

Andere Gateways

Wenn Ihre Organisation bereits ein LLM-Gateway oder API-Gateway betreibt, können Sie es stattdessen verwenden. Anthropic unterstützt, verwaltet oder prüft keine anderen Gateway-Produkte und unterstützt nicht das Routing von Claude Code zu Nicht-Claude-Modellen über ein Gateway. Siehe Andere LLM-Gateways für die Admin-Rollout-Checkliste, was ein Gateway implementieren muss, und wie Sie Claude Code darauf verweisen.

Abonnements und Gateways

Wenn Entwickler sich über ein Gateway mit einem Gateway-Anmeldedatum verbinden, wird die Nutzung zu API-Raten auf das Anbieterkonto Ihrer Organisation abgerechnet, und ihre claude.ai-Abonnements werden nicht verwendet oder berechnet. Das Setzen von ANTHROPIC_AUTH_TOKEN für ein Gateway, das Sie betreiben, oder die Anmeldung bei einem Claude-Apps-Gateway mit /login deaktiviert die Abonnement-Anmeldung für diese Sitzung. Jede Anfrage, die unter diesem Anmeldedatum weitergeleitet wird, wird dem Konto hinter dem Anmeldedatum des Gateway-Providers berechnet.

Die Ausnahme ist das Setzen von nur ANTHROPIC_BASE_URL, ohne Gateway-Anmeldedatum. Anfragen werden immer noch über das Gateway weitergeleitet, aber eine gespeicherte claude.ai-Anmeldung bleibt das aktive Anmeldedatum, sodass die Nutzungslimits und Abrechnung des Abonnements gelten. Andere LLM-Gateways behandelt diese Konfiguration und was das Gateway weiterleiten muss, damit es funktioniert.

Separat vom Gateway konfigurieren

Ein Gateway leitet Modell-API-Anfragen weiter. Ein paar Dinge, die Sie erwarten könnten, dass es sie verarbeitet, werden anderswo konfiguriert:

  • Welches Modell antwortet: Wählen Sie das Modell mit dem /model-Befehl oder Modell-Umgebungsvariablen. Das Gateway entscheidet, wohin Anfragen gehen, nicht welches Modell der Entwickler auswählt. Claude-Apps-Gateway kann die Auswahl mit einer Pro-Gruppen-availableModels-Zulassungsliste begrenzen, aber der Entwickler wählt immer noch innerhalb davon.
  • Anderer Netzwerk-Traffic: Claude Code selbst sendet Versionsüberprüfungen und Downloads direkt an Anthropic, getrennt vom Gateway-Pfad. Ihr Netzwerk benötigt immer noch Ausgang zu den erforderlichen Domänen, oder setzen Sie CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, um die optionalen Streams auszuschalten.
  • Client-Telemetrie: Claude Code deaktiviert seine Anthropic-gebundene Client-Analytik, wenn sich eine Sitzung bei einem Claude apps Gateway anmeldet. Um auch die Telemetrie vor der Anmeldung beim Startup auszuschalten, liefern Sie DISABLE_TELEMETRY in den clientseitigen verwalteten Einstellungen auf jedem Gerät.
  • Client-Telemetrie auf anderen Gateways: Ob Claude Code den optionalen Client-Telemetrie-Stream sendet, hängt von Ihrem Anbieter ab, und die Telemetrie-Standardtabelle behandelt jeden Fall.
  • Telemetrie-Ziele: Wohin Claude Code die Telemetrie einer Gateway-Sitzung sendet, hängt davon ab, wie sich die Sitzung angemeldet hat, und Was wird bei Entwicklern durchgesetzt sagt, wohin die Exporte jeder Art von Sitzung gehen.
  • Unternehmens-HTTP-Proxies: Ein HTTPS_PROXY sitzt zwischen Claude Code und jedem Server, mit dem es spricht, einschließlich des Gateways. Wenn Ihr Netzwerk einen benötigt, konfigurieren Sie den Proxy zusätzlich zum Gateway. Für ein Claude apps Gateway, das Sie hosten, überprüft die Anmeldung, dass der Proxy-Host auch in einem privaten Netzwerk ist; wenn nicht, fügen Sie den Gateway-Host zu NO_PROXY hinzu, damit die CLI sich direkt mit ihm verbindet.

Nächste Schritte

Die nächste Seite hängt davon ab, wer das Gateway betreibt. Anthropics Gateway wird aus der claude-Binärdatei ausgeführt und hat seinen eigenen Setup-Leitfaden; ein Gateway, das Ihre Organisation bereits betreibt, hat ein Protokoll zum Implementieren und eine Admin-Rollout-Checkliste.