Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Configurazione Codice Claude metriche in Amazon CloudWatch con un token al portatore
<a name="coding-agents-claude-code-bearer-token"></a>

In questo percorso, Claude Code invia le metriche OpenTelemetry (OTel) direttamente all'endpoint delle metriche OTLP CloudWatch native di Amazon e si autentica con un token al portatore (una chiave API di metrica). CloudWatch Non è richiesto alcun raccoglitore. OpenTelemetry Questo è il modo più veloce per un singolo sviluppatore o un piccolo team di inserire le metriche di Claude Code nelle dashboard di Coding Agent Insights.

**Importante**  
I token al portatore sono credenziali a lungo termine. Li consigliamo solo laddove AWS le credenziali a breve termine non sono possibili, come i laptop per sviluppatori esterni. AWS Per i compromessi in termini di sicurezza e le indicazioni sulla rotazione dei tasti, consulta. [Impostazione dell'autenticazione del token al portatore per Metrics](CloudWatch-OTLP-MetricsBearerTokenAuth.md) Le organizzazioni che uniscono le identità tramite l'SSO aziendale dovrebbero invece utilizzare l'implementazione aziendale con Claude Apps Gateway. Per informazioni, consulta [Configura Claude Code con il gateway delle app Claude](coding-agents-claude-code-gateway.md).

## Prerequisiti
<a name="coding-agents-claude-code-bearer-token-prereqs"></a>
+ Claude Code installato sul computer dello sviluppatore.
+ Un modo efficace per Claude Code di chiamare un modello per l'inferenza. Questa configurazione di telemetria è indipendente dall'inferenza, quindi puoi utilizzare un account Anthropic (il provider predefinito di Claude Code) o Amazon Bedrock. Per utilizzare Amazon Bedrock per l'inferenza, consulta [ Claude Code su Amazon Bedrock nella documentazione di Claude Code. ](https://code.claude.com/docs/en/amazon-bedrock)
+ Una chiave API CloudWatch metrica (token al portatore), creata da un utente IAM che dispone delle autorizzazioni relative alle metriche. CloudWatch Per la procedura che crea l'utente IAM e genera la chiave, consulta. [Impostazione dell'autenticazione del token al portatore per Metrics](CloudWatch-OTLP-MetricsBearerTokenAuth.md)

## Configura l'esportatore delle metriche
<a name="coding-agents-claude-code-bearer-token-configure"></a>

Claude Code si configura tramite variabili OpenTelemetry di ambiente. Imposta le seguenti variabili nella shell che avvia Claude Code (o nel tuo profilo shell) per abilitare le metriche, seleziona il OTLP/HTTP protocollo e indirizza l'esportatore delle metriche all'endpoint delle metriche con il token al portatore nell' CloudWatchintestazione. `Authorization` Includi il percorso completo. `/v1/metrics`

```
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}}"
```

**Nota**  
Considera il gettone al portatore un segreto. Evita di affidarlo al controllo del codice sorgente o ai profili di shell condivisi o sottoposti a backup in modo non sicuro. Ruota periodicamente la chiave come descritto in. [Impostazione dell'autenticazione del token al portatore per Metrics](CloudWatch-OTLP-MetricsBearerTokenAuth.md)

## Aggiungi attributi identificativi e organizzativi
<a name="coding-agents-claude-code-bearer-token-attributes"></a>

Le dashboard di Coding Agent Insights raggruppano l'utilizzo per sviluppatore, team, reparto e altre dimensioni organizzative. Forniscili come * attributi * delle risorse OtEL tramite la variabile di `OTEL_RESOURCE_ATTRIBUTES` ambiente. Imposta i valori in base all'identità dello sviluppatore e alla struttura della tua organizzazione.

```
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}}"
```

**Nota**  
L'impostazione di questi attributi come attributi di risorsa (anziché attributi per punto di dati) corrisponde alla forma prevista dalle `@resource.team.id` dashboard, quindi puoi raggrupparli per ed etichette simili. `@resource.department` Claude Code stampa automaticamente le dimensioni a livello di metrica come e sulle metriche. `model` `type`

## Verifica e visualizza
<a name="coding-agents-claude-code-bearer-token-verify"></a>

Esegui Claude Code per generare metriche, quindi conferma i dati raggiunti. CloudWatch

**Per verificare le metriche**

1. Esegui una sessione di Claude Code che esegua alcune operazioni.

1. Nella CloudWatch console, scegli ** GenAI Observability**, ** Coding Agent Insights e quindi la scheda ** Claude Code. Le metriche vengono visualizzate in genere entro pochi minuti.

1. Facoltativamente, interroga le metriche direttamente con ProMQL. Per ulteriori informazioni, consulta [Interrogazione ProMQL](CloudWatch-PromQL-Querying.md).

Per una guida completa e continuamente aggiornata, consulta la [ Guida per Claude Code con Amazon Bedrock on. ](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock) GitHub