Domine as 5 novas funcionalidades do Claude Code v2.1.92: persistência de resultados MCP, executáveis de plugins e tutoriais interativos

title: "Análise das atualizações do Claude Code: v2.1.90 a v2.1.92"
description: "Explore as novidades do Claude Code v2.1.92, incluindo persistência de resultados MCP, diretórios de plugins e o novo tutorial interativo /powerup."

Nota do autor: Detalhamento das atualizações principais das versões v2.1.92 a v2.1.90 do Claude Code, incluindo persistência de resultados de ferramentas MCP (500K caracteres), diretório bin de plugins, tutorial interativo /powerup e outras 5 melhorias funcionais.

O Claude Code lançou uma série de atualizações importantes nos últimos três lançamentos (v2.1.90 ~ v2.1.92), com destaque para a persistência de resultados de ferramentas MCP, diretório de executáveis de plugins e o tutorial interativo /powerup, que geraram grande interesse na comunidade de desenvolvedores. Este artigo analisa rapidamente o impacto dessas atualizações no fluxo de trabalho de programação assistida por IA.

Valor central: Entenda em 3 minutos as principais atualizações funcionais das últimas 3 versões do Claude Code e domine o método de configuração de persistência MCP e o caminho de aprendizado via /powerup.

Visão geral das atualizações do Claude Code v2.1.92

O Claude Code lançou intensamente três versões no início de abril de 2026: v2.1.90, v2.1.91 e v2.1.92. Abaixo está o resumo completo das atualizações principais entre as versões:

Análise detalhada do Claude Code v2.1.92

As mudanças fundamentais na v2.1.92 concentram-se em dois eixos: controle de segurança de nível corporativo e otimização da experiência de desenvolvimento:

A estratégia forceRemoteSettingsRefresh é uma atualização importante para equipes corporativas. Ao habilitar esta política, a CLI força a busca das configurações gerenciadas remotamente mais recentes a cada inicialização; se a busca falhar, o sistema é encerrado (modelo de segurança fail-closed). Isso significa que as equipes de TI corporativas podem garantir que todos os desenvolvedores estejam sempre executando configurações que atendam às políticas de segurança da empresa, evitando problemas de desvio de política causados por cache local.

O assistente de configuração interativa Bedrock melhora significativamente a experiência de configuração inicial para usuários da AWS. Após selecionar "3rd-party platform" na tela de login, o assistente guia o usuário por todo o processo de autenticação AWS, configuração de região, verificação de credenciais e vinculação de modelo, eliminando a necessidade de editar arquivos de configuração manualmente.

Detalhando a persistência de resultados de ferramentas MCP no Claude Code

Mecanismo central de persistência de resultados MCP

A persistência de resultados de ferramentas MCP, introduzida na v2.1.91, é o recurso desta atualização que mais impacta os desenvolvedores. Anteriormente, resultados grandes retornados por ferramentas MCP (como esquemas de banco de dados ou índices de grandes bases de código) eram truncados por excederem os limites padrão, resultando na perda de informações de contexto.

Agora, os servidores MCP podem substituir o limite padrão de tamanho de resultado definindo o campo _meta["anthropic/maxResultSizeChars"], suportando até 500.000 caracteres (aproximadamente 500K). Isso significa que:

• Transferência completa do esquema de banco de dados: A estrutura completa de bancos de dados de grandes projetos pode ser passada para o Claude de uma só vez.
• Índices de código sem truncamento: Índices de arquivos e grafos de dependência em nível de projeto podem ser preservados integralmente.
• Carregamento total da documentação da API: A documentação completa de APIs complexas pode ser transmitida como contexto.

Como configurar a persistência de resultados MCP

Basta adicionar o campo _meta na resposta do seu servidor MCP para habilitá-lo:

{
  "content": [
    {
      "type": "text",
      "text": "... conteúdo de resultado grande ..."
    }
  ],
  "_meta": {
    "anthropic/maxResultSizeChars": 500000
  }
}

import { Server } from "@modelcontextprotocol/sdk/server/index.js";

const server = new Server({
  name: "database-schema-server",
  version: "1.0.0"
});

server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "get_database_schema") {
    const schema = await fetchFullDatabaseSchema();

    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(schema, null, 2)
        }
      ],
      _meta: {
        "anthropic/maxResultSizeChars": 500000
      }
    };
  }
});

🎯 Dica de desenvolvimento: Se você está criando um servidor MCP, recomendo definir o valor de maxResultSizeChars de forma sensata. Não é necessário definir sempre o valor máximo de 500K; escolha um limite superior adequado ao volume real de dados. Para cenários que exigem testes com vários modelos de IA, você pode usar a plataforma APIYI (apiyi.com) para gerenciar centralmente suas chaves API e validar rapidamente o desempenho do servidor MCP em diferentes modelos.

