NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #3768 most downloaded on npm
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.
Latest stable
0.3.325
Last release 2 days ago
13 Nov 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
1 years old
345 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Updated to parity with Claude Code v2.1.41
npm install @anthropic-ai/claude-agent-sdk@0.2.41
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.41
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.41
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.41
Updated to parity with Claude Code v2.1.40
Updated to parity with Claude Code v2.1.39
Your coding agent can read these notes before it upgrades. Set up the MCP server →
npm install @anthropic-ai/claude-agent-sdk@0.2.39
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.39
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.39
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.39
Updated to parity with Claude Code v2.1.38
npm install @anthropic-ai/claude-agent-sdk@0.2.38
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.38
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.38
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.38
Updated to parity with Claude Code v2.1.37
npm install @anthropic-ai/claude-agent-sdk@0.2.37
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.37
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.37
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.37
Updated to parity with Claude Code v2.1.36
npm install @anthropic-ai/claude-agent-sdk@0.2.36
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.36
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.36
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.36
Updated to parity with Claude Code v2.1.34
npm install @anthropic-ai/claude-agent-sdk@0.2.34
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.34
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.34
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.34
Added TeammateIdle and TaskCompleted hook events with corresponding TeammateIdleHookInput and TaskCompletedHookInput types
TeammateIdle and TaskCompleted hook events with corresponding TeammateIdleHookInput and TaskCompletedHookInput typessessionId option to specify a custom UUID for conversations instead of auto-generated onesnpm install @anthropic-ai/claude-agent-sdk@0.2.33
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.33
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.33
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.33
Updated to parity with Claude Code v2.1.32
npm install @anthropic-ai/claude-agent-sdk@0.2.32
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.32
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.32
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.32
Added stop_reason field to SDKResultSuccess and SDKResultError to indicate why the model stopped generating
stop_reason field to SDKResultSuccess and SDKResultError to indicate why the model stopped generatingnpm install @anthropic-ai/claude-agent-sdk@0.2.31
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.31
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.31
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.31
Added debug and debugFile options for programmatic control of debug logging
debug and debugFile options for programmatic control of debug loggingpages field to FileReadToolInput for reading specific PDF page rangesparts output type to FileReadToolOutput for page-extracted PDF resultsnpm install @anthropic-ai/claude-agent-sdk@0.2.30
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.30
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.30
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.30
Updated to parity with Claude Code v2.1.29
npm install @anthropic-ai/claude-agent-sdk@0.2.29
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.29
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.29
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.29
Added listSessions function to discover resumable sessions by project, repo, or globally
listSessions function to discover resumable sessions by project, repo, or globallyannotations support to the tool() helper function for specifying MCP tool hints (readOnlyHint, destructiveHint, openWorldHint, idempotentHint)mcpServerStatus() to include tools from SDK and dynamically-added MCP serversnpm install @anthropic-ai/claude-agent-sdk@0.2.27
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.27
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.27
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.27
Nothing published for this version
Updated to parity with Claude Code v2.1.25
npm install @anthropic-ai/claude-agent-sdk@0.2.25
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.25
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.25
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.25
Fixed structured output validation errors not being reported correctly
npm install @anthropic-ai/claude-agent-sdk@0.2.23
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.23
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.23
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.23
Fixed structured outputs to handle empty assistant messsages
npm install @anthropic-ai/claude-agent-sdk@0.2.22
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.22
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.22
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.22
Added config, scope, and tools fields to McpServerStatus for richer server introspection
config, scope, and tools fields to McpServerStatus for richer server introspectionreconnectMcpServer() and toggleMcpServer() methods for managing MCP server connectionsdisabled status to McpServerStatusnpm install @anthropic-ai/claude-agent-sdk@0.2.21
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.21
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.21
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.21
Added support for loading CLAUDE.md files from directories specified via additionalDirectories option (requires setting CLAUDE_CODE_ADDITIONAL_DIRECTO
additionalDirectories option (requires setting CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 in the env option)CLAUDE_CODE_ENABLE_TASKS env var, set to true to opt into the new task systemnpm install @anthropic-ai/claude-agent-sdk@0.2.20
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.20
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.20
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.20
Added CLAUDE_CODE_ENABLE_TASKS env var, set to true to opt into the new task system
CLAUDE_CODE_ENABLE_TASKS env var, set to true to opt into the new task systemnpm install @anthropic-ai/claude-agent-sdk@0.2.19
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.19
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.19
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.19
Nothing published for this version
Updated to parity with Claude Code v2.1.17
npm install @anthropic-ai/claude-agent-sdk@0.2.17
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.17
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.17
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.17
Updated to parity with Claude Code v2.1.16
npm install @anthropic-ai/claude-agent-sdk@0.2.16
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.16
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.16
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.16
Added notification hook support
close() method to Query interface for forcefully terminating running queriesnpm install @anthropic-ai/claude-agent-sdk@0.2.15
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.15
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.15
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.15
Updated to parity with Claude Code v2.1.14
npm install @anthropic-ai/claude-agent-sdk@0.2.14
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.14
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.14
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.14
Updated to parity with Claude Code v2.1.12
npm install @anthropic-ai/claude-agent-sdk@0.2.12
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.12
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.12
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.12
Updated to parity with Claude Code v2.1.11
npm install @anthropic-ai/claude-agent-sdk@0.2.11
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.11
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.11
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.11
Added skills and maxTurns configuration options to custom agent definitions.
skills and maxTurns configuration options to custom agent definitions.Updated to parity with Claude Code v2.1.9
npm install @anthropic-ai/claude-agent-sdk@0.2.9
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.9
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.9
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.9
Updated to parity with Claude Code v2.1.8
Updated to parity with Claude Code v2.1.7
npm install @anthropic-ai/claude-agent-sdk@0.2.7
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.7
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.7
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.7
Updated to parity with Claude Code v2.1.6
claudeCodeVersion field to package.json for programmatically determining compatible CLI versionnpm install @anthropic-ai/claude-agent-sdk@0.2.6
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.6
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.6
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.6
Updated to parity with Claude Code v2.1.5
npm install @anthropic-ai/claude-agent-sdk@0.2.5
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.5
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.5
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.5
Updated to parity with Claude Code v2.1.4
npm install @anthropic-ai/claude-agent-sdk@0.2.4
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.4
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.4
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.4
Updated to parity with Claude Code v2.1.3
npm install @anthropic-ai/claude-agent-sdk@0.2.3
# or
yarn add @anthropic-ai/claude-agent-sdk@0.2.3
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.2.3
# or
bun add @anthropic-ai/claude-agent-sdk@0.2.3
Nothing published for this version
Nothing published for this version
Added error field to McpServerStatus for failed MCP server connections
error field to McpServerStatus for failed MCP server connectionsUpdated to parity with Claude Code v2.0.78
Nothing published for this version
Updated to parity with Claude Code v2.0.75
Updated to parity with Claude Code v2.0.74
npm install @anthropic-ai/claude-agent-sdk@0.1.74
# or
yarn add @anthropic-ai/claude-agent-sdk@0.1.74
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.1.74
# or
bun add @anthropic-ai/claude-agent-sdk@0.1.74
Fixed a bug where Stop hooks would not consistently run due to Stream closed error
Stream closed errornpm install @anthropic-ai/claude-agent-sdk@0.1.73
# or
yarn add @anthropic-ai/claude-agent-sdk@0.1.73
# or
pnpm add @anthropic-ai/claude-agent-sdk@0.1.73
# or
bun add @anthropic-ai/claude-agent-sdk@0.1.73
Fixed /context command not respecting custom system prompts
/context command not respecting custom system promptsreceive() to stream() for consistency with Anthropic SDK patternsAdded zod ^4.0.0 as peer dependency option in addition to zod ^3.24.1
^4.0.0 as peer dependency option in addition to zod ^3.24.1tools option, enable by including 'AskUserQuestion' in listNothing published for this version
Updated to parity with Claude Code v2.0.69
Fixed a bug where disallowed MCP tools were visible to the model
Updated to parity with Claude Code v2.0.67
Fixed project MCP servers from .mcp.json not being available when settingSources includes project
.mcp.json not being available when settingSources includes projectUpdated to parity with Claude Code v2.0.66
Updated to parity with Claude Code v2.0.63
Nothing published for this version
Updated to parity with Claude Code v2.0.61
Updated to parity with Claude Code v2.0.60
Updated to parity with Claude Code v2.0.59
Updated to parity with Claude Code v2.0.58
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.Updated to parity with Claude Code v2.0.57
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).Updated to parity with Claude Code v2.0.56
Update to parity with Claude Code v2.0.55
One column per month.