Claude Code v2.1.290: Ajuste de Hooks de Plugins, Integração de Agentes Gerenciados e uma Longa Lista de Correções de Sessão

O Claude Code v2.1.290 foi lançado e é majoritariamente uma versão de manutenção, com várias adições à API de hooks de plugin e uma longa lista de correções. Os destaques são novos campos expostos a mods e hooks de plugin, além de algumas conveniências na CLI.

Mudanças em hooks de plugin e mod

• serverToolUses agora está no resultado do hook turn.step de um mod — ele lista as chamadas de ferramenta que a própria API executou (o advisor), cada uma com id, nome, input, início e fim.
• agentId foi adicionado ao evento tool.check dos hooks de plugin, para que um hook consiga distinguir a verificação de permissão de um subagente da sessão principal.
• ceiling foi adicionado à pergunta e ao veredito lidos pelo hook tool.check de um mod, indicando a aprovação que uma organização exige para uma ferramenta.
• Os tipos ThemeKey e Color foram adicionados às tipagens dos hooks de plugin para que editores possam autocompletar as cores de tema que o desenho de um mod pode nomear.

O claude plugin validate agora lista cada hook que um mod registra em um ponto de gating, junto com a informação de se ele tem um .catch (como gatingHooks sob --json). Uma correção relacionada trata de hooks de plugin com .catch sendo descarregados e seu .catch sendo ignorado quando o hook continuava lançando exceções.

Adições na CLI e no onboarding

• claude attach <name> e claude logs <name> agora aceitam parte de um nome de sessão em vez de um id completo.
• /claude-api managed-agents-onboard <url> configura o padrão Managed Agents que uma página descreve como arquivos ant apply.
• /claude-api managed-agents-onboard <quickstart-name> cria um template de quickstart do Console (por exemplo, deep-researcher) usando a CLI ant.
• Um botão Negar foi adicionado à página de aprovação de login do gateway dos apps Claude — o terminal em espera para em segundos.

Dois novos avisos: um quando um arquivo de configurações gerenciadas é um symlink para um arquivo fora da pasta de configurações gerenciadas, e outro em /status e no doctor quando as configurações gerenciadas ignoram caminhos allowRead do sandbox configurados pelo usuário ou domínios permitidos.

Correções que vale destacar

• Requisições atrás de proxies e gateways que rejeitam headers beta com status diferentes de 400, ou junto com um segundo beta, agora funcionam.
• Sessões longas com centenas de imagens não ficam mais travadas em erros de "Request rejected as unprocessable by the model".
• Quando o filtro de conteúdo de saída da API interrompe uma resposta enquanto o Claude ainda está pensando, a requisição é tentada novamente uma vez antes de o erro ser exibido.
• Subagentes/colegas retomados não perdem mais o thinking anterior e o cache de prompt após receberem uma mensagem no meio da execução.
• O WebFetch não descarta mais texto silenciosamente após 100.000 caracteres; ele informa quanto não foi lido e aceita um offset.
• Tarefas agendadas (/loop com intervalo, lembretes) sobrevivem à compactação ao retomar a partir desta versão, e tarefas agendadas em primeiro plano agora disparam após um hand-off com ← ou /background.
• Execuções headless com --json-schema não terminam mais com código diferente de zero e is_error: true quando a conexão cai após a saída estruturada ser entregue.
• O modo de plano não permite mais que o classificador de modo automático aprove ferramentas de conector que não são somente leitura com uma política de ask enviada pelo servidor.
• CLAUDE.md do projeto, regras ou AGENTS.md com symlink para fora dos diretórios de trabalho não são mais carregados sob permissions.blockReadsOutsideWorkingDirectories ou uma regra de negação de Read.
• O /ultrareview no Windows não descarta mais alterações não commitadas sem aviso quando git stash create falha.
• O log do daemon em segundo plano não passa mais caracteres de controle do terminal para a tela sob claude daemon run / claude daemon logs; eles aparecem como escapes \uXXXX.

Se você roda o Claude Code em CI ou atrás de um proxy corporativo, a correção do header beta e os avisos de configurações gerenciadas provavelmente são os que mais vão importar.