Как создать AI агента с Claude на VPS

Что означает создание агента с помощью Claude

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

Такое разделение является преимуществом. Вы получаете рассуждения уровня frontier-моделей без необходимости запускать модель самостоятельно, и вы сохраняете полный контроль над тем, к чему может иметь доступ агент, так как инструменты запускаются на вашем оборудовании. Если вы уже создали свою первую программу на Claude, руководство первое приложение Claude на VPS содержит основы, на которых строится данное руководство.

Claude — это мозг: Messages API

Каждый вызов Claude проходит через одну конечную точку — Messages API. Вы отправляете историю текущего разговора и список инструментов, которые может использовать агент; Claude возвращает свое следующее сообщение. Это сообщение является либо окончательным ответом, либо запросом на вызов инструмента. Для пути самостоятельной разработки не существует отдельного «agent API»: использование инструментов является функцией этой единственной конечной точки, а цикл вокруг нее вы запускаете самостоятельно.

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

Использование инструментов — это цикл агента

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

Вы можете написать этот цикл вручную в несколько строк, и многие так и делают, потому что его легко отслеживать и контролировать. Официальные SDK также предоставляют инструмент запуска (tool runner), который управляет циклом за вас: вы предоставляете функции инструментов, а SDK берет на себя процесс взаимодействия с Claude, запуска инструментов и передачи результатов обратно до завершения работы Claude. В обоих случаях структура одинакова. Tool runner просто избавляет вас от необходимости писать цикл самостоятельно.

Три способа создания и выбор для VPS

Существует три способа создания агента Claude, и они различаются объемом управляемых вами компонентов.

Первый — это ваш собственный код, вызывающий Claude API с вашими инструментами. Вы пишете цикл или используете tool runner из SDK и размещаете все это на своем VPS. Это распространенный выбор, так как он дает полный контроль над инструментами, данными и безопасностью, и работает как обычная программа на вашем сервере. Большинство инструкций в этом руководстве предполагают именно этот путь.

Второй — Claude Agent SDK. Это Claude Code, агент для программирования, упакованный в виде библиотеки, на базе которой можно строить решения. Он поставляется с полным циклом агента и встроенными инструментами для чтения и записи файлов, выполнения команд shell и поиска, поэтому вам не нужно собирать их с нуля. Он также запускается на вашем собственном сервере, что делает его отличным вариантом для VPS, если вам нужен функциональный агент для работы с файлами и shell без самостоятельной сборки инфраструктуры. Агенту, который читает файлы и запускает команды shell, требуется изоляция перед автономной работой; руководство безопасный запуск Claude Code на сервере описывает систему разрешений, песочницу и варианты изоляции.

Третий — Managed Agents (управляемые агенты), где Anthropic запускает цикл и хостит песочницу, в которой выполняются инструменты агента. Это вариант с минимальным участием: вам нужно гораздо меньше операций для управления, но рабочее пространство агента находится на инфраструктуре Anthropic, а не на вашем VPS. Выбирайте этот вариант, если хотите минимизировать эксплуатационные задачи и вам не нужно, чтобы инструменты запускались на вашей машине. В двух других случаях ваш сервер является домом для агента, о чем и пойдет речь в оставшейся части руководства.

Подключение инструментов через MCP

Какой бы путь вы ни выбрали, вам захочется подключить агента к реальным системам, и Model Context Protocol (MCP) — это удобный способ сделать это. MCP — это открытый стандарт для предоставления инструментов и данных агенту. Вместо того чтобы писать код интеграции для каждого сервиса вручную, вы направляете Claude на MCP-сервер, который уже предоставляет эти возможности в качестве инструментов. Вы можете запускать MCP-серверы как небольшие сервисы на том же VPS, каждый из которых имеет только необходимые ему права доступа; об этом я рассказываю в запуск MCP-серверов на VPS.

Выбор модели

Claude представлена несколькими моделями, и выбор одной из них — это компромисс между возможностями, скоростью и стоимостью. На момент написания текста основными вариантами являются Claude Opus 4.8 (claude-opus-4-8), стандартный выбор для сложных рассуждений и длительных сессий агента; Claude Sonnet 5 (claude-sonnet-5), сбалансированный вариант, который дешевле и быстрее, оставаясь близким к Opus во многих задачах; и Claude Haiku 4.5 (claude-haiku-4-5), самый быстрый и дешевый вариант для простых и массовых операций. Выше них находится Claude Fable 5 (claude-fable-5), самая мощная модель для самых сложных задач. В коде используйте точный идентификатор модели без указания даты.

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

