掲載済み (2026-08-29号)
131 116文字 • 1分

anthropic SDK が httpx をやめました。移行しても動くので気づけません #Python - Qiita

日本語

掲載情報

概要

AnthropicのPython SDK v1.0.0でHTTP層がhttpxからhttpx2へ変更された際、環境に残った旧版のせいで移行漏れに気づかない「サイレントな不整合」のリスクと対処法を解説。

詳細内容

AnthropicのPython SDKがバージョン1.0.0に到達し、HTTPレイヤーがPydanticチームのメンテナンスする`httpx2`へと移行されました。この記事では、SDKをアップデートした直後は以前の`httpx`が環境に「残骸」として残るため、コードを修正しなくてもエラーが出ず、クリーンな環境やCI環境で突然動作しなくなるリスクを指摘しています。対応として`import httpx2 as httpx`と1行書き換えるだけで互換性が維持できることや、Anthropic側が主張する「httpxは非推奨」という見解の検証、Claude Codeを用いた自動移行手順についても紹介されており、実務的な移行ガイドとなっています。