Zum Hauptinhalt springen

Verwendung von AWS Bedrock mit Cursor (BYOK)

AWS Bedrock BYOK in Cursor

Bring Your Own Key (BYOK) ermöglicht es Ihnen, Cursor auf einen Modellanbieter zu richten, für den Sie bereits bezahlen, statt auf Cursors integriertes Modell-Routing. AWS Bedrock ist eine der häufigsten Wahlen, weil es Anthropic Claude und andere Frontier-Modelle hinter einem AWS-Konto hostet, das Sie bereits kontrollieren. Dieser Leitfaden erklärt, was BYOK ist, warum speziell Bedrock, wie Sie es in Cursor konfigurieren, wie Abrechnung und Kostenkontrolle funktionieren und wie Sie die wahrscheinlichsten Fehler beheben, einschließlich des verwirrenden „Invalid signature in thinking block is bound to a different conversation“.

Was ist BYOK und wann sollte man es nutzen​

BYOK bedeutet, dass Sie Ihre eigenen Anbieter-Credentials bereitstellen, und der Anbieter Ihnen die verbrauchten Tokens direkt in Rechnung stellt. In Cursor läuft das Modell weiterhin über Cursors Oberfläche und Funktionen, aber die Inferenzanfrage geht an Ihr Konto statt an Cursors.

Sie wollen BYOK im Allgemeinen, wenn:

  • Sie bereits Cloud-Ausgaben gebunden haben. Wenn Ihre Organisation eine AWS-Verpflichtung oder einen Unternehmensrabatt hat, nutzt das Routing des Modellverkehrs über Bedrock diese Ausgaben, statt eine neue Position hinzuzufügen.
  • Compliance eine bestimmte Grenze erfordert. Bedrock hält Daten innerhalb Ihres AWS-Kontos und Ihrer Region, was Datenresidenz und Sicherheitsprüfung vereinfacht.
  • Die Beschaffung einen Anbieter bevorzugt. Der Kauf über AWS ist oft einfacher, als einen separaten KI-Anbieter zu einem Vertrag hinzuzufügen.

BYOK ist nicht immer günstiger. Cursors inklusive und nutzungsbasierte Preisgestaltung kann Bedrock für kleine Teams unterbieten, und Sie übernehmen das Quota-Management selbst. Wählen Sie BYOK für Kontrolle und Compliance, nicht nur wegen des Preises.

BYOK gilt pro Modellanbieter, nicht pro Chat

In Cursor aktivieren Sie Anbieter unter Settings > Models. Sobald Bedrock aktiviert und Ihre Credentials gespeichert sind, werden Ihre ausgewählten Bedrock-Modell-IDs überall dort auswählbar, wo Sie Modelle wählen. Sie sind für andere Modelle nicht auf Bedrock festgelegt.

BYOK vs. Cursors integriertes Routing​

Es hilft, die beiden Wege Seite an Seite zu sehen, bevor Sie sich festlegen.

DimensionCursors integrierte ModelleBYOK mit Bedrock
AbrechnungCursor stellt Ihnen in RechnungAWS stellt Ihnen direkt in Rechnung
CredentialsVon Cursor verwaltetSie liefern und rotieren AWS-Schlüssel
QuotaVon Cursor verwaltetSie verwalten Quotas pro Modell
ComplianceCursors GrenzeIhr AWS-Konto und Ihre Region
EinrichtungsaufwandNullIAM, Modellzugang, Anbieterkonfiguration
ModelllisteVon Cursor kuratiertWas Ihre Region anbietet

Wenn Sie ein Solo-Entwickler sind, der auf Geschwindigkeit optimiert, bleiben Sie beim integrierten Routing. Wenn Sie in einer Organisation sind, in der die AWS-Rechnung, die Region und die IAM-Policy alle Ihre sein müssen, ist BYOK die richtige Antwort.

Warum AWS Bedrock​

Bedrock ist eine gehostete Inferenzschicht, nicht selbst ein Modell. Es legt Anthropic Claude, Amazon Nova, Meta Llama, Mistral und andere über eine einzige AWS-API offen. Diese einzige API ist der Grund, warum es für Unternehmenseinsatz attraktiv ist.

  • Compliance und Governance. Anfragen und Daten bleiben innerhalb Ihres AWS-Kontos und Ihrer Region, unter Ihren bestehenden Kontrollen und Audit-Logs.
  • Bestehende AWS-Ausgaben. Modellnutzung erscheint auf Ihrer AWS-Rechnung und kann durch bestehende Verpflichtungen gedeckt werden.
  • Datenresidenz. Sie wählen die Region, was zählt, wenn Vorschriften verlangen, dass Daten in einem Land bleiben.
  • Unternehmensbeschaffung. AWS ist in den meisten großen Organisationen bereits ein zugelassener Anbieter.

