Skip to content

Commit 59f4412

Browse files
ashwin-antclaude
andcommitted
Add v0.1.0 changelog entry for Python SDK with comprehensive release documentation
Document breaking changes including ClaudeCodeOptions rename, system prompt changes, and settings isolation. Include new features like programmatic subagents, session forking, and granular settings control. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 9d4659c commit 59f4412

File tree

1 file changed

+47
-0
lines changed

1 file changed

+47
-0
lines changed

CHANGELOG.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,52 @@
11
# Changelog
22

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+
350
## 0.0.22
451

552
- Introduce custom tools, implemented as in-process MCP servers.

0 commit comments

Comments
 (0)