PackageTrack

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.

Release timeline

279 releases since 2025
2026

Releases

  1. 0.2.346 Feb 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.34

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.34
    Open source →
  2. 0.2.336 Feb 2026
    Release notes

    What's changed

    • Added TeammateIdle and TaskCompleted hook events with corresponding TeammateIdleHookInput and TaskCompletedHookInput types
    • Added sessionId option to specify a custom UUID for conversations instead of auto-generated ones
    • Updated to parity with Claude Code v2.1.33

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Added TeammateIdle and TaskCompleted hook events with corresponding TeammateIdleHookInput and TaskCompletedHookInput types
    • Added sessionId option to specify a custom UUID for conversations instead of auto-generated ones
    • Updated to parity with Claude Code v2.1.33
    Open source →
  3. 0.2.325 Feb 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.32

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.32
    Open source →
  4. 0.2.314 Feb 2026
    Release notes

    What's changed

    • Added stop_reason field to SDKResultSuccess and SDKResultError to indicate why the model stopped generating

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Added stop_reason field to SDKResultSuccess and SDKResultError to indicate why the model stopped generating
    Open source →
  5. 0.2.303 Feb 2026
    Release notes

    What's changed

    • Added debug and debugFile options for programmatic control of debug logging
    • Added optional pages field to FileReadToolInput for reading specific PDF page ranges
    • Added parts output type to FileReadToolOutput for page-extracted PDF results
    • Fixed "(no content)" placeholder messages being included in SDK output

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Added debug and debugFile options for programmatic control of debug logging
    • Added optional pages field to FileReadToolInput for reading specific PDF page ranges
    • Added parts output type to FileReadToolOutput for page-extracted PDF results
    • Fixed "(no content)" placeholder messages being included in SDK output
    Open source →
  6. 0.2.2931 Jan 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.29

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.29
    Open source →
  7. 0.2.2730 Jan 2026
    Release notes

    What's changed

    • Added listSessions function to discover resumable sessions by project, repo, or globally
    • Added optional annotations support to the tool() helper function for specifying MCP tool hints (readOnlyHint, destructiveHint, openWorldHint, idempotentHint)
    • Fixed mcpServerStatus() to include tools from SDK and dynamically-added MCP servers
    • Updated to parity with Claude Code v2.1.27

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Added optional annotations support to the tool() helper function for specifying MCP tool hints (readOnlyHint, destructiveHint, openWorldHint, idempotentHint)
    • Fixed mcpServerStatus() to include tools from SDK and dynamically-added MCP servers
    • Updated to parity with Claude Code v2.1.27
    Open source →
  8. 0.2.2630 Jan 2026

    Nothing published for this version

  9. 0.2.2529 Jan 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.25

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.25
    Open source →
  10. 0.2.2329 Jan 2026
    Release notes

    What's changed

    • Fixed structured output validation errors not being reported correctly
    • Updated to parity with Claude Code v2.1.23

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Fixed structured output validation errors not being reported correctly
    • Updated to parity with Claude Code v2.1.23
    Open source →
  11. 0.2.2228 Jan 2026
    Release notes

    What's changed

    • Fixed structured outputs to handle empty assistant messsages
    • Updated to parity with Claude Code v2.1.22

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Fixed structured outputs to handle empty assistant messsages
    • Updated to parity with Claude Code v2.1.22
    Open source →
  12. 0.2.2128 Jan 2026
    Release notes

    What's changed

    • Added config, scope, and tools fields to McpServerStatus for richer server introspection
    • Added reconnectMcpServer() and toggleMcpServer() methods for managing MCP server connections
    • Added disabled status to McpServerStatus
    • Fixed PermissionRequest hooks not being executed in SDK mode (e.g., VS Code extension)
    • Updated to parity with Claude Code v2.1.21

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Added config, scope, and tools fields to McpServerStatus for richer server introspection
    • Added reconnectMcpServer() and toggleMcpServer() methods for managing MCP server connections
    • Added disabled status to McpServerStatus
    • Fixed PermissionRequest hooks not being executed in SDK mode (e.g., VS Code extension)
    • Updated to parity with Claude Code v2.1.21
    Open source →
  13. 0.2.2027 Jan 2026
    Release notes

    What's changed

    • Added support for loading CLAUDE.md files from directories specified via additionalDirectories option (requires setting CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 in the env option)
    • Added CLAUDE_CODE_ENABLE_TASKS env var, set to true to opt into the new task system
    • Updated to parity with Claude Code v2.1.20

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Added support for loading CLAUDE.md files from directories specified via additionalDirectories option (requires setting CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 in the env option)
    • Added CLAUDE_CODE_ENABLE_TASKS env var, set to true to opt into the new task system
    • Updated to parity with Claude Code v2.1.20
    Open source →
  14. 0.2.1923 Jan 2026
    Release notes

    What's changed

    • Added CLAUDE_CODE_ENABLE_TASKS env var, set to true to opt into the new task system

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Added CLAUDE_CODE_ENABLE_TASKS env var, set to true to opt into the new task system
    Open source →
  15. 0.2.1822 Jan 2026

    Nothing published for this version

  16. 0.2.1722 Jan 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.17

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.17
    Open source →
  17. 0.2.1622 Jan 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.16

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.16
    Open source →
  18. 0.2.1521 Jan 2026
    Release notes

    What's changed

    • Added notification hook support
    • Added close() method to Query interface for forcefully terminating running queries
    • Updated to parity with Claude Code v2.1.15

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Added notification hook support
    • Added close() method to Query interface for forcefully terminating running queries
    • Updated to parity with Claude Code v2.1.15
    Open source →
  19. 0.2.1420 Jan 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.14

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.14
    Open source →
  20. 0.2.1217 Jan 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.12

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.12
    Open source →
  21. 0.2.1117 Jan 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.11

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.11
    Open source →
  22. 0.2.1017 Jan 2026
    Release notes
    • Added skills and maxTurns configuration options to custom agent definitions.
    Open source →
  23. 0.2.916 Jan 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.9

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.9
    Open source →
  24. 0.2.815 Jan 2026
    Release notes
    • Updated to parity with Claude Code v2.1.8
    Open source →
  25. 0.2.713 Jan 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.7

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.7
    Open source →
  26. 0.2.613 Jan 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.6
    • Added claudeCodeVersion field to package.json for programmatically determining compatible CLI version

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.6
    • Added claudeCodeVersion field to package.json for programmatically determining compatible CLI version
    Open source →
  27. 0.2.511 Jan 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.5

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.5
    Open source →
  28. 0.2.410 Jan 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.4

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.4
    Open source →
  29. 0.2.39 Jan 2026
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.1.3

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.1.3
    Open source →
  30. 0.2.28 Jan 2026

    Nothing published for this version

  31. 0.2.17 Jan 2026

    Nothing published for this version

  32. 0.2.07 Jan 2026
    Release notes
    • Added error field to McpServerStatus for failed MCP server connections
    • Updated to parity with Claude Code v2.1.0
    Open source →
  33. 0.1.776 Jan 2026
    Release notes
    • Updated to parity with Claude Code v2.0.78
    Open source →
  34. 0.1.7622 Dec 2025

    Nothing published for this version

  35. 0.1.7520 Dec 2025
    Release notes
    • Updated to parity with Claude Code v2.0.75
    Open source →
  36. 0.1.7419 Dec 2025
    Release notes

    What's changed

    • Updated to parity with Claude Code v2.0.74

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Updated to parity with Claude Code v2.0.74
    Open source →
  37. 0.1.7318 Dec 2025
    Release notes

    What's changed

    • Fixed a bug where Stop hooks would not consistently run due to Stream closed error
    • Updated to parity with Claude Code v2.0.73

    Update

    npm install @anthropic-ai/[email protected]
