Обзор Agent SDK

Установка

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

Опции SDK

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

• TypeScript SDK - Для приложений Node.js и веб-приложений
• Python SDK - Для приложений Python и науки о данных
• Потоковый режим и одиночный режим - Понимание режимов ввода и лучших практик

Почему использовать 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 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:

• TypeScript SDK: Сообщить об ошибках на GitHub
• Python SDK: Сообщить об ошибках на GitHub

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

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

• TypeScript SDK: Просмотреть CHANGELOG.md
• Python SDK: Просмотреть CHANGELOG.md

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

• Справочник CLI - Полная документация CLI
• Интеграция GitHub Actions - Автоматизируйте ваш рабочий процесс GitHub
• Документация MCP - Расширьте Claude пользовательскими инструментами
• Общие рабочие процессы - Пошаговые руководства
• Устранение неполадок - Распространенные проблемы и решения