Die Abwägungen sind das Spiegelbild: Sie besitzen das Quota, das IAM-Setup und die Fehlerbehebung.

Voraussetzungen​

Richten Sie vor der Konfiguration von Cursor Folgendes auf der AWS-Seite ein.

AWS-Konto und Modellzugang​

Sie benötigen ein AWS-Konto mit aktivierter Abrechnung. In der Bedrock-Konsole ist der Modellzugang pro Modell Opt-in, daher müssen Sie den Zugang zu den Anthropic-Claude-Modellen, die Sie verwenden wollen, explizit beantragen. Einige Modelle werden automatisch gewährt; andere erfordern einen Zustimmungsschritt oder ein kurzes Anwendungsfall-Formular.

IAM-Berechtigungen​

Erstellen Sie einen IAM-Benutzer oder eine Rolle für Cursor mit den engsten Berechtigungen, die noch funktionieren. Mindestens muss Cursor Modelle aufrufen und auflisten können.

IAM-BerechtigungWarum Cursor sie braucht
bedrock:InvokeModelSendet eine nicht-streamende Anfrage an ein Modell
bedrock:InvokeModelWithResponseStreamSendet eine streamende Anfrage, was die Chat-UI verwendet
bedrock:ListFoundationModelsFüllt die Modellauswahl und validiert Modell-IDs

Für Claude-Modelle auf Bedrock benötigen Sie meist zusätzlich bedrock:InvokeModel, beschränkt auf die Modell-ARNs oder, einfacher, auf die Inferenzprofile der Region. Halten Sie die Policy eng und vermeiden Sie das Anhängen breiter Admin-Policies.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "CursorBedrockInvoke",
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream"
      ],
      "Resource": [
        "arn:aws:bedrock:us-east-1::foundation-model/anthropic.claude-sonnet-4-5-v1:0",
        "arn:aws:bedrock:us-east-1:123456789012:inference-profile/us.anthropic.claude-sonnet-4-5-v1:0"
      ]
    },
    {
      "Sid": "CursorBedrockList",
      "Effect": "Allow",
      "Action": "bedrock:ListFoundationModels",
      "Resource": "*"
    }
  ]
}

Hängen Sie diese Policy an einen dedizierten IAM-Benutzer oder eine Rolle für Cursor, statt eine bestehende Admin-Identität wiederzuverwenden. Wenn Ihre Organisation kurzlebige Credentials verwendet, nehmen Sie eine Rolle an und erneuern Sie das Sitzungstoken regelmäßig, statt einen statischen Schlüssel zu erstellen.

Zugang vor der Konfiguration von Cursor verifizieren​

Beweisen Sie zuerst über die Kommandozeile, dass die Credentials funktionieren. Wenn der Aufruf hier fehlschlägt, wird er auch in Cursor fehlschlagen, und Sie haben sich einen verwirrenden Umweg erspart.

# Confirm the configured identity is the one you expect
aws sts get-caller-identity

# List the models your region exposes
aws bedrock list-foundation-models \
  --region us-east-1 \
  --query "modelSummaries[?contains(modelId, 'anthropic')].[modelId]" \
  --output table

Wenn das Auflisten funktioniert, aber der Aufruf fehlschlägt, liegt das Problem beim Modellzugang oder der spezifischen Modell-ID, nicht bei den Credentials.

Regionswahl​

Wählen Sie eine Region, in der das gewünschte Modell verfügbar ist und in der Ihre Daten liegen dürfen. Cross-Region-Inferenz wird für einige Modelle über ein Inferenzprofil-Präfix unterstützt, sodass Sie nicht auf eine einzige Region beschränkt sein müssen.

Bedrock in Cursor konfigurieren​

Cursor legt BYOK-Anbieter in den Models-Einstellungen offen. Der Ablauf hat für jeden Anbieter dieselbe Form.

  1. Öffnen Sie Cursor Settings > Models.
  2. Suchen Sie den AWS-Bedrock-Anbieter und aktivieren Sie ihn.
  3. Geben Sie Ihre AWS-Access-Key-ID, den Secret Access Key und die Region ein.
  4. Wählen Sie die Modell-IDs, die in der Auswahl sichtbar sein sollen.
  5. Speichern Sie, kehren Sie zu einem Chat zurück und wählen Sie dann ein Bedrock-Modell.

Credential-Felder​

Cursor benötigt eine regionsqualifizierte Konfiguration. Ein Bedrock-Anbieterblock sieht ungefähr so aus:

