Перейти к основному содержанию

Обзор

Claude Code SDK был переименован в Claude Agent SDK, и его документация была переорганизована. Это изменение отражает более широкие возможности SDK для создания AI-агентов, выходящих за рамки только задач кодирования.

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

Изменения в документации: Документация Agent SDK переместилась из Claude Code документации в API Guide в отдельный раздел Agent SDK. Документация Claude Code теперь сосредоточена на инструменте CLI и функциях автоматизации.

Шаги миграции

Для проектов TypeScript/JavaScript

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

Для Python проектов

1. Удалите старый пакет:
2. Установите новый пакет:
3. Обновите ваши импорты: Измените все импорты с claude_code_sdk на claude_agent_sdk:
4. Обновите имена типов: Измените ClaudeCodeOptions на ClaudeAgentOptions:
5. Просмотрите критические изменения Внесите необходимые изменения в код для завершения миграции.

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

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

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

Что изменилось: Тип Python SDK ClaudeCodeOptions был переименован в ClaudeAgentOptions. Миграция:
Почему это изменилось: Имя типа теперь соответствует брендингу “Claude Agent SDK” и обеспечивает согласованность в соглашениях об именовании SDK.

Системный промпт больше не используется по умолчанию

Что изменилось: SDK больше не использует системный промпт Claude Code по умолчанию. Миграция:
Почему это изменилось: Обеспечивает лучший контроль и изоляцию для приложений SDK. Теперь вы можете создавать агентов с пользовательским поведением без наследования инструкций, ориентированных на CLI Claude Code.

Значения по умолчанию для источников настроек

Это значение по умолчанию было кратко изменено в v0.1.0, а затем восстановлено, поэтому никаких действий по миграции не требуется. Текущее поведение: Пропуск settingSources в query() загружает пользовательские, проектные и локальные настройки файловой системы, соответствуя CLI. Это включает ~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json, файлы CLAUDE.md и пользовательские команды. Для запуска в изоляции от настроек файловой системы передайте пустой массив:
Изоляция особенно важна для конвейеров CI/CD, развёрнутых приложений, тестовых сред и многопользовательских систем, где локальные настройки не должны просачиваться.
SDK v0.1.0 кратко использовал значение по умолчанию без загруженных настроек; это было восстановлено в последующих выпусках. Python SDK 0.1.59 и более ранние версии обрабатывали пустой список так же, как пропуск опции, поэтому обновитесь перед использованием setting_sources=[]. Смотрите Что settingSources не контролирует для входных данных, которые читаются даже когда settingSources равен [].

Почему переименование?

Claude Code SDK был первоначально разработан для задач кодирования, но он превратился в мощную платформу для создания всех типов AI-агентов. Новое имя “Claude Agent SDK” лучше отражает его возможности:
  • Создание бизнес-агентов (помощники по правовым вопросам, финансовые консультанты, поддержка клиентов)
  • Создание специализированных агентов кодирования (боты SRE, рецензенты безопасности, агенты проверки кода)
  • Разработка пользовательских агентов для любой области с использованием инструментов, интеграции MCP и многого другого

Получение помощи

Если вы столкнулись с какими-либо проблемами во время миграции: Для TypeScript/JavaScript:
  1. Проверьте, что все импорты обновлены для использования @anthropic-ai/claude-agent-sdk
  2. Убедитесь, что ваш package.json содержит новое имя пакета
  3. Запустите npm install, чтобы убедиться, что зависимости обновлены
Для Python:
  1. Проверьте, что все импорты обновлены для использования claude_agent_sdk
  2. Убедитесь, что ваш requirements.txt или pyproject.toml содержит новое имя пакета
  3. Запустите pip install claude-agent-sdk, чтобы убедиться, что пакет установлен

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