Почему это важно именно вам
Вы не будете писать код на SDK. Но вы будете принимать решение, когда его нужно писать, — а это решение стоит денег и времени команды.
Типичный разговор: «Давайте сделаем бота, который будет разбирать заявки». Дальше две дороги. Первая: настроить Claude Code — скилл, агент, расписание — за день силами одного человека. Вторая: разработка на SDK — недели работы, сопровождение, деплой. Разница в цене — десятки раз, и выбирают её обычно неправильно, потому что «сделать продукт» звучит солиднее.
Этот урок — про то, как отличить случаи.
Что это такое
Agent SDK — библиотека для Python и TypeScript, дающая те же инструменты, тот же рабочий цикл агента и то же управление контекстом, что и Claude Code, но внутри вашего приложения.
Соседние варианты и чем они отличаются:
| Что вы делаете | Что брать |
|---|---|
| Интерактивная работа и разовые задачи из терминала | Claude Code CLI |
| Приложение-агент без написания цикла инструментов вручную | Agent SDK |
| Прямые обращения к API со своей реализацией цикла | Client SDK |
| Долгие асинхронные агенты без своей инфраструктуры | Managed Agents (размещённый сервис) |
Важная деталь для нетехнического заказчика: SDK доступен только для Python и TypeScript. Если ваша система на другом языке — CLI можно запускать как подпроцесс в неинтерактивном режиме (-p с JSON-выводом), и это часто дешевле, чем переписывать.
Ещё одна деталь, которую при оценке цены упускают всегда. Настройка Claude Code работает на вашей подписке — вы уже за неё платите. Продукт на Agent SDK так работать не может: Anthropic не разрешает сторонним разработчикам подставлять в свои продукты вход и лимиты claude.ai, нужен API-ключ. То есть у разработки появляется вторая статья расходов — оплата по факту обращений, растущая вместе с числом пользователей.
Что переносится из вашего опыта: встроенные инструменты, хуки, субагенты, MCP, разрешения, сессии, скиллы и память из .claude/, плагины (последние подключаются по локальному пути, а не ставятся из каталога). То есть наработки из блоков 2–6 не пропадают.
Оговорка для разговора с разработчиком: загрузка .claude/ — управляемая настройка. По умолчанию всё подхватывается, но её можно выключить, и для продукта, обслуживающего много разных клиентов, документация прямо требует это сделать ради изоляции. Спросите прямо: подхватываются ли мои скиллы и правила или мы начали с чистого листа.
Как работает на практике
Признаки, что SDK не нужен
- задача выполняется по вашей команде или по расписанию;
- пользователь один — вы (или несколько человек, готовых работать в терминале);
- нужен результат, а не интерфейс;
- логика умещается в скилл и агента.
Это девять случаев из десяти в работе директора. Ответ здесь — Claude Code с настройкой, а не разработка.
Признаки, что SDK нужен
- у результата есть пользователи, которые не должны знать про Claude: сотрудники, клиенты, посетители сайта;
- нужен интерфейс: форма, кнопка, чат на сайте, приложение;
- нужна своя логика вокруг: очередь, база данных, права доступа, биллинг;
- работа должна выполняться в вашей инфраструктуре по требованиям безопасности;
- нагрузка предполагает множество параллельных запросов от разных людей.
Как ставить задачу разработчику
Если решили, что SDK нужен, ваша роль — сформулировать три вещи, которые обычно упускают:
Границы прав. Что агент может делать сам, что — только с подтверждением, чего не может никогда. В SDK это настраивается явно.
Что делать при ошибке. Молчаливое падение — самый частый дефект таких систем. Должно быть определено: куда приходит алерт, что видит пользователь, что происходит с недоделанной работой.
Как измерять качество. Не «работает/не работает», а доля задач, выполненных без вмешательства человека, и стоимость одной задачи. Без этого через полгода никто не сможет сказать, окупилась ли разработка.
Название. Ваш продукт нельзя называть «Claude Code» или оформлять под него. Допустимо «Claude Agent» или «<ваше имя>, powered by Claude». Мелочь, которая всплывает, когда лендинг уже нарисован.
Самая дорогая ошибка на этом этапе
Начать с разработки, минуя настройку. Правильный порядок: сначала соберите то же самое на Claude Code и поработайте так месяц. Вы узнаете реальные требования — они всегда отличаются от воображаемых. И в половине случаев обнаружите, что разработка не нужна вовсе.
Частые ошибки
Заказывать продукт до проверки гипотезы. Настройка проверяется за день, разработка — за недели.
Забывать про сопровождение. У продукта есть версии, зависимости, изменения API. Кто-то должен это вести. Если никто — через полгода он сломается.
Не переносить наработки. Скиллы, агенты и правила из ваших .claude/ подхватываются приложением. Начинать с чистого листа — терять то, что уже отлажено.
Путать SDK с прямыми обращениями к API. Если разработчик предлагает «просто дёргать API», убедитесь, что он понимает: цикл вызова инструментов, управление контекстом и разрешения придётся писать самому.
Когда нужно / когда нет
SDK: когда результат — продукт для других людей, с интерфейсом и своей инфраструктурой.
Claude Code: когда результат — ваша работа, сделанная быстрее.
Managed Agents: когда нужен долгий автономный агент, но нет желания и ресурсов держать свою инфраструктуру.
Связь с другими уроками
День 21–30 — агенты и День 31–34 — скиллы. Именно эти наработки переносятся в приложение.
День 78 — routines. Промежуточный вариант между настройкой и разработкой: автономная работа без своего кода.
День 90 — итоговый проект. Там вы сведёте систему целиком и увидите, где у неё границы.
Задание на сегодня
- Возьмите идею «нам бы сделать бота/сервис», которая у вас есть.
- Пройдите по признакам: есть ли у результата пользователи кроме вас? нужен ли интерфейс? нужна ли своя логика вокруг?
- Если по всем пунктам «нет» — соберите это на Claude Code за день и работайте месяц.
- Если «да» — напишите на одну страницу: границы прав, поведение при ошибках, метрики качества.
- Оцените стоимость обоих путей и примите решение осознанно, а не по привычке «надо разработать».
Критерий «выполнено»: по одной вашей идее принято обоснованное решение — настройка или разработка — с записанными аргументами.
Резюме
- Agent SDK — библиотека для Python и TypeScript с теми же инструментами, циклом и управлением контекстом, что у Claude Code.
- Соседние варианты: CLI (интерактив), Client SDK (свой цикл поверх API), Managed Agents (размещённые долгие агенты).
- Ваши скиллы, агенты, хуки, MCP и память из
.claude/подхватываются приложением на SDK — но эту загрузку можно выключить, и для многопользовательских продуктов её выключают. - Продукт на SDK оплачивается API-ключом: подставлять в него вход и лимиты claude.ai нельзя, это отдельная статья расходов.
- Разработка нужна, когда есть внешние пользователи, интерфейс, своя логика вокруг или требования к инфраструктуре.
- В остальных случаях (большинство директорских задач) хватает настройки Claude Code — она проверяется за день.
- Ставя задачу на разработку, зафиксируйте границы прав, поведение при ошибке и метрики качества.