PyPI · #756 most downloaded on PyPI

claude-agent-sdk

0.2.16332M downloads/moanthropics/claude-agent-sdk-python ↗New releases in your daily digest, changelog included.

Python SDK for Claude Code

Last release today
30 Sep 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 58 of the last 60 stable releases
55 versions withdrawn
withdrawn after publishing
1 years old
165 releases · first in 2025

Release timeline

165 releases since 2025

20252026

One column per month.

Releases

0.1.4325 Feb 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree
Updated bundled Claude CLI to version 2.1.56
Internal/Other Changes

Updated bundled Claude CLI to version 2.1.56

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.43/

pip install claude-agent-sdk==0.1.43
Open source →
0.1.4225 Feb 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree
Updated bundled Claude CLI to version 2.1.55
Internal/Other Changes

Updated bundled Claude CLI to version 2.1.55

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.42/

pip install claude-agent-sdk==0.1.42

0.1.4124 Feb 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

Updated bundled Claude CLI to version 2.1.52

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.52

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.41/

pip install claude-agent-sdk==0.1.41

Open source →

0.1.4024 Feb 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

Unknown message type handling: Fixed an issue where unrecognized CLI message types (e.g., rate_limit_event) would crash the session by raising Message

Bug Fixes

Unknown message type handling: Fixed an issue where unrecognized CLI message types (e.g., rate_limit_event) would crash the session by raising MessageParseError. Unknown message types are now silently skipped, making the SDK forward-compatible with future CLI message types (#598)

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.51

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.40/

pip install claude-agent-sdk==0.1.40

Open source →

0.1.3919 Feb 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

Updated bundled Claude CLI to version 2.1.49

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.49

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.39/

pip install claude-agent-sdk==0.1.39

Open source →

0.1.3818 Feb 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

Updated bundled Claude CLI to version 2.1.47

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.47

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.38/

pip install claude-agent-sdk==0.1.38

Open source →

0.1.3716 Feb 20262 sources agree

Updated bundled Claude CLI to version 2.1.44

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.44

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.37/

pip install claude-agent-sdk==0.1.37

Open source →

0.1.3613 Feb 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).Deprecated2 sources agree

The new thinking field takes precedence over the now-deprecated max_thinking_tokens field

New Features