Suporte a executáveis em plugins do Claude Code

Mecanismo de diretório bin/ em plugins

A v2.1.91 adicionou suporte ao diretório bin/ em plugins, uma expansão importante para o ecossistema de plugins do Claude Code. Os desenvolvedores de plugins agora podem incluir executáveis nos pacotes e chamá-los diretamente como comandos simples na ferramenta Bash.

Cenários de aplicação típicos incluem:

• Ferramentas CLI personalizadas: Ferramentas de linha de comando incluídas no plugin que rodam diretamente na ferramenta Bash do Claude.
• Scripts de build: Scripts dedicados de compilação, teste e implantação para o projeto.
• Ferramentas de processamento de dados: Ferramentas personalizadas de conversão e formatação de dados.

Estrutura do diretório bin/ do plugin

my-claude-plugin/
├── plugin.json
├── src/
│   └── index.ts
└── bin/
    ├── lint-check        # Ferramenta personalizada de verificação de código
    ├── db-migrate        # Script de migração de banco de dados
    └── deploy-preview    # Ferramenta de implantação de preview

Após a configuração, o Claude Code pode chamar essas ferramentas diretamente ao executar comandos Bash:

# O Claude pode chamar os executáveis do plugin diretamente no Bash
lint-check src/
db-migrate --status
deploy-preview --branch feature/new-api

Outras atualizações importantes do Claude Code v2.1.91

💡 Dica prática: A correção do --resume resolveu um problema de amplo impacto — anteriormente, ao restaurar uma sessão com --resume, se a escrita assíncrona falhasse silenciosamente, a cadeia de histórico da sessão era interrompida. Agora, isso foi totalmente corrigido, permitindo interromper e retomar sessões de desenvolvimento longas com segurança.

Sistema de tutorial interativo /powerup do Claude Code

Visão geral da funcionalidade /powerup

Introduzido na v2.1.90, o /powerup é o primeiro sistema de tutorial interativo integrado ao Claude Code. Ele oferece lições com demonstrações animadas diretamente no terminal, cobrindo 18 tópicos que vão do nível iniciante ao avançado.

Como usar o /powerup

Basta digitar no terminal do Claude Code:

/powerup

O sistema exibirá um menu interativo onde você pode selecionar módulos de aula específicos. Cada lição inclui:

• Explicação de conceitos: Princípios fundamentais e lógica de design da funcionalidade.
• Demonstração animada: Demonstrações de operação em tempo real dentro do terminal.
• Exercícios práticos: Orientações para você experimentar em seus próprios projetos.

Caminho de aprendizado recomendado para o /powerup

Para desenvolvedores com diferentes níveis de experiência, recomendamos o seguinte caminho:

Para iniciantes — Domine os 3 fundamentos:

1. Como escrever o arquivo de configuração de projeto CLAUDE.md
2. Gerenciamento da janela de contexto com o comando /compact
3. Resolução de tarefas complexas passo a passo com o modo de planejamento (Plan Mode)

Para nível intermediário — Foque na automação:

1. Automação de fluxos de trabalho com configuração de Hooks
2. Processamento paralelo de tarefas com subagentes
3. Expansão das capacidades de ferramentas do Claude com servidores MCP

Para nível avançado — Desbloqueie todo o potencial:

1. Desenvolvimento paralelo em ambientes isolados com Worktrees
2. Execução agendada de agentes remotos com /schedule
3. Integração em pipelines de CI/CD com o modo headless do SDK

🚀 Início rápido: Se você precisa testar vários modelos de IA durante o desenvolvimento de servidores MCP, recomendamos usar a interface unificada da APIYI (apiyi.com). Com uma única chave API, você acessa modelos como Claude, GPT, Gemini e outros.

Resumo de otimizações de desempenho do Claude Code v2.1.92

Melhoria de desempenho na ferramenta Write

A v2.1.92 otimizou o cálculo de diff da ferramenta Write, resultando em um ganho de desempenho de cerca de 60% ao processar arquivos grandes que contêm tabulações, símbolos & e cifrões $. Isso representa uma melhoria significativa na experiência para desenvolvedores que editam diariamente arquivos de configuração grandes, scripts Shell e arquivos de template.

Otimizações de desempenho da v2.1.90

A versão v2.1.90 incluiu várias otimizações de desempenho de baixo nível:

Outras melhorias na v2.1.92

• Aprimoramento do comando /cost: Usuários assinantes podem visualizar detalhes de custos segmentados por modelo e taxa de acerto de cache.
• Atualização do /release-notes: Agora é um seletor de versão interativo, facilitando a visualização do histórico de atualizações de qualquer versão.
• Nomeação de sessão de controle remoto: Usa o prefixo do nome do host por padrão (ex: myhost-graceful-unicorn), com suporte a personalização via --remote-control-session-name-prefix.
• Aviso de expiração de cache: Usuários Pro verão um aviso no rodapé após a expiração do cache de prompt, exibindo uma estimativa de tokens não armazenados em cache.

