Назад
Создание автономных агентов с Claude Code SDK: практическое руководство разработчика
June 20, 2026
19 мин чтения
Поделиться статьёй

Создание автономных агентов с Claude Code SDK: практическое руководство разработчика

Официальная библиотека, превращающая агентный движок Claude Code в программируемый строительный блок для CI, автоматизации и мультиагентных систем.

Создание автономных агентов с помощью Claude Code SDK: практическое руководство для разработчиков

Claude Code SDK — официально называемый Agent SDK — это библиотека для Python и TypeScript, которая позволяет программно управлять полным агентным движком Claude Code: без терминала, без человека за клавиатурой — просто ваше приложение вызывает асинхронную функцию query() и получает потоковую передачу каждого шага работы агента. Если вы использовали Claude Code в интерактивном режиме, SDK предоставляет тот же цикл чтения файлов / редактирования кода / выполнения команд в виде компонуемой библиотеки, которую можно встроить в CI-пайплайны, боты для код-ревью, оркестраторы мультиагентных систем или любой бэкенд-сервис.


Что такое Agent SDK — и почему он существует

Claude Code хорошо известен как инструмент для терминала. Вы вводите промпт, агент анализирует вашу кодовую базу, вызывает встроенные инструменты (Read, Edit, Bash, Grep и другие) и возвращает вам результаты. Но в момент, когда вы хотите автоматизировать этот цикл — запускать ревью на каждый pull request, распределять задачи между несколькими специализированными суб-агентами или строить продукт на его основе — интерактивный CLI становится неподходящей абстракцией. Нужна библиотека.

Agent SDK закрывает этот пробел. Согласно официальной документации Anthropic, он предоставляет "те же инструменты, тот же цикл агента и управление контекстом, которые лежат в основе Claude Code, программируемые на Python и TypeScript". Это не маркетинговая формулировка — это буквальная архитектура. SDK запускает бинарный файл CLI Claude Code как управляемый подпроцесс, общается с ним через stdio и представляет всё как асинхронный поток типизированных объектов сообщений, которые ваш код может потреблять и на которые может реагировать.

Это различие важно по нескольким причинам:

Тот же движок, другой интерфейс. Когда вы переходите от CLI к SDK, вы не переходите к менее мощному или более простому инструменту. SDK наследует все возможности CLI — подключение к MCP-серверам, жизненный цикл хуков, файлы навыков (skill files), память CLAUDE.md, делегирование суб-агентам и полный набор инструментов.

SDK сам выполняет вызовы инструментов за вас. Если вы используете Anthropic Client SDK (низкоуровневый пакет anthropic для Python/JS) и хотите, чтобы Claude вызывал инструменты, вам нужно самостоятельно реализовать цикл вызова инструментов: вызвать API, обнаружить ответ с использованием инструмента, выполнить инструмент, передать результат обратно, повторять до тех пор, пока Claude не остановится. Agent SDK сворачивает весь этот цикл в единственную конструкцию async for message in query(...) — Claude сам решает, какие инструменты вызывать, выполняет их внутри своего подпроцесса и продолжает цикл до завершения задачи. Вам остаётся только потреблять поток.

Headless-режим по умолчанию. Запросы разрешений в CLI — "разрешить эту bash-команду?" — блокируются в ожидании действий человека. SDK заменяет их опцией permissionMode и набором режимов разрешений — например, acceptEdits для автоматического подтверждения редактирования файлов и bypassPermissions для выполнения всего без запросов в изолированной CI-среде — а также программным callback-обработчиком подтверждения для нестандартных сценариев. Точные названия режимов и их поведение описаны в справочнике SDK от Anthropic (обратитесь к нему за актуальным списком), но эффект один и тот же: ваша автоматизация никогда не зависает в ожидании нажатия клавиши.

Interactive CLI vs Agent SDK architecture — two ways to invoke Claude Code Один и тот же движок Claude Code, два интерфейса: интерактивный CLI для работы с участием человека и Agent SDK для программной, headless-автоматизации, где ваше приложение управляет промптом, а режим разрешений заменяет диалог подтверждения.


Установка SDK

Anthropic публикует два пакета:

  • TypeScript: @anthropic-ai/claude-agent-sdk (npm)
  • Python: claude-agent-sdk (pip; требуется Python 3.10+)

