SpyBara
Go Premium

agent-sdk/overview.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 18 additions and 18 deletions.

2026
Thu 15 23:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

Обзор 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, Загрузка конфигурации
Plugins Упаковывать skills, агентов, hooks и MCP серверы, и загружать их по локальному пути Plugins

Начало работы

Следуйте Quickstart, чтобы установить SDK, установить ваш API ключ и создать вашего первого агента, который находит и исправляет ошибки в существующем коде.

[!NOTE]

Если не было предварительного одобрения, Anthropic не разрешает сторонним разработчикам предлагать вход через claude.ai или ограничения скорости для своих продуктов, включая агентов, созданных на основе Claude Agent SDK. Вместо этого используйте методы аутентификации по API ключу, описанные в Quickstart.

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

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

Сообщение об ошибках

Если вы столкнулись с ошибками или проблемами с Agent SDK:

Рекомендации по брендингу

Для партнеров, интегрирующих 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 использует динамические рабочие процессы для одновременной организации множества подагентов