Resumo
O Claude Code 2.1.317 corrige a preservação de conversas em runners e muda o comportamento de sessões claude -p abertas dentro de outra sessão. A versão também reporta falhas de gravação por disco cheio com código de saída 1 nos formatos text e JSON. Para automações, essa diferença permite distinguir a execução concluída de uma conversa cujo histórico não foi salvo.
Novidades
- Claude Code 2.1.317 — Hooks: callbacks do Agent SDK aceitam
onFailure: "block"para recusar a ação quando o callback falha. - Claude Code 2.1.317 — Privacidade: chamadas de ferramenta web ou shell que enviam o email do cadastro para a rede passam por confirmação. O comando
/scheduleavisa quando uma nova tarefa recebe conectores não solicitados e explica como removê-los. - Claude Code 2.1.317 — Custos: a interface administrativa do gateway acrescenta
GET /v1/organizations/analytics/cost, com consulta por período e agrupamento por desenvolvedor, dia ou grupo do provedor de identidade.
Melhorias
- Claude Code 2.1.317 — Runners: falhas de servidor 5xx, exceto 501 e 529, levam à abertura de novas conexões. Sessões também renovam as conexões quando a verificação periódica deixa de receber resposta.
- Claude Code 2.1.317 — Mensagens entre agentes: uma mensagem para um agente ativo chega mais cedo ao colocar seu comando em segundo plano, preservando a execução.
- Claude Code 2.1.317 — Esforço do modelo: subagentes que usam outro modelo utilizam o esforço salvo para esse modelo ou seu padrão, em vez de herdar o esforço da conversa principal.
Correções
- Claude Code 2.1.317 — Histórico: reiniciar um runner durante a aprovação de um plano preserva as mensagens recentes. Conversas longas também conservam o resumo anterior quando a compactação precisa reduzir sua própria requisição.
- Claude Code 2.1.317 — MCP: servidores locais e de projeto deixam de desconectar após o primeiro turno em determinadas sessões do desktop. A identificação de conectores considera os servidores repetidos em plugins sincronizados, evitando avisos incorretos de desconexão.
- Claude Code 2.1.317 — Autenticação:
claude auth statusaguarda a gravação de uma renovação lenta do token. A versão também corrige falhas de certificados após renovação da autoridade raiz em alguns proxies de inspeção TLS (Transport Layer Security). - Claude Code 2.1.317 — Telemetria: exportações OpenTelemetry sem resposta expiram em dez segundos, com ajuste por
OTEL_EXPORTER_OTLP_TIMEOUTaté trinta segundos. A correção também evita tentativas excessivas após uma recusa HTTP 403 do proxy. - Claude Code 2.1.317 — VS Code e Windows: conversas derivadas preservam chamadas paralelas e mensagens mantidas na compactação. No Windows, a conferência da pasta de trabalho utiliza sua identidade quando a consulta nativa de caminho falha.
Breaking changes
- Claude Code 2.1.317 — Código de saída: falhas de escrita por disco cheio ou quota retornam 1 em
claude -pcom saída text ou JSON, em vez de 0. Automações que interpretavam esse resultado como sucesso precisam tratar o erro. As notas ressalvam que volumes NFS (Network File System) cheios podem escapar dessa detecção. - Claude Code 2.1.317 — Sessões aninhadas:
claude -pdeixa de compartilhar o identificador e o transcript da sessão externa em runners. Integrações que dependem desse compartilhamento precisam se adaptar. Em runner próprio,CLAUDE_CODE_DISABLE_NESTED_SESSION_ID=1restaura o comportamento anterior.
Ponto de Atenção
Teste sugerido: execute uma chamada claude -p num ambiente de teste com quota limitada e confira o código de saída e a mensagem de erro. Abra uma sessão aninhada num runner de homologação e verifique a separação dos históricos. Para hooks críticos, provoque uma falha controlada do callback com onFailure: "block" e confira a recusa da ação.
Notas da versão
O Claude Code 2.1.317 foi publicado em 03/11/2026, às 01h25 UTC, como versão estável. O agrupamento diário utiliza a data UTC da publicação, embora a cron seja agendada no fuso de Nova York.