Пакет TypeScript включает в себя нативный бинарный файл Claude Code для вашей платформы, поэтому отдельная установка CLI не требуется. Аутентификация выполняется через переменную окружения ANTHROPIC_API_KEY, полученную в Anthropic Console. SDK также поддерживает Amazon Bedrock, Google Vertex AI и Microsoft Azure AI Foundry — см. документацию Anthropic для соответствующих шаблонов переменных окружения.


Основные концепции

Понимание четырёх концепций покрывает подавляющее большинство реальных сценариев использования SDK.

1. Функция query() и асинхронный поток сообщений

Каждое взаимодействие с SDK начинается с query(). Вы передаёте строку prompt и объект options; в ответ вы получаете асинхронный итератор, который выдаёт типизированные объекты сообщений по мере работы агента. Цикл завершается, когда агент заканчивает работу или сталкивается с ошибкой.

Получаемые сообщения включают:

  • AssistantMessage — текст рассуждений Claude и описания вызовов инструментов
  • ToolResultMessage — результат выполнения каждого инструмента
  • ResultMessage — итоговый результат, с полем subtype, указывающим на успех или неудачу
  • SystemMessage — события жизненного цикла сессии (подтип init содержит session_id)

В большинстве продакшн-кода вы фильтруете по ResultMessage, чтобы извлечь итоговый результат, и опционально логируете блоки AssistantMessage, чтобы отслеживать, что делал агент.

2. Инструменты и allowedTools

Встроенный набор инструментов SDK напрямую соответствует возможностям Claude Code:

ИнструментЧто делает
ReadЧитает любой файл в рабочем каталоге
WriteСоздаёт новые файлы
EditВыполняет точные изменения в существующих файлах
BashЗапускает терминальные команды, операции git, скрипты
GlobНаходит файлы по шаблону (**/*.ts, src/**/*.py)
GrepИщет по содержимому файлов с помощью regex
WebSearchИщет информацию в интернете
WebFetchЗагружает и разбирает веб-страницу
AskUserQuestionЗадаёт пользователю уточняющий вопрос (интерактивные сценарии)
AgentЗапускает суб-агента, определённого в ваших опциях

Опция allowedTools предварительно одобряет подмножество этих инструментов, фактически давая агенту разрешение вызывать их без каких-либо дополнительных проверок. Агент только для чтения, выполняющий аудит, может указывать только ["Read", "Glob", "Grep"]; полноценная автоматизация может включать ["Read", "Edit", "Bash", "Glob", "Grep"].

3. Режимы разрешений

Режимы разрешений определяют, что происходит, когда агент хочет использовать инструмент, который не предварительно одобрен в allowedTools:

  • acceptEdits — автоматически одобряет редактирование файлов и стандартные файловые операции; запрашивает подтверждение для всего остального. Лучше всего подходит для доверенных рабочих процессов разработки.
  • dontAsk — молча отклоняет всё, что не входит в allowedTools. Лучше всего подходит для строго ограниченных headless-агентов.
  • bypassPermissions — запускает любой инструмент без проверок. Используйте только внутри изолированной (sandboxed) среды.

SDK также предоставляет программный callback-обработчик подтверждения, позволяющий реализовать полностью нестандартную логику одобрения, а список доступных режимов может расширяться со временем — обращайтесь к справочнику SDK от Anthropic за актуальным и достоверным перечнем и точным поведением каждого режима. В CI вы почти всегда будете использовать строго ограниченную конфигурацию с запретом по умолчанию либо bypassPermissions внутри контролируемого вами контейнера-песочницы.

4. Сессии, возобновление и контекст

Каждый вызов query() создаёт (или возобновляет) сессию. session_id сессии приходит в первом SystemMessage с subtype === "init". Вы можете захватить его и передать как resume: sessionId в последующем вызове, чтобы продолжить диалог именно с того места, где он был прерван — с теми же прочитанными файлами, той же историей рассуждений, тем же контекстным окном.

Так строятся многоходовые агенты: один вызов query() анализирует модуль, захватывает session_id, а второй вызов query()resume) ссылается на "него" или "файл, который вы только что прочитали" без повторного объяснения. Транскрипты сессий по умолчанию записываются на локальный диск; для продакшна вы можете подключить адаптер SessionStore на базе S3, Redis или Postgres, чтобы сессии сохранялись при перезапуске контейнеров.


Шаблон разработки 1: CI-бот для код-ревью

Это канонический пример использования "headless-автоматизации". При каждом pull request задача CI переключается на ветку, запускает агента, который читает изменённые файлы, и публикует комментарий с ревью.

