A Anthropic lançou uma nova versão da Claude API, com o número 2026-10-21. Desde 2023, os desenvolvedores escrevem anthropic-version: 2023-06-01 no cabeçalho das requisições; esta é a primeira versão oficial nova depois dela.
A mudança mais visível: os três parâmetros de amostragem temperature, top_p e top_k foram removidos da Messages API. Segundo a documentação de migração, ao enviar requisições com a nova versão, se qualquer um desses campos estiver presente, mesmo que o valor seja o padrão, a API devolve diretamente um erro 400. Sem eles, a requisição usa a amostragem padrão, com temperature em 1.0, o mesmo efeito de não passar parâmetros na versão antiga.
A versão antiga não foi descontinuada. O conselho da documentação é direto: quem tiver requisições que dependem de valores de amostragem diferentes do padrão deve remover os parâmetros ou continuar em 2023-06-01.
Quem será afetado
Para os modelos a partir do Claude 4.7, a remoção quase não muda nada na prática, pois, segundo a documentação, esses modelos já aceitavam apenas os valores padrão. Os afetados são aplicações que ainda usam modelos mais antigos, como o Claude Sonnet 4.6, e reduzem a temperatura de propósito para obter saídas mais estáveis. A documentação é clara: essas requisições perdem o efeito original após a atualização, e nenhuma outra configuração pode substituí-lo.
Além dos parâmetros de amostragem, a Messages API tem mais duas mudanças que causam erro 400:
- Colocar um bloco
documentdiretamente numa mensagem de assistant agora gera erro; o documento deve ir na mensagem de user; - Incluir
citationsnão vazio num bloco de texto de uma mensagem de user também gera erro.
Também há renomeações no lado administrativo. Na Admin API, o campo roles dos grupos RBAC passa a role_ids, o workspace_id das chaves de API é removido e passa-se a ler scope, e na interface de análise empresarial actor.email vira actor.email_address. Na nova versão, os nomes antigos dos campos deixam de ser devolvidos.
SDKs saltam juntos de versão principal
Os SDKs oficiais de todas as linguagens subiram a versão principal, e as novas versões enviam por padrão 2026-10-21: o pacote Python anthropic vai para 2.0.0, o @anthropic-ai/sdk do TypeScript para 1.0.0, Go para v2 (o caminho de importação precisa do sufixo /v2), Java para 3.0.0, C# para 13.0.0, PHP para 1.0.0 e Ruby para 2.0.0. A ferramenta de linha de comando ant sobe para 2.0.0.
Quem usa Go deve ter um cuidado extra. O caminho do módulo da CLI passou a ser github.com/anthropics/anthropic-cli/v2; a documentação avisa que, com o caminho antigo, o go install continua instalando a última v1, sem erro e sem aviso.
No Amazon Bedrock, a nova versão só está disponível para modelos a partir do Claude 4.7. Quem ainda chama o Opus 4.6 e outros modelos antigos no Bedrock deve manter a versão atual do SDK ou trocar de modelo antes de atualizar.
A chave passa a ir em outro cabeçalho
A mudança com maior alcance para os desenvolvedores na China talvez esteja escondida nas alterações dos SDKs. O novo SDK e a CLI deixam de colocar a chave de API no cabeçalho X-Api-Key e passam a usar, de forma unificada, Authorization: Bearer <key>.
A própria Claude API aceita os dois cabeçalhos, então programas que se conectam diretamente à interface oficial não são afetados. O problema está nas camadas intermediárias: proxies reversos próprios, gateways de API e middlewares de contagem de cota que leem a chave em X-Api-Key para autenticar ou cobrar deixarão de encontrá-la assim que o SDK for atualizado. A documentação oferece dois caminhos: alterar o gateway para ler Authorization ou recolocar manualmente a chave em X-Api-Key no cliente.
Outra consequência é que cada cliente só pode manter um tipo de credencial. Antes, passar api_key e auth_token ao mesmo tempo em Python enviava os dois cabeçalhos; agora isso lança diretamente um ValueError.
Sobre um número de versão com mais de dois anos
O número 2023-06-01 cobriu toda a evolução do Claude, da era do Claude 2 até a série Claude 5. Recursos adicionados nesse meio tempo, como chamada de ferramentas, cache de prompts e raciocínio estendido, foram em sua maioria sobrepostos por meio de cabeçalhos beta e novos campos, sem que o número da versão mudasse.
A saída dos parâmetros de amostragem, na verdade, já vinha sendo preparada. Desde o Claude 4.7, os modelos só aceitam os valores padrão, e ajustar a temperatura em modelos novos já não tinha efeito. Agora essa regra passou para o contrato da interface, fazendo a requisição falhar logo na entrada, para que quem chama não pense que o parâmetro ainda vale.
Por quanto tempo a versão antiga será mantida, a documentação de migração não informa cronograma, e a Anthropic também não divulgou até agora uma data de encerramento para 2023-06-01.
Fontes: documentação de migração da plataforma Claude, conta oficial de desenvolvedores do Claude, CocoLoop; números de versão dos SDKs por linguagem, condições de erro e o alcance de modelos no Bedrock seguem a documentação oficial de migração.