​
Зачем использовать Claude Code SDK?

Построенный на основе агентской платформы, которая обеспечивает работу Claude Code, Claude Code SDK предоставляет все строительные блоки, необходимые для создания готовых к производству агентов:

  • Оптимизированная интеграция с Claude: Автоматическое кэширование промптов и оптимизация производительности
  • Богатая экосистема инструментов: Файловые операции, выполнение кода, веб-поиск и расширяемость MCP
  • Расширенные разрешения: Детальный контроль над возможностями агента
  • Основы для производства: Встроенная обработка ошибок, управление сессиями и мониторинг

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

Вот несколько примеров типов агентов, которых вы можете создать:

Агенты для программирования:

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

Бизнес-агенты:

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

​
Варианты SDK

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

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

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

Для базовой аутентификации получите API ключ Anthropic из Консоли Anthropic и установите переменную окружения 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.

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

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

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

Контролируйте, какие инструменты может использовать ваш агент, с помощью детальных разрешений:

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

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

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

​
Общие случаи использования

​
Автоматизированное тестирование и CI/CD

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

​
Проверка кода и аудит безопасности

Создавайте агентов, которые проверяют pull request’ы на уязвимости безопасности, качество кода и соответствие требованиям.

​
Реагирование на инциденты

Развертывайте SRE агентов, которые диагностируют проблемы в производстве, анализируют логи и предлагают исправления.

​
Генерация документации

Создавайте агентов, которые генерируют и поддерживают документацию на основе вашей кодовой базы.

​
Анализ данных

Создавайте агентов, которые анализируют данные, генерируют отчеты и создают визуализации.

​
Лучшие практики

  • Используйте формат вывода JSON для программного разбора ответов
  • Обрабатывайте ошибки корректно - проверяйте коды выхода и реализуйте логику повторных попыток
  • Используйте управление сессиями для поддержания контекста в многоходовых разговорах
  • Реализуйте таймауты для долго выполняющихся операций
  • Соблюдайте ограничения скорости при выполнении множественных запросов
  • Тщательно тестируйте перед развертыванием в производство

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