Процесс:

  1. Событие PR запускает workflow в GitHub Actions (или задачу GitLab CI).
  2. Раннер переключается на ветку и запускает ваш скрипт ревью.
  3. Ваш скрипт вызывает query() с промптом для ревью, allowedTools: ["Read", "Glob", "Grep", "Bash"] и permissionMode: "dontAsk".
  4. Claude читает diff, ищет паттерны, анализирует находки.
  5. ResultMessage содержит текст ревью; ваш скрипт публикует его в PR через GitHub API.

Ключевое проектное решение — использование dontAsk со списком инструментов только для чтения. Агент не может записывать файлы или совершать сетевые вызовы за пределами того, что разрешают инструменты, поэтому ваша CI-задача не может случайно смержить коммиты или вызвать внешние API. Лимит maxTurns (задаётся в опциях) ограничивает глубину работы агента, чтобы бесконтрольные циклы не расходовали бюджет.

Иллюстрацию архитектуры этого процесса см. на диаграмме ниже.

CI code-review bot: PR event → Agent SDK → findings → PR comment Полностью автоматизированный пайплайн код-ревью. Агент SDK работает внутри CI-контейнера со списком инструментов только для чтения; находки возвращаются потоком как ResultMessage, и ваш код публикует их как комментарий к PR на GitHub. Агент никогда не записывает файлы и никогда не выходит за пределы контейнера.

Этот шаблон можно расширить с помощью хуков — функции SDK, подробно рассмотренной в нашем глубоком разборе хуков Claude Code — чтобы логировать каждый вызов инструмента в файл аудита, блокировать чтение определённых путей к файлам или отправлять структурированную телеметрию вместе с ревью.


Шаблон разработки 2: Цепочки мультиагентных инструментов

Опция agents в SDK позволяет определить именованных суб-агентов, каждый со своим системным промптом, списком инструментов и разрешениями. Ваш основной агент делегирует им работу через встроенный инструмент Agent. Сообщения суб-агентов содержат поле parent_tool_use_id, позволяющее точно отследить, какое делегирование привело к появлению каждой части результата.

Практический пример: цепочка агентов для аудита безопасности, где суб-агент code-scanner находит потенциальные уязвимости с помощью Grep и Glob, суб-агент dependency-checker запускает Bash для запроса метаданных ваших пакетов, а координирующий агент синтезирует оба отчёта в единый аудит. У каждого суб-агента есть минимальный доступ к инструментам, необходимый для его роли, что ограничивает радиус поражения, если суб-агент "придумает" опасную команду.

Мультиагентные цепочки хорошо работают для задач, которые естественным образом разбиваются на части: один агент на одну область ответственности, каждый с ограниченным списком инструментов, оркестрируемый координатором, которому нужны только Read и Agent. Более широкий обзор того, как мультиагентные архитектуры сочетаются с такими функциями Claude Code, как память CLAUDE.md и файлы навыков, см. в нашем руководстве по инженерии harness.


Шаблон разработки 3: Headless-пайплайны автоматизации

Помимо код-ревью, SDK отлично подходит для любой повторяющейся автоматизации, где агент — это шаг в более крупном пайплайне:

Ночные аудиты зависимостей. Cron-задача вызывает query() с промптом для проверки устаревших пакетов, запуска сканеров безопасности и создания структурированного отчёта. Инструмент Bash запускает npm audit или pip check; Read проверяет lock-файлы. ResultMessage передаёт данные в уведомление Slack.

Перевод и i18n при слиянии PR. Когда PR слит, webhook запускает агента, который считывает изменённые файлы строк с помощью Glob и Read, создаёт переведённые версии с помощью Write и открывает новый PR через Bash (запуская gh pr create).

Обнаружение аномалий в логах. Передайте последний вывод логов в промпт query(). Агент при необходимости читает дополнительные файлы контекста, анализирует логи и выдаёт структурированную находку. Записи файлов не требуются; достаточно списка инструментов только для чтения.

Синхронизация документации. После слияния PR агент считывает обновлённые исходные файлы и переписывает соответствующие страницы документации, затем коммитит изменения. permissionMode: "acceptEdits" обрабатывает запись файлов без запросов подтверждения.

Общая нить: query() заменяет специализированную интеграцию LLM. Вам не нужно реализовывать цикл вызова инструментов, вручную управлять контекстными окнами или разбирать вывод модели, чтобы решить, что выполнять следующим. Агент управляет оркестрацией; вы предоставляете промпт и потребляете результат.


Разобранный иллюстративный пример: агент для исправления багов

