Обзор
Claude Code SDK был переименован в Claude Agent SDK, а его документация была реорганизована. Это изменение отражает более широкие возможности SDK для создания ИИ-агентов, выходящие за рамки задач программирования. Вы переходите не с Claude Code SDK, а с OpenAI Agents SDK? Рецепт миграции с OpenAI Agents SDK сопоставляет каждый примитив с Claude Agent SDK на одном подробно разобранном примере.Что изменилось
Этапы миграции
Миграция проекта TypeScript или JavaScript
1. Удалите старый пакет:@anthropic-ai/claude-code на @anthropic-ai/claude-agent-sdk:
@anthropic-ai/claude-code всё ещё указан в вашем package.json, замените его на @anthropic-ai/claude-agent-sdk и также обновите диапазон версий, например с "^0.0.42" на "^0.3.0".
5. Ознакомьтесь с критическими изменениями
Внесите необходимые изменения в код для завершения миграции.
Миграция проекта Python
1. Удалите старый пакет:WARNING: Skipping claude-code-sdk as it is not installed. Это нормально, и вы можете перейти к следующему этапу.
2. Установите новый пакет:
claude-code-sdk указан в вашем requirements.txt или pyproject.toml, замените его на claude-agent-sdk.
3. Обновите ваши импорты:
Измените все импорты с claude_code_sdk на claude_agent_sdk:
Критические изменения
Python: ClaudeCodeOptions переименован в ClaudeAgentOptions
Что изменилось: Тип Python SDKClaudeCodeOptions был переименован в ClaudeAgentOptions.
Миграция:
Системный промпт больше не используется по умолчанию
Что изменилось: SDK больше не использует системный промпт Claude Code по умолчанию. Миграция:Источники параметров по умолчанию
Это значение по умолчанию было кратко изменено в v0.1.0 для загрузки без параметров файловой системы, а затем восстановлено, поэтому никаких действий по миграции не требуется. Текущее поведение: ПропускsettingSources в query() загружает параметры пользователя, проекта и локальной файловой системы, соответствуя CLI. Это включает ~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json, файлы CLAUDE.md и пользовательские команды.
Для работы в изоляции от параметров файловой системы передайте settingSources: [] или setting_sources=[] в Python. См. Управление параметрами файловой системы с помощью settingSources для информации о том, что загружает каждый источник.
Изоляция особенно важна для конвейеров CI/CD, развёрнутых приложений, тестовых сред и многопользовательских систем, где локальные настройки не должны утекать.
Python SDK 0.1.59 и более ранние версии обрабатывали пустой список так же, как пропуск опции, поэтому обновитесь перед использованием
setting_sources=[]. См. Что settingSources не контролирует для входных данных, которые читаются даже когда settingSources равен [].Следующие шаги
- Изучите Обзор Agent SDK, чтобы узнать о доступных функциях
- Ознакомьтесь со Справочником TypeScript SDK для подробной документации API
- Просмотрите Справочник Python SDK для документации, специфичной для Python
- Узнайте о Пользовательских инструментах и Интеграции MCP