Claude Code 2.1.311

Resumo

O Claude Code 2.1.311 corrige interrupções e perda de continuidade em sessões longas. Uma conversa com janela padrão que ultrapassa 200 mil tokens é compactada e continua, em vez de parar com uma cobrança para utilizar um milhão de tokens. A compactação também recupera o conteúdo atualizado de MEMORY.md e CLAUDE.md quando esses arquivos foram editados na sessão.

As correções nos subagentes preservam o worktree enquanto um agente em segundo plano ainda o utiliza. Os subagentes também recebem acesso às ferramentas MCP (Model Context Protocol) dos servidores que terminam a conexão depois de sua inicialização. Você pode conferir esses comportamentos separadamente da retomada de sessões remotas, que recebe correções próprias.

Novidades

• Claude Code 2.1.311 — Sessões ociosas: self-hosted-runner recebe --hold-idle-file e --max-hold-min para manter uma sessão ociosa enquanto o host informa processos deixados em execução.
• Claude Code 2.1.311 — Explicações: uma dica apresenta o estilo de saída Explanatory quando você solicita explicações.
• Claude Code 2.1.311 — Extensão do VS Code: blocos de código nas respostas recebem cores de sintaxe. A execução demorada de hooks UserPromptSubmit exibe um indicador e um anúncio para leitores de tela.
• Claude Code 2.1.311 — Uso de skills no Slack: a análise do Claude Tag mostra a frequência de execução das skills vinculadas aos canais e identifica as que permanecem sem uso.

Melhorias

• Claude Code 2.1.311 — Inicialização: assinaturas Pro e Max evitam duas requisições de rede em novas aberturas realizadas até uma hora após a última consulta. Aberturas com apenas opções e seus valores também recebem otimização.
• Claude Code 2.1.311 — Comandos demorados: quando o shell atinge o tempo limite, a resposta mostra a saída já produzida e informa que o comando continua em segundo plano.
• Claude Code 2.1.311 — Compactação e transferência: o aplicativo normalmente solicita outra vez o resumo quando a resposta do modelo o omite. O /teleport avisa quando a cópia local começa na última compactação da sessão na nuvem.
• Claude Code 2.1.311 — Esforço do modelo: ultrathink utiliza xhigh nos modelos Opus 5.5, Sonnet 5.5, Haiku 5.5 e Fable 5.1 pela API (Application Programming Interface) da Anthropic. Digitá-lo durante a execução eleva o esforço pelo restante daquele turno.
• Claude Code 2.1.311 — Saída estruturada: json e stream-json representam DEL, controles C1 e caracteres de formatação Unicode com escapes \uXXXX. Os valores obtidos após interpretar o JSON permanecem iguais.
• Claude Code 2.1.311 — Catálogo de modelos: Bedrock, Mantle, Vertex e Foundry carregam as configurações de modelos de um arquivo assinado em downloads.claude.ai. CLAUDE_CODE_MODEL_CATALOG=off desativa esse carregamento.
• Claude Code 2.1.311 — Revisão automática: uma revisão cuja sessão falha ao iniciar por erro transitório do servidor recebe uma nova tentativa automática. O resultado informa quando outra revisão automática não será iniciada.

Correções