Официальный quickstart наглядно демонстрирует этот шаблон (код ниже соответствует документированному API — проверьте точный синтаксис в документации quickstart Anthropic):

Иллюстративный Python (проверьте точный API в официальной документации):

# Illustrative — confirm exact import paths and option names in official docs
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ResultMessage

async def run_bug_fixer(file_path: str):
    async for message in query(
        prompt=f"Review {file_path} for bugs that would cause crashes. Fix any issues.",
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Edit", "Glob"],
            permission_mode="acceptEdits",
        ),
    ):
        if isinstance(message, AssistantMessage):
            for block in message.content:
                if hasattr(block, "text"):
                    print(block.text)
        elif isinstance(message, ResultMessage):
            print(f"Completed: {message.subtype}")

asyncio.run(run_bug_fixer("src/utils.py"))

Иллюстративный TypeScript (проверьте точный API в официальной документации):

// Illustrative — confirm exact import paths and option names in official docs
import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Review src/utils.ts for crash-causing bugs and fix them.",
  options: {
    allowedTools: ["Read", "Edit", "Glob"],
    permissionMode: "acceptEdits",
  },
})) {
  if (message.type === "assistant" && message.message?.content) {
    for (const block of message.message.content) {
      if ("text" in block) console.log(block.text);
    }
  }
  if (message.type === "result") console.log("Done:", message.subtype);
}

Что происходит при запуске: Claude считывает utils.py (или .ts) с помощью инструмента Read, анализирует код, выявляет граничные случаи, затем вызывает Edit, чтобы добавить защитную обработку. Вы видите, как рассуждения и вызовы инструментов потоково передаются в виде объектов AssistantMessage; финальный ResultMessage сигнализирует о завершении. Весь цикл работы агента — включая повторное чтение файла для проверки изменений — управляется SDK.

Именно это отличает SDK от прямого вызова API моделей Anthropic: вам не нужно реализовывать слой выполнения инструментов. Claude сам решает, когда вызвать Read, вызывает его, получает содержимое файла обратно и продолжает рассуждать. Цикл автономен.


Разрешения, изоляция и безопасность в продакшне

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

Ограничение набора инструментов — первая линия защиты. Если агенту не нужен Bash, не включайте его в allowedTools. Агент только с ["Read", "Glob", "Grep"] не может изменять файлы, запускать shell-команды или совершать сетевые вызовы, независимо от того, что говорит его промпт.

Режимы разрешений обеспечивают второй уровень защиты. dontAsk гарантирует, что всё, что выходит за пределы allowedTools, молча отклоняется, а не запрашивается. Это критически важно в headless-средах — запрос, который зависает в ожидании ввода пользователя, застопорит ваш пайплайн.

Опция cwd ограничивает доступ агента к файловой системе конкретным каталогом. В многотенантных средах передавайте рабочий каталог для каждой сессии, чтобы агенты разных тенантов не могли читать файлы друг друга.

Изоляция тенантов требует дополнительных шагов: установите settingSources: [], чтобы никакие настройки файловой системы не перетекали между тенантами; установите CLAUDE_CODE_DISABLE_AUTO_MEMORY=1, чтобы предотвратить загрузку авто-памяти; направьте CLAUDE_CONFIG_DIR на путь для конкретного тенанта. Всё это подробно описано в руководстве Anthropic по хостингу.

Изоляция в контейнерах — внешняя оболочка защиты. Для продакшн-агентов, которым нужен доступ к Bash, запускайте SDK внутри контейнера с ограниченным сетевым исходящим трафиком, разрешённым только для явно указанных доменов. Провайдеры вроде Modal, E2B, Cloudflare Sandboxes, Fly Machines и Vercel Sandbox упоминаются в документации Anthropic как варианты для изолированного развёртывания SDK.

maxTurns ограничивает количество циклов вызова инструментов, ограничивая как затраты, так и бесконтрольные циклы. Устанавливайте это значение в зависимости от ожидаемой сложности вашей задачи — простое ревью с чтением файла может потребовать 5–10 итераций; сложный рефакторинг с множеством файлов может потребовать 30–50.

Для команд, разрабатывающих продакшн-хуки и потоки разрешений, наше руководство по хукам Claude Code подробно описывает жизненный цикл хуков PreToolUse и PostToolUse, включая то, как писать callback-обработчики хуков, которые блокируют, трансформируют или логируют вызовы инструментов перед их выполнением.


MCP: подключение агента к внешним системам

