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 и установите переменную окружения 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 Code

SDK предоставляет доступ ко всем стандартным функциям, доступным в Claude Code, используя ту же конфигурацию на основе файловой системы:
  • Подагенты: Запускайте специализированных агентов, сохраненных как Markdown-файлы в ./.claude/agents/
  • Хуки: Выполняйте пользовательские команды, настроенные в ./.claude/settings.json, которые реагируют на события инструментов
  • Слэш-команды: Используйте пользовательские команды, определенные как Markdown-файлы в ./.claude/commands/
  • Память (CLAUDE.md): Поддерживайте контекст проекта через файлы CLAUDE.md, которые предоставляют постоянные инструкции и контекст
Эти функции работают идентично своим аналогам в Claude Code, читая из тех же расположений файловой системы.

​
Системные промпты

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

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

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

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

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

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

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

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