{
  "provider": "bedrock",
  "aws_access_key_id": "AKIAIOSFODNN7EXAMPLE",
  "aws_secret_access_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
  "aws_region": "us-east-1",
  "models": [
    "anthropic.claude-sonnet-4-5-v1:0",
    "anthropic.claude-3-5-haiku-v1:0"
  ]
}

Bevorzugen Sie den langlebigen IAM-Access-Key nur als letztes Mittel für einen Entwickler-Rechner. Verwenden Sie für ein Team eine temporäre Sitzung oder eine angenommene Rolle, damit Schlüssel nicht im Klartext auf der Platte liegen.

Modell-IDs und Cross-Region-Inferenz​

Bedrock-Modell-IDs folgen einer vorhersehbaren Form: Anbieter, Familie, Version. Einige Modelle erfordern ein Inferenzprofil-Präfix, das die Anfrage für Verfügbarkeit und Durchsatz über Regionen hinweg routet.

# Direct model IDs (region-scoped)
anthropic.claude-sonnet-4-5-v1:0
anthropic.claude-3-5-haiku-v1:0

# Cross-region inference profile IDs (note the region prefix)
us.anthropic.claude-sonnet-4-5-v1:0
eu.anthropic.claude-sonnet-4-5-v1:0
apac.anthropic.claude-sonnet-4-5-v1:0

Wenn ein Modell einen Zugriffsfehler zurückgibt, obwohl Sie es aktiviert haben, ist die Modell-ID fast immer die Ursache: Prüfen Sie, ob sie das Präfix us. oder eu. für die gewählte Region benötigt.

Access-Keys sind Secrets

Fügen Sie Access-Keys nicht in einen Chat, eine Rule-Datei oder einen geteilten Screenshot ein. Speichern Sie sie dort, wo Cursor Anbieter-Credentials speichert, und rotieren Sie jeden Schlüssel, von dem Sie vermuten, dass er offengelegt wurde. Die obigen Beispiel-Schlüssel sind öffentliche Dokumentations-Platzhalter von AWS, keine echten Credentials.

Die Verbindung in Cursor verifizieren​

Bestätigen Sie nach dem Speichern der Anbieterkonfiguration die Verdrahtung mit einem trivialen Prompt statt einer echten Aufgabe, damit ein Fehlschlag eindeutig ist.

  1. Öffnen Sie einen neuen Chat und wählen Sie eine Ihrer Bedrock-Modell-IDs aus der Modellauswahl.
  2. Bitten Sie um etwas Kleines, wie „reply with the word ready“.
  3. Wenn die Antwort zurückkommt, sind Credentials, Region und Modell-ID alle korrekt.
  4. Wenn es fehlschlägt, führen Sie den folgenden CLI-Invoke-Test erneut aus und vergleichen Sie den Fehlertext mit dem, was Cursor zeigt.
# Invoke the model directly so you can see the raw error text
aws bedrock-runtime invoke-model \
  --model-id anthropic.claude-sonnet-4-5-v1:0 \
  --region us-east-1 \
  --body '{"anthropic_version":"bedrock-2023-05-31","max_tokens":16,"messages":[{"role":"user","content":"reply with the word ready"}]}' \
  --cli-binary-format raw-in-base64-out \
  /tmp/out.json && cat /tmp/out.json

Einen funktionierenden CLI-Befehl für jedes verwendete Modell bereitzuhalten verwandelt Cursors Fehlermeldungen von mehrdeutig in entschlüsselbar, weil Sie bereits wissen, wie ein erfolgreicher Aufruf aussieht.

Abrechnung und Kostenkontrolle​

Mit BYOK stellt AWS Ihnen die Tokens in Rechnung, nicht Cursor. Das ändert, wie Sie budgetieren und überwachen.

Modellpreisgestaltung​

Bedrock berechnet pro Eingabe- und Ausgabe-Token, und der Satz hängt vom Modell ab. Eingabe-Tokens sind im Allgemeinen günstiger als Ausgabe-Tokens, und Modelle mit langem Kontext kosten pro Token mehr als kleine.

ModellfamilieRelative EingabekostenRelative AusgabekostenHinweise
Claude Sonnet-KlasseMittelMittelStarker allgemeiner Coding-Standard
Claude Haiku-KlasseNiedrigNiedrigSchnell, günstig, gut für kleine Bearbeitungen
Claude Opus-KlasseHochHochBestes Reasoning, höchste Kosten
Amazon NovaNiedrigNiedrigKosteneffektive Alternativen

Kostenallokation und -überwachung​

