Wer mit Claude programmiert, kennt das anthropic-Paket für Python. Seit dem 20. August steht es bei Version 1.0 – und das ist keine reine Zahlenkosmetik. Ein paar Dinge ändern sich so, dass du beim Update kurz hinschauen solltest.
httpx2 statt httpx
Der interessanteste Teil ist der, den man normalerweise nie sieht. Der HTTP-Unterbau wandert von httpx zu httpx2 – einem gepflegten, API-kompatiblen Fork, der bei Pydantic gelandet ist. Für die meisten läuft das geräuschlos durch: Eigene http_client-, Timeout- und Transport-Objekte baust du künftig aus httpx2, die DefaultHttpxClient-Helfer bleiben, wie sie sind.
Ein Stolperstein bleibt aber. Wenn du Tracing- oder Mocking-Bibliotheken nutzt, die httpx von außen patchen, musst du beim Start einmal httpx2.alias_httpx() aufrufen. Sonst greifen diese Tools ins Leere. Genau die Art Detail, die man beim ersten roten Test sucht und dann froh ist, vorher gelesen zu haben.
Was rausfliegt
Version 1.0 räumt auf. Die alte Text-Completions-API ist raus – wer noch darauf baut, muss vorher umziehen. Auch die Parameter temperature, top_p und top_k verschwinden aus den Messages-Methoden, ebenso die clientseitige compaction_control im Tool-Runner.
Beim asynchronen Client gibt es eine kleine, aber wichtige Änderung: .with_raw_response liefert das Ergebnis jetzt erst nach einem await response.parse(). Und AnthropicBedrock wirft einen Fehler, wenn keine AWS-Region gesetzt ist, statt still auf us-east-1 zurückzufallen. Klingt streng, ist aber ehrlicher – ein falsch geratenes Rechenzentrum hat schon manche Rechnung und manche Latenz erklärt.
Dazu kommt die harte Grenze: Python 3.10 ist ab jetzt das Minimum. Wer noch auf 3.9 oder älter sitzt, kommt an einem Update nicht vorbei.
Meine Einordnung
Ein Major-Release, das vor allem aufräumt, ist genau das, was man von einem SDK will, das man täglich einbindet. Kein neuer Glanz, dafür weniger Altlasten und klarere Fehler statt stiller Annahmen.
Der Umzug zu httpx2 ist der Punkt, den ich mir gemerkt habe. Ein API-kompatibler Fork unter dem Dach von Pydantic – das riecht nach einer Wette darauf, wo die Python-Welt beim HTTP-Handling hinläuft. Für dich heißt das erstmal: Migrationsleitfaden lesen, einmal durch die Tests, fertig. Und dann hast du ein Fundament, das wieder eine Weile trägt.
Quellen: