Обзор Agent SDK
Создавайте производственные AI-агентов с Claude Code как библиотеку
Агент — это приложение, которое выполняет задачу, планируя собственные шаги и вызывая инструменты, которые читают файлы, запускают команды или редактируют код. Agent SDK предоставляет вам те же инструменты, цикл агента и управление контекстом, которые питают Claude Code, программируемые на Python и TypeScript.
Сравнение Agent SDK с другими инструментами Claude
Agent SDK, CLI, Client SDK и Managed Agents подходят для разных потребностей. Используйте таблицу, чтобы найти тот, который соответствует тому, что вы создаёте.
| Если вы... | Используйте | Почему |
|---|---|---|
| Создаёте агента без самостоятельной реализации цикла инструментов | Agent SDK | Библиотека Python или TypeScript, которая запускает цикл агента для вас. |
| Занимаетесь интерактивной разработкой или запускаете одноразовые задачи из терминала | Claude Code CLI | Интерфейс терминала, созданный для ежедневного интерактивного использования. |
| Вызываете API напрямую и реализуете цикл инструментов самостоятельно | Client SDK | Прямой доступ к API Anthropic вместо Claude Code. Вы реализуете цикл инструментов самостоятельно. |
| Запускаете долгоживущих или асинхронных агентов без управления собственной инфраструктурой sandbox или сессии | Managed Agents | Размещённый REST API, отдельный продукт от Agent SDK. Anthropic запускает агента и sandbox. |
SDK доступен как библиотека только для Python и TypeScript. Чтобы запустить тот же цикл агента из другого языка, запустите CLI как подпроцесс с флагом -p и --output-format json.
Возможности
Эти возможности Claude Code доступны в SDK:
| Возможность | Что она делает | Узнайте больше |
|---|---|---|
| Встроенные инструменты | Читать, писать, редактировать файлы, запускать команды и искать в веб-сети | Справочник инструментов |
| Hooks | Запускать пользовательский код в ключевых точках жизненного цикла агента | Hooks |
| Subagents | Создавать специализированных агентов для сосредоточенных подзадач | Subagents |
| MCP | Подключать внешние инструменты и источники данных через Model Context Protocol | MCP |
| Permissions | Контролировать, какие инструменты запускаются автоматически, какие требуют одобрения | Permissions |
| Sessions | Сохранять контекст между обменами, возобновлять или разветвлять позже | Sessions |
| Skills, commands, и memory | Загружать автоматически из .claude/ вашего проекта и из ~/.claude/, как в Claude Code |
Skills, Commands, Memory, Configuration loading |
| Plugins | Упаковывать skills, агентов, hooks и MCP серверы, и загружать их по локальному пути | Plugins |
Начало работы
Следуйте Quickstart, чтобы установить SDK, установить ваш API ключ и создать вашего первого агента, который находит и исправляет ошибки в существующем коде.
Журнал изменений
Просмотрите полный журнал изменений для обновлений SDK, исправлений ошибок и новых функций:
- TypeScript SDK: просмотреть CHANGELOG.md
- Python SDK: просмотреть CHANGELOG.md
Сообщение об ошибках
Если вы столкнулись с ошибками или проблемами с Agent SDK:
- TypeScript SDK: сообщить об ошибках на GitHub
- Python SDK: сообщить об ошибках на GitHub
Рекомендации по брендингу
Для партнеров, интегрирующих Claude Agent SDK, использование брендинга Claude является необязательным. При ссылке на Claude в вашем продукте:
Разрешено:
- "Claude Agent", предпочтительно для раскрывающихся меню
- "Claude", когда находится в меню, уже помеченном как "Agents"
- "{YourAgentName} Powered by Claude", если у вас есть существующее имя агента
Не разрешено:
- "Claude Code" или "Claude Code Agent"
- ASCII-арт с брендингом Claude Code или визуальные элементы, которые имитируют Claude Code
Ваш продукт должен сохранять свой собственный брендинг и не должен выглядеть как Claude Code или любой продукт Anthropic. Для вопросов о соответствии брендингу свяжитесь с командой Anthropic sales team.
Лицензия и условия
Использование Claude Agent SDK регулируется Коммерческими условиями обслуживания Anthropic, включая случаи, когда вы используете его для питания продуктов и услуг, которые вы предоставляете своим собственным клиентам и конечным пользователям, за исключением случаев, когда конкретный компонент или зависимость покрыты другой лицензией, как указано в файле LICENSE этого компонента.
Следующие шаги
Эти ресурсы содержат более глубокие технические детали и примеры проектов для разработки с помощью Agent SDK.
- Быстрый старт: создайте своего первого агента, который находит и исправляет ошибки
- Руководство по миграции: перейдите с пакетов Claude Code SDK на Agent SDK
- Цикл агента: как Claude планирует, вызывает инструменты и решает, когда задача завершена
- Примеры агентов: демонстрационные приложения для локальной разработки
- TypeScript SDK: полная справка API TypeScript и примеры
- Python SDK: полная справка API Python и примеры
- Дизайн агентского каркаса: как команда Claude Code использует динамические рабочие процессы для одновременной организации множества подагентов