Обзор Agent SDK
Создавайте производственные AI-агентов с Claude Code как библиотеку
Агент — это приложение, которое выполняет задачу, планируя собственные шаги и вызывая инструменты, которые читают файлы, запускают команды или редактируют код. Agent SDK предоставляет вам те же инструменты, цикл агента и управление контекстом, которые питают Claude Code, программируемые на Python и TypeScript.
Сравнение Agent SDK с другими инструментами Claude
Agent SDK, CLI, Client SDK и Managed Agents отличаются тем, кто запускает агента, что входит в комплект и как вы его используете. Найдите строку, которая соответствует тому, как вы хотите создавать и запускать свой агент.
| Что вы хотите | Используйте | Что вы получаете |
|---|---|---|
| Встроить агента Claude Code в собственное приложение Python или TypeScript, в процессе, который вы контролируете | Agent SDK | Библиотека, которая запускает бинарный файл Claude Code, с возможностями Claude Code, такими как встроенные инструменты, разрешения, сессии и hooks. |
| Выполнять интерактивную разработку или запускать одноразовые задачи из терминала | Claude Code CLI | Интерфейс терминала, созданный для ежедневного интерактивного использования. |
| Вызывать Claude API непосредственно из собственного кода | Client SDK | Прямой доступ к Claude API из любого из языков Client SDK. Вы сами пишете цикл инструментов или позволяете бета-версии tool runner Client SDK управлять им. |
| Разместить агента в Anthropic, настроенного через Claude API | Managed Agents | Размещённая оболочка агента, которая запускает цикл агента, с сессиями в управляемой Anthropic облачной песочнице или самостоятельно размещённой песочнице на вашей собственной инфраструктуре. Используйте её из SDK для вашего языка, CLI ant или REST API. |
Чтобы запустить тот же цикл агента из языка, отличного от 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 использует динамические рабочие процессы для одновременной организации множества подагентов