Claude Code v2.1.317 adiciona API de análise de custos, atributos de usuário OTel e hooks de bloqueio em caso de falha

O Claude Code v2.1.317 é uma versão de manutenção com algumas adições voltadas para equipes que executam o aplicativo por meio de um gateway, monitoram via OpenTelemetry ou desenvolvem sobre o Agent SDK.

Relatórios de custos do gateway

A API de administração do gateway dos aplicativos Claude agora expõe GET /v1/organizations/analytics/cost. Ela retorna os gastos passados em um intervalo de datas, detalhados no total, por desenvolvedor, por dia ou por grupo de IdP. Para dar suporte ao agrupamento por IdP, os gateways com admin: definido agora mantêm um registro diário dos grupos de IdP de cada desenvolvedor, retido por admin.identity_retention_days.

Atributos do OpenTelemetry

Quatro novos atributos são anexados às métricas, eventos e spans do OTel:

• anthropic.plan
• anthropic.seat_type
• anthropic.provider
• anthropic.custom_base_url

Se você já coleta a telemetria do Claude Code em um painel, esses atributos permitem dividir os rastreamentos por nível de assinatura ou pelo provedor/URL base por onde a solicitação passou.

Comportamento dos hooks do Agent SDK

Os callbacks de hook agora aceitam onFailure: "block". Anteriormente, um callback com falha permitia que a ação prosseguisse; com esta configuração, a falha bloqueia a ação.

Proteções de privacidade e agendamento

Dois novos avisos reduzem a exposição inesperada de dados:

• Uma verificação pergunta antes que uma chamada de ferramenta da web ou shell envie o endereço de e-mail da sua conta pela rede.
• /schedule avisa quando uma nova tarefa agendada na nuvem usa conectores que você não solicitou e informa como removê-los.

Também novo: avisos na aba Code do Claude Desktop quando as configurações gerenciadas remotamente da sua organização ainda não foram carregadas e quando foram. O modo automático agora exibe um aviso quando sua verificação não tem resposta para a chamada de ferramenta de um subagente, em vez de deixar a visualização principal vazia.

Válvula de escape para runner auto-hospedado

Defina CLAUDE_CODE_DISABLE_NESTED_SESSION_ID=1 em um runner auto-hospedado para fazer com que claude -p dentro de uma sessão use o ID e a transcrição dessa sessão, restaurando o comportamento anterior à mudança.

Correções notáveis

• Servidores MCP de projeto e locais desconectando após o primeiro turno em algumas sessões de desktop.
• Modo automático falhando a cada turno quando uma URL base de gateway LLM retorna 403/422 para a verificação de segurança do lado do servidor (403 com apiKeyHelper permanece inalterado).
• claude auth status saindo antes de uma atualização lenta de token ser salva, o que poderia desconectar você na próxima execução.
• claude --from-pr relatando "Nenhuma conversa encontrada" para sessões vinculadas mais antigas em projetos com muitas sessões.
• claude -p saindo com código 0 quando um disco cheio ou cota perdia a transcrição ou gravações em ~/.claude.json; agora ele imprime um erro e sai com código 1 na saída de texto e json. Exportações NFS completas podem não ser detectadas.
• Edições em arquivos de configurações feitas no primeiro segundo após a inicialização não entrando em vigor até outra alteração de configurações.
• Transcrições antigas não sendo limpas quando as execuções pulam a limpeza, por exemplo, com --setting-sources.
• O gateway dos aplicativos Claude ocultando o erro "Input is too long." do Bedrock, o que deixava as sessões falhando a cada turno com "upstream rejected the request" em vez de compactar.

Há mais uma dúzia de correções para equipes de agentes, /team-onboarding, despertadores de /loop, títulos de sessões na nuvem, habilidades sincronizadas do claude.ai e verbosidade de leitores de tela — a lista completa está nas notas de versão.