Thinking configuration: Added ThinkingConfig types (ThinkingConfigAdaptive, ThinkingConfigEnabled, ThinkingConfigDisabled) and thinking field to ClaudeAgentOptions for fine-grained control over extended thinking behavior. The new thinking field takes precedence over the now-deprecated max_thinking_tokens field (#565)
Effort option: Added effort field to ClaudeAgentOptions supporting "low", "medium", "high", and "max" values for controlling thinking depth (#565)

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.42

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.36/

pip install claude-agent-sdk==0.1.36

Open source →

0.1.3510 Feb 20262 sources agree

Updated bundled Claude CLI to version 2.1.39

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.39

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.35/

pip install claude-agent-sdk==0.1.35

Open source →

0.1.3410 Feb 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

Updated bundled Claude CLI to version 2.1.38

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.38
Updated CI workflows to use Claude Opus 4.6 model (#556)

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.34/

pip install claude-agent-sdk==0.1.34

Open source →

0.1.337 Feb 20262 sources agree

Updated bundled Claude CLI to version 2.1.37

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.37

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.33/

pip install claude-agent-sdk==0.1.33

Open source →

0.1.327 Feb 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

Updated bundled Claude CLI to version 2.1.36

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.36

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.32/

pip install claude-agent-sdk==0.1.32

Open source →

0.1.316 Feb 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

MCP tool annotations support: Added support for MCP tool annotations via the @tool decorator's new annotations parameter, allowing developers to speci

New Features

MCP tool annotations support: Added support for MCP tool annotations via the @tool decorator's new annotations parameter, allowing developers to specify metadata hints like readOnlyHint, destructiveHint, idempotentHint, and openWorldHint. Re-exported ToolAnnotations from claude_agent_sdk for convenience (#551)

Bug Fixes

Large agent definitions: Fixed an issue where large agent definitions would silently fail to register due to platform-specific CLI argument size limits (ARG_MAX). Agent definitions are now sent via the initialize control request through stdin, matching the TypeScript SDK approach and allowing arbitrarily large agent payloads (#468)

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.33

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.31/

pip install claude-agent-sdk==0.1.31

Open source →

0.1.305 Feb 20262 sources agree

Updated bundled Claude CLI to version 2.1.32

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.32

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.30/

pip install claude-agent-sdk==0.1.30

Open source →

0.1.294 Feb 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

New hook events: Added support for three new hook event types (#545):

New Features

New hook events: Added support for three new hook event types (#545):
- Notification — for handling notification events with NotificationHookInput and NotificationHookSpecificOutput
- SubagentStart — for handling subagent startup with SubagentStartHookInput and SubagentStartHookSpecificOutput
- PermissionRequest — for handling permission requests with PermissionRequestHookInput and PermissionRequestHookSpecificOutput
Enhanced hook input/output types: Added missing fields to existing hook types (#545):
- PreToolUseHookInput: added tool_use_id
- PostToolUseHookInput: added tool_use_id
- SubagentStopHookInput: added agent_id, agent_transcript_path, agent_type
- PreToolUseHookSpecificOutput: added additionalContext
- PostToolUseHookSpecificOutput: added updatedMCPToolOutput

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.31

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.29/

pip install claude-agent-sdk==0.1.29

Open source →

0.1.283 Feb 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

AssistantMessage error field: Fixed AssistantMessage.error field not being populated due to incorrect data path. The error field is now correctly read

Bug Fixes

AssistantMessage error field: Fixed AssistantMessage.error field not being populated due to incorrect data path. The error field is now correctly read from the top level of the response (#506)

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.30

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.28/

pip install claude-agent-sdk==0.1.28

Open source →

0.1.2731 Jan 20262 sources agree

Updated bundled Claude CLI to version 2.1.29

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.29

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.27/

pip install claude-agent-sdk==0.1.27

Open source →

0.1.2630 Jan 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

PostToolUseFailure hook event: Added PostToolUseFailure hook event type for handling tool use failures, including PostToolUseFailureHookInput and Post

New Features

PostToolUseFailure hook event: Added PostToolUseFailure hook event type for handling tool use failures, including PostToolUseFailureHookInput and PostToolUseFailureHookSpecificOutput types (#535)

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.27

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.26/

pip install claude-agent-sdk==0.1.26

Open source →

0.1.2529 Jan 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

Updated bundled Claude CLI to version 2.1.23

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.23

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.25/

pip install claude-agent-sdk==0.1.25

Open source →

0.1.2428 Jan 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

Updated bundled Claude CLI to version 2.1.22

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.22

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.24/

pip install claude-agent-sdk==0.1.24

Open source →

0.1.2327 Jan 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

MCP status querying: Added public get_mcp_status() method to ClaudeSDKClient for querying MCP server connection status without accessing private inter

Features

MCP status querying: Added public get_mcp_status() method to ClaudeSDKClient for querying MCP server connection status without accessing private internals (#516)

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.20

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.23/

pip install claude-agent-sdk==0.1.23

Open source →

0.1.2223 Jan 2026

Added tool_use_result field to UserMessage

Features

Added tool_use_result field to UserMessage (#495)

Bug Fixes

Added permissions to release job in auto-release workflow (#504)

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.19
Extracted build-and-publish workflow into reusable component (#488)

Open source →

0.1.2121 Jan 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

Updated bundled Claude CLI to version 2.1.15

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.15

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.21/

pip install claude-agent-sdk==0.1.21

Open source →

0.1.2016 Jan 2026withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).2 sources agree

Permission callback test reliability: Improved robustness of permission callback end-to-end tests

Bug Fixes

Permission callback test reliability: Improved robustness of permission callback end-to-end tests (#485)

Documentation

Updated Claude Agent SDK documentation link (#442)

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.9
CI improvements: Updated claude-code actions from @beta to @v1 (#467)

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.20/

pip install claude-agent-sdk==0.1.20

Open source →

0.1.198 Jan 20262 sources agree

Updated bundled Claude CLI to version 2.1.1

Internal/Other Changes

Updated bundled Claude CLI to version 2.1.1
CI improvements: Jobs requiring secrets now skip when running from forks (#451)
Fixed YAML syntax error in create-release-tag workflow (#429)

PyPI: https://pypi.org/project/claude-agent-sdk/0.1.19/

pip install claude-agent-sdk==0.1.19

Open source →

0.1.1818 Dec 2025withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).

Docker-based test infrastructure: Added Docker support for running e2e tests in containerized environments, helping catch Docker-specific issues

Internal/Other Changes

Docker-based test infrastructure: Added Docker support for running e2e tests in containerized environments, helping catch Docker-specific issues (#424)
Updated bundled Claude CLI to version 2.0.72

Open source →

0.1.1716 Dec 2025withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.17/

Installation

pip install claude-agent-sdk==0.1.17

What's Changed

Add UUID to UserMessage response type to improve devX for rewind by @noahzweben in https://github.com/anthropics/claude-agent-sdk-python/pull/418
chore: release v0.1.17 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/419

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.16...v0.1.17

Open source →

Additional notes

New Features

UserMessage UUID field: Added uuid field to UserMessage response type, making it easier to use the rewind_files() method by providing direct access to message identifiers needed for file checkpointing (#418)

Internal/Other Changes

Updated bundled Claude CLI to version 2.0.70

Open source →

0.1.1613 Dec 2025withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.16/

Installation

pip install claude-agent-sdk==0.1.16

What's Changed

fix: parse error field in AssistantMessage to enable rate limit detection by @majiayu000 in https://github.com/anthropics/claude-agent-sdk-python/pull/405
chore: release v0.1.16 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/412

New Contributors

@majiayu000 made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/405

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.15...v0.1.16

Open source →

Additional notes

Bug Fixes

Rate limit detection: Fixed parsing of the error field in AssistantMessage, enabling applications to detect and handle API errors like rate limits. Previously, the error field was defined but never populated from CLI responses (#405)

Internal/Other Changes

Updated bundled Claude CLI to version 2.0.68

Open source →

0.1.1511 Dec 2025withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.15/

Installation

pip install claude-agent-sdk==0.1.15

What's Changed

Add license and terms section to README. by @sarahdeaton in https://github.com/anthropics/claude-agent-sdk-python/pull/399
feat: add file checkpointing and rewind_files support by @noahzweben in https://github.com/anthropics/claude-agent-sdk-python/pull/395
chore: release v0.1.15 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/408

New Contributors

@sarahdeaton made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/399

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.14...v0.1.15

Open source →

Additional notes

New Features

File checkpointing and rewind: Added enable_file_checkpointing option to ClaudeAgentOptions and rewind_files(user_message_id) method to ClaudeSDKClient and Query. This enables reverting file changes made during a session back to a specific checkpoint, useful for exploring different approaches or recovering from unwanted modifications (#395)

Documentation

Added license and terms section to README (#399)

Open source →

0.1.149 Dec 2025withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.14/

Installation

pip install claude-agent-sdk==0.1.14

What's Changed

fix: move fetch-depth to publish job and use claude-opus-4-5 for changelog by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/394
chore: release v0.1.14 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/398

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.13...v0.1.14

Open source →

Additional notes

Internal/Other Changes

Updated bundled Claude CLI to version 2.0.62

Open source →

0.1.135 Dec 2025withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.13/

Installation

pip install claude-agent-sdk==0.1.13

What's Changed

fix: add write lock to prevent concurrent transport writes by @CarlosCuevas in https://github.com/anthropics/claude-agent-sdk-python/pull/391
fix: add McpServer runtime placeholder for Pydantic 2.12+ compatibility by @kaminoguo in https://github.com/anthropics/claude-agent-sdk-python/pull/385
fix: propagate CLI errors to pending control requests by @grumpygordon in https://github.com/anthropics/claude-agent-sdk-python/pull/388
chore: release v0.1.13 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/393

New Contributors

@CarlosCuevas made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/391
@kaminoguo made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/385
@grumpygordon made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/388

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.12...v0.1.13

Open source →

Additional notes

Bug Fixes

Faster error handling: CLI errors (e.g., invalid session ID) now propagate to pending requests immediately instead of waiting for the 60-second timeout (#388)
Pydantic 2.12+ compatibility: Fixed PydanticUserError caused by McpServer type only being imported under TYPE_CHECKING (#385)
Concurrent subagent writes: Added write lock to prevent BusyResourceError when multiple subagents invoke MCP tools in parallel (#391)

Internal/Other Changes

Updated bundled Claude CLI to version 2.0.59

Open source →

0.1.124 Dec 2025withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.12/

Installation

pip install claude-agent-sdk==0.1.12

What's Changed

feat: add SDK beta support with SdkBeta type and betas option by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/390
feat: add tools option to ClaudeAgentOptions by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/389
chore: release v0.1.12 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/392

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.11...v0.1.12

Open source →

Additional notes

New Features

Tools option: Added tools option to ClaudeAgentOptions for controlling the base set of available tools, matching the TypeScript SDK functionality. Supports three modes:
- Array of tool names to specify which tools should be available (e.g., ["Read", "Edit", "Bash"])
- Empty array [] to disable all built-in tools
- Preset object {"type": "preset", "preset": "claude_code"} to use the default Claude Code toolset
SDK beta support: Added betas option to ClaudeAgentOptions for enabling Anthropic API beta features. Currently supports "context-1m-2025-08-07" for extended context window

Open source →

0.1.113 Dec 2025withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.11/

Installation

pip install claude-agent-sdk==0.1.11

What's Changed

Create sandbox adapter interface for Python SDK by @ollie-anthropic in https://github.com/anthropics/claude-agent-sdk-python/pull/363
fix: correct mypy type ignore error codes for MCP decorators by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/379
fix: wait for first result before closing stdin if SDK MCP present by @dltn in https://github.com/anthropics/claude-agent-sdk-python/pull/380
feat: bundle claude code CLI for linux arm64 by @jbott in https://github.com/anthropics/claude-agent-sdk-python/pull/373
chore: release v0.1.11 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/383

New Contributors

@ollie-anthropic made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/363
@dltn made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/380
@jbott made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/373

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.10...v0.1.11

Open source →

Additional notes

Internal/Other Changes

Updated bundled Claude CLI to version 2.0.57

Open source →

0.1.1025 Nov 2025withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.10/

Installation

pip install claude-agent-sdk==0.1.10

What's Changed

Use CLAUDE_CODE_STREAM_CLOSE_TIMEOUT (if present) to override initialize() timeout by @mdworsky in https://github.com/anthropics/claude-agent-sdk-python/pull/354
Fix: Fix HookMatcher.timeout type to float by @harupy in https://github.com/anthropics/claude-agent-sdk-python/pull/357
Added slack issue notifier for new opened issues by @noahzweben in https://github.com/anthropics/claude-agent-sdk-python/pull/356
chore: release v0.1.10 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/369

New Contributors

@mdworsky made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/354
@harupy made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/357
@noahzweben made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/356

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.9...v0.1.10

Open source →

Additional notes

Internal/Other Changes

Updated bundled Claude CLI to version 2.0.53

Open source →

0.1.921 Nov 2025withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.9/

Installation

pip install claude-agent-sdk==0.1.9

What's Changed

refactor: source CLI version from code in publish workflow by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/350
feat: add timeout parameter to HookMatcher by @dicksontsai in https://github.com/anthropics/claude-agent-sdk-python/pull/351
Add AssistantMessageError type by @shawnm-anthropic in https://github.com/anthropics/claude-agent-sdk-python/pull/352
chore: release v0.1.9 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/353

New Contributors

@shawnm-anthropic made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/352

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.8...v0.1.9

Open source →

Additional notes

Internal/Other Changes

Updated bundled Claude CLI to version 2.0.49

Open source →

0.1.819 Nov 2025withdrawn: This release will be deleted from PyPI on or after 2026-09-19 to free project storage. Please upgrade to the latest claude-agent-sdk (pip install -U claude-agent-sdk).

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.8/

Installation

pip install claude-agent-sdk==0.1.8

What's Changed

feat: bundle Claude Code CLI in pip package by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/283
fix: remove emojis from build_wheel.py for Windows compatibility by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/342
fix: use PowerShell installer for Windows CLI download by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/343
fix: disable artifact compression to prevent wheel corruption by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/344
fix: install wheel package for retagging platform-specific wheels by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/345
chore: release v0.1.8 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/346

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.7...v0.1.8

Open source →

Additional notes

Features

Claude Code is now included by default in the package, removing the requirement to install it separately. If you do wish to use a separately installed build, use the cli_path field in Options.

Open source →

0.1.718 Nov 2025

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.7/

Installation

pip install claude-agent-sdk==0.1.7

What's Changed

feat: add support for Claude CLI at ~/.claude/local/claude by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/302
Add fallback model handling for parity with TypeScript SDK by @szwang in https://github.com/anthropics/claude-agent-sdk-python/pull/317
feat: add structured output support by @bogini in https://github.com/anthropics/claude-agent-sdk-python/pull/340
chore: release v0.1.7 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/341

New Contributors

@bogini made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/340

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.6...v0.1.7

Open source →

Additional notes

Features

Structured outputs support: Agents can now return validated JSON matching your schema. See https://docs.claude.com/en/docs/agent-sdk/structured-outputs. (#340)
Fallback model handling: Added automatic fallback model handling for improved reliability and parity with the TypeScript SDK. When the primary model is unavailable, the SDK will automatically use a fallback model (#317)
Local Claude CLI support: Added support for using a locally installed Claude CLI from ~/.claude/local/claude, enabling development and testing with custom Claude CLI builds (#302)

Open source →

0.1.631 Oct 2025

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.6/

Installation

pip install claude-agent-sdk==0.1.6

What's Changed

feat: add /generate-changelog slash command by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/287
feat: add max_thinking_tokens option to ClaudeAgentOptions by @blois in https://github.com/anthropics/claude-agent-sdk-python/pull/298
feat: add max_budget_usd option to Python SDK by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/293
Limit CI examples to Python 3.13 only by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/299
Update publish.yml by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/300
fix: uses empty system prompt by default by @yokomotod in https://github.com/anthropics/claude-agent-sdk-python/pull/290
chore: release v0.1.6 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/301

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.5...v0.1.6

Open source →

Additional notes

Features

Max budget control: Added max_budget_usd option to set a maximum spending limit in USD for SDK sessions. When the budget is exceeded, the session will automatically terminate, helping prevent unexpected costs (#293)
Extended thinking configuration: Added max_thinking_tokens option to control the maximum number of tokens allocated for Claude's internal reasoning process. This allows fine-tuning of the balance between response quality and token usage (#298)

Bug Fixes

System prompt defaults: Fixed issue where a default system prompt was being used when none was specified. The SDK now correctly uses an empty system prompt by default, giving users full control over agent behavior (#290)

Open source →

0.1.524 Oct 2025

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.5/

Installation

pip install claude-agent-sdk==0.1.5

What's Changed

feat: add plugin support to Python SDK by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/285
chore: release v0.1.5 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/286

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.4...v0.1.5

Open source →

Additional notes

Features

Plugin support: Added the ability to load Claude Code plugins programmatically through the SDK. Plugins can be specified using the new plugins field in ClaudeAgentOptions with a SdkPluginConfig type that supports loading local plugins by path. This enables SDK applications to extend functionality with custom commands and capabilities defined in plugin directories

Open source →

0.1.415 Oct 2025

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.4/

Installation

pip install claude-agent-sdk==0.1.4

What's Changed

feat: add cli_path support to ClaudeAgentOptions by @cnaples79 in https://github.com/anthropics/claude-agent-sdk-python/pull/235
feat: add pre-push hook for lint checks by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/254
feat: Added base64 image handling to sdk_mcp_server tool calling by @Riehantunut in https://github.com/anthropics/claude-agent-sdk-python/pull/175
feat: add CLAUDE_AGENT_SDK_SKIP_VERSION_CHECK env var by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/257
fix: handle Windows command line length limit for --agents option by @KuaaMU in https://github.com/anthropics/claude-agent-sdk-python/pull/245
fix: fetch all git history including tags in publish workflow by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/284
chore: release v0.1.4 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/260

New Contributors

@cnaples79 made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/235
@Riehantunut made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/175

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.3...v0.1.4

Open source →

Additional notes

Features

Skip version check: Added CLAUDE_AGENT_SDK_SKIP_VERSION_CHECK environment variable to allow users to disable the Claude Code version check. Set this environment variable to skip the minimum version validation when the SDK connects to Claude Code. (Only recommended if you already have Claude Code 2.0.0 or higher installed, otherwise some functionality may break)
SDK MCP server tool calls can now return image content blocks

Open source →

0.1.311 Oct 2025

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.3/

Installation

pip install claude-agent-sdk==0.1.3

What's Changed

fix: convert Python-safe field names (async_, continue_) to CLI format by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/239
feat: add strongly-typed hook inputs with TypedDict by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/240
Revert "chore: temporarily disable Windows CI in test-e2e workflow" by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/241
chore: release v0.1.3 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/242

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.2...v0.1.3

Open source →

Additional notes

Features

Strongly-typed hook inputs: Added typed hook input structures (PreToolUseHookInput, PostToolUseHookInput, UserPromptSubmitHookInput, etc.) using TypedDict for better IDE autocomplete and type safety. Hook callbacks now receive fully typed input parameters

Bug Fixes

Hook output field conversion: Fixed bug where Python-safe field names (async_, continue_) in hook outputs were not being converted to CLI format (async, continue). This caused hook control fields to be silently ignored, preventing proper hook behavior. The SDK now automatically converts field names when communicating with the CLI

Internal/Other Changes

CI/CD: Re-enabled Windows testing in the end-to-end test workflow. Windows CI had been temporarily disabled but is now fully operational across all test suites

Open source →

0.1.210 Oct 2025

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.2/

Installation

pip install claude-agent-sdk==0.1.2

What's Changed

Fix Windows test failures due to path separator issues by @KuaaMU in https://github.com/anthropics/claude-agent-sdk-python/pull/219
Add Windows support to test workflows by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/222
Add CHANGELOG entry for version 0.1.1 by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/229
feat: automate changelog updates in release workflow by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/231
fix #227: Fix PermissionResultAllow conversion to control_response by @vimota in https://github.com/anthropics/claude-agent-sdk-python/pull/232
chore: temporarily disable Windows CI in test-e2e workflow by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/234
Add missing hook output fields to match TypeScript SDK by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/226
chore: release v0.1.2 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/236

New Contributors

@KuaaMU made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/219
@vimota made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/232

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.1...v0.1.2

Open source →

Additional notes

Bug Fixes

Hook output fields: Added missing hook output fields to match the TypeScript SDK, including reason, continue_, suppressOutput, and stopReason. The decision field now properly supports both "approve" and "block" values. Added AsyncHookJSONOutput type for deferred hook execution and proper typing for hookSpecificOutput with discriminated unions

Open source →

0.1.17 Oct 2025

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.1/

Installation

pip install claude-agent-sdk==0.1.1

What's Changed

feat: ClaudeSDKClient supports custom transport. by @jwx0925 in https://github.com/anthropics/claude-agent-sdk-python/pull/187
changelog update by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/192
Update model references to claude-sonnet-4-5 by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/198
Add minimum Claude Code version check (2.0.0+) by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/206
update PermissionResult to match latest control protocol by @ashwin-ant in https://github.com/anthropics/claude-agent-sdk-python/pull/209
chore: bump version to 0.1.1 by @github-actions[bot] in https://github.com/anthropics/claude-agent-sdk-python/pull/210

New Contributors

@jwx0925 made their first contribution in https://github.com/anthropics/claude-agent-sdk-python/pull/187

Full Changelog: https://github.com/anthropics/claude-agent-sdk-python/compare/v0.1.0...v0.1.1

Open source →

Additional notes

Features

Minimum Claude Code version check: Added version validation to ensure Claude Code 2.0.0+ is installed. The SDK will display a warning if an older version is detected, helping prevent compatibility issues
Updated PermissionResult types: Aligned permission result types with the latest control protocol for better type safety and compatibility

Improvements

Model references: Updated all examples and tests to use the simplified claude-sonnet-4-5 model identifier instead of dated version strings

Open source →

0.1.028 Sept 2025

Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.0/

Installation

pip install claude-agent-sdk==0.1.0

What's Changed

feat: improve GitHub release notes generation by @ashwin-ant in https://github.com/anthropics/claude-code-sdk-python/pull/173
feat: add fork_session option for resuming sessions by @blois in https://github.com/anthropics/claude-code-sdk-python/pull/179
feat: add version environment variable by @ashwin-ant in https://github.com/anthropics/claude-code-sdk-python/pull/184
feat: add agents and setting sources support by @ashwin-ant in https://github.com/anthropics/claude-code-sdk-python/pull/182
feat: refactor system_prompt to support preset and append options by @ashwin-ant in https://github.com/anthropics/claude-code-sdk-python/pull/183
Rename ClaudeCodeOptions to ClaudeAgentOptions by @dicksontsai in https://github.com/anthropics/claude-code-sdk-python/pull/185
feat: add dynamic permission mode and model switching to ClaudeSDKClient by @dicksontsai in https://github.com/anthropics/claude-code-sdk-python/pull/171
feat: add stderr callback to capture CLI debug output by @dicksontsai in https://github.com/anthropics/claude-code-sdk-python/pull/170
Rename claude_code to claude_agent by @dicksontsai in https://github.com/anthropics/claude-code-sdk-python/pull/188
refactor: remove unnecessary node installation check by @ashwin-ant in https://github.com/anthropics/claude-code-sdk-python/pull/189
Make CLI buffer limit configurable by @Mng-dev-ai in https://github.com/anthropics/claude-code-sdk-python/pull/190
chore: bump version to 0.1.0 by @github-actions[bot] in https://github.com/anthropics/claude-code-sdk-python/pull/191

New Contributors

@blois made their first contribution in https://github.com/anthropics/claude-code-sdk-python/pull/179

Full Changelog: https://github.com/anthropics/claude-code-sdk-python/compare/v0.0.23...v0.1.0

Open source →

Additional notes

Introducing the Claude Agent SDK! The Claude Code SDK has been renamed to better reflect its capabilities for building AI agents across all domains, not just coding.

Breaking Changes

Type Name Changes

ClaudeCodeOptions renamed to ClaudeAgentOptions: The options type has been renamed to match the new SDK branding. Update all imports and type references:

# Before
from claude_agent_sdk import query, ClaudeCodeOptions
options = ClaudeCodeOptions(...)

# After
from claude_agent_sdk import query, ClaudeAgentOptions
options = ClaudeAgentOptions(...)

System Prompt Changes

Merged prompt options: The custom_system_prompt and append_system_prompt fields have been merged into a single system_prompt field for simpler configuration
No default system prompt: The Claude Code system prompt is no longer included by default, giving you full control over agent behavior. To use the Claude Code system prompt, explicitly set:
```
system_prompt={"type": "preset", "preset": "claude_code"}
```

Settings Isolation

No filesystem settings by default: Settings files (settings.json, CLAUDE.md), slash commands, and subagents are no longer loaded automatically. This ensures SDK applications have predictable behavior independent of local filesystem configurations
Explicit settings control: Use the new setting_sources field to specify which settings locations to load: ["user", "project", "local"]

For full migration instructions, see our migration guide.

New Features

Programmatic subagents: Subagents can now be defined inline in code using the agents option, enabling dynamic agent creation without filesystem dependencies. Learn more
Session forking: Resume sessions with the new fork_session option to branch conversations and explore different approaches from the same starting point. Learn more
Granular settings control: The setting_sources option gives you fine-grained control over which filesystem settings to load, improving isolation for CI/CD, testing, and production deployments

Documentation

Comprehensive documentation now available in the API Guide
New guides for Custom Tools, Permissions, Session Management, and more
Complete Python API reference

0.0.2328 Sept 2025

Published to PyPI: https://pypi.org/project/claude-code-sdk/0.0.23/

Release v0.0.23

Published to PyPI: https://pypi.org/project/claude-code-sdk/0.0.23/

Installation

pip install claude-code-sdk==0.0.23

What's Changed

See the full changelog

Open source →