• Claude Code 2.1.311 — Arquivos extensos: itens de lista muito longos em CLAUDE.md não provocam os congelamentos descritos na inicialização e na leitura ou edição. Write e Edit também corrigem pausas de até cinco segundos e o registro incorreto de zero linhas alteradas em edições extensas.
• Claude Code 2.1.311 — Interrupção de ferramentas: interromper a execução produz efeito durante uma leitura de recurso MCP sem resposta ou durante o download de uma skill.
• Claude Code 2.1.311 — Histórico da sessão: claude -p e sessões pelo SDK (Software Development Kit) corrigem a ordem das mensagens gravadas e a preservação indevida de mensagens retiradas. Após compactar, o modelo recebe as revisões atuais dos arquivos de memória e instruções.
• Claude Code 2.1.311 — Subagentes: SubagentStop executa ao término do subagente, em vez de repetir durante sua atividade. O worktree isolado permanece disponível enquanto um subagente em segundo plano iniciado nele continua trabalhando.
• Claude Code 2.1.311 — Conexões MCP: subagentes utilizam ferramentas dos servidores conectados depois de sua abertura. Comandos executados abaixo da raiz identificam a entrada correta do projeto para servidores de escopo local em ~/.claude.json.
• Claude Code 2.1.311 — Sessões em segundo plano: sessões que falham entre turnos voltam a iniciar quando permanecem anexadas, fixadas ou com tarefa ou despertar agendados. Skills já concluídas, como /code-review, não executam outra vez após reiniciar a sessão.
• Claude Code 2.1.311 — Retomada de trabalho coletivo: a lista de tarefas retorna ao retomar sessões de agentes, inclusive após /clear ou falha. O /branch utiliza a lista da sessão correspondente.
• Claude Code 2.1.311 — Requisições recusadas: o cliente respeita a indicação de não repetir uma requisição devolvida pelo serviço. Isso corrige esperas de minutos e repetições indefinidas com CLAUDE_CODE_RETRY_WATCHDOG.
• Claude Code 2.1.311 — Execução no Linux: comandos na sandbox corrigem o erro bwrap: Can't create file quando um diretório de --plugin-dir também está adicionado e permissions.blockReadsOutsideWorkingDirectories está ativo.
• Claude Code 2.1.311 — Repositórios adicionais: o runner inicia sem o repositório adicional somente de leitura quando seu acesso recebe HTTP 429 ou um wrapper do Git termina com código 75.
• Claude Code 2.1.311 — Controle remoto e nuvem: mensagens enviadas pelo Claude são identificadas corretamente nos aplicativos móveis. Falhas ao gravar anexos por disco cheio e anexos omitidos após o limite de 20 são informados ao modelo.
• Claude Code 2.1.311 — Ferramentas na nuvem: sessões Cowork preservam conectores e ferramentas após reiniciar quando plugins ou configurações definem agent. Requisições paradas de WebFetch e WebSearch terminam com falha após 300 segundos.
• Claude Code 2.1.311 — Compactação desativada: agentes colaboradores respeitam DISABLE_COMPACT e o menu de retorno deixa de oferecer resumo nessas condições. A variável definida nas configurações ou por $.env.set de um mod permite desativar a compactação, mas não reativá-la.
• Claude Code 2.1.311 — Editor e privacidade: comandos personalizados enviados pelo VS Code ou JetBrains incluem o arquivo aberto ou as linhas selecionadas. Com a telemetria do VS Code desativada, a extensão inicia sessões com DISABLE_TELEMETRY, sem métricas de uso, relatórios de erros ou consulta de feature flags.

Ponto de Atenção

A saída estruturada preserva os valores interpretados, mas altera sua representação textual. Compare o resultado de um parser JSON quando sua integração processar essas respostas. Os nomes de modelos perdem o sufixo [1m] quando ele não produz efeito, embora o sufixo continue aceito.

O comando sugerido após falha do serviço em segundo plano é claude daemon stop --any. Ele encerra sessões em segundo plano, conforme o novo aviso. No runner, confira se um repositório adicional foi omitido após uma recusa por limite de acesso antes de continuar uma tarefa que utilize seus arquivos.

Teste sugerido: em homologação, edite MEMORY.md, compacte a conversa e confira o conteúdo consultado pelo modelo. Inicie um subagente antes de terminar a conexão de um servidor MCP e verifique o acesso à ferramenta depois da conexão. Para a saída estruturada, interprete uma resposta com caracteres de controle e compare o valor recuperado com o conteúdo enviado.

Notas da versão

O release oficial do Claude Code 2.1.311 foi publicado em 26/10/2026 às 21h51 UTC e está classificado como estável no GitHub. As notas também detalham ajustes de acessibilidade, autenticação e prévias de arquivos. Elas não descrevem uma migração obrigatória ou remoção de contrato nesta versão.