Resumo dos recursos do Claude Code: modificações em TypeScript, recuperação de rascunhos e hooks de plugins (outubro de 2026)

Recursos do Claude Code em um relance

As três primeiras versões de outubro combinam um recurso de extensão significativo com melhorias menores para o desenvolvimento cotidiano. O Claude Code 2.1.287 introduziu mods; 2.1.288 adicionou recuperação de rascunhos e controles de revisão; 2.1.289 ampliou o suporte a hooks de plugins e resolveu problemas de carregamento de mods e de permissões.

A tabela abaixo oferece um ponto de partida com base no fluxo de trabalho que você deseja melhorar.

Essas versões abordam diferentes partes do mesmo fluxo de trabalho. Os mods permitem que plugins alterem o comportamento do Claude Code, enquanto a recuperação de rascunhos torna a edição de prompts mais tolerante a erros. As correções posteriores de hooks e permissões são relevantes quando essas extensões interagem com agentes, ferramentas e configurações gerenciadas pela organização.

Mods em TypeScript ampliam o comportamento dos plugins

Claude Code 2.1.287 introduziu Claude Mods com a descrição nas notas de versão “os plugins agora podem modificar comportamentos mais profundos”. Mods são pequenas funções TypeScript empacotadas em plugins e funcionam tanto na CLI quanto no aplicativo desktop.

O O anúncio dos mods de outubro 1 descreve vários recursos: reescrever prompts, adicionar elementos de interface, substituir recursos integrados e bloquear, reescrever ou tentar novamente chamadas de ferramentas. Esse escopo torna os mods relevantes quando você precisa alterar como o Claude Code se comporta durante uma tarefa.

Para desenvolvedores familiarizados com hooks, a distinção útil é o escopo explicitamente documentado para mods: eles podem alterar prompts, a interface, comportamentos integrados e chamadas de ferramentas. O guia de hooks do Claude Code fornece uma referência ao avaliar qual mecanismo de extensão se adapta a um projeto.

Como criar e testar um mod

O README de mods com versionamento 2.1.287 documenta uma função exportada register(on, options) e handlers no formato ($, e, next). A estrutura do plugin inclui .claude-plugin/plugin.json, hooks/hooks.json, e arquivos TypeScript em hooks/.

Os comandos de desenvolvimento documentados são:

/plugin-types
claude --plugin-dir mods/diff
claude plugin test mods/diff

/plugin-types grava declarações. Os outros dois comandos são os exemplos do retrato para executar o Claude Code com o diretório do plugin de exemplo e testar esse plugin.

O retrato também alerta que a API pode mudar entre versões sem aviso prévio. Trate a documentação versionada como parte da sua referência de implementação, especialmente ao atualizar um plugin que depende de APIs de mods.

Acesso, confiança e o mod integrado

Os mods são executados com o acesso do Claude Code à máquina e não são isolados em sandbox. O anúncio da Anthropic recomenda instalá-los apenas de fontes confiáveis. Revise o código-fonte e a origem de um mod antes de ativá-lo, especialmente quando ele puder reescrever ou repetir chamadas de ferramentas.

A versão 2.1.287 também adicionou “Você deveria saber,” um mod integrado cujo agente auxiliar sinaliza coisas que o usuário ou o Claude podem deixar passar. O comando para ativá-lo é:

/plugin enable cc-plugin-you-should-know@builtin

A disponibilidade indicada é para sessões próprias com telemetria ativada. Esse detalhe de elegibilidade importa: o anúncio não confirma a disponibilidade em todas as configurações de sessão.

Recuperação de rascunhos e controles de revisão de código

Claude Code 2.1.288 adiciona dois controles úteis para o trabalho interativo: recuperar um prompt apagado com Ctrl+C e escolher quantos apontamentos da revisão de código serão relatados.

Restaurar um prompt apagado com Ctrl+C

Se Ctrl+C apagar seu prompt, pressione Seta para cima enquanto o prompt estiver vazio para restaurar o rascunho. A recuperação inclui texto colado e imagens.