SDK полностью поддерживает Model Context Protocol (MCP), который позволяет подключить вашего агента к любой внешней системе, предоставляющей MCP-сервер: базам данных, автоматизации браузера, Jira, Slack, GitHub и сотням серверов, созданных сообществом.

Вы настраиваете MCP-серверы в опции mcpServers — каждая запись указывает команду для запуска и опциональные аргументы. SDK запускает эти серверы как подпроцессы, и агент может вызывать их инструменты так же, как он вызывает встроенные инструменты. Так вы даёте агенту для код-ревью доступ к вашему трекеру задач или подключаете агента документации к базе знаний вашей компании.

Модель разрешений применяется и к вызовам инструментов MCP — allowedTools может включать имена инструментов MCP, а permissionMode определяет, что происходит с неуказанными инструментами.


Подводные камни и распространённые ошибки

Сессии по умолчанию локальны для подпроцесса. Транскрипты сессий хранятся на локальном диске хоста в ~/.claude/projects/. В контейнеризированных или горизонтально масштабируемых развёртываниях это означает, что состояние сессии теряется при перезапуске или переназначении узла. Используйте адаптер SessionStore для любой сессии, которую нужно возобновлять между контейнерами.

Модель подпроцессов имеет последствия для использования памяти. Каждая работающая сессия — отдельный подпроцесс. Запуск пятидесяти одновременных сессий означает пятьдесят процессов Claude Code. Официальная рекомендация — примерно 1 ГиБ ОЗУ на агента как отправная точка, но реальное потребление памяти зависит от длительности сессии и активности инструментов. Подбирайте размер контейнеров соответствующим образом и устанавливайте maxTurns, чтобы ограничить глубину сессии.

Большие веерные развёртывания суб-агентов упираются в лимиты частоты запросов. Если ваш оркестратор одновременно делегирует задачи двадцати суб-агентам, вы, скорее всего, упрётесь в лимиты частоты запросов API Anthropic. Разбивайте широкие веерные развёртывания на пакеты и добавляйте небольшую задержку между отправками.

bypassPermissions требует настоящей песочницы. Этот режим пропускает все проверки разрешений. Он предназначен для полностью контролируемых сред, таких как CI-контейнеры, где вы владеете всем контекстом выполнения. Использование его на машине разработчика — где агент имеет доступ к SSH-ключам, облачным учётным данным и произвольным путям файловой системы — представляет угрозу безопасности.

SDK для TypeScript включает бинарный файл Claude Code; для Python он не требуется отдельно. Но оба SDK привязаны к конкретной версии CLI. Когда вы обновляете пакет SDK, вы обновляете и базовый CLI. Просматривайте changelog перед минорными обновлениями — критические изменения поведения анонсируются там.

Текст промптов и входные данные инструментов по умолчанию не включаются в экспорты OTEL. Это намеренное поведение для обеспечения конфиденциальности. Если вам нужна трассировка на уровне промптов для отладки, необходимо явно подключить её через переменные окружения, описанные в руководстве Anthropic по наблюдаемости.

Более старые версии SDK могут не поддерживать новые модели. В документации Anthropic отмечается, что для новых моделей может требоваться актуальная версия SDK из-за изменений в API параметра thinking, поэтому устаревший SDK может не работать с новой моделью. Всегда проверяйте changelog и фиксируйте проверенную версию при переходе на новые модели.


SDK против CLI: что вам нужно?

Для большинства разработчиков ответ — оба инструмента, и это неслучайно.

Интерактивный CLI — правильный инструмент для повседневной разработки: изучения незнакомой кодовой базы, интерактивной работы со сложным багом или разового рефакторинга. SDK — правильный инструмент для всего, что должно работать без присутствия человека: CI, запланированные задачи, функции приложений и мультиагентные пайплайны.

SDK и CLI — не конкурирующие продукты. Рабочие процессы, которые вы разрабатываете интерактивно с помощью CLI, напрямую переносятся в автоматизацию SDK — те же инструменты, те же концепции разрешений, та же память CLAUDE.md и та же система навыков. Рабочий процесс ревью, который вы прототипируете с помощью claude в терминале сегодня, завтра становится CI-ботом на базе SDK.

Для команд, использующих веб-версию Claude Code (описанную в нашем руководстве по Claude Code в браузере), SDK открывает возможность сочетать веб-сессии с программной оркестрацией — запустить длительную задачу из веб-версии, а затем подключиться к ней программно из вашего бэкенда.


Часто задаваемые вопросы

