Claude Code v2.1.299 adiciona compactação em ociosidade, controle de menção de arquivos e desativação de ferramentas

O Claude Code v2.1.299 foi lançado, e a mudança de destaque é a compactação ociosa: uma conversa parada em 200K+ tokens que ficou ociosa por cerca de 54 minutos é compactada automaticamente, bem antes de o cache de prompts de uma hora expirar. A ideia é que sua próxima mensagem não reprocesse toda a janela de contexto do zero.

Controles da compactação ociosa

• CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS altera o limite mínimo de 200K tokens.
• "idleCompaction": false em settings.json desativa o recurso por completo.
• As duas opções exigem a v2.1.290 ou superior.

Menções a arquivos e controle de ferramentas

CLAUDE_CODE_DISABLE_FILE_MENTIONS muda como as menções a arquivos com @ funcionam — em vez de injetar o conteúdo do arquivo, o Claude recebe apenas os caminhos e os lê usando suas próprias ferramentas de arquivo. Útil quando você não quer o corpo dos arquivos despejado no contexto.

Para fluxos de avaliação, claude plugin eval agora aceita --disallow-tools mais um campo de caso disallowed_tools, permitindo manter ferramentas nativas como Agent fora das execuções de avaliação.

Runner auto-hospedado e hooks

claude self-hosted-runner orchestrator ganha --shutdown-drain-sec: ao receber SIGTERM, ele para de fazer polling e dá até N segundos para o poll em andamento e os hooks de spawn em execução terminarem.

Os hooks de mod ganharam novos recursos:

• $.prompt.media permite que um hook prompt.submit leia os bytes de uma imagem ou documento anexado.
• $.session.identity() expõe como a sessão está autenticada, além de organização e e-mail quando forceLoginOrgUUID lista essa organização.
• skill.prompt agora recebe o frontmatter da skill, a origem, o nome do plugin e o caminho do arquivo.
• session.append ganha uma porta queue para que um mod possa divergir os registros da fila de transcrição do prompt conforme enviado.
• O Text de mod ganha size, weight, mono e tabular; bold foi descontinuado em favor de weight. O Box ganha passos de espaçamento nomeados de xs a xl.

Correções notáveis

• Sessões em um modelo específico de gateway por trás de um ANTHROPIC_BASE_URL personalizado não morriam mais com "Prompt is too long · automatic compaction failed" perto de 200K tokens.
• Um mod que enviava um prompt ao fim de cada turno podia ultrapassar --max-turns, --max-budget-usd, interrupções ou o fim da conversa em execuções headless — corrigido.
• Mods instalados e desativados remotamente agora são descarregados entre turnos em vez de continuar em uma sessão aberta.
• Editar e Tentar Novamente no Cowork e em sessões na nuvem do claude.ai falhava em mensagens interrompidas no meio de um hook (regressão da 2.1.296) — corrigido.
• Um comando de shell em sandbox podia escrever em uma pasta --plugin-dir, cujo código o Claude Code recarrega e executa fora do sandbox — agora bloqueado.
• O log de depuração (--debug, --debug-file) não cresce mais de forma ilimitada na memória e não trava mais ao sair quando o log está em uma rede ou montagem de disco travada.

Também novo: CLAUDE_CODE_ATTRIBUTION_HEADER=0 remove o bloco de atribuição nas sessões do Claude Code e na aba Code do Claude Desktop, e /usage agora avisa sobre esforço máximo, workflows, contexto sempre ativo e resultados grandes de ferramentas. A visualização de Agente ganha /effort e /fast para definir padrões de novas sessões.