​
Обзор

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

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

АспектСтароеНовое
Название пакета (TS/JS)@anthropic-ai/claude-code@anthropic-ai/claude-agent-sdk
Python пакетclaude-code-sdkclaude-agent-sdk
Расположение документацииДокументы Claude Code → раздел SDKРуководство API → раздел Agent SDK
Изменения в документации: Документация Agent SDK была перемещена из документов Claude Code в Руководство API в специальный раздел Agent SDK. Документы Claude Code теперь сосредоточены на инструменте CLI и функциях автоматизации.

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

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

1. Удалите старый пакет: 
npm uninstall @anthropic-ai/claude-code
2. Установите новый пакет: 
npm install @anthropic-ai/claude-agent-sdk
3. Обновите ваши импорты: Измените все импорты с @anthropic-ai/claude-code на @anthropic-ai/claude-agent-sdk: 
// До
import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-code";

// После
import {
  query,
  tool,
  createSdkMcpServer,
} from "@anthropic-ai/claude-agent-sdk";
4. Обновите зависимости в package.json: Если у вас есть пакет в вашем package.json, обновите его: 
// До
{
  "dependencies": {
    "@anthropic-ai/claude-code": "^1.0.0"
  }
}

// После
{
  "dependencies": {
    "@anthropic-ai/claude-agent-sdk": "^0.1.0"
  }
}
Вот и всё! Никаких других изменений в коде не требуется.

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

1. Удалите старый пакет: 
pip uninstall claude-code-sdk
2. Установите новый пакет: 
pip install claude-agent-sdk
3. Обновите ваши импорты: Измените все импорты с claude_code_sdk на claude_agent_sdk: 
# До
from claude_code_sdk import query, ClaudeCodeOptions

# После
from claude_agent_sdk import query, ClaudeAgentOptions
4. Обновите названия типов: Измените ClaudeCodeOptions на ClaudeAgentOptions: 
# До
from claude_agent_sdk import query, ClaudeCodeOptions

options = ClaudeCodeOptions(
    model="claude-sonnet-4-5"
)

# После
from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(
    model="claude-sonnet-4-5"
)
5. Просмотрите критические изменения Внесите необходимые изменения в код для завершения миграции.

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

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

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

Что изменилось: Тип Python SDK ClaudeCodeOptions был переименован в ClaudeAgentOptions. Миграция: 
# ДО (v0.0.x)
from claude_agent_sdk import query, ClaudeCodeOptions

options = ClaudeCodeOptions(
    model="claude-sonnet-4-5",
    permission_mode="acceptEdits"
)

# ПОСЛЕ (v0.1.0)
from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(
    model="claude-sonnet-4-5",
    permission_mode="acceptEdits"
)
Почему это изменилось: Название типа теперь соответствует брендингу “Claude Agent SDK” и обеспечивает согласованность в соглашениях об именовании SDK.

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

Что изменилось: SDK больше не использует системный промпт Claude Code по умолчанию. Миграция: 
// ДО (v0.0.x) - Использовал системный промпт Claude Code по умолчанию
const result = query({ prompt: "Привет" });

// ПОСЛЕ (v0.1.0) - Использует пустой системный промпт по умолчанию
// Чтобы получить старое поведение, явно запросите пресет Claude Code:
const result = query({
  prompt: "Привет",
  options: {
    systemPrompt: { type: "preset", preset: "claude_code" }
  }
});

// Или используйте пользовательский системный промпт:
const result = query({
  prompt: "Привет",
  options: {
    systemPrompt: "Вы полезный помощник по программированию"
  }
});
Почему это изменилось: Обеспечивает лучший контроль и изоляцию для приложений SDK. Теперь вы можете создавать агентов с пользовательским поведением, не наследуя инструкции Claude Code, ориентированные на CLI.

​
Источники настроек больше не загружаются по умолчанию

Что изменилось: SDK больше не читает настройки файловой системы (CLAUDE.md, settings.json, слэш-команды и т.д.) по умолчанию. Миграция: 
// ДО (v0.0.x) - Загружал все настройки автоматически
const result = query({ prompt: "Привет" });
// Читал бы из:
// - ~/.claude/settings.json (пользователь)
// - .claude/settings.json (проект)
// - .claude/settings.local.json (локальный)
// - файлы CLAUDE.md
// - Пользовательские слэш-команды

// ПОСЛЕ (v0.1.0) - Настройки не загружаются по умолчанию
// Чтобы получить старое поведение:
const result = query({
  prompt: "Привет",
  options: {
    settingSources: ["user", "project", "local"]
  }
});

// Или загружайте только определенные источники:
const result = query({
  prompt: "Привет",
  options: {
    settingSources: ["project"]  // Только настройки проекта
  }
});
Почему это изменилось: Обеспечивает предсказуемое поведение приложений SDK независимо от локальных конфигураций файловой системы. Это особенно важно для:
  • Сред CI/CD - Согласованное поведение без локальных настроек
  • Развернутых приложений - Отсутствие зависимости от настроек файловой системы
  • Тестирования - Изолированные тестовые среды
  • Многопользовательских систем - Предотвращение утечки настроек между пользователями
Обратная совместимость: Если ваше приложение полагалось на настройки файловой системы (пользовательские слэш-команды, инструкции CLAUDE.md и т.д.), добавьте settingSources: ['user', 'project', 'local'] в ваши опции.

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

Claude Code SDK изначально был разработан для задач кодирования, но он превратился в мощный фреймворк для создания всех типов ИИ-агентов. Новое название “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, чтобы убедиться, что пакет установлен
См. руководство по Устранению неполадок для решения распространенных проблем.

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