A Anthropic lança a versão 1.0 do seu SDK para Python com mudanças que quebram a compatibilidade

Em 20 de agosto de 2026, a Anthropic lançou a versão 1.0 do seu SDK para Python. A camada HTTP passou para o httpx2, o Python 3.10 ou superior passou a ser exigido e foram removidos a API Text Completions e os parâmetros de amostragem dos métodos do Messages.

Registro de arquivo: cobre um fato de 20 de agosto de 2026, e o publicamos em 8 de novembro de 2026. As informações vêm de fontes daquela data e podem ter mudado desde então.

Em 20 de agosto de 2026, a Anthropic lançou a versão 1.0 do seu SDK para Python anthropic, uma versão principal com mudanças que quebram a compatibilidade. O Claude Code v2.1.239 trouxe, em 21 de agosto de 2026, um comando de migração, como mostra a página da versão v2.1.239 do Claude Code no GitHub.

O que mudou na versão 1.0

A camada HTTP passou do httpx para o httpx2, um fork mantido e compatível com a API. Os objetos personalizados http_client, Timeout e de transporte eram criados a partir do httpx2, e chamar httpx2.alias_httpx() na inicialização mantinha funcionando as bibliotecas de rastreamento ou de mock que alteram o httpx.
A versão 1.0 exigia Python 3.10 ou superior.
Ela removeu a API legada Text Completions, os parâmetros temperature, top_p e top_k nos métodos do Messages e o compaction_control do lado do cliente no tool runner.
No cliente assíncrono, os resultados de .with_raw_response exigiam await response.parse().
O AnthropicBedrock gerava um erro quando nenhuma região da AWS estava configurada, em vez de usar us-east-1 por padrão.

O que isso significou para projetos Python

Projetos Python que fixavam o anthropic de forma frouxa podiam quebrar na atualização, principalmente os que passavam parâmetros de amostragem, usavam o Bedrock sem região ou alteravam o httpx.

Ajuda para migrar e fontes

O comando do Claude Code, /claude-api upgrade, migrava projetos Python do anthropic 0.x para o 1.x. Os timeouts na 1.x usavam anthropic.Timeout, e não httpx.Timeout. Um guia de migração para a v1 listava cada mudança com trechos de antes e depois, e as notas de versão do Claude Platform registram o lançamento do SDK.

Fontes

Release v2.1.239 · anthropics/claude-code · GitHub (Anthropic (GitHub), 21 de agosto de 2026, oficial)
Claude Platform release notes - Claude Platform Docs (Anthropic (Claude Platform Docs), 20 de agosto de 2026, oficial)

Escrito com ajuda de IA, apenas a partir das fontes listadas acima. Antes de ir ao ar, verificações automáticas conferiram as datas, as fontes e todas as versões de idioma.