Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Richten Sie Claude Code mit einem Inhaber-Token ein
<a name="coding-agents-claude-code-bearer-token"></a>

Auf diesem Pfad sendet Claude Code OpenTelemetry (OTel) -Metriken direkt an den Endpunkt für CloudWatch native OTLP-Metriken von Amazon und authentifiziert sich mit einem Bearer-Token (einem CloudWatch Metrik-API-Schlüssel). Es ist kein OpenTelemetry Collector erforderlich. Dies ist der schnellste Weg für einen einzelnen Entwickler oder ein kleines Team, Claude Code-Metriken in die Coding Agent Insights-Dashboards zu integrieren.

**Wichtig**  
Inhaber-Token sind langfristige Zugangsdaten. Wir empfehlen sie nur dort, wo kurzfristige AWS Anmeldeinformationen nicht möglich sind, wie z. B. bei Laptops für Entwickler im Freien AWS. Informationen zu Kompromissen bei der Sicherheit und Hinweise zur Schlüsselrotation finden Sie unter. [Einrichtung der Bearer-Token-Authentifizierung für Metrics](CloudWatch-OTLP-MetricsBearerTokenAuth.md) Organizations, die ihre Identität über Unternehmens-SSO bündeln, sollten stattdessen den Enterprise-Rollout mit Claude Apps Gateway verwenden. Siehe [Claude Code mit dem Claude Apps Gateway einrichten](coding-agents-claude-code-gateway.md).

## Voraussetzungen
<a name="coding-agents-claude-code-bearer-token-prereqs"></a>
+ Claude Code ist auf dem Computer des Entwicklers installiert.
+ Eine funktionierende Methode für Claude Code, ein Modell zur Inferenz aufzurufen. Diese Telemetrieeinrichtung ist unabhängig von Inferenzen, sodass Sie entweder ein Anthropic-Konto (den standardmäßigen Claude Code-Anbieter) oder Amazon Bedrock verwenden können. Informationen zur Verwendung von Amazon Bedrock als Inferenz finden Sie unter [Claude Code on Amazon Bedrock](https://code.claude.com/docs/en/amazon-bedrock) in der Claude Code-Dokumentation.
+ Ein API-Schlüssel (Bearer-Token) für CloudWatch Kennzahlen, der von einem IAM-Benutzer mit Metrikberechtigungen erstellt wurde. CloudWatch Informationen zum Verfahren, mit dem der IAM-Benutzer und der Schlüssel erstellt werden, finden Sie unter. [Einrichtung der Bearer-Token-Authentifizierung für Metrics](CloudWatch-OTLP-MetricsBearerTokenAuth.md)

## Konfigurieren Sie den Metrik-Exporter
<a name="coding-agents-claude-code-bearer-token-configure"></a>

Claude Code konfiguriert OpenTelemetry über Umgebungsvariablen. Legen Sie die folgenden Variablen in der Shell fest, die Claude Code startet (oder in Ihrem Shell-Profil), um Metriken zu aktivieren, wählen Sie das OTLP/HTTP Protokoll aus und richten Sie den Metrik-Exporter mit Ihrem Bearer-Token im Header auf den CloudWatch Metrik-Endpunkt. `Authorization` Geben Sie den vollständigen `/v1/metrics` Pfad an.

```
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="https://monitoring.{{region}}.amazonaws.com/v1/metrics"
export OTEL_EXPORTER_OTLP_METRICS_HEADERS="Authorization=Bearer {{YOUR_API_KEY}}"
```

**Anmerkung**  
Behandeln Sie das Inhaber-Token als Geheimnis. Vermeiden Sie es, es an Quellcodeverwaltungs- oder Shell-Profile zu übergeben, die gemeinsam genutzt oder unsicher gesichert werden. Drehen Sie den Schlüssel regelmäßig, wie unter beschrieben. [Einrichtung der Bearer-Token-Authentifizierung für Metrics](CloudWatch-OTLP-MetricsBearerTokenAuth.md)

## Fügen Sie Identitäts- und Organisationsattribute hinzu
<a name="coding-agents-claude-code-bearer-token-attributes"></a>

Die Coding Agent Insights-Dashboards gruppieren die Nutzung nach Entwickler, Team, Abteilung und anderen organisatorischen Dimensionen. Stellen Sie diese als *oTEL-Ressourcenattribute* über die `OTEL_RESOURCE_ATTRIBUTES` Umgebungsvariable bereit. Legen Sie die Werte anhand der Identität Ihres Entwicklers und der Struktur Ihrer Organisation fest.

```
export OTEL_RESOURCE_ATTRIBUTES="\
user.id={{alias}},\
user.email={{developer@example.com}},\
user.name={{Jane Doe}},\
department={{engineering}},\
team.id={{platform}},\
cost_center={{cc-1234}},\
organization={{example-corp}},\
location={{us-seattle}},\
role={{software-engineer}},\
manager={{manager@example.com}}"
```

**Anmerkung**  
Wenn Sie diese als Ressourcenattribute (und nicht als Attribute pro Datenpunkt) festlegen, entspricht dies der Form, die die Dashboards erwarten, sodass Sie nach, und ähnlichen Bezeichnungen `@resource.team.id` gruppieren können. `@resource.department` Claude Code stempelt automatisch Dimensionen auf Metrikebene wie und auf die Metriken. `model` `type`

## Überprüfen und ansehen
<a name="coding-agents-claude-code-bearer-token-verify"></a>

Führen Sie Claude Code aus, um Metriken zu generieren, und bestätigen Sie dann, ob die Daten erreicht wurden CloudWatch.

**Um Metriken zu verifizieren**

1. Führen Sie eine Claude Code-Sitzung aus, die einige Arbeiten ausführt.

1. Wählen Sie in der CloudWatch Konsole **GenAI Observability**, **Coding Agent Insights** und dann den Tab Claude Code. Metriken werden in der Regel innerhalb weniger Minuten angezeigt.

1. Fragen Sie die Metriken optional direkt mit PromQL ab. Weitere Informationen finden Sie unter [PromQL abfragen](CloudWatch-PromQL-Querying.md).

Die vollständigen, ständig aktualisierten Leitlinien finden Sie in den [Leitlinien für Claude Code with Amazon Bedrock](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock) on GitHub.