Claude SDK for Python, which lets Python applications access the Claude API. It includes installation via pip and example code for creating messages and calling Claude models, with full API SDK documentation available on platform.claude.com.
Project status
- Actively maintained: The repo has very recent activity (last upstream push on 2026-10-14) and multiple SDK updates in September and October 2026, including functional API surface additions and supporting fixes.
- Update cadence: The updates arrive frequently, roughly every week or less in late September through mid-October 2026 (v1.11.0, v1.10.0, v1.9.0, then v1.12.x and v1.13.0 within about 3 to 4 weeks).
AI summary generated
Recent updates
v1.15.0
v1.15.0 adds new API surface for model thinking capabilities by introducing a between_tools thinking type, and extends Messages with a speed parameter (plus usage.speed). It also exposes a Console organization usage-tier spend cap as a read-only spend limit. The diff also shows several internal and beta-endpoint related behavior and documentation adjustments.
Featuresv1.14.0
v1.14.0 adds OpenTelemetry tracing across API calls, streaming, and tool runs, and expands telemetry destination coverage via new Admin API support and a destination test endpoint. It also introduces managed agent API enhancements (execution identity) and improves streaming behavior around unexpected event ordering. Several tracing-related and telemetry-related fixes are included, but most user-facing breaking changes are not clearly documented.
Featuresv1.13.0
v1.13.0 primarily expands the Managed Agents multiagent configuration surface by adding new typed variants around coordinator topology, advisor, subagents, and workflows, including a new multiagent_20261001 mode. It also updates analytics-related types/docs for Chat and Cowork unified metrics and extends streaming to recognize additional workflow_run event types.
Featuresv1.12.1
Release v1.12.1 is primarily a version bump plus documentation updates around Claude Console spend limit listing being in an early access preview. It also includes CI process changes (changelog enforcement) and repository automation changes (release workflow and release-please config adjustments), with no apparent public API signature changes in the SDK code shown.
v1.12.0
v1.12.0 expands the SDK’s Beta API surface with new model capability fields and adds support for runnable computer and browser toolset tool calls (plus related tool runner plumbing). It also introduces several new API fields for RBAC roles and workspace listing, and includes targeted bug fixes around request headers and tool execution/session behavior.
Featuresv1.11.0
v1.11.0 adds support for listing organization spend limits via a new paginated beta endpoint. The release notes also mention deprecating the claude-sonnet-4-5 model. Code changes further include additional typing and response-shape updates related to the spend limits API.
Featuresv1.10.0
v1.10.0 adds several Admin API and Managed Agents API capabilities, including new analytics and plugin-related Admin endpoints, plus Organization API endpoints moving to GA. It also tightens credential file security and adjusts Managed Agents session tool runner idle behavior.
SecurityFeaturesv1.9.0
Release v1.9.0 adds new thinking and diagnostics-related types, introduces an option to run tool calls while the reply streams, and extends workspace rate limit listing with inherited values. It also includes a fix to avoid sending a placeholder filename for unnamed file uploads and several SDK updates to reflect new beta API behaviors.
Featuresv1.8.0
v1.8.0 adds support for the claude-opus-5-5 model and introduces beta support for inline tool definitions and MCP tool-list pinning. The release notes also call out several targeted fixes around tool compaction behavior, managed agent event permission sharing, and safer streaming shutdown in Python 3.13. Separately, the SDK refactors request parameter encoding away from the previous transform-based approach.
Featuresv1.7.0
v1.7.0 adds a new `group` object (including `display_name` for `model_group`) to beta rate limit entries and introduces `compact_before_next_turn()` for the beta tool runner. It also improves Bedrock eventstream error handling, and fixes parsing issues for PEP 604 (`X | Y`) unions, plus tweaks how the `anthropic-beta` header is joined.
BreakingFeaturesv1.6.0
v1.6.0 adds multiple API-layer capabilities (Managed Agents tool permissions auto mode, compaction support, new workspace/user profile parameters, and additional transformation fields) and improves the client retry behavior (Retry-After handling). It also introduces support for async credential token providers, along with corresponding internal credential caching changes.
Featuresv1.5.0
v1.5.0 adds support for passing tool objects directly into Messages API calls (create, parse, stream, count_tokens), plus new helper methods for message serialization (Message.to_param, BetaMessage.to_param). It also introduces dedicated credential exception types and improves streaming/tool input JSON handling to avoid leaking partial JSON into content blocks.
Featuresv1.4.0
v1.4.0 adds multiple API surface improvements, including usage report enhancements (Claude Tag category and user breakdowns) and broader workspace_id support across more endpoints. It also improves developer ergonomics by raising a clearer error when the wrong HTTPX client types are provided. No dependency bumps or explicit breaking changes are described in the release notes.
Featuresv1.3.0
v1.3.0 adds beta API surface area for user profiles and organization compliance settings, alongside type schema updates for memory-store and toolsets. It also includes internal refactors around discriminated unions and several request/streaming behavior fixes. Code diffs show additional behavioral changes around AWS auth/base_url handling and streaming fallback event shaping that are not explicitly documented in the release notes.
BreakingFeaturesv1.2.0
v1.2.0 updates the SDK to use GA-shaped types for the beta files/skills namespaces, and removes some older beta header pinning behavior. It also hardens file upload and request signing (AWS and Bedrock), improves session event accumulation compatibility, and upgrades the tools file APIs to preserve exact bytes and support view_range reads over the size cap.
Featuresv1.1.0
Release v1.1.0 adds new beta API capabilities, including an `updates` thinking display mode and support for Organization API endpoints. It also adjusts tool runner behavior to keep execution going for `pause_turn`, alongside a set of internal refactors (including removing a legacy response API).
Featuresv1.0.0
v1.0.0 is a major release that upgrades the SDK from httpx to httpx2 across the client stack. The release notes only call out this upgrade (and to see MIGRATION.md), but the code diff shows additional API surface removals and behavior changes beyond just the dependency swap.
Breakingv0.125.0
v0.125.0 primarily introduces beta managed agents web search configuration and adds/updates logic for self-hosted sandbox memory in the environment worker. The code diff also expands the managed agents tool configuration surface area (new per-tool config models) and makes several self-hosted environment behavior and typing changes beyond what is mentioned in the release notes.
Featuresv0.124.0
v0.124.0 adds GA support for the Files and Skills APIs and introduces new computer use and browser use toolsets. The diff also shows a large expansion of generated type definitions related to browser tool configuration and state reporting.
Featuresv0.123.0
v0.123.0 adds several beta API capabilities around files, memory stores, and user/workspace context, and improves the client experience for reading workspace ID from response headers. It also includes reliability changes for tool execution, including longer tool-result retry behavior tied to the environment lease TTL, and adjustments for how sync tools run under the session runner. Finally, it removes support for the previously mentioned mid_conv_system content block.
BreakingFeatures