Migrate to Claude Agent SDK changedagent-sdk/migration-guide
Nearest release: v2.1.296, published 3 hours before upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Upstream edited this page at 9 Oct 2026 20:45 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 22 Oct 2026 18:07 UTC.
Upstream edited
Recorded here
Lines+7added
Lines−7removed
From line
14
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits9to this page, all time
The whole hunk
from line 14, old and new numbered
/
from line 14
1414| :- | :- | :- |
1515| **Package Name (TS/JS)** | `@anthropic-ai/claude-code` | `@anthropic-ai/claude-agent-sdk` |
1616| **Python Package** | `claude-code-sdk` | `claude-agent-sdk` |
17| **Documentation Location** | Claude Code docs | Claude Code docs → dedicated [Agent SDK](/docs/en/agent-sdk/overview) section |
17| **Documentation Location** | Claude Code docs | Claude Code docs → dedicated [Agent SDK](/docs/en/agent-sdk/overview.md) section |
1818
1919## Migration Steps
2020
from line 177
177177
178178**Current behavior:** Omitting `settingSources` on `query()` loads user, project, and local filesystem settings, matching the CLI. This includes `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, CLAUDE.md files, and custom commands.
179179
180To run isolated from filesystem settings, pass `settingSources: []`, or `setting_sources=[]` in Python. See [Control filesystem settings with settingSources](/docs/en/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) for what each source loads.
180To run isolated from filesystem settings, pass `settingSources: []`, or `setting_sources=[]` in Python. See [Control filesystem settings with settingSources](/docs/en/agent-sdk/claude-code-features.md#control-filesystem-settings-with-settingsources) for what each source loads.
181181
182182Isolation is especially important for CI/CD pipelines, deployed applications, test environments, and multi-tenant systems where local customizations should not leak in.
183183
184184> [!NOTE]
185185>
186> Python SDK 0.1.59 and earlier treated an empty list the same as omitting the option, so upgrade before relying on `setting_sources=[]`. See [What settingSources does not control](/docs/en/agent-sdk/claude-code-features#what-settingsources-does-not-control) for inputs that are read even when `settingSources` is `[]`.
186> Python SDK 0.1.59 and earlier treated an empty list the same as omitting the option, so upgrade before relying on `setting_sources=[]`. See [What settingSources does not control](/docs/en/agent-sdk/claude-code-features.md#what-settingsources-does-not-control) for inputs that are read even when `settingSources` is `[]`.
187187
188188## Next Steps
189189
190* Explore the [Agent SDK Overview](/docs/en/agent-sdk/overview) to learn about available features
191* Check out the [TypeScript SDK Reference](/docs/en/agent-sdk/typescript) for detailed API documentation
192* Review the [Python SDK Reference](/docs/en/agent-sdk/python) for Python-specific documentation
193* Learn about [Custom Tools](/docs/en/agent-sdk/custom-tools) and [MCP Integration](/docs/en/agent-sdk/mcp)
190* Explore the [Agent SDK Overview](/docs/en/agent-sdk/overview.md) to learn about available features
191* Check out the [TypeScript SDK Reference](/docs/en/agent-sdk/typescript.md) for detailed API documentation
192* Review the [Python SDK Reference](/docs/en/agent-sdk/python.md) for Python-specific documentation
193* Learn about [Custom Tools](/docs/en/agent-sdk/custom-tools.md) and [MCP Integration](/docs/en/agent-sdk/mcp.md)
194194
No line in this hunk matches that.