Python SDK upgrade guide rewritten against the shipped anthropic…

Python SDK upgrade guide rewritten against the shipped anthropic 1.0.0 migration notes

The /claude-api Python upgrade guide now matches the released 1.0.0 SDK built on httpx2.

Use it nowTier: how much it should matter to you

3Useful: my rating, 1 to 5

2Signal: worth watching, 1 to 5

SkillsArea: what it touches

ImprovementsKind: in v2.1.239, 21 Aug 26

What probably matters to youSection of the release

What

The /claude-api Python upgrade guide now reflects the released 1.0.0 SDK: it is built on httpx2, so anthropic.Timeout is an httpx2 timeout and a timeout object from the older httpx package is rejected when the request is made.

Details

Reverses the earlier advice to delete temperature, top_p and top_k. They are gone from the 1.x signatures but can still be passed through extra_body when the pinned model accepts them, with the per-model rules spelled out.
Passing output_format as a plain dict is now rejected by the stream() and count_tokens() helpers too.
The client configuration sample no longer imports httpx and uses anthropic.Timeout instead.

Evidence

Last reconciled with MIGRATION.md at the 1.0.0 release (2026-08-20)

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

Read from

Names in the bundle/claude-api

How sure we are

One source agreesOne thing we can check says the same as this entry.

Anthropic's release notes agreeAdded /claude-api upgrade to migrate Python projects from anthropic 0.x to 1.x, and updated the skill's Python reference for 1.x (timeouts…

See this entry in the whole of v2.1.239 →

The build it came inv2.1.239

21 Aug 2026 · 300 entries, this one is #93.

Use it now41
You'll notice160
Nothing to try yet37
Under the hood62

Either side of it

v2.1.238Older
v2.1.240Newer

Open the release →

Names in this entry

slash/claude-api
Skill. Load Claude API and Managed Agents reference material for your project's language. Also activates automatically when your code imports anthropic or @anthropic-ai/sdk. Run migrate to update existing Claude API code to a newer model. Run upgrade to move your project's Anthropic SDK dependency across a major version, currently the Python anthropic package from 0.x to 1.x. Run managed-agents-onboard for a walkthrough that creates a new Managed Agent. Run prompt-audit to flag instructions written for older models in your prompts, skills, and tool descriptions and propose fixes as a diff. Run cost-optimize to profile where your project's Claude API spend goes and propose savings from options such as prompt caching, trimming unneeded input and output tokens, batch processing, effort, and model choice, one change at a time. Run build-eval to build an eval set for your Claude-powered app, and hillclimb to iteratively improve the app against an existing eval. The prompt-audit subcommand requires Claude Code v2.1.221 or later, upgrade requires v2.1.236 or later, cost-optimize requires v2.1.247 or later, and build-eval and hillclimb require v2.1.259 or later

Anthropic's note

Upstream's own release notes for v2.1.239 name something this entry names, so the two are probably about the same change. Probably: the pairing is made on a shared name rather than on the words around it.

Added /claude-api upgrade to migrate Python projects from anthropic 0.x to 1.x, and updated the skill's Python reference for 1.x (timeouts use anthropic.Timeout, not httpx.Timeout)

Is this right?