Что такое Claude Code SDK (Agent SDK) именно? Это библиотека для Python (claude-agent-sdk) и TypeScript (@anthropic-ai/claude-agent-sdk), которая предоставляет полный агентный движок Claude Code — инструменты, разрешения, управление сессиями, суб-агентов, MCP — как программируемый асинхронный API. Вы вызываете query(), передаёте промпт и опции, и получаете поток работы агента в виде типизированных объектов сообщений.

Нужен ли мне установленный Claude Code для использования SDK? Для TypeScript SDK — нет, пакет включает нативный бинарный файл Claude Code. Для Python SDK пакет claude-agent-sdk обрабатывает эту зависимость. Вам нужен API-ключ Anthropic из Anthropic Console.

Могу ли я использовать SDK с моделями, отличными от Claude, через API Anthropic? Да. SDK поддерживает Amazon Bedrock, Google Vertex AI, Microsoft Azure AI Foundry и Claude Platform на AWS через переменные окружения. Вы также можете направлять запросы через собственный proxy, установив ANTHROPIC_BASE_URL.

Как использовать SDK в workflow GitHub Actions? Добавьте свой ANTHROPIC_API_KEY как секрет GitHub Actions, переключитесь на ветку PR в своём workflow, установите пакет SDK и запустите скрипт агента. Используйте permissionMode: "dontAsk" со списком allowedTools только для чтения, чтобы агент не мог изменять файлы в вашей CI-среде. Документация Anthropic также описывает специальную интеграцию GitHub Actions, которая автоматизирует ревью PR и триаж issue без написания собственного кода SDK.

Какая разница между Agent SDK и Managed Agents? Agent SDK — это библиотека, которая запускает цикл агента внутри вашего собственного процесса и инфраструктуры. Managed Agents — это хостируемый REST API, где Anthropic запускает агента и песочницу — вы отправляете события и получаете результаты потоком. SDK лучше подходит для локального прототипирования и агентов, работающих непосредственно с вашей файловой системой; Managed Agents лучше подходит для продакшна, когда вы не хотите управлять инфраструктурой контейнеров.

Как ограничить доступ агента? Используйте allowedTools, чтобы ограничить доступные инструменты, permissionMode: "dontAsk", чтобы отклонять всё, что не входит в этот список, и cwd, чтобы ограничить доступ к файловой системе конкретным каталогом. Для многотенантных развёртываний дополнительно установите settingSources: [] и CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.

Поддерживает ли SDK потоковую передачу вывода? Да — асинхронный итератор из query() передаёт сообщения потоком в реальном времени. Если вам не нужен вывод в реальном времени (для фоновых задач или CI-пайплайнов, где важен только итоговый результат), документация Anthropic описывает однократный режим, который собирает все сообщения перед возвратом результата. См. Streaming vs. single-turn mode в официальной документации.

Могу ли я запускать несколько агентов параллельно? Да. Каждый вызов query() запускает независимый подпроцесс. Вы можете запустить N одновременных сессий — но каждая из них представляет собой отдельный процесс, поэтому распределяйте память соответствующим образом и учитывайте лимиты частоты запросов API. Для одновременных веерных развёртываний суб-агентов от одного оркестратора разбивайте отправки на пакеты, чтобы избежать превышения лимитов частоты запросов.

Что происходит, если сессия аварийно завершается посреди выполнения задачи? По умолчанию транскрипты сессий локальны для контейнера и теряются при перезапуске. Чтобы переживать перезапуски, настройте адаптер SessionStore (S3, Redis или Postgres) и передайте его в опциях. После этого вы можете возобновить сессию по session_id на новом контейнере.


Запуск агентов без локальной настройки

Ценность SDK — в автоматизации, но чтобы заставить эту автоматизацию работать, требуется настоящая инфраструктура: среда выполнения Python или Node, API-ключ, стратегия контейнеризации, решение по изоляции и время, потраченное на моделирование разрешений перед первым продакшн-развёртыванием.

Для разработчиков, которые хотят опробовать идеи агентов без этих накладных расходов на настройку, Happycapy запускает агентов в стиле Claude Code прямо в браузере. Не требуется ни локальной установки, ни управления подпроцессами, ни настройки контейнеров. Вы приносите промпт, а Happycapy обеспечивает среду выполнения — с доступом к более чем 150 моделям и безопасной облачной песочницей. Это быстрый путь для прототипирования поведения агента, которое вы позже переведёте в продакшн с помощью SDK.

Начните бесплатно на happycapy.ai

Похожие руководства

Опубликовано June 20, 2026
Другие статьи