Telemetria do Claude Code
O Claude Code pode enviar as próprias métricas de uso para o Lore via OpenTelemetry, em qualquer plano: Pro, Max, Team e Enterprise. É assim que se vê o uso do Claude Code em planos por assento. As APIs de administração da Anthropic não cobrem o Claude Team.
Para cada pessoa, e opcionalmente cada repositório, o Lore recebe:
- tokens por tipo (entrada, saída, leitura e escrita de cache) e por modelo;
- o custo equivalente na API: quanto esse uso custaria a preço de API. É estimado, nunca faturado, porque num plano por assento você paga por assento;
- sessões, tempo ativo, linhas de código, commits e pull requests.
Só métricas são enviadas. A configuração abaixo nunca habilita os logs do OpenTelemetry, então prompts, respostas e saída de ferramentas nunca chegam ao Lore. O Lore não tem nenhum endpoint que os aceite.
Exige um plano Pro ativo e um Owner da org para configurar.
Crie uma chave de ingestão
No painel do Lore, abra Claude Code Telemetry e clique em Create key. Copie a chave: ela só é exibida uma vez.
Uma chave de ingestão só consegue enviar telemetria para a sua org. Ela não lê nem altera nada no Lore, então é seguro distribuí-la para todas as máquinas dos devs. Revogue quando quiser, na mesma página.
Configure o Claude Code
A mesma página gera a configuração já com o endpoint da sua org e a chave preenchidos. É um bloco env:
{
"env": {
"CLAUDE_CODE_ENABLE_TELEMETRY": "1",
"OTEL_METRICS_EXPORTER": "otlp",
"OTEL_EXPORTER_OTLP_PROTOCOL": "http/json",
"OTEL_EXPORTER_OTLP_ENDPOINT": "https://registry.lore.infraestrutura.app/v1/orgs/<sua-org>/otlp",
"OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer <sua chave de ingestão>",
"OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE": "delta",
"OTEL_METRICS_INCLUDE_REPOSITORY": "true"
}
}- Pessoal: cada dev mescla no próprio
~/.claude/settings.json. Ele pode remover. - Imposto pela org (recomendado): aplique uma vez para todos pelo managed settings do Claude Code, usando o console do claude.ai, o Intune ou outro MDM. O dev não consegue desligar. Veja Implantação na organização.
OTEL_METRICS_INCLUDE_REPOSITORY acrescenta o repositório (owner/nome) a cada métrica, para ver o uso por repositório. Remova se não quiser que os nomes dos repositórios sejam enviados.
Informe quanto você paga por assento
Na mesma página, informe o plano, a quantidade de assentos e o preço por assento por mês. Se o preço não estiver em USD, informe também a taxa de conversão (1 USD = ? na sua moeda). A taxa é sua, e o Lore a mostra ao lado de cada valor convertido.
Implantação na organização
A telemetria só é completa se todos os assentos enviarem. Em vez de pedir a cada dev que edite as próprias configurações, aplique a configuração uma vez pelo managed settings do Claude Code. O managed settings tem precedência sobre tudo o que o dev define, então ele não consegue desligar a telemetria. A aba Claude Code Telemetry → Org rollout do painel gera tudo o que está abaixo, com o seu endpoint e a sua chave preenchidos.
Use uma chave de ingestão dedicada por canal (por exemplo, “Intune” ou “console do claude.ai”), para poder revogar um canal sem afetar os outros. O painel preenche a chave nos arquivos só no seu navegador.
Os canais:
| Canal | Indicado para | Quem faz |
|---|---|---|
| Console do claude.ai | Claude Team/Enterprise, com ou sem MDM | Um Owner do Claude |
| Intune (macOS / Windows) | Dispositivos gerenciados pelo Microsoft Intune | Admin de endpoints |
| Outro MDM ou manual | Jamf, Kandji, Group Policy, Linux | Admin de endpoints |
Console do claude.ai ou MDM?
Os dois entregam o mesmo JSON, e nos dois o dev não consegue sobrescrever. A diferença está no que a configuração acompanha: o console do claude.ai acompanha a conta, e o MDM acompanha o dispositivo.
| Console do claude.ai | MDM (Intune, Jamf…) | |
|---|---|---|
| Vale para | Toda sessão logada com a conta Claude da organização, em qualquer computador (inclusive pessoal) e nas sessões na nuvem | Todo Claude Code rodando nos dispositivos da empresa, com qualquer conta logada |
| Conta Claude pessoal num dispositivo da empresa | Não pega: a configuração só chega para contas da organização | Pega. O e-mail pessoal aparece marcado como não-membro, fora da comparação de assentos |
API key do Console, Bedrock, Vertex, Foundry ou ANTHROPIC_BASE_URL customizado | Não pega | Pega |
| Computador pessoal do dev | Pega, se ele logar com a conta da organização | Não pega |
| O dev consegue burlar? | Recusar o pedido de aprovação fecha o Claude Code, então na prática é obrigatório. Num dispositivo sem gestão, quem souber pode mexer no cache local | Não, sem ser admin do dispositivo: o arquivo é protegido pelo sistema, e o MDM restaura se for apagado |
| Esforço | Colar o JSON uma vez | Um script no MDM e os dispositivos registrados |
| Primeira vez | Um pedido de aprovação para cada dev | Nenhum aviso |
Por onde começar: se todos usam o Claude pelos assentos Team ou Enterprise, só o console do claude.ai já cobre todos os assentos, com o mesmo resultado na visão Seats. Acrescente o MDM quando também quiser:
- o uso de contas pessoais ou de API key nos dispositivos da empresa (shadow AI);
- uma garantia que não dependa de arquivos locais ficarem intactos;
- cobertura de sessões que não passam pelo login da Anthropic (Bedrock, Vertex).
Usar os dois juntos não tem problema. O console tem prioridade, então as configurações do exportador vêm dele, e o MDM cobre o que o console não alcança. Como os valores são iguais, não há conflito. Use uma chave de ingestão diferente por canal, para poder revogar uma sem afetar a outra.
Console do claude.ai (Team e Enterprise)
- No claude.ai, abra Admin Settings → Claude Code → Managed settings. É preciso ter o papel Owner ou Primary Owner no Claude.
- Cole o JSON do painel. Se o editor já tiver configurações, adicione as entradas de
enva elas em vez de substituir tudo. - Salve.
O Claude Code busca essas configurações em toda sessão logada com a conta Claude da organização, em qualquer dispositivo, na inicialização e depois a cada hora. Os devs vão notar duas coisas:
- um pedido de aprovação único, porque as configurações definem um endpoint de telemetria (
OTEL_EXPORTER_OTLP_ENDPOINT); - o exportador começa na próxima abertura do Claude Code, não nas sessões já abertas.
Esse canal não alcança sessões que usam Bedrock, Vertex, Foundry ou um ANTHROPIC_BASE_URL customizado. Para essas máquinas, use um canal de MDM.
Intune: macOS
Baixe o script de instalação no painel. Ele instala /Library/Application Support/ClaudeCode/managed-settings.d/lore-telemetry.json, um drop-in que se mescla a um managed-settings.json existente sem modificá-lo. Ele valida o JSON antes de instalar, porque um arquivo gerenciado malformado impediria o Claude Code de abrir, e pode ser executado várias vezes sem problema.
-
No Intune admin center , vá em Devices → macOS → Scripts → Add.
-
Envie o script de instalação e use estas configurações:
Configuração Valor Run script as signed-in user No (roda como root) Hide script notifications on devices Yes Script frequency Every 1 day, para restaurar o arquivo se alguém removê-lo Max number of times to retry if script fails 3 -
Atribua ao grupo que usa o Claude Code.
Intune: Windows
Baixe o script de instalação (.ps1) no painel. Ele instala C:\Program Files\ClaudeCode\managed-settings.d\lore-telemetry.json com as mesmas garantias. Ele também grava em UTF-8 sem BOM, porque o BOM padrão do Windows PowerShell deixaria o arquivo ilegível para o Claude Code.
-
No Intune admin center , vá em Devices → Windows → Scripts and remediations → Platform scripts → Add.
-
Envie o script de instalação e use estas configurações:
Configuração Valor Run this script using the logged on credentials No (roda como SYSTEM) Enforce script signature check No, a menos que a org assine scripts Run script in 64 bit PowerShell Host Yes -
Atribua ao grupo que usa o Claude Code.
Platform scripts rodam uma vez por dispositivo. Para o Intune restaurar o arquivo caso ele seja apagado, use o mesmo script como script de correção de uma Remediation.
Outro MDM ou manual
Coloque o JSON do painel (só o env) como managed-settings.d/lore-telemetry.json no diretório de sistema do Claude Code. O arquivo precisa ser legível por todos os usuários e gravável só por administradores:
| SO | Diretório |
|---|---|
| macOS | /Library/Application Support/ClaudeCode/managed-settings.d/ |
| Windows | C:\Program Files\ClaudeCode\managed-settings.d\ |
| Linux / WSL | /etc/claude-code/managed-settings.d/ |
Os scripts do painel também funcionam com Jamf, Kandji e ferramentas parecidas. A Anthropic publica templates de MDM para perfis e Group Policy.
Como as fontes gerenciadas se combinam
O Claude Code lê o managed settings destas fontes, nesta ordem:
- o console do claude.ai;
- um perfil de MDM (
com.anthropic.claudecode) ou uma política de registro (HKLM\SOFTWARE\Policies\ClaudeCode); - os arquivos managed-settings e seus drop-ins.
Normalmente vence a primeira fonte que tiver configurações. O bloco env, porém, é mesclado por variável entre essas fontes (Claude Code 2.1.223 ou posterior), então o drop-in do Lore continua valendo quando a org já tem uma política em outro lugar.
A exceção: as variáveis do exportador OpenTelemetry (OTEL_EXPORTER_OTLP_*) valem em bloco, vindas da fonte mais alta que define qualquer uma delas. Se a sua org já envia a telemetria do Claude Code para outro coletor por uma fonte mais alta, as configurações de exportador do Lore são ignoradas. Nesse caso, coloque os valores do Lore nessa fonte mais alta. Detalhes: managed settings do Claude Code .
Verificar e reverter
- Verificar: numa máquina, abra uma sessão nova do Claude Code e rode
/status, cuja linha de fontes de configuração mostra a fonte gerenciada, ouclaude doctor, cuja linha “Managed settings (remote)” vale para o console do claude.ai. Depois de um minuto de uso, a pessoa aparece em Who is sending telemetry no painel. - Reverter: remova as entradas de
envno console do claude.ai, ou desatribua o script de instalação e aplique o script de remoção do painel, que apaga só olore-telemetry.json. Revogar a chave interrompe a ingestão na hora, qualquer que seja o canal.
Como ler a visão Seats
Em AI Usage → Seats, o Lore compara, para cada pessoa, o uso equivalente na API com o custo do assento no mesmo período:
- Uso ÷ assento acima de 1×: o assento vale mais do que custa. Essa pessoa pagaria mais na API.
- Bem abaixo de 1×: o assento está subutilizado.
- Os assentos que não enviaram telemetria aparecem contados à parte.
Dois tipos de uso ficam fora da comparação:
- Claude Code rodando com uma API key do Console é cobrado pela API, não pelo assento. Se a org também tem o conector Anthropic Admin, o Lore usa o Claude Code Analytics dele para separar essas sessões.
- E-mails que não são de membros da org. A chave de ingestão prova a org, não a pessoa: o e-mail é o que o Claude Code informa.
Atualização dos dados
O Claude Code envia métricas mais ou menos a cada minuto. O Lore consolida no uso diário na sincronização de hora em hora, então os valores aparecem em AI Usage em até cerca de uma hora.
Solução de problemas
Rode claude --debug e procure as linhas marcadas com [3P telemetry].
| Sintoma | Causa | Correção |
|---|---|---|
401 | Chave ausente, errada ou revogada | Confira o OTEL_EXPORTER_OTLP_HEADERS e se a chave está ativa |
415 | O protocolo não é http/json | Defina OTEL_EXPORTER_OTLP_PROTOCOL=http/json (gRPC e protobuf ainda não são suportados) |
402 | O plano da org não é Pro | Faça o upgrade da org |
| O painel avisa sobre pontos rejeitados | Temporalidade cumulativa | Defina OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE=delta |
| Ninguém em “Who is sending telemetry” | Configuração não carregada | Reinicie o Claude Code depois de mudar a configuração e use por um minuto |
Cobertura
Só o Claude Code envia telemetria. O uso do chat do claude.ai e do Claude Desktop nos planos Team continua invisível: a Anthropic não oferece API para isso.
Cowork
O uso do Claude Cowork é recebido do mesmo jeito, configurado uma única vez no claude.ai com o mesmo tipo de chave de ingestão: veja Telemetria do Cowork.