A versão descreve uma ação específica de recuperação para um prompt apagado. Ela não estabelece um arquivo geral de rascunhos nem um comportamento de recuperação para todas as formas de encerramento de uma sessão. A sequência a lembrar é simples: Ctrl+C apaga o prompt; depois, a seta para cima no prompt vazio o restaura.

Isso é particularmente relevante quando o prompt inclui mais do que instruções digitadas. Materiais colados e imagens estão explicitamente incluídos no comportamento de recuperação, portanto o recurso abrange o conteúdo desse rascunho apagado.

Definir o número de apontamentos da revisão

A nova /code-review --max-findings <n>|all opção controla quantos apontamentos uma revisão relata. Você pode escolher um número, solicitar todos os apontamentos ou restaurar o padrão:

/code-review --max-findings 5
/code-review --max-findings all
/code-review --max-findings default

A configuração permanece até que você a redefina com default. Trate-a como uma preferência contínua ao alternar entre revisões.

A versão não especifica o valor numérico padrão, portanto não há uma contagem padrão verificada para citar. Se quiser um limite conhecido de apontamentos, defina um número explícito; se quiser voltar ao comportamento integrado, use o comando de redefinição. O referência da CLI é um complemento útil para fluxos de trabalho mais amplos na linha de comando.

Hooks de plugins ganham acompanhamento mais claro dos agentes

Claude Code 2.1.289 adiciona informações nos hooks de plugins sobre a criação de colegas de equipe e o estado dos agentes. As mudanças relevantes são agent.spawn para colegas de equipe, um único ID de agente em todos os eventos dos hooks de plugins e estados de inatividade ou espera em $.agent.list().

Para autores de plugins, essas adições fornecem mais informações sobre a atividade dos agentes. Um ID consistente dá aos eventos um identificador de agente comum, enquanto os estados de inatividade e espera acrescentam detalhes à lista retornada por $.agent.list(). O resumo não fornece um exemplo completo de implementação, portanto essas adições devem ser tratadas como recursos da API, e não como uma receita de orquestração pronta para uso.

Correções no carregamento de mods e na interface

A mesma versão corrige a falha no carregamento de mods instalados na primeira sessão após uma atualização. Ela também resolve cópias desatualizadas de plugins do marketplace local e várias falhas na interface dos mods.

Essas correções são relevantes ao validar uma extensão após atualizar o Claude Code. Inclua a primeira sessão após uma atualização nas suas verificações e confirme que o plugin instalado corresponde à versão esperada do marketplace local.

A versão 2.1.288 já havia adicionado $.ui.selection(). Ele retorna a última seleção de texto em tela cheia e, quando essa seleção está contida em uma única linha da transcrição, a própria linha. Isso fornece aos autores de mods informações sobre a seleção, com uma condição documentada para receber a linha associada.

Tratamento de permissões em máquinas gerenciadas

A versão 2.1.289 também corrige o comportamento das permissões envolvendo mods instalados pelo usuário. Em máquinas gerenciadas pela organização, regras de negação e solicitação de aprovação em partes aninhadas de comandos compostos de shell são preservadas diante de aprovações concedidas por mods.

Outras correções tratam de Read regras de negação por meio de links simbólicos da IDE e regras de negação ou solicitação de aprovação do Bash sob permissão automática do sandbox. Essas mudanças merecem atenção junto com os novos recursos de mods: o comportamento das extensões e a aplicação das permissões fazem parte da avaliação de uma atualização.

Navegação de sessões, MCP e compatibilidade com gateways

Vários novos recursos menores do Claude Code afetam a navegação e o trabalho de integração.

Na versão 2.1.287, a visualização de agentes ganhou um n:<text> filtro que corresponde a nomes de sessões e tarefas. A versão 2.1.288 então adicionou Ctrl+F para pesquisar sessões pelo nome e Alt+↑/↓ para alternar entre grupos na visualização de agentes. Esses atalhos e a ação de renomear podem ser remapeados em keybindings.json.

Para sessões restauradas, a versão 2.1.288 inclui várias --resume correções que preservam o contexto restaurado, as respostas finais e o raciocínio anterior. Essas são mudanças de confiabilidade no trabalho retomado, separadas da recuperação de um prompt apagado com Ctrl+C.

Prompts de URL do MCP

