Claude Code 2.1.299

Resumo

O Claude Code 2.1.299 corrige falhas na aplicação das permissões da sandbox e no isolamento das chaves utilizadas com gateways de terceiros. As conexões MCP recebem verificações de política anteriores ao início da comunicação. A publicação também altera contratos de plugins e a correspondência dos nomes dos servidores nas permissões, o que exige conferir integrações existentes.

As sessões longas recebem compactação durante a inatividade e correções para retomadas após reinício. No Remote Control, a manutenção abrange o recebimento de arquivos e mensagens. Os agendamentos também são corrigidos para a hora repetida no encerramento do horário de verão.

Novidades

• Claude Code 2.1.299 — Compactação em repouso: conversas de pelo menos 200 mil tokens no terminal são compactadas após cerca de 54 minutos de inatividade, dentro da validade de uma hora do cache do prompt. Você pode alterar esse mínimo com CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS ou desativar o recurso com idleCompaction: false nas configurações. As notas informam compatibilidade dessas opções a partir de 2.1.290.
• Claude Code 2.1.299 — Menções a arquivos: CLAUDE_CODE_DISABLE_FILE_MENTIONS envia ao modelo os caminhos mencionados com @, em vez de incluir diretamente o conteúdo. A leitura utiliza as ferramentas de arquivo.
• Claude Code 2.1.299 — Runner autogerenciado: --shutdown-drain-sec define o tempo concedido à consulta em andamento e aos hooks de criação de sessões após SIGTERM no orquestrador.
• Claude Code 2.1.299 — Avaliação de plugins: claude plugin eval recebe --disallow-tools e o campo disallowed_tools para excluir ferramentas específicas dos testes.

Melhorias

• Claude Code 2.1.299 — Documentos na conversa: os bytes dos PDFs mencionados com @ não permanecem no histórico da sessão, reduzindo a ocupação de memória e disco associada a esses anexos.
• Claude Code 2.1.299 — Artefatos publicados: uma sessão local pode acompanhar até 25 artefatos simultaneamente, em vez dos dez anteriores.
• Claude Code 2.1.299 — Gateway personalizado: uma resposta em streaming por ANTHROPIC_BASE_URL pode aguardar até 300 segundos sem receber conteúdo, em vez de 180 segundos. O prazo também vale quando as flags de funcionalidade não foram carregadas.

Correções

• Claude Code 2.1.299 — Chaves de gateways: as consultas auxiliares à Anthropic deixam de carregar a chave configurada para um gateway de terceiros. A correção abrange também a consulta das configurações gerenciadas quando ANTHROPIC_BASE_URL vem do arquivo de administração.
• Claude Code 2.1.299 — Caminhos da sandbox: as permissões no macOS consideram o destino real dos links simbólicos. Os padrões de leitura e escrita são reavaliados quando o diretório inicial é substituído por um link. Os comandos isolados também não podem gravar no diretório indicado por --plugin-dir.
• Claude Code 2.1.299 — Políticas MCP: servidores recusados pela política não são iniciados ou contatados pelas sessões e comandos afetados. A autenticação OAuth encaminha headers e headersHelper configurados, inclusive na renovação do token e na saída.
• Claude Code 2.1.299 — Planejamento e hooks: o modo de planejamento recusa escritas que um hook tenha autorizado indevidamente. No Windows sem Git for Windows, a falha de um hook de permissão sem shell definido resulta na recusa da chamada.
• Claude Code 2.1.299 — Retomada das sessões: a versão corrige chamadas aprovadas que podiam executar duas vezes após reinício e reconexões MCP que interrompiam ou duplicavam chamadas nas sessões sem interação.
• Claude Code 2.1.299 — Horário dos agendamentos: os disparos respeitam o próximo horário calculado e deixam de se repetir a cada turno ou ocorrer antecipadamente durante a hora repetida no fim do horário de verão.
• Claude Code 2.1.299 — Arquivos remotos: anexos entre 30 e 35 MiB voltam a chegar às sessões remotas. O download interrompido de um anexo recebe nova tentativa. O Remote Control conserva o texto no compositor quando o computador está inacessível.
• Claude Code 2.1.299 — Resultado das avaliações: uma execução de claude plugin eval encerrada por erro da API recebe nota zero e faz a suíte retornar código 1, em vez de ser considerada bem-sucedida.

Breaking changes

• Claude Code 2.1.299 — Nomes dos servidores MCP: a permissão mcp__a alcança somente o servidor indicado, sem incluir a__b ou a_. Revise as permissões e as listas tools: dos agentes que dependiam dessa correspondência. Para um nome normalizado com __, utilize mcp__<server>__* com o nome completo.
• Claude Code 2.1.299 — Redirecionamentos dos proxies: as requisições aos proxies MCP das sessões e aos servidores MCP hospedados pela Anthropic deixam de seguir redirecionamentos HTTP. Configure o endereço final nas integrações afetadas. Os redirecionamentos feitos pelo próprio servidor de um conector não estão incluídos na alteração do proxy de conectores.
• Claude Code 2.1.299 — Testes de mods: as raízes Box e Text de ui.render incluem part: { plugin }. Atualize as asserções que comparam a árvore exata. Uma chamada a método $ sem resposta em dez segundos também falha no teste.
• Claude Code 2.1.299 — Carregamento de skills: arquivos ou diretórios com caracteres invisíveis, de direção, semelhantes a espaços, < ou > deixam de disponibilizar a skill ou o comando. Renomeie os itens afetados. O campo name: com esses caracteres é ignorado.
• Claude Code 2.1.299 — Limites dos hooks: os valores retornados com profundidade superior a 28 mil níveis são recusados. Os scripts de workflow aceitavam até 100 mil. A falha de comunicação com um hook que pode recusar uma ação também resulta em recusa, exigindo corrigir o hook para retomar a chamada.
• Claude Code 2.1.299 — Codificação dos arquivos: a ferramenta Write recusa a conversão silenciosa de Windows-1252, Shift-JIS, GBK ou UTF-16BE para UTF-8. Os processos que dependiam dessa conversão precisam realizar uma etapa explícita de preparação do arquivo.

Ponto de Atenção

As conexões MCP das sessões na nuvem e do Remote Control negociam o protocolo 2026-07-28 por padrão nas instalações que não consultam flags. A opção MCP_PROTOCOL_NEGOTIATION=legacy permite manter o comportamento anterior.

Os hooks UserPromptSubmit executam antes da expansão da skill ou do comando. O hook declarado no frontmatter da própria skill começa no prompt seguinte ao que a invoca, por isso confira essa diferença nas extensões que dependem da ordem de execução.

Teste sugerido: num ambiente de homologação, confira uma permissão MCP com o nome completo do servidor e uma conexão por proxy. Execute os testes dos mods com comparação exata de ui.render e reproduza uma escrita em arquivo com codificação diferente de UTF-8. Para as rotinas agendadas, compare o próximo disparo exibido com o fuso configurado.

Notas da versão

O release oficial do Claude Code 2.1.299 foi publicado em 14/10/2026 às 02h49 UTC como versão estável, correspondente a 13/10 às 22h49 em Nova York. A data editorial acompanha o registro UTC do GitHub.