Claude Code v2.1.248

Resumo

O Claude Code v2.1.248 acrescenta modo restrito, TTL de cache por agent, diagnóstico de configurações gerenciadas, créditos de uso e mensagens entre sessões. A publicação também corrige autenticação, sessões, hooks, MCP, worktrees e a proteção de arquivos de credenciais.

Novidades

• Claude Code v2.1.248 — Modo restrito: --restricted e CLAUDE_CODE_RESTRICTED=1 removem ferramentas de comando, código e WebFetch, mantêm as ferramentas de arquivo no diretório atual e recusam bypassPermissions.
• Claude Code v2.1.248 — Cache de agents: experimental.cacheTtl aceita 5m ou 1h no frontmatter do agent quando não há TTL específico para subagents.
• Claude Code v2.1.248 — Mensagens entre sessões: SendMessage e ListAgents enviam mensagens entre sessões da mesma máquina em Bedrock, Vertex e Foundry.

Melhorias

• Claude Code v2.1.248 — Diagnóstico de configurações: a inicialização, /doctor e /status explicam falhas no carregamento de configurações gerenciadas e indicam provedores ou variáveis que impedem a busca.
• Claude Code v2.1.248 — Cache e interface: ajustes no cache de prompt preservam o raciocínio após renovação OAuth, e a descrição do Workflow reduz a ocupação do prompt.

Correções

• Claude Code v2.1.248 — Segurança de arquivos: /ultrareview e sessões na nuvem deixam arquivos de credenciais e cópias temporárias somente na máquina local.
• Claude Code v2.1.248 — Sessões e autenticação: login, Remote Control, sessões em segundo plano, permissões de worktree e falhas de hooks informam a causa e oferecem recuperação mais precisa.
• Claude Code v2.1.248 — MCP e terminal: servidores com headersHelper repetem a autenticação antes da descoberta OAuth, e claude logs restaura os modos do terminal ao encerrar.

Ponto de Atenção

• Claude Code v2.1.248 — Teste sugerido: em homologação, abra uma sessão com --restricted, confirme as ferramentas permitidas, configure experimental.cacheTtl, simule falha de configuração gerenciada e valide uma conexão MCP autenticada.

Notas da versão

• Claude Code v2.1.248 — Áreas afetadas: permissões, cache, settings gerenciadas, créditos de uso, sessões, autenticação, MCP, worktrees e terminal.