# Configurar métricas do OpenTelemetry do Claude Code para Amazon CloudWatch
<a name="coding-agents-claude-code"></a>

O Claude Code emite métricas do OpenTelemetry (OTel) sobre uso de tokens, sessões, edições de código, chamadas de ferramentas e custo. Quando você envia essas métricas para o Amazon CloudWatch, elas preenchem a aba Claude Code dos painéis do Coding Agent Insights. Para saber mais sobre o painel, consulte [Coding Agent Insights](coding-agents-insights.md).

O Claude Code configura seu exportador OTel por meio de variáveis de ambiente. Dois caminhos de configuração estão disponíveis, a depender de como seus desenvolvedores executam o Claude Code.

## Escolha um caminho de configuração
<a name="coding-agents-claude-code-paths"></a>
+ **Token de portador** — O Claude Code envia métricas de OTLP diretamente para o endpoint OTLP nativo do CloudWatch, autenticando com um cabeçalho `Authorization: Bearer`. Os atributos de identidade e organizacionais são fornecidos através da variável de ambiente `OTEL_RESOURCE_ATTRIBUTES`. Esse caminho não precisa de coletor e é a maneira mais rápida para um desenvolvedor individual ou uma pequena equipe começar. Consulte [Token do portador](coding-agents-claude-code-bearer-token.md).
+ **Implementação corporativa com o gateway de aplicativos Claude** — Para organizações que precisam de controle centralizado sobre o acesso do desenvolvedor, a federação de identidades e a coleta de telemetria. Implante um gateway auto-hospedado que fique entre os clientes Claude Code de seus desenvolvedores e seu provedor de modelos. Os desenvolvedores fazem login com seu IdP corporativo em vez de manter chaves de API ou credenciais de nuvem. O gateway mantém a credencial upstream, impõe o acesso ao modelo e as configurações gerenciadas pelo grupo de IdP e retransmite a telemetria de uso para sua pilha de observabilidade. Suporta Amazon Bedrock, Claude Platform on AWS, Google Cloud e Microsoft Foundry como upstreams. Consulte [Configure o Claude Code com o gateway de aplicativos Claude](coding-agents-claude-code-gateway.md).

**nota**  
O caminho do token portador configura somente como o Claude Code envia a *telemetria* para o CloudWatch; ele é independente de como o Claude Code chama um modelo para *inferência*, portanto, é possível utilizá-lo com qualquer provedor de modelo. A implementação corporativa com o gateway de aplicativos Claude combina configuração de telemetria com acesso centralizado à inferência e oferece suporte a vários backends, incluindo Amazon Bedrock, Claude Platform on AWS, Google Cloud e Microsoft Foundry.

Para obter a orientação completa e continuamente atualizada, incluindo modelos de implantação e scripts de configuração, veja a [Orientação para Claude Code com o Amazon Bedrock](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock) no GitHub.

**Topics**
+ [Escolha um caminho de configuração](#coding-agents-claude-code-paths)
+ [Configurar métricas do Claude Code no Amazon CloudWatch com um token de portador](coding-agents-claude-code-bearer-token.md)
+ [Configure o Claude Code com o gateway de aplicativos Claude](coding-agents-claude-code-gateway.md)