​
Хостинг Agent SDK

Claude Agent SDK отличается от традиционных stateless LLM API тем, что поддерживает состояние разговора и выполняет команды в постоянной среде. Это руководство охватывает архитектуру, соображения по хостингу и лучшие практики для развертывания агентов на основе SDK в производственной среде.

​
Понимание архитектуры SDK

​
Модель долго работающего процесса

В отличие от stateless API вызовов, Claude Agent SDK работает как долго работающий процесс, который:
  • Выполняет команды в постоянной среде shell
  • Управляет файловыми операциями в рабочем каталоге
  • Обрабатывает выполнение инструментов с контекстом из предыдущих взаимодействий

​
Требования к хостингу

​
Контейнерная песочница

Для безопасности и изоляции SDK должен работать внутри изолированной контейнерной среды. Это обеспечивает:
  • Изоляцию процессов - Отдельная среда выполнения для каждой сессии
  • Ограничения ресурсов - Ограничения CPU, памяти и хранилища
  • Контроль сети - Ограничение исходящих соединений
  • Эфемерные файловые системы - Чистое состояние для каждой сессии

​
Системные требования

Каждый экземпляр SDK требует:
  • Зависимости времени выполнения
    • Python 3.10+ (для Python SDK) или Node.js 18+ (для TypeScript SDK)
    • Node.js (требуется для Claude Code CLI)
    • Claude Code CLI: npm install -g @anthropic-ai/claude-code
  • Выделение ресурсов
    • Рекомендуется: 1ГиБ RAM, 5ГиБ дискового пространства и 1 CPU (варьируйте это в зависимости от вашей задачи по мере необходимости)
  • Доступ к сети
    • Исходящий HTTPS к api.anthropic.com
    • Опционально: Доступ к MCP серверам или внешним инструментам

​
Варианты провайдеров песочниц

Несколько провайдеров специализируются на безопасных контейнерных средах для выполнения AI кода:

​
Паттерны производственного развертывания

​
Паттерн 1: Эфемерные сессии

Создайте новый контейнер для каждой пользовательской задачи, затем уничтожьте его по завершении. Лучше всего подходит для разовых задач, пользователь может по-прежнему взаимодействовать с AI во время выполнения задачи, но после завершения контейнер уничтожается. Примеры:
  • Исследование и исправление ошибок: Отладка и решение конкретной проблемы с соответствующим контекстом
  • Обработка счетов: Извлечение и структурирование данных из чеков/счетов для бухгалтерских систем
  • Задачи перевода: Перевод документов или пакетов контента между языками
  • Обработка изображений/видео: Применение преобразований, оптимизаций или извлечение метаданных из медиафайлов

​
Паттерн 2: Долго работающие сессии

Поддерживайте постоянные экземпляры контейнеров для долго работающих задач. Часто запускается несколько процессов Claude Agent внутри контейнера в зависимости от спроса. Лучше всего подходит для проактивных агентов, которые предпринимают действия без ввода пользователей, агентов, которые обслуживают контент, или агентов, которые обрабатывают большие объемы сообщений. Примеры:
  • Email агент: Отслеживает входящие электронные письма и автономно сортирует, отвечает или предпринимает действия на основе содержания
  • Конструктор сайтов: Хостит пользовательские веб-сайты для каждого пользователя с возможностями живого редактирования, обслуживаемыми через порты контейнера
  • Высокочастотные чат-боты: Обрабатывает непрерывные потоки сообщений с платформ типа Slack, где критически важно быстрое время отклика

​
Паттерн 3: Гибридные сессии

Эфемерные контейнеры, которые гидратируются историей и состоянием, возможно, из базы данных или из функций возобновления сессии SDK. Лучше всего подходит для контейнеров с периодическим взаимодействием от пользователя, которое запускает работу и останавливается, когда работа завершена, но может быть продолжена. Примеры:
  • Персональный менеджер проектов: Помогает управлять текущими проектами с периодическими проверками, поддерживает контекст задач, решений и прогресса
  • Глубокое исследование: Проводит многочасовые исследовательские задачи, сохраняет находки и возобновляет исследование, когда пользователь возвращается
  • Агент поддержки клиентов: Обрабатывает тикеты поддержки, которые охватывают несколько взаимодействий, загружает историю тикетов и контекст клиента

​
Паттерн 4: Одиночные контейнеры

Запустите несколько процессов Claude Agent SDK в одном глобальном контейнере. Лучше всего подходит для агентов, которые должны тесно сотрудничать друг с другом. Это, вероятно, наименее популярный паттерн, потому что вам придется предотвращать перезапись агентами друг друга. Примеры:
  • Симуляции: Агенты, которые взаимодействуют друг с другом в симуляциях, таких как видеоигры.

​
FAQ

​
Как мне общаться с моими песочницами?

При хостинге в контейнерах откройте порты для связи с вашими экземплярами SDK. Ваше приложение может предоставлять HTTP/WebSocket конечные точки для внешних клиентов, в то время как SDK работает внутри контейнера.

​
Какова стоимость хостинга контейнера?

Мы обнаружили, что доминирующая стоимость обслуживания агентов - это токены, контейнеры варьируются в зависимости от того, что вы предоставляете, но минимальная стоимость составляет примерно 5 центов в час работы.

​
Когда мне следует отключать неактивные контейнеры против поддержания их в теплом состоянии?

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

​
Как часто мне следует обновлять Claude Code CLI?

Claude Code CLI версионируется с semver, поэтому любые критические изменения будут версионированы.

​
Как мне отслеживать здоровье контейнера и производительность агента?

Поскольку контейнеры - это просто серверы, та же инфраструктура логирования, которую вы используете для бэкенда, будет работать для контейнеров.

​
Как долго может работать сессия агента до таймаута?

Сессия агента не будет таймаутиться, но мы рекомендуем установить свойство ‘maxTurns’, чтобы предотвратить зацикливание Claude.

​
Следующие шаги