Запуск в качестве защищенного сервиса на вашем VPS

Агент полезен только в том случае, если он работает постоянно, и он безопасен только в том случае, если он изолирован. На VPS и то, и другое достигается путем запуска агента как защищенного системного сервиса, а не как программы, запущенной вручную в терминале. Как сервис, он запускается при загрузке системы, перезапускается в случае сбоя и записывает логи в journal. В защищенном виде он работает от имени непривилегированного пользователя, имея только необходимые ему права, что ограничивает последствия ошибки или некорректной инструкции.

Самое важное правило: храните ваш Claude API key на стороне сервера. Ключ оплачивает и авторизует каждый вызов, поэтому он должен находиться в файле, доступном только пользователю агента, загружаться в сервис как переменная окружения и никогда не размещаться в коде, в репозитории или в любом месте, доступном через браузер. Сгенерируйте полный защищенный юнит-файл сервиса для вашего агента здесь:

Затем настройте сам сервер. Настройте SSH только по ключам и ограничьте учетную запись, с которой вы администрируете систему, как описано в укрепление безопасности SSH на VPS. Если вы предпочитаете управлять агентом через интерактивную сессию во время разработки, запуск Claude Code на VPS с использованием tmux будет хорошим дополнением. А если вы хотите понять концепции, лежащие в основе всего этого, не привязываясь к конкретной модели, вспомогательное руководство создание собственного AI агента на VPS излагает основы.

Если вам нужен терминальный помощник для кодинга, запуск AI агента для кодинга на VPS охватывает Aider и Goose.

FAQ

Какую модель Claude мне следует использовать для создания агента?

Начните с Claude Opus 4.8 (claude-opus-4-8) как стандартного надежного варианта и корректируйте по мере необходимости. Claude Sonnet 5 (claude-sonnet-5) дешевле и быстрее для большинства задач, Claude Haiku 4.5 (claude-haiku-4-5) лучше всего подходит для простых массовых шагов, а Claude Fable 5 (claude-fable-5) является самой мощной для самых сложных задач. Распространенный паттерн — использование более дешевой модели для рутинных шагов и более мощной для принятия сложных решений, так как переключение — это изменение в одну строку.

Я запускаю всего агента на своем VPS или это делает Anthropic?

Это зависит от подхода. Если вы пишете собственный цикл для Claude API или используете Claude Agent SDK, агент полностью работает на вашем VPS, и только вызовы модели уходят в Anthropic. Если вы используете Managed Agents, Anthropic запускает цикл и хостит песочницу, где выполняются инструменты, поэтому меньше компонентов работает на вашем сервере. Для агента, работающего на вашей собственной машине, используйте первые два варианта.

В чем разница между Claude API и Claude Agent SDK?

Claude API — это необработанная конечная точка Messages: вы отправляете диалог и инструменты, а затем сами пишете цикл агента или используете tool runner из SDK. Claude Agent SDK — это библиотека более высокого уровня, представляющая собой Claude Code, упакованный для разработки, которая поставляется с полным циклом и встроенными инструментами для работы с файлами, shell и поиском. Используйте API, когда хотите определить все самостоятельно, и Agent SDK, когда вам нужен функциональный агент без самостоятельной сборки инфраструктуры.

Как обеспечить безопасность моего Claude API key на сервере?

Храните его на стороне сервера, вне вашего кода. Сохраняйте его в файле, доступном только для учетной записи, под которой работает агент, загружайте его в сервис как переменную окружения и никогда не фиксируйте его в репозитории и не открывайте для браузера. Поскольку каждый запрос к Claude исходит с вашего сервера, ключу никогда не нужно попадать на устройство пользователя, что делает агента, работающего на сервере, более безопасным, чем встроенного в клиентское приложение.

Нужно ли мне запускать модель самостоятельно (self-host) для создания агента с помощью Claude?

Нет. В случае с Claude модель является хостинг-сервисом, который вы вызываете через API, поэтому вам не нужно ничего запускать на GPU. Ваш VPS запускает цикл агента, инструменты и данные, а рассуждения происходят на стороне Anthropic. Это позволяет скромному серверу запускать мощного агента. Если же вам нужна полностью локальная модель, используйте путь self-hosted, описанный в руководстве по созданию собственного AI агента.