A versão 2.1.287 adicionou prompts de URL para servidores MCP que usam o protocolo 2025-11-25. Se um servidor deixar de se conectar, a versão indica "bareElicitationCapability": true como configuração de compatibilidade.

Essa configuração é um detalhe de solução de problemas ligado à mudança no MCP dessa versão. Verifique-a no contexto do servidor afetado, em vez de tratá-la como um requisito universal de configuração. O guia de MCP oferece um ponto de partida para o fluxo de trabalho de integração relacionado.

Saídas estruturadas

A versão 2.1.288 introduziu CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS, que desativa saídas estruturadas em ambientes como gateways que as rejeitam.

O resumo informa a finalidade da variável de ambiente, mas não fornece um valor específico de atribuição nem um comando de shell. Se a rejeição de saídas estruturadas afetar seu ambiente, essa é a opção de configuração a investigar; a versão não estabelece que todos os gateways precisam dela.

Limites de uso a acompanhar

As mudanças nos recursos de outubro acompanham um ajuste de setembro nos limites de uso das assinaturas. Desde setembro de 14, os limites semanais estão permanentemente 25% acima dos níveis anteriores à promoção para Pro, Max, Team e Enterprise por licença.

O aumento temporário anterior de 50% vigorou de maio de 13 até setembro de 13 de 2026, terminando às 11:59 da tarde, no horário do Pacífico. As licenças Free e Enterprise baseadas em consumo foram excluídas dessa promoção.

Mantenha essas porcentagens separadas ao verificar sua cota atual. O aumento permanente e a promoção encerrada usam valores diferentes; as versões de outubro não estabelecem um retorno ao nível promocional.

Use /usage para ver seus limites. Para mais contexto sobre as restrições relevantes das assinaturas, consulte o guia de limites de taxa do Claude Code.

Principais conclusões

• O Claude Code 2.1.287 introduziu mods em TypeScript que são distribuídos dentro de plugins e podem modificar prompts, a interface, recursos integrados e chamadas de ferramentas na CLI e no aplicativo para desktop.
• Os mods não são isolados em sandbox. Eles são executados com o acesso do Claude Code à máquina, e o anúncio recomenda instalá-los apenas de fontes confiáveis.
• A versão 2.1.288 restaura rascunhos apagados: depois que Ctrl+C apagar um prompt, pressione a seta para cima no prompt vazio para recuperá-lo, incluindo texto colado e imagens.
• Os apontamentos da revisão são configuráveis, e a configuração persiste. Use /code-review --max-findings 5, all, ou default; o valor numérico padrão não é especificado.
• A versão 2.1.289 amplia os hooks de plugins relacionados a agentes e corrige o carregamento de mods, a interface e o tratamento de permissões. Use /usage para verificar seus limites atuais separadamente dessas mudanças de recursos.

Perguntas frequentes

O que são mods do Claude Code?

Os mods do Claude Code são pequenas funções TypeScript empacotadas dentro de plugins que podem reescrever prompts, adicionar elementos à interface, substituir recursos integrados e bloquear, reescrever ou repetir chamadas de ferramentas. Eles funcionam na CLI e no aplicativo para desktop, são executados com o acesso do Claude Code à máquina e não são isolados em sandbox.

Como criar e testar um mod em TypeScript?

O registro da versão 2.1.287 documenta uma função exportada register(on, options) , manipuladores no formato ($, e, next)e um plugin contendo .claude-plugin/plugin.json, hooks/hooks.jsone TypeScript em hooks/. Use /plugin-types para gerar declarações; os comandos de exemplo documentados são claude --plugin-dir mods/diff e claude plugin test mods/diff.

Como recuperar um prompt apagado acidentalmente com Ctrl+C?

No Claude Code 2.1.288, pressione a seta para cima no prompt vazio depois que Ctrl+C o apagar. Isso restaura o rascunho apagado, incluindo texto colado e imagens.

Como alterar ou redefinir o limite de apontamentos da revisão de código?

Use /code-review --max-findings 5 para definir um limite numérico ou /code-review --max-findings all para solicitar todos os apontamentos. A escolha permanece até /code-review --max-findings default, e a versão não especifica o valor numérico padrão.