AI 開發者平台
Anthropic Python SDK 1.0 改用 httpx2，舊追蹤與 mock 可能靜默失效
新版將最低 Python 版本提高至 3.10，並移除 Text Completions、部分取樣參數及用戶端壓縮介面。一般 API 呼叫大多毋須修改，但直接依賴 httpx 的監控、測試與自訂傳輸層必須遷移。
Anthropic 8 月 20 日發布 Python SDK 1.0，最關鍵的底層變更是把 HTTP 用戶端由 `httpx` 換成 Pydantic 團隊維護的相容分支 `httpx2`。只傳入數字逾時、重試次數等普通值的應用通常可繼續運作；自行建立 `Client`、`Timeout`、transport、proxy 或事件 hook 的程式，則須改用 `httpx2` 類別。舊版 `httpx.Client` 傳給 SDK 時會立即拋出 `TypeError`，但 OpenTelemetry、Sentry、RESPX、pytest-httpx 或 VCR 等透過 patch `httpx` 攔截流量的工具，可能繼續執行卻看不到任何 Claude 請求，形成更難察覺的可觀測性缺口。官方提供 `httpx2.alias_httpx()` 作為整個程序的相容方案，但必須在任何模組載入 `httpx` 前呼叫，而且函式庫不應代替下游應用啟用它。
這次主版本也清理多項舊介面。最低執行環境由 Python 3.9 提高至 3.10；`client.completions.create()` 與舊 Text Completions 型別、`HUMAN_PROMPT`、`AI_PROMPT` 均被移除。Messages 方法的 `temperature`、`top_p`、`top_k` 不再出現在正式簽名中，仍需控制舊模型時只能經 `extra_body` 傳送。非同步 `.with_raw_response` 的 `parse()`、`text()`、`read()` 現在必須等待；工具執行器的用戶端 `compaction_control` 亦由伺服器端 context management 取代。Bedrock 使用者若未設定 AWS region，也會由原先默認 `us-east-1` 改為直接報錯。
工程團隊不宜把這次升級視為普通依賴更新。較安全的做法是先鎖定 0.x，在獨立分支升級後執行型別檢查、HTTP mock、APM trace、代理與企業 CA 測試，再確認結構化輸出及非同步 raw response 路徑。官方遷移指南相當完整，但第三方監控套件對 `httpx2` 的支援程度仍須逐一驗證。