Taggen Sie Ihre Bedrock-Nutzung, damit sie zuordenbar ist, und beobachten Sie die Metriken statt die Rechnung.

# Enable cost allocation tags on the resources that call Bedrock
aws resourcegroupstaggingapi tag-resources \
  --resource-arn-list arn:aws:bedrock:us-east-1:123456789012:inference-profile/us.anthropic.claude-sonnet-4-5-v1:0 \
  --tags Project=cursor-byok Team=platform

Verfolgen Sie in CloudWatch die Bedrock-Aufrufmetriken und setzen Sie einen Abrechnungsalarm, damit ein durchdrehender Agent nicht über Nacht still Ihr Monatsbudget ausgibt.

# Quick cost sanity check: list recent Bedrock usage with Cost Explorer
aws ce get-cost-and-usage \
  --time-period Start=2026-10-01,End=2026-10-20 \
  --granularity DAILY \
  --metrics BlendedCost \
  --filter '{"Dimensions":{"Key":"SERVICE","Values":["Amazon Bedrock"]}}'

Token-Kosten reduzieren​

BYOK legt das Token-Meter in Ihre Hände, daher zahlen sich ein paar Gewohnheiten schnell aus:

  • Das Modell richtig dimensionieren. Verwenden Sie ein Modell der Haiku-Klasse für kleine Bearbeitungen und reservieren Sie das Modell der Opus-Klasse für wirklich schwieriges Reasoning.
  • Den Kontext knapp halten. Ein aufgeblähtes Kontextfenster sind die größten versteckten Kosten; starten Sie einen neuen Chat, wenn der Thread abdriften.
  • Kleine Bearbeitungen bündeln. Mehrere winzige Prompts kosten mehr als ein gut abgegrenzter Prompt, der dieselben Änderungen abdeckt.
  • Die Rules verschlanken. Jede immer angewendete Rule sind Tokens, die bei jeder Anfrage gesendet werden, halten Sie .cursor/rules also schlank.
  • Die erste Woche beobachten. Prüfen Sie Cost Explorer in der ersten Woche täglich, danach wöchentlich, damit Sie Ihre echte Basislinie lernen, bevor sie Sie überrascht.

Den Fehler „Invalid signature in thinking block“ beheben​

Dies ist der verwirrendste Bedrock-Fehler in Cursor, weil er nach einem API-Schlüsselproblem klingt, aber fast immer ein Problem des Konversationszustands ist. Die vollständige Meldung lautet:

Invalid `signature` in `thinking` block is bound to a different conversation

Grundursache​

Claudes erweitertes Denken erzeugt verschlüsselte Reasoning-Blöcke, die eine Signatur tragen, die an die genaue Konversation und Runde gebunden ist, in der sie erstellt wurden. Wenn diese Blöcke in eine neue Anfrage wiedereingespielt werden, passt der signierte Inhalt nicht mehr, und der Anbieter lehnt die gesamte Anfrage ab. Dies geschieht, wenn:

  • ein erweitertes Denkblock aus einer früheren Runde in einer späteren erneut gesendet wird,
  • ein Proxy oder Gateway den Request-Body cacht und wiedereinspielt,
  • der Konversationszustand veraltet oder dupliziert ist, zum Beispiel nach einem Modellwechsel mitten im Thread.

Behebungen​

Arbeiten Sie diese der Reihe nach durch:

  1. Starten Sie einen neuen Chat. Die Signatur ist an die Konversation gebunden, daher ist ein frischer Chat das zuverlässige Zurücksetzen.
  2. Deaktivieren Sie das erweiterte Denken für das Modell, während Sie debuggen, und aktivieren Sie es wieder, sobald der Ablauf sauber ist.
  3. Aktualisieren Sie Cursor. Die Signaturbehandlung für Denkblöcke wurde in neueren Builds behoben; ein veralteter Client ist eine häufige Ursache.
  4. Entfernen Sie zwischengeschaltete Proxys oder Gateways, die Request-Bodys zwischen Cursor und Bedrock cachen oder umschreiben könnten.
  5. Senken Sie die Temperatur und verkürzen Sie den Thread, damit weniger Denkblöcke im Kontext akkumulieren.
Erst frischer Chat, alles andere danach

In neunzig Prozent der Fälle löst das Starten eines neuen Chats den Signaturfehler sofort. Wenn er in einem brandneuen Chat reproduziert, sehen Sie dann Proxys und Client-Version an.

Throttling- und resource_exhausted-Fehler​

Bedrock wendet Durchsatz-Quotas pro Konto und pro Modell an. Wenn Sie sie überschreiten, erhalten Sie einen Throttling- oder resource_exhausted-Fehler statt eines sauberen Fehlschlags.

