Обзор
Создавайте пользовательских ИИ-агентов с помощью Claude Code SDK
Варианты SDK
Claude Code SDK доступен в нескольких формах для различных случаев использования:
- Режим без интерфейса - Для CLI-скриптов и автоматизации
- TypeScript SDK - Для Node.js и веб-приложений
- Python SDK - Для Python-приложений и науки о данных
Зачем использовать Claude Code SDK?
Построенный на основе агентской платформы, которая питает Claude Code, Claude Code SDK предоставляет все строительные блоки, необходимые для создания готовых к производству агентов:
- Оптимизированная интеграция с Claude: Автоматическое кэширование промптов и оптимизации производительности
- Богатая экосистема инструментов: Файловые операции, выполнение кода, веб-поиск и расширяемость MCP
- Расширенные разрешения: Детальный контроль над возможностями агента
- Основы для производства: Встроенная обработка ошибок, управление сессиями и мониторинг
Что можно создать с помощью SDK?
Вот несколько примеров типов агентов, которых вы можете создать:
Агенты для программирования:
- SRE-агенты, которые диагностируют и исправляют проблемы в производстве
- Боты для проверки безопасности, которые аудируют код на уязвимости
- Помощники дежурных инженеров, которые сортируют инциденты
- Агенты для проверки кода, которые обеспечивают соблюдение стиля и лучших практик
Бизнес-агенты:
- Юридические помощники, которые проверяют контракты и соответствие требованиям
- Финансовые консультанты, которые анализируют отчеты и прогнозы
- Агенты службы поддержки клиентов, которые решают технические проблемы
- Помощники по созданию контента для маркетинговых команд
Основные концепции
Аутентификация
Для базовой аутентификации получите API-ключ Anthropic из Anthropic 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 Code
SDK предоставляет доступ ко всем функциям по умолчанию, доступным в Claude Code, используя ту же конфигурацию на основе файловой системы:
- Субагенты: Запускайте специализированных агентов, сохраненных как Markdown-файлы в
./.claude/agents/
- Хуки: Выполняйте пользовательские команды, настроенные в
./.claude/settings.json
, которые реагируют на события инструментов - Слэш-команды: Используйте пользовательские команды, определенные как Markdown-файлы в
./.claude/commands/
- Память (CLAUDE.md): Поддерживайте контекст проекта через файлы
CLAUDE.md
, которые предоставляют постоянные инструкции и контекст
Эти функции работают идентично своим аналогам в Claude Code, читая из тех же расположений файловой системы.
Системные промпты
Системные промпты определяют роль, экспертизу и поведение вашего агента. Здесь вы указываете, какой тип агента вы создаете.
Разрешения инструментов
Контролируйте, какие инструменты может использовать ваш агент, с помощью детальных разрешений:
allowedTools
- Явно разрешить определенные инструментыdisallowedTools
- Заблокировать определенные инструментыpermissionMode
- Установить общую стратегию разрешений
Model Context Protocol (MCP)
Расширьте своих агентов пользовательскими инструментами и интеграциями через MCP-серверы. Это позволяет подключаться к базам данных, API и другим внешним сервисам.
Связанные ресурсы
- Справочник CLI - Полная документация CLI
- Интеграция с GitHub Actions - Автоматизируйте свой рабочий процесс GitHub
- Документация MCP - Расширьте Claude пользовательскими инструментами
- Общие рабочие процессы - Пошаговые руководства
- Устранение неполадок - Распространенные проблемы и решения