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