ResourceNotFoundException / ServiceQuotaExceededException:
You have exceeded the rate of requests allowed for this model.

Dies ist ein Quota-Problem, kein Credentials-Problem. Zwei Behebungen:

  • Last über Modelle oder Regionen verteilen. Cross-Region-Inferenzprofile existieren genau, um Kapazität zu bündeln.
  • Eine Quota-Erhöhung beantragen in der AWS Service Quotas-Konsole für das verwendete Bedrock-Modell.
# List the Bedrock service quotas you can request increases for
aws service-quotas list-service-quotas \
  --service-code bedrock \
  --query "Quotas[?contains(QuotaName, 'Claude')].[QuotaName,QuotaCode,Value]" \
  --output table

Der Fehler verschwindet meist von selbst, sobald der Burst-Verkehr abklingt, aber wenn er chronisch ist, ist die Quota-Anfrage die Lösung.

Zugriffs-, Regions- und Proxy-Fehler​

Zugriff verweigert, wenn der Modellzugang nicht gewährt ist​

AccessDeniedException: You don't have access to the model with the specified model ID

Zwei Ursachen dominieren hier:

  • Der Modellzugang wurde nie gewährt in der Bedrock-Konsole. Öffnen Sie die Konsole und beantragen Sie Zugang zu diesem spezifischen Anthropic-Modell.
  • Die IAM-Policy ist zu eng oder die Modell-ID ist falsch. Bestätigen Sie, dass die Policy bedrock:InvokeModelWithResponseStream gewährt und dass die Modell-ID-Zeichenkette mit einem Modell übereinstimmt, das Sie tatsächlich aktiviert haben.

Falsche Region​

Wenn Cursors konfigurierte Region das Modell nicht hostet oder die Modell-ID ein Cross-Region-Präfix benötigt, schlagen Anfragen fehl, obwohl der Schlüssel gültig ist. Bestätigen Sie, dass die Region in Cursor mit der Region in der Konsole übereinstimmt, in der Sie den Modellzugang aktiviert haben.

Streaming-Fehler hinter Unternehmens-Proxys​

Streaming ist der Standard für den Chat. Unternehmens-Proxys und TLS-inspizierende Firewalls brechen text/event-stream-Antworten oft, was sich als Chat zeigt, der hängt oder eine unvollständige Antwort liefert.

  • Whitelisten Sie die regionalen Bedrock-Endpunkte (zum Beispiel bedrock-runtime.us-east-1.amazonaws.com).
  • Stellen Sie sicher, dass der Proxy gestreamte Antworten nicht puffert; suchen Sie nach einer Einstellung „streaming“ oder „chunked transfer“.
  • Wenn der Proxy unvermeidbar ist, prüfen Sie, ob Cursor ihn für den Bedrock-Host umgehen kann.

Schnellreferenz zur Fehlerbehebung​

SymptomWahrscheinliche UrsacheLösung
Invalid signature in thinking blockDenkblöcke über Konversationen hinweg wiedereingespieltEinen neuen Chat starten, erweitertes Denken deaktivieren, Cursor aktualisieren
resource_exhausted / ThrottlingQuota pro Modell überschrittenÜber Regionen verteilen, Quota-Erhöhung beantragen
AccessDeniedExceptionModellzugang nicht gewährt oder Policy zu engModell in der Konsole aktivieren, IAM-Policy erweitern
Modell nicht gefunden / kein Zugriff in einer RegionFalsche Region oder fehlendes Inferenzprofil-PräfixRegion abgleichen, Präfix us. / eu. verwenden
Chat hängt ohne Stream-AusgabeProxy puffert text/event-streamBedrock-Endpunkte whitelisten, Proxy-Pufferung deaktivieren
Modellauswahl leerbedrock:ListFoundationModels fehltDie Berechtigung hinzufügen, Credentials erneut speichern
Auth-Fehler nach SchlüsselrotationVeraltete Credentials in Cursor gespeichertAccess-Key und Secret in den Models-Einstellungen erneut eingeben
Funktioniert lokal, schlägt in CI fehlRegion oder Profil nicht in der Pipeline übergebenRegion und Profil in der CI-Umgebung setzen

Sobald der Ablauf stabil ist, halten Sie eine kurze Notiz zu Ihrer Region, Ihren Modell-IDs und Quota-Limits neben der Anbieterkonfiguration. Wenn sechs Monate später ein Fehler auftaucht, verwandelt diese Notiz eine zweistündige Untersuchung in eine Zwei-Minuten-Behebung.