Skip to main content

Обзор

Claude Code SDK был переименован в Claude Agent SDK, а его документация была реорганизована. Это изменение отражает более широкие возможности SDK для создания ИИ-агентов, выходящие за рамки задач программирования. Вы переходите не с Claude Code SDK, а с OpenAI Agents SDK? Рецепт миграции с OpenAI Agents SDK сопоставляет каждый примитив с Claude Agent SDK на одном подробно разобранном примере.

Что изменилось

Этапы миграции

Миграция проекта TypeScript или JavaScript

1. Удалите старый пакет:
2. Установите новый пакет:
3. Обновите ваши импорты: Измените все импорты с @anthropic-ai/claude-code на @anthropic-ai/claude-agent-sdk:
4. Обновите package.json: Если @anthropic-ai/claude-code всё ещё указан в вашем package.json, замените его на @anthropic-ai/claude-agent-sdk и также обновите диапазон версий, например с "^0.0.42" на "^0.3.0". 5. Ознакомьтесь с критическими изменениями Внесите необходимые изменения в код для завершения миграции.

Миграция проекта Python

1. Удалите старый пакет:
Если старый пакет не установлен, pip выведет 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:
4. Ознакомьтесь с критическими изменениями Внесите необходимые изменения в код для завершения миграции.

Критические изменения

Для улучшения изоляции и явной конфигурации Claude Agent SDK v0.1.0 вводит критические изменения для пользователей, переходящих с Claude Code SDK.

Python: ClaudeCodeOptions переименован в ClaudeAgentOptions

Что изменилось: Тип Python SDK ClaudeCodeOptions был переименован в 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 равен [].

Следующие шаги