# or
yarn add @anthropic-ai/[email protected]
# or
pnpm add @anthropic-ai/[email protected]
# or
bun add @anthropic-ai/[email protected]
    Open source →
    Additional notes
    • Fixed a bug where Stop hooks would not consistently run due to Stream closed error
    • Updated to parity with Claude Code v2.0.73
    Open source →
  38. 0.1.7217 Dec 2025
    Release notes2 sources agree
    • Fixed /context command not respecting custom system prompts
    • Fixed non-streaming single-turn queries to close immediately on first result instead of waiting for inactivity timeout
    • Changed V2 session API method receive() to stream() for consistency with Anthropic SDK patterns
    • Updated to parity with Claude Code v2.0.72
    Open source →
  39. 0.1.7116 Dec 2025
    Release notes
    • Added zod ^4.0.0 as peer dependency option in addition to zod ^3.24.1
    • Added support for AskUserQuestion tool. If using tools option, enable by including 'AskUserQuestion' in list
    • Fixed visible console window appearing when spawning Claude subprocess on Windows
    • Fixed spawn message being sent to stderr callback (anthropics/claude-agent-sdk-typescript#45)
    • Updated to parity with Claude Code v2.0.71
    Open source →
  40. 0.1.7015 Dec 2025

    Nothing published for this version

  41. 0.1.6913 Dec 2025
    Release notes
    • Updated to parity with Claude Code v2.0.69
    Open source →
  42. 0.1.6812 Dec 2025
    Release notes
    • Fixed a bug where disallowed MCP tools were visible to the model
    • Updated to parity with Claude Code v2.0.68
    Open source →
  43. 0.1.6711 Dec 2025
    Release notes
    • Updated to parity with Claude Code v2.0.67
    Open source →
  44. 0.1.6611 Dec 2025
    Release notes
    • Fixed project MCP servers from .mcp.json not being available when settingSources includes project
    • Updated to parity with Claude Code v2.0.66
    Open source →
  45. 0.1.6511 Dec 2025
    Release notes
    • Updated to parity with Claude Code v2.0.66
    Open source →
  46. 0.1.639 Dec 2025
    Release notes
    • Updated to parity with Claude Code v2.0.63
    Open source →
  47. 0.1.629 Dec 2025

    Nothing published for this version

  48. 0.1.617 Dec 2025
    Release notes
    • Updated to parity with Claude Code v2.0.61
    Open source →
  49. 0.1.605 Dec 2025
    Release notes
    • Updated to parity with Claude Code v2.0.60
    Open source →
  50. 0.1.594 Dec 2025
    Release notes
    • Updated to parity with Claude Code v2.0.59
    Open source →
  51. 0.1.583 Dec 2025
    Release notes
    • Updated to parity with Claude Code v2.0.58
    • Added betas option to enable beta features. Currently supports 'context-1m-2025-08-07' for 1M token context window on Sonnet 4/4.5. See https://platform.claude.com/docs/en/api/beta-headers for more details.
    Open source →
  52. 0.1.573 Dec 2025
    Release notes
    • Updated to parity with Claude Code v2.0.57
    • Added tools option to specify the exact set of built-in tools available to the agent. Use tools: ['Bash', 'Read', 'Edit'] for a strict allowlist, tools: [] to disable all built-in tools, or tools: { type: 'preset', preset: 'claude_code' } for all default tools. Omitting this option preserves existing behavior where all built-in tools are available (and can be filtered with disallowedTools).
    Open source →
  53. 0.1.561 Dec 2025
    Release notes
    • Updated to parity with Claude Code v2.0.56
    Open source →
  54. 0.1.5526 Nov 2025
    Release notes
    • Update to parity with Claude Code v2.0.55
    Open source →
  55. 0.1.5426 Nov 2025
    Release notes
    • Updated to parity with Claude Code v2.0.54
    • Added experimental v2 session APIs (unstable_v2_createSession, unstable_v2_resumeSession, unstable_v2_prompt) for simpler multi-turn conversations
    • Fixed a bug where ExitPlanMode tool input was empty
    Open source →
  56. 0.1.5325 Nov 2025
    Release notes
    • Updated to parity with Claude Code v2.0.53
    Open source →
  57. 0.1.5224 Nov 2025
    Release notes
    • Updated to parity with Claude Code v2.0.52
    Open source →
  58. 0.1.5124 Nov 2025
    Release notes
    • Updated to parity with Claude Code v2.0.51
    • Added support for Opus 4.5! https://www.anthropic.com/news/claude-opus-4-5
    Open source →
  59. 0.1.5021 Nov 2025
    Release notes
    • Updated to parity with Claude Code v2.0.50
    Open source →
  60. 0.1.4921 Nov 2025
    Release notes
    • Updated to parity with Claude Code v2.0.49
    Open source →