Resumo
O Claude Code 2.1.312 corrige a leitura das políticas da organização após o login no VS Code e a gravação de arquivos de instruções extensos. A descoberta de skills acompanha mudanças de diretório dentro do repositório. A publicação também altera o prompt utilizado com modelos cujos nomes o Claude Code não reconhece e limita a quantidade de hooks executados simultaneamente.
Novidades
- Claude Code 2.1.312 — Identificação no gateway:
oidc.user_id_claimpermite utilizar um campo deid_tokendiferente desubna identificação após autenticar, comooiddo Microsoft Entra ID. - Claude Code 2.1.312 — Mensagens na fila: clicar na indicação
to send nowenvia imediatamente a mensagem que aguarda no modo de tela cheia. - Claude Code 2.1.312 — Rotinas na nuvem: a criação e a edição de rotinas recebem uma seleção do nível de esforço. O campo de script de preparação recebe um editor Bash com cores de sintaxe e números de linha.
Melhorias
- Claude Code 2.1.312 — Esforço aplicado: o indicador de atividade, as transcrições e o atributo
effortdo OpenTelemetry mostram o nível utilizado pelo modelo. Uma alteração solicitada durante a tarefa recebe aviso quando ainda aguarda aplicação. - Claude Code 2.1.312 — Hooks simultâneos: os hooks de prompt e de agente executam no máximo 24 chamadas simultâneas por sessão, incluindo subagentes. Até 12 chamadas adicionais podem permanecer após ultrapassar o tempo limite do evento. Um
timeoutinferior a um segundo utiliza o mínimo de um segundo. - Claude Code 2.1.312 — Compactação de subagentes:
autoCompactWindowreduz a janela definida porCLAUDE_CODE_AUTO_COMPACT_WINDOWquando seu limite é menor. Um limite maior não amplia essa janela. - Claude Code 2.1.312 — Telemetria MCP: servidores remotos de URL fixa declarados por plugins do marketplace oficial recebem seu nome real em
mcp_server.name. O envio do eventoclaude_code.safety_eventfoi removido.
Correções
- Claude Code 2.1.312 — Políticas após login: a extensão do VS Code volta a buscar as configurações gerenciadas e as políticas da organização após autenticar. Falhas ao carregá-las na abertura recebem uma explicação com opções de nova tentativa ou login.
- Claude Code 2.1.312 — Arquivos de instruções: a ferramenta Write solicita a leitura completa ou uma edição no próprio arquivo quando o modelo consultou apenas o início de um
CLAUDE.mdmuito extenso. A correção também abrange os arquivos de instruções complementares e aqueles incluídos por@. - Claude Code 2.1.312 — Skills por diretório: skills locais e com
paths:voltam a ser encontradas após umcdpara uma subpasta do repositório. - Claude Code 2.1.312 — Comandos e sessões: um nome de comando inválido deixa de interromper o carregamento dos demais comandos. A primeira resposta após retomar uma sessão permanece disponível na retomada seguinte.
- Claude Code 2.1.312 — Leitura de PDF: a ferramenta Read recebe correção para a falha de geração de imagem quando a limpeza de arquivos antigos ocorre simultaneamente.
- Claude Code 2.1.312 — Mensagens e revisão: repetir uma mensagem inalterada após falha de envio na nuvem deixa de executar a solicitação duas vezes. O Code Review consulta o commit atual da revisão de código quando um evento de push chega atrasado.
- Claude Code 2.1.312 — Arquivos no Slack: respostas preservam o tópico correto ao publicar arquivos. Canais privados que se tornam públicos mantêm suas configurações após mudar de identificador.
Ponto de Atenção
Nomes de modelo desconhecidos, incluindo deployments personalizados, utilizam o prompt de sistema reduzido no Bedrock e no Vertex, assim como no Foundry e no Mantle. CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0 mantém o prompt completo. A troca automática de modelo após uma mensagem sinalizada também abrange esses nomes. CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1 desativa essa troca.
Teste sugerido: autentique pela extensão num ambiente com políticas gerenciadas e confira seu carregamento. Num repositório de homologação, entre numa subpasta pelo Bash e verifique a descoberta de uma skill com paths:. Para um deployment de nome personalizado, compare o comportamento com a configuração padrão e com CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0.
Notas da versão
O release oficial do Claude Code 2.1.312 foi publicado em 27/10/2026 às 20h24 UTC como versão estável. As notas também corrigem o modo Vim e a recuperação do campo de composição, além de esclarecer os avisos do limite de cinco horas.