Seus 20 Devs Usam Claude Code e Você Não Sabe Quem Gasta Quanto? Um Header Resolve
Vou te contar uma coisa que deveria te tirar o sono: se você tem 10, 20, 50 devs usando Claude Code na sua software house agora, provavelmente não faz a menor ideia de quanto cada um gasta. Nem por sessão. Nem por projeto. Nem por squad.
E não é porque você é negligente. É porque até pouco tempo atrás, era impossível.
O billing da Anthropic te mostra o total. Ponto. Um número. Tipo olhar a conta de energia da empresa inteira e tentar adivinhar qual andar gasta mais. Na minha experiência com 300+ software houses, essa cegueira é a norma — e é exatamente o tipo de problema que engole margem sem você perceber.
A boa notícia? Desde a versão v2.1.86 do Claude Code, existe um header chamado X-Claude-Code-Session-Id que muda o jogo. Parece pouco. É tudo.
O que é o X-Claude-Code-Session-Id
A partir da v2.1.86, toda request que o Claude Code faz para a API da Anthropic agora carrega um header extra:
X-Claude-Code-Session-Id: <uuid-único-da-sessão>Isso significa que qualquer proxy, gateway ou middleware que fique entre o Claude Code e a API consegue agrupar todas as requests de uma mesma sessão — sem precisar abrir e parsear o body de cada request.
Antes desse header, um proxy via requests anônimas. Sabia que alguém estava chamando a API, mas não conseguia conectar essas chamadas a uma sessão específica. Era como ter câmeras de segurança que gravam vultos sem identificar rostos.
Agora cada sessão tem uma identidade. E identidade é o primeiro passo para visibilidade.
A documentação oficial do LLM Gateway descreve o header assim:
“A unique identifier for the current Claude Code session. Proxies can use this to aggregate all API requests from a single session without parsing the request body.”
Por que isso importa mais do que parece
Vamos fazer uma conta rápida.
Dados atuais mostram que o Claude Code custa em média $6 por dev por dia em uso de API, com 90% dos devs ficando abaixo de $12/dia. Parece razoável, certo? Mas faça a multiplicação:
- 20 devs × $6/dia × 22 dias úteis = $2.640/mês
- Com picos de Opus: pode facilmente dobrar para $5.000+/mês
Agora a pergunta de $5.000: qual dev está em $3/dia e qual está em $25/dia? Qual projeto está consumindo 60% do budget? Qual squad está desperdiçando tokens refazendo trabalho?
Sem visibilidade por sessão, essas perguntas não têm resposta.
E o problema é maior do que o Claude Code. Segundo dados de 2026, shadow AI custa em média $412 mil por ano para empresas. Apenas 12% das empresas conseguem detectar todo uso de IA — as outras 88% têm pontos cegos. E 34% do gasto com shadow AI duplica ferramentas já aprovadas.
Na prática, você pode estar pagando duas vezes pela mesma coisa sem saber.
Como funciona na prática
O header sozinho não faz mágica. Ele é a chave que destrava três camadas de observabilidade:
Camada 1: LLM Gateway (Proxy)
Você coloca um proxy entre o Claude Code e a API. Os mais usados:
LiteLLM — proxy open-source em Python, suporta 100+ providers, tracking de custo por virtual key:
export ANTHROPIC_BASE_URL=https://seu-litellm:4000Bifrost — gateway open-source em Go, alta performance, observabilidade nativa:
export ANTHROPIC_BASE_URL=https://seu-bifrost:8080Kong AI Gateway — enterprise, plugin-based, analytics de tokens:
Com qualquer um deles, o X-Claude-Code-Session-Id permite agregar todas as requests de uma sessão sem parsing de body. O proxy sabe: “estas 47 requests vieram da mesma sessão de dev, custaram $3.20, consumiram 285K tokens de input e 42K de output.”
Nota de segurança: as versões 1.82.7 e 1.82.8 do LiteLLM (PyPI) foram comprometidas com malware que roubava credenciais. Se você instalou alguma delas, rotacione todas as credenciais imediatamente. A própria Anthropic alerta sobre isso na documentação oficial.
Camada 2: OpenTelemetry (Métricas e Eventos)
O Claude Code tem integração nativa com OpenTelemetry. Você ativa com uma variável:
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_ENDPOINT=http://seu-collector:4317E recebe 8 métricas em tempo real:
| Métrica | O que mede |
|---|---|
claude_code.cost.usage |
Custo em USD por request |
claude_code.token.usage |
Tokens (input, output, cache read, cache creation) |
claude_code.session.count |
Sessões iniciadas |
claude_code.lines_of_code.count |
Linhas adicionadas/removidas |
claude_code.commit.count |
Commits criados |
claude_code.pull_request.count |
PRs criados |
claude_code.active_time.total |
Tempo ativo (user vs CLI) |
claude_code.code_edit_tool.decision |
Accept/reject de edições |
Mais 5 tipos de eventos detalhados: prompts do usuário, resultados de tools, requests API, erros, e decisões de permissão.
Cada métrica e evento carrega session.id como atributo — o mesmo ID do header. Proxy e OTel falam a mesma língua.
Camada 3: Segmentação por Time
Aqui é onde a mágica acontece para software houses. Com OTEL_RESOURCE_ATTRIBUTES, você etiqueta cada dev:
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=squad-erp,cost_center=projeto-abc"Agora no seu Grafana, Datadog ou Honeycomb, você vê:
- Squad ERP: $1.200/mês, 15 sessões/dia, 80% Sonnet
- Squad Mobile: $800/mês, 8 sessões/dia, 30% Opus (por isso mais caro)
- Dev João (solo): $400/mês — está no Opus full-time, precisa de coaching
E se você for admin, pode forçar essas configs via managed settings — o dev não consegue desligar:
{
"env": {
"CLAUDE_CODE_ENABLE_TELEMETRY": "1",
"OTEL_METRICS_EXPORTER": "otlp",
"OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.empresa.com:4317"
}
}Isso conecta direto com o que escrevi sobre managed-settings.d/ — governança de IA sem micromanagement.
O stack completo em 5 minutos
Se você quer sair do zero para visibilidade total, aqui está o caminho mínimo:
1. Proxy (2 minutos):
# LiteLLM básico
pip install litellm
litellm --model anthropic/claude-sonnet-4-6 --port 4000
# Nos devs:
export ANTHROPIC_BASE_URL=http://seu-litellm:40002. OpenTelemetry (1 minuto):
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_ENDPOINT=http://seu-collector:43173. Segmentação por time (1 minuto):
export OTEL_RESOURCE_ATTRIBUTES="team.id=squad-erp,cost_center=CC-042"4. Dashboard (1 minuto): A Anthropic publicou o Claude Code ROI Measurement Guide com Docker Compose, Prometheus e templates prontos de relatórios. Também existem projetos da comunidade como claude-code-otel e agents-observe para visualização em tempo real.
Os números que deveriam preocupar todo dono de SH
Vou ser direto com os dados que coletei:
- $412 mil/ano: custo médio de shadow AI para empresas (JumpCloud, 2026)
- 12%: empresas que conseguem detectar todo uso de IA. As outras 88% têm pontos cegos
- 34%: do gasto com shadow AI que duplica ferramentas já aprovadas
- 40%: das empresas gastam mais de $250K/ano com LLMs
- $492 milhões: mercado de AI governance em 2026, projetado para $1B em 2030
- 70%: das interações com IA serão via SaaS embeddado até fim de 2026 (Gartner)
O padrão é claro: empresas estão gastando mais com IA a cada mês, com menos visibilidade a cada dia. E software houses que dependem de margem operacional não podem se dar ao luxo de voar cegas.
O que eu penso
Esse header é daquelas features que ninguém vai twittar sobre. Não é sexy. Não tem screenshot bonito. Não faz o dev coding 10x mais rápido.
Mas se você é o CEO de uma software house com 15+ devs usando Claude Code, essa é provavelmente a feature mais importante do ano pra você. Porque é a diferença entre “estamos gastando uns $3.000 por mês com IA, acho” e “o squad ERP gasta $1.200, o squad mobile gasta $800, e o João sozinho gasta $400 porque está no Opus full-time fazendo coisa que Sonnet resolve”.
O primeiro é achismo. O segundo é gestão.
E gestão é o que separa software houses que escalam de software houses que quebram.
Conclusão
O X-Claude-Code-Session-Id é uma linha de código na codebase do Claude Code. Mas é a linha que conecta proxy → sessão → dev → custo. Sem ela, você tem um dashboard de API genérico. Com ela, você tem observabilidade real por sessão.
Combine com OpenTelemetry para métricas detalhadas, um LLM gateway para controle centralizado, e managed settings para forçar a config no time inteiro. O stack está pronto. A documentação existe. Os dados mostram que quem não mede, paga mais.
Se você quer implementar esse nível de visibilidade na sua software house, comece pelo proxy. São 5 minutos que podem revelar milhares de reais de desperdício invisível.
Sou Thulio, mentoro 300+ SHs desde 2016.
