Claude Code 2.1.295

Resumo

O Claude Code 2.1.295 acrescenta uma política para recusar ações quando um hook de comando ou HTTP falha. A atualização também corrige a reconexão dos servidores MCP e a preservação das respostas de sessões sem interface interativa. Você precisa revisar as mensagens grandes enviadas por WebSocket e o encerramento de sessões pelo serviço de agentes, pois esses comportamentos recebem restrições explícitas nesta publicação.

Novidades

• Claude Code 2.1.295 — Falhas dos hooks: onFailure: "block" permite recusar a ação quando um hook de comando ou HTTP não inicia, excede seu tempo ou termina com um código inesperado.
• Claude Code 2.1.295 — Encaminhamento de modelos: cada provedor do Claude apps gateway aceita uma lista opcional models, com um * como curinga por entrada. A seleção também vale para o encaminhamento após uma falha. timeouts.upstream_ttfb_ms limita a espera pelo início da resposta nos provedores de nuvem, com encaminhamento alternativo ou erro 502 após o prazo.
• Claude Code 2.1.295 — Login pelo gateway: forceLoginMethod: "gateway" e forceLoginGatewayUrl podem ser definidos nas configurações pessoais de máquinas sem configurações gerenciadas. O comando /login abre o gateway selecionado.
• Claude Code 2.1.295 — Estado do terminal: o Program Status Protocol, identificado por OSC 7501, informa trabalho em andamento, espera por sua ação ou conclusão em terminais compatíveis. Sessões claude -p que permanecem abertas após o último turno informam o motivo da espera no stderr quando essa saída é um terminal.
• Claude Code 2.1.295 — Mods e novas tentativas: $.ui.notify envia uma notificação nativa conforme sua preferência e identifica o canal. CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS limita a espera do modo de novas tentativas sem supervisão diante dos erros 429 e 529.

Melhorias

• Claude Code 2.1.295 — Tokens no Bedrock: o gateway utiliza a API (interface de programação de aplicações) CountTokens da AWS para calcular os tokens utilizados por /context e pelas leituras de arquivos grandes. A integração exige a permissão bedrock:CountTokens.
• Claude Code 2.1.295 — Rastreamento das respostas: eventos inference incluem upstream_request_id. Respostas bem-sucedidas incluem o cabeçalho request-id, permitindo relacionar a telemetria do Claude Code ao log de auditoria do gateway.
• Claude Code 2.1.295 — Descoberta de ferramentas: descrições de ferramentas MCP carregadas pela busca aceitam até 16.384 caracteres, substituindo o limite anterior de 2.048. Subagentes carregam inicialmente até 32 skills do campo skills e podem utilizar as demais pelo Skill tool quando ele estiver disponível.
• Claude Code 2.1.295 — Plugins: comandos que alteram a configuração avisam quando escrevem num arquivo que não será carregado. claude plugin validate sugere uma linha de instalação ausente no README sem alterar o código de saída, inclusive com --strict.

Correções

• Claude Code 2.1.295 — Reconexão MCP: sessões sem interface interativa e sessões do SDK (kit de desenvolvimento de software) retomam servidores remotos após interrupções superiores a 15 segundos. Desconexões sucessivas aumentam o intervalo das novas tentativas até 30 segundos. Respostas que mencionam um erro de rede deixam de encerrar indevidamente a conexão e cursores de paginação repetidos deixam de provocar consultas reiteradas à mesma página.
• Claude Code 2.1.295 — Permissões das ferramentas: --tools e --restricted alcançam as ferramentas incorporadas registradas após a inicialização. Nomes depreciados deixam de permitir acesso a ferramentas fora do conjunto autorizado. Hooks dos mods recebem uma correção para entradas aninhadas que eram truncadas silenciosamente e para chamadas durante a recarga que contornavam a verificação de outro mod.
• Claude Code 2.1.295 — Sessões em segundo plano: cancelar a transferência pelo prompt conserva o trabalho em primeiro plano. Edições e comandos que aguardam um subagente deixam de iniciar prematuramente. A retomada preserva mensagens após /rewind e corrige tarefas agendadas perdidas ou restauradas indevidamente.
• Claude Code 2.1.295 — Saída e arquivos: claude -p imprime a resposta de cada turno concluído quando o trabalho em segundo plano inicia outro turno. Arquivos CSS, JavaScript e XML retornados por ferramentas MCP recebem extensões utilizáveis pelo Read.
• Claude Code 2.1.295 — Plugins e configurações gerenciadas: a correção do cache adulterado evita promover um plugin pessoal a plugin da organização. A aba de erros exige confirmação para remover um marketplace e seus plugins pela tecla Enter. No Windows, o carregamento e os registros de instalação reconhecem variações da letra da unidade.
• Claude Code 2.1.295 — Terminal e editor: saídas muito extensas, citações profundamente aninhadas e realce de linhas longas recebem correções para travamentos do terminal. O cursor preserva a posição após colar texto acentuado do macOS. No VS Code, o foco deixa de alternar indevidamente entre duas conversas visíveis.
• Claude Code 2.1.295 — Modelos e revisão: modelos [1m] repetem a solicitação sem a opção experimental da janela de contexto de um milhão de tokens quando o provedor a recusa. Avaliações de hooks agent e buscas web recebem correções de demora nos esforços xhigh e max. A revisão de código informa achados anteriores ainda abertos e considera as instruções de um CLAUDE.md grande alterado pela revisão.

Breaking changes

• Claude Code 2.1.295 — Mensagens MCP por WebSocket: mensagens superiores a 16 MiB são recusadas e encerram a conexão, alinhando esse transporte aos demais. Integrações que enviavam mensagens maiores precisam reduzir seu tamanho ou dividir o conteúdo.
• Claude Code 2.1.295 — Serviço de agentes interrompido: no macOS ou no Linux sem o serviço instalado, encerrar claude agents junto com seu serviço de segundo plano encerra as sessões ativas em cerca de um minuto, salvo se o comando for executado novamente. Ajuste rotinas que utilizavam esse encerramento para conservar sessões ativas.

Ponto de Atenção

A versão é estável. onFailure: "block" é uma opção explícita e sua inclusão nas notas não comprova a recusa de ações por hooks que continuam com a configuração anterior. No gateway com Bedrock, confira a permissão bedrock:CountTokens. Conectores do claude.ai utilizam por padrão o protocolo MCP 2026-07-28 nas instalações sem consulta de flags, com MCP_PROTOCOL_NEGOTIATION=legacy para utilizar o comportamento anterior.

Teste sugerido: num projeto descartável, configure um hook de comando com onFailure: "block" e provoque uma falha inofensiva de inicialização para conferir a recusa da ação. Interrompa temporariamente um servidor MCP de teste por mais de 15 segundos e observe a reconexão. Numa sessão claude -p com trabalho em segundo plano, confirme que a saída conserva a resposta de cada turno concluído.

Notas da versão

O release oficial do Claude Code 2.1.295 está marcado como estável e foi publicado em 08/10/2026 às 19h48 UTC, correspondente a 15h48 em Nova York. A opção de falha dos hooks complementa as correções de interpretação publicadas na 2.1.294 no mesmo dia.