Estamos alterando como a API de Mensagens lida com blocos de pensamento para proteger contra destilação. Um bloco de pensamento é um registro do raciocínio que Claude pode produzir ao trabalhar em uma resposta. No Claude Fable 5.1, Claude Opus 5.5 e Claude Sonnet 5.5, novas contas de API não podem mais editar o contexto ao redor de um bloco de pensamento, como as mensagens, ferramentas ou prompt do sistema, durante uma conversa com múltiplos turnos. Expandiremos o lançamento para todos os usuários com os próximos lançamentos de modelos.
Modificar esse contexto anterior tem aplicações legítimas, que continuamos a apoiar usando os ajustes descritos abaixo. No entanto, tais modificações também são uma técnica comum e documentada publicamente para destilação ilícita em escala industrial, que é proibida pela nossa Política de Uso e Termos de Serviço.
Agora, a API verificará se um bloco de pensamento é devolvido com o mesmo prompt do sistema, ferramentas e mensagens que o produziram, e retornará um erro se não corresponderem. Para que solicitações modificadas tenham sucesso, os desenvolvedores podem optar por ter os blocos de pensamento removidos de tais solicitações; o modelo responderá sem ver o bloco de pensamento.
Neste artigo, compartilhamos detalhes sobre por que estamos fazendo isso e os ajustes que você pode fazer para minimizar a interrupção.
O que são blocos de pensamento?
Claude produz etapas de raciocínio antes de fornecer sua resposta final. Na API, estas são retornadas ao usuário como "blocos de pensamento". Em uma conversa com múltiplos turnos, os usuários da API devolvem esses blocos com cada troca (junto com o prompt do sistema, ferramentas e mensagens anteriores), para que Claude tenha contexto conversacional completo.
O que está mudando?
Para contas afetadas usando os modelos listados abaixo, a API retornará um erro se o prompt do sistema, ferramentas ou mensagens anteriores a um bloco de pensamento anterior tiverem sido modificados.
Para evitar uma mensagem de erro, você pode optar pelo modo "não-restrito". Neste modo, a solicitação será processada, mas os blocos de pensamento afetados serão removidos do que o modelo vê. Isso permite que você continue sua conversa ou tarefa sem interrupção, apesar do pensamento dos turnos anteriores não ser mostrado ao modelo. Quando isso acontecer, a resposta da API informará quais blocos foram removidos.
Por que estamos fazendo essa mudança?
Alterar os turnos anteriores de uma conversa é uma técnica comum usada em campanhas de destilação ilícita, que visam extrair as capacidades de modelos avançados—especialmente pensamento—para treinar outro modelo, sem autorização. A destilação é frequentemente empregada em escala industrial, usando milhares de contas falsas. Criptografamos os blocos de pensamento do Claude para evitar isso, mas ao editar a conversa antes de um bloco de pensamento, um usuário poderia fazer Claude descriptografar e imprimir seu raciocínio. Sistemas treinados dessa forma podem herdar capacidades que não teriam de outra forma, sem herdar as proteções que construímos para evitar uma ampla gama de abuso como ataques cibernéticos e desenvolvimento de armas.
Essa mudança visa tornar as campanhas de destilação mais difíceis de executar. Ela se baseia em medidas anti-destilação existentes como classificadores de destilação aprimorados e restrições na transferência de sessões ou raciocínio de modelos mais avançados para modelos menos capazes com proteções mais fracas.
O que isso significa para integrações de API?
Certas integrações—particularmente aquelas que envolvem reescrever turnos anteriores no meio da conversa, como compactação de contexto, lembretes de sistema injetados ou alteração de ferramentas no meio da sessão—podem precisar de ajustes.
Aqui estão os recursos para ajudá-lo nesta atualização:
A documentação de pensamento preservado cobre onde a mudança se aplica, como verificar se sua integração é afetada, e como fazer edições comuns sem quebrar o pensamento preservado.
Compactação (beta) pode resumir turnos mais antigos mantendo os turnos mais recentes palavra por palavra, e pode construir o resumo em segundo plano enquanto seu agente continua trabalhando. Ela substitui a compactação do lado do cliente, que é provavelmente a razão mais comum pela qual as integrações precisam mudar.
Alterações de ferramentas no meio da conversa (beta) permitem adicionar ou remover ferramentas durante uma conversa sem editar turnos anteriores.
Nossos guias de migração têm uma lista de verificação completa para migrar para cada modelo.
Verifique cada página para disponibilidade no Amazon Bedrock, Google Cloud Vertex AI e Microsoft Foundry.
Se as orientações acima não cobrirem seu caso de uso, entre em contato com nossa equipe de suporte. Se você trabalha com uma equipe de conta, você também pode entrar em contato com eles para obter suporte na atualização de integrações mais complexas.
Há benefícios adicionais em manter blocos de pensamento consistentes: significa que a API pode reutilizar prompts em cache com mais frequência, o que reduz custos e tempo de resposta.
Quem isso afetará?
O pensamento preservado se aplica a estes modelos e contas:
Modelo | Contas de API criadas em ou após 31 de agosto de 2026 (00:00 UTC) | Contas criadas antes disso |
Claude Fable 5.1 | Aplica-se | Não se aplica |
Claude Opus 5.5 | Aplica-se | Não se aplica |
Claude Sonnet 5.5 | Aplica-se | Não se aplica |
Isso cobre organizações da Plataforma Claude, contas do Amazon Bedrock, projetos do Google Cloud Vertex AI e projetos do Microsoft Foundry.
Estamos adotando uma abordagem faseada para aplicação, começando com novas contas, onde vemos a maior concentração de abuso relacionado a destilação. Isso dá aos desenvolvedores com contas existentes tempo para tornar seus harnesses e integrações compatíveis.
Se você usa Claude Code, Claude Cowork ou Claude.ai, não há nada que você precise mudar; esses produtos lidam com blocos de pensamento para você.
O pensamento só pode ser lido pela conta que o criou
A partir do Claude Sonnet 5.5, um bloco de pensamento só pode ser lido pela conta que o criou, ou por uma conta vinculada a ele.
Os blocos de pensamento podem conter informações privadas. Como são criptografados, essas informações não são visíveis quando você inspeciona uma transcrição. Essa verificação ajuda a evitar que uma transcrição compartilhada ou vazada exponha o raciocínio dentro dela. Também torna mais difícil para os destiladores moverem transcrições colhidas para novas contas depois que banimos a conta que as produziu.
Se uma solicitação incluir pensamento de uma conta que não está vinculada, a API remove esse pensamento e a solicitação continua. Ela não retorna um erro. A próxima resposta pode ser mais lenta e usar mais tokens, semelhante a uma compactação.
Contas na mesma organização pai da Plataforma Claude ou na mesma organização do Google Cloud são vinculadas automaticamente. Se você continuar conversas em outras contas, por exemplo para fazer failover entre a Plataforma Claude e o Amazon Bedrock, entre em contato com sua equipe de conta para vinculá-las.
No Claude Code, alternar contas no meio de uma sessão tem o mesmo efeito: a próxima resposta é mais lenta e usa mais tokens.