Claude Code v2.1.311 corrige travamentos na inicialização, edições de linhas longas e interrupções por excesso de contexto

Claude Code v2.1.311 chegou com duas novas flags para self-hosted-runner e uma pilha de correções de bugs que atingem dores reais de desenvolvedores — travamentos na inicialização, estouro de contexto e edições em arquivos grandes.

Novas flags para self-hosted-runner

A versão adiciona --hold-idle-file e --max-hold-min ao self-hosted-runner. Essas flags mantêm uma sessão ociosa ativa enquanto o host relata processos que deixou em execução — útil quando um processo gerado sobrevive ao turno do agente.

Estouro de contexto agora compacta em vez de parar

Sessões com contexto padrão costumavam parar com Usage credits required for 1M context quando uma requisição ultrapassava 200K tokens. Na v2.1.311, o Claude Code compacta a conversa e continua. Chega de sessão morta por causa de uma leitura ou edição longa.

Travamentos na inicialização e na edição de arquivos

• Travamentos longos na inicialização e após ler/editar arquivos quando um CLAUDE.md contém um item de lista muito longo.
• Write e Edit travando por até 5 segundos após concluir e reportando 0 linhas alteradas ao editar milhares de linhas.
• Interrupções que não surtiam efeito até o timeout enquanto um servidor MCP não havia respondido a uma leitura de recurso ou uma skill ainda estava baixando.

Correções em subagentes e MCP

• Subagentes agora podem usar ferramentas MCP de servidores que terminam de conectar depois que o subagente inicia.
• O Claude não vê mais conteúdo desatualizado de MEMORY.md e CLAUDE.md logo após a compactação automática quando esses arquivos foram editados anteriormente na sessão.
• Hooks SubagentStop agora disparam uma vez ao final, em vez de aproximadamente duas vezes por minuto por subagente em execução.
• O worktree isolado de um subagente não é mais removido enquanto um subagente em segundo plano que ele iniciou ainda está trabalhando nele.

Correções em sessões e CLI

• Sessões claude -p e do SDK não salvam mais mensagens de transcrição fora de ordem nem mantêm mensagens retratadas.
• claude mcp add, claude mcp remove e /mcp agora nomeiam a entrada do projeto em ~/.claude.json em vez da pasta atual quando executados abaixo da raiz de um repositório.
• claude mcp list e claude mcp get não duplicam mais códigos de erro (ENOENT: ENOENT:).
• claude respawn <id> não inicia mais o serviço em segundo plano antes de reportar que nenhuma sessão corresponde ao id.
• O erro "background service did not respond" agora sugere claude daemon stop --any em vez do desativado claude daemon restart.

Correções em nuvem e controle remoto

• Sessões de Controle Remoto não ficam mais presas em "Connecting" por ~2 minutos quando um proxy bloqueia uma requisição de inicialização.
• Mensagens que o Claude envia para uma sessão de nuvem ou de Controle Remoto não aparecem mais como suas nos aplicativos móveis.
• O Claude agora é informado da causa quando um anexo falha ao salvar (ex.: disco cheio) ou quando anexos além dos primeiros 20 são descartados.
• WebFetch e WebSearch em sessões de nuvem do Cowork agora falham após 300 segundos em uma resposta travada, em vez de ficar pendurados.
• Sessões de nuvem do Cowork agora ignoram a configuração agent para que conectores e ferramentas sobrevivam a reinicializações.

Detalhes de UI e ferramentas

• O seletor de arquivos @ agora respeita regras de negação de .ignore/.rgignore que reincluem arquivos ignorados pelo git.
• A descrição da ferramenta Bash não afirma mais que o diretório de trabalho sempre persiste entre chamadas.
• O bloco de ambiente não nomeia mais um shell em que os comandos não são executados (ex.: fish quando o Bash usa zsh).
• Sessões de equipe de agentes mostram a lista de tarefas novamente em --resume, --continue, /resume ou --session-id, inclusive após /clear ou uma falha.
• Colar texto que menciona um caminho de imagem (ex.: ! open /tmp/shot.png) não anexa mais a imagem nem remove o caminho do prompt.

Se você usa o Claude Code diariamente, vale a pena atualizar — especialmente se já enfrentou a parada em 200K tokens ou o travamento do Write/Edit em arquivos grandes.