|
1 | 1 | # Changelog |
2 | 2 |
|
| 3 | +All notable changes to the Claude Agent SDK will be documented in this file. |
| 4 | + |
| 5 | +## 0.1.0 - 2025-09-29 |
| 6 | + |
| 7 | +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. |
| 8 | + |
| 9 | +### Breaking Changes |
| 10 | + |
| 11 | +#### Type Name Changes |
| 12 | +- **ClaudeCodeOptions renamed to ClaudeAgentOptions**: The options type has been renamed to match the new SDK branding. Update all imports and type references: |
| 13 | + ```python |
| 14 | + # Before |
| 15 | + from claude_agent_sdk import query, ClaudeCodeOptions |
| 16 | + options = ClaudeCodeOptions(...) |
| 17 | + |
| 18 | + # After |
| 19 | + from claude_agent_sdk import query, ClaudeAgentOptions |
| 20 | + options = ClaudeAgentOptions(...) |
| 21 | + ``` |
| 22 | + |
| 23 | +#### System Prompt Changes |
| 24 | +- **Merged prompt options**: The `custom_system_prompt` and `append_system_prompt` fields have been merged into a single `system_prompt` field for simpler configuration |
| 25 | +- **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: |
| 26 | + ```python |
| 27 | + system_prompt={"type": "preset", "preset": "claude_code"} |
| 28 | + ``` |
| 29 | + |
| 30 | +#### Settings Isolation |
| 31 | +- **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 |
| 32 | +- **Explicit settings control**: Use the new `setting_sources` field to specify which settings locations to load: `["user", "project", "local"]` |
| 33 | + |
| 34 | +For full migration instructions, see our [migration guide](https://docs.claude.com/en/docs/claude-code/sdk/migration-guide). |
| 35 | + |
| 36 | +### New Features |
| 37 | + |
| 38 | +- **Programmatic subagents**: Subagents can now be defined inline in code using the `agents` option, enabling dynamic agent creation without filesystem dependencies. [Learn more](https://docs.claude.com/en/api/agent-sdk/subagents) |
| 39 | +- **Session forking**: Resume sessions with the new `fork_session` option to branch conversations and explore different approaches from the same starting point. [Learn more](https://docs.claude.com/en/api/agent-sdk/sessions) |
| 40 | +- **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 |
| 41 | + |
| 42 | +### Documentation |
| 43 | + |
| 44 | +- Comprehensive documentation now available in the [API Guide](https://docs.claude.com/en/api/agent-sdk/overview) |
| 45 | +- New guides for [Custom Tools](https://docs.claude.com/en/api/agent-sdk/custom-tools), [Permissions](https://docs.claude.com/en/api/agent-sdk/permissions), [Session Management](https://docs.claude.com/en/api/agent-sdk/sessions), and more |
| 46 | +- Complete [Python API reference](https://docs.claude.com/en/api/agent-sdk/python) |
| 47 | + |
| 48 | +--- |
| 49 | + |
3 | 50 | ## 0.0.22 |
4 | 51 |
|
5 | 52 | - Introduce custom tools, implemented as in-process MCP servers. |
|
0 commit comments