💰 Dica de custo: O comando /cost do Claude Code agora oferece análise de custos detalhada por modelo. Se você utiliza vários modelos de IA para desenvolvimento, pode usar a função de faturamento da plataforma APIYI (apiyi.com) para visualizar o uso e os custos de cada modelo de forma centralizada, facilitando o controle financeiro.

Lista de correções de bugs do Claude Code v2.1.92

Os últimos três lançamentos trouxeram correções para diversos problemas que afetavam a experiência de uso:

Correções na v2.1.92

• Corrigido o problema de falha na criação de sessões tmux de subagentes
• Corrigido o erro 400 da API causado por blocos de "thinking" contendo apenas caracteres de espaço em branco
• Corrigido o envio acidental de questionários de pesquisa causado por teclas pressionadas no modo de direção autônoma
• Corrigida a exibição duplicada de mensagens na reprodução de rolagem em tela cheia
• Corrigido o travamento do servidor MCP do plugin no estado "connecting"
• Removidos os comandos /tag e /vim
• Restaurado o bloqueio de Unix Socket no sandbox do Linux

Correções na v2.1.91

• Corrigida a perda do histórico da sessão causada por falha na escrita assíncrona do --resume
• Corrigida a falha do atalho cmd+delete nos terminais iTerm2, kitty, WezTerm e Ghostty
• Corrigida a perda do estado do modo de planejamento após a reinicialização do contêiner

Correções na v2.1.90

• Corrigida a regressão que causava falha no hit do prompt-cache completo ao usar --resume (introduzida desde a v2.1.69)
• Corrigido o loop infinito da caixa de diálogo de limite de taxa
• Corrigido o problema em que o modo automático ignorava limites explícitos do usuário (como "don't push")
• Corrigido o erro "File content has changed" nas ferramentas Edit/Write ao ativar o hook de format-on-save

Perguntas frequentes

npm install -g @anthropic-ai/claude-code@latest

Resumo

Os pontos principais das atualizações nas versões v2.1.90 a v2.1.92 do Claude Code:

1. Persistência de resultados MCP: Suporte para resultados de ferramentas de até 500 mil caracteres, resolvendo problemas de truncamento em grandes esquemas e índices.
2. Diretório bin/ para plugins: Agora os plugins podem incluir arquivos executáveis, expandindo a capacidade da cadeia de ferramentas do Claude Code.
3. Tutorial interativo /powerup: 18 lições divididas em três níveis de dificuldade para ajudar usuários de todos os perfis a aprenderem o Claude Code de forma estruturada.
4. Segurança corporativa aprimorada: A política forceRemoteSettingsRefresh garante a consistência das configurações.
5. Otimização de desempenho geral: A ferramenta de escrita (Write) ficou 60% mais rápida e a transmissão SSE foi otimizada de O(n²) para O(n).

Essas atualizações marcam a evolução do Claude Code, deixando de ser apenas um assistente de programação com IA para se tornar uma plataforma de desenvolvimento completa. O fortalecimento contínuo do ecossistema MCP e o aprimoramento do sistema de plugins oferecem aos desenvolvedores muito mais flexibilidade para criar fluxos de trabalho personalizados.

Recomendamos utilizar o APIYI (apiyi.com) para experimentar rapidamente as APIs do Claude e de outros modelos de linguagem grandes. A plataforma oferece créditos gratuitos e uma interface unificada para múltiplos modelos, facilitando a validação e a comparação rápida.

📚 Referências

1. Registro de alterações oficial do Claude Code: Histórico completo das versões

   • Link: code.claude.com/docs/en/changelog
   • Descrição: A melhor fonte para obter detalhes sobre as atualizações mais recentes.

2. Repositório GitHub do Claude Code: Código-fonte aberto e rastreamento de issues

   • Link: github.com/anthropics/claude-code
   • Descrição: Confira o código-fonte, envie relatórios de bugs e sugestões de funcionalidades.

3. Especificação do protocolo MCP: Documentação oficial do Model Context Protocol

   • Link: modelcontextprotocol.io
   • Descrição: Referência definitiva para o desenvolvimento de servidores MCP e formatos de resultados de ferramentas.

4. Guia de desenvolvimento de plugins para Claude Code: Documentação introdutória para criação de plugins

   • Link: code.claude.com/docs/en/plugins
   • Descrição: Entenda a estrutura dos plugins, a configuração do diretório bin e o processo de publicação.

Autor: Equipe Técnica APIYI
Troca técnica: Sinta-se à vontade para discutir suas experiências com o Claude Code nos comentários. Para mais materiais sobre desenvolvimento com IA, acesse a central de documentação do APIYI em docs.apiyi.com.