Claude Code v2.1.248: Modo Restrito e Cache TTL

Claude Code v2.1.248 foi lançado com um novo modo de execução restrito, configuração de TTL de cache por agente e uma série de correções de estabilidade para cache de prompt e gerenciamento de sessão.

Modo Restrito

Agora você pode executar o Claude Code com --restricted (ou definir CLAUDE_CODE_RESTRICTED=1). Isso remove todas as ferramentas integradas que executam comandos ou código, além de WebFetch, a menos que explicitamente nomeado em --tools. As operações de arquivo permanecem dentro do diretório de trabalho, bypassPermissions é recusado e os arquivos de configuração do usuário/projeto/local são ignorados. Isso é útil para revisões de código não confiáveis ou ambientes de CI.

Cache TTL por Agente

Agora você pode definir um TTL de cache de prompt no frontmatter do agente via experimental.cacheTtl: "5m" ou "1h". Isso se aplica quando nenhum TTL de subagente é configurado, dando a você um controle mais preciso sobre a expiração do cache para agentes específicos.

Runner Auto-hospedado e Diagnóstico de Configurações

O comando claude self-hosted-runner ganha uma flag --client-label (ou SELF_HOSTED_RUNNER_CLIENT_LABEL) para substituir o rótulo padrão (hostname). A inicialização agora avisa se as configurações gerenciadas pelo servidor falharem ao carregar, e /doctor e /status explicam o motivo da falha. Além disso, /usage-credits permite que membros Enterprise solicitem limites maiores aos administradores (AWS Marketplace, autoatendimento, testes).

Mensagens entre Sessões

Adicionados SendMessage e ListAgents para mensagens entre sessões na mesma máquina, agora suportados no Bedrock, Vertex, Foundry e quando a telemetria está desabilitada.

Principais Correções

Falhas de cache de prompt em sessões longas (aproximadamente a cada hora) causadas pela re-renderização da ferramenta após a atualização do OAuth — corrigido.
Definição da ferramenta ScheduleWakeup mudando em excesso, causando falhas de cache em --resume — corrigido.
Sessões do Desktop/Cowork desaparecendo após 30 dias — corrigido; a nova configuração desktopSessionCleanupPeriodDays limita a isenção.
Loop de login quando outro processo detinha o bloqueio de atualização do token — agora retorna um erro que pode ser repetido.
Windows: a lista de agentes agora responde ao teclado após desanexar ou no modo win32-input.
/login com ANTHROPIC_API_KEY definido agora usa o login com chave de API em vez de falhar com OAuth.
Os nomes dos modelos em /model são renderizados como código (por exemplo, literal [1m]).
Os agentes pulam o prompt de confiança do workspace quando CI está definido — corrigido para mostrar.
A visualização do agente não ressuscita sessões em segundo plano obsoletas; sessões interrompidas são mostradas como interrompidas.
Processos duplicados em sessões retomadas — evitado.
Exclusão de sessões com branches mescladas mas não enviadas — permitida.
Respostas inválidas de hooks agora mostram o nome do hook e o erro de esquema.
JSON inválido de hooks é relatado como erro, não tratado silenciosamente como texto.
/mcp lista entradas de conectores no escopo real, e servidores MCP com headersHelper re-executam o helper em 401 em vez de fallback OAuth.