Claude Code SDK был переименован в Claude Agent SDK. Если вы переходите со старого SDK, см. Руководство по миграции.

​
Установка

npm install @anthropic-ai/claude-agent-sdk

​
Опции SDK

Claude Agent SDK доступен в нескольких формах для различных вариантов использования:

​
Почему использовать Claude Agent SDK?

Построенный на основе агентского каркаса, который питает Claude Code, Claude Agent SDK предоставляет все строительные блоки, необходимые для создания готовых к производству агентов. Используя преимущества работы, проделанной нами над Claude Code, включая:
  • Управление контекстом: Автоматическое сжатие и управление контекстом, чтобы ваш агент не исчерпал контекст.
  • Богатая экосистема инструментов: Операции с файлами, выполнение кода, веб-поиск и расширяемость MCP
  • Продвинутые разрешения: Точный контроль над возможностями агента
  • Основные элементы производства: Встроенная обработка ошибок, управление сеансами и мониторинг
  • Оптимизированная интеграция Claude: Автоматическое кэширование подсказок и оптимизация производительности

​
Что вы можете создать с помощью SDK?

Вот некоторые примеры типов агентов, которые вы можете создать: Агенты кодирования:
  • SRE-агенты, которые диагностируют и исправляют проблемы в производстве
  • Боты проверки безопасности, которые проверяют код на уязвимости
  • Помощники инженеров по вызовам, которые сортируют инциденты
  • Агенты проверки кода, которые обеспечивают соблюдение стиля и лучших практик
Бизнес-агенты:
  • Юридические помощники, которые проверяют контракты и соответствие нормативным требованиям
  • Финансовые консультанты, которые анализируют отчеты и прогнозы
  • Агенты поддержки клиентов, которые решают технические проблемы
  • Помощники по созданию контента для маркетинговых команд

​
Основные концепции

​
Аутентификация

Для базовой аутентификации получите ключ API Claude из Claude Console и установите переменную окружения ANTHROPIC_API_KEY. SDK также поддерживает аутентификацию через поставщиков API третьих сторон:
  • Amazon Bedrock: Установите переменную окружения CLAUDE_CODE_USE_BEDROCK=1 и настройте учетные данные AWS
  • Google Vertex AI: Установите переменную окружения CLAUDE_CODE_USE_VERTEX=1 и настройте учетные данные Google Cloud
Для получения подробных инструкций по конфигурации для поставщиков третьих сторон см. документацию Amazon Bedrock и Google Vertex AI.
Если не одобрено ранее, мы не разрешаем разработчикам третьих сторон применять ограничения скорости Claude.ai для своих продуктов, включая агентов, созданных на Claude Agent SDK. Вместо этого используйте методы аутентификации с ключом API, описанные в этом документе.

​
Полная поддержка функций Claude Code

SDK предоставляет доступ ко всем функциям по умолчанию, доступным в Claude Code, используя ту же конфигурацию на основе файловой системы:
  • Подагенты: Запускайте специализированные агенты, хранящиеся как файлы Markdown в ./.claude/agents/
  • Навыки агента: Расширьте Claude специализированными возможностями, хранящимися как файлы SKILL.md в ./.claude/skills/
  • Хуки: Выполняйте пользовательские команды, настроенные в ./.claude/settings.json, которые реагируют на события инструментов
  • Косые команды: Используйте пользовательские команды, определенные как файлы Markdown в ./.claude/commands/
  • Плагины: Загружайте пользовательские плагины программно, используя опцию plugins, чтобы расширить Claude Code пользовательскими командами, агентами, навыками, хуками и MCP-серверами. Подробнее см. Плагины.
  • Память (CLAUDE.md): Поддерживайте контекст проекта через файлы CLAUDE.md или .claude/CLAUDE.md в каталоге вашего проекта, или ~/.claude/CLAUDE.md для инструкций на уровне пользователя. Чтобы загрузить эти файлы, вы должны явно установить settingSources: ['project'] (TypeScript) или setting_sources=["project"] (Python) в ваших опциях. Подробнее см. Изменение системных подсказок.
Эти функции работают идентично своим аналогам Claude Code, читая из одних и тех же местоположений файловой системы.

​
Системные подсказки

Системные подсказки определяют роль, опыт и поведение вашего агента. Здесь вы указываете, какой тип агента вы создаете.

​
Разрешения инструментов

Контролируйте, какие инструменты может использовать ваш агент, с помощью точных разрешений:
  • allowedTools - Явно разрешить определенные инструменты
  • disallowedTools - Заблокировать определенные инструменты
  • permissionMode - Установить общую стратегию разрешений

​
Протокол контекста модели (MCP)

Расширьте своих агентов пользовательскими инструментами и интеграциями через MCP-серверы. Это позволяет вам подключаться к базам данных, API и другим внешним сервисам.

​
Сообщение об ошибках

Если вы столкнулись с ошибками или проблемами с Agent SDK:

​
Журнал изменений

Просмотрите полный журнал изменений для обновлений SDK, исправлений ошибок и новых функций:

​
Связанные ресурсы