npm · #3768

@anthropic-ai/claude-agent-sdk

0.3.247anthropics/claude-agent-sdk-typescript ↗

SDK for building AI agents with Claude Code's capabilities. Programmatically interact with Claude to build autonomous agents that can understand codebases, edit files, and execute workflows.

Last release today
26 Aug 2026
Ships on a steady schedule
a new release about every 8 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 months old
279 releases · first in 2025

Release timeline

279 releases since 2025

2026

Releases

0.1.4719 Nov 2025
Release notes
- Updated to parity with Claude Code v2.0.47
- Add error field to some messages
Open source →
0.1.4619 Nov 2025
Release notes
- Updated to parity with Claude Code v2.0.46
Open source →
0.1.4518 Nov 2025
Release notes
- Add support for Microsoft Foundry! See https://code.claude.com/docs/en/azure-ai-foundry
- Structured outputs support. Agents can now return validated JSON matching your schema. See https://platform.claude.com/docs/en/agent-sdk/structured-outputs.
- Updated to parity with Claude Code v2.0.45
Open source →
0.1.4418 Nov 2025
Release notes
- Updated to parity with Claude Code v2.0.44
Open source →
0.1.4317 Nov 2025
Release notes
- Updated to parity with Claude Code v2.0.43
Open source →
0.1.4214 Nov 2025
Release notes
- Updated to parity with Claude Code v2.0.42
Open source →
0.1.3914 Nov 2025
Release notes
- Updated to parity with Claude Code v2.0.41
Open source →
0.1.3710 Nov 2025
Release notes
- Updated to parity with Claude Code v2.0.37
Open source →
0.1.367 Nov 2025
Release notes
- Updated to parity with Claude Code v2.0.36
Open source →
0.1.356 Nov 2025
Release notes
- Updated to parity with Claude Code v2.0.35
Open source →
0.1.345 Nov 2025
Release notes
- Updated to parity with Claude Code v2.0.34
Open source →
0.1.334 Nov 2025
Release notes
- Updated to parity with Claude Code v2.0.33
Open source →
0.1.313 Nov 2025
Release notes
- Updated to parity with Claude Code v2.0.32
Open source →
0.1.3030 Oct 2025
Release notes
- Added --max-budget-usd flag
- Fixed a bug where hooks were sometimes failing in stream mode
- Updated to parity with Claude Code v2.0.31
Open source →
0.1.2929 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.29
Open source →
0.1.2827 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.28
- Fixed a bug where custom tools were timing out after 30 seconds instead of respecting MCP_TOOL_TIMEOUT (anthropics/claude-agent-sdk-typescript#42)
Open source →
0.1.2724 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.27
- Added plugins field to Options
Open source →
0.1.2623 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.26
Open source →
0.1.2521 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.25
- Fixed a bug where project-level skills were not loading when 'project' settings source was specified
- Added skills field to SDKSystemMessage with list of available skills
- Fixed a bug where some exported types were not importing correctly (anthropics/claude-agent-sdk-typescript#39)
Open source →
0.1.2320 Oct 2025
Nothing published for this version
0.1.2217 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.22
Open source →
0.1.2116 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.21
Open source →
0.1.2016 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.20
Open source →
0.1.1915 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.19
Open source →
0.1.1715 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.18
Open source →
0.1.1615 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.17
Open source →
0.1.1514 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.15
- Updated env type to not use Bun Dict type
- Startup performance improvements when using multiple SDK MCP servers
Open source →
0.1.1410 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.14
Open source →
0.1.139 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.13
Open source →
0.1.129 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.12
- Increased SDK MCP channel closure timeout to 60s, addressing anthropics/claude-agent-sdk-typescript#15
Open source →
0.1.118 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.11
Open source →
0.1.107 Oct 2025
Release notes
- Updated to parity with Claude Code v2.0.10
- Added zod ^3.24.1 as peer dependency
Open source →
0.1.96 Oct 2025
Release notes
- Fixed a bug where system prompt was sometimes not getting set correctly: anthropics/claude-agent-sdk-typescript#8
Open source →
0.1.84 Oct 2025
Nothing published for this version
0.1.52 Oct 2025
Nothing published for this version
0.1.230 Sept 2025
Nothing published for this version
0.1.130 Sept 2025
Nothing published for this version
0.1.029 Sept 2025
Release notes
- Merged prompt options: The customSystemPrompt and appendSystemPrompt fields have been merged into a single systemPrompt 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:
- 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 settingSources field to specify which settings locations to load: ["user", "project", "local"]
- 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 forkSession option to branch conversations and explore different approaches from the same starting point. Learn more
- Granular settings control: The settingSources option gives you fine-grained control over which filesystem settings to load, improving isolation for CI/CD, testing, and production deployments
- Comprehensive documentation now available in the API Guide
- New guides for Custom Tools, Permissions, Session Management, and more
- Complete TypeScript API reference
Open source →
0.0.427 Sept 2025
Nothing published for this version