Claude Code 2.1.304

Resumo

O Claude Code 2.1.304 amplia a configuração do modo automático e corrige falhas que afetavam a preservação de conversas e worktrees. As mudanças nos mods também alteram a avaliação de permissões: uma ferramenta pode exigir aprovação humana explícita, com recusa quando a sessão não permite consultar você.

Novidades

• Claude Code 2.1.304 — Modo automático: o comando /auto-mode-setup orienta a configuração usando o projeto e as sessões recentes. O recurso também funciona no Bedrock, Vertex, Foundry e Claude apps gateway, além das sessões com telemetria desativada.
• Claude Code 2.1.304 — Permissões dos mods: a resposta decider: "person" em tool.check exige aprovação pelo diálogo de permissão ou callback do host. Sem possibilidade de consulta, a ação é recusada com o motivo informado pelo mod. O evento também recebe e.isReadOnly para identificar chamadas somente de leitura.
• Claude Code 2.1.304 — Managed Agents: o comando /claude-api managed-agents-secure compara as configurações do agente com o guia de segurança da Anthropic, sem modificá-las.
• Claude Code 2.1.304 — Histórico e consumo: a visualização da conversa mostra as ferramentas utilizadas no resumo da compactação. Nos planos Pro e Max, retomar uma conversa inativa pode gerar um aviso sobre o consumo de uma parcela relevante do limite de cinco horas.
• Claude Code 2.1.304 — Code Review: a administração pode escolher os níveis Quick, Standard ou Deep e definir exceções por repositório. Outra opção inclui automaticamente todos os repositórios de uma organização do GitHub, inclusive os adicionados depois.

Melhorias

• Claude Code 2.1.304 — Sessões extensas: a retomada de conversas compactadas envia a primeira requisição mais cedo no SDK e no modo headless. O envio de requisições em conversas longas utiliza menos memória. A publicação não apresenta medições.
• Claude Code 2.1.304 — Sessões na nuvem: a primeira interação deixa de aguardar servidores MCP locais de plugins sincronizados do claude.ai, exceto quando o servidor declara alwaysLoad: true. O protocolo MCP permite integrar ferramentas à sessão.
• Claude Code 2.1.304 — Gateways: a busca de ferramentas fica ativa por padrão com ANTHROPIC_BASE_URL personalizado. Respostas HTTP 400 ou 422 provocam nova tentativa sem esse recurso. Requisições recusadas por causa de context_management também são reenviadas sem o campo.
• Claude Code 2.1.304 — Interface: /usage informa quando termina a restrição de consulta do consumo. O VS Code reúne os subagentes em segundo plano numa linha de estado, mantendo a conversa completa em /tasks.

Correções

• Claude Code 2.1.304 — Worktrees: sair de claude --worktree com HEAD destacado ou em outra branch deixa de remover o worktree e sua branch sem perguntar. A falha podia causar perda de commits.
• Claude Code 2.1.304 — Conversas salvas: a limpeza acionada por CLAUDE_CODE_TRANSCRIPT_LOCAL_GC corrige a perda de mensagens quando o disco fica cheio durante a redução do arquivo. A interrupção de uma compactação também deixa de provocar determinados erros de limite da janela de contexto.
• Claude Code 2.1.304 — Execução de plugins: criar ou retomar subagentes deixa de prolongar uma execução headless além de --max-turns, Stop ou do encerramento da entrada. Subagentes retomados logo após terminar preservam o trabalho recente.
• Claude Code 2.1.304 — Arquivos e sandbox: comandos no Linux voltam a iniciar quando sandbox.filesystem.denyRead contém colchetes literais, como numa pasta [user-id]. A remoção recursiva de unidades montadas ou de pastas no primeiro nível recebe a confirmação de segurança correspondente.
• Claude Code 2.1.304 — Remote Control: a exibição do histórico deixa de ficar permanentemente indisponível quando o terminal utiliza outro perfil autenticado. O início pelo Claude Desktop volta a funcionar em planos pagos com DISABLE_TELEMETRY ou DO_NOT_TRACK.
• Claude Code 2.1.304 — Configuração da sessão: a política da organização é renovada após aprovar uma chave no início ou trocar a chave personalizada. Configurações gerenciadas de OpenTelemetry são aplicadas após o login inicial. Comandos Bash fora da sandbox no Claude Desktop recebem as variáveis exportadas pelos arquivos de inicialização do shell no macOS e no Linux.
• Claude Code 2.1.304 — Mods e hooks: uma recarga malsucedida preserva as ferramentas da versão ainda carregada. Um hook de uso único deixa de remover o hook idêntico de outra skill. A recusa de um PreToolUse mantém seu motivo quando um callback do Agent SDK excede o tempo de espera.
• Claude Code 2.1.304 — Janela de compactação: CLAUDE_CODE_AUTO_COMPACT_WINDOW aceita os sufixos k e M. A configuração 200k deixa de resultar silenciosamente numa janela de 100 mil tokens.
• Claude Code 2.1.304 — VS Code: o tempo gasto por um hook SessionStart deixa de consumir o limite de inicialização do processo, até dez minutos no total. Fechar uma sessão durante a inicialização também encerra o processo correspondente.

Breaking changes

• Claude Code 2.1.304 — Contrato de settings.read: os hooks dos mods recebem cada camada de configuração e reescrevem o resultado mesclado. Mods que utilizam esse hook precisam conferir a adaptação ao novo contrato, especialmente quando limitam configurações da organização ou o prazo cleanupPeriodDays.
• Claude Code 2.1.304 — Limites de hooks: cada fonte de skills pode registrar no máximo 1.024 hooks e 16.384 caracteres de matchers por sessão. Configurações acima desses limites precisam reduzir os registros. Sob uma política que permite apenas hooks de plugins, uma skill utilizada na conversa principal deixa de receber allowed-tools quando seus hooks são excluídos.

Ponto de Atenção

Confira os mods que alteram configurações e as skills que usam hooks antes de aplicar a atualização ao ambiente de trabalho. A exigência decider: "person" também muda o resultado esperado de uma automação sem interação: a chamada é recusada quando você não pode responder ao diálogo de permissão.

Teste sugerido: numa sessão de homologação, confira a recarga de um mod e o resultado de settings.read. Execute uma ferramenta somente de leitura para observar e.isReadOnly, depois confira a recusa de uma chamada que exija aprovação humana numa sessão sem interação. Retome uma conversa pelo Remote Control e verifique a continuidade do histórico.

Notas da versão

O release oficial do Claude Code 2.1.304 foi publicado em 19/10/2026 às 21h34 UTC como versão estável.