Как запустить AI-агента для кода на VPS

Зачем запускать AI-агента для программирования на VPS

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

Стоит обратить внимание на два агента, работающих в терминале. Aider — это решение, ориентированное на работу в терминале и тесную интеграцию с git: агент автоматически фиксирует каждое изменение с понятным сообщением, что позволяет поддерживать чистоту истории и отменять любые правки. Это один из наиболее зрелых терминальных агентов для программирования, хотя темпы его обновлений снизились. Goose от компании Block — более универсальный инструмент: это агент с лицензией Apache-2.0, обладающий обширной экосистемой расширений и поддержкой множества провайдеров, включая локальные модели Ollama. В настоящее время разработка Goose ведется под эгидой фонда Agentic AI Foundation (AAIF) при Linux Foundation. Aider подходит для дисциплинированного рабочего процесса с упором на git; Goose лучше подходит в качестве универсального помощника с широким набором плагинов.

Что вам потребуется

Вам понадобится VPS с установленными git, tmux и актуальной версией Python для Aider или установщик Goose для Goose. Также необходима модель: либо API-ключ от облачного провайдера, например Anthropic или OpenAI, либо локальная модель, запущенная через Ollama на том же VPS. Вариант с локальным размещением позволяет хранить код на собственном сервере и не платить за каждый токен, однако требует наличия достаточного объема оперативной памяти для работы производительной модели.

Установка и запуск Aider

Установите Aider в изолированной среде с помощью pipx, который доступен через apt, так как Ubuntu 24.04 блокирует обычный pip install вне виртуального окружения (PEP 668). Затем запустите Aider внутри вашего проекта в сессии tmux, чтобы процесс не прервался при разрыве соединения:

sudo apt install pipx
pipx ensurepath
pipx install aider-chat
tmux new -s aider
cd ~/my-project
aider

Примечание о версиях: данная установка работает в Ubuntu 24.04. В Ubuntu 26.04 она завершается ошибкой, так как зафиксированные зависимости Aider включают старую версию numpy, которая не собирается с Python 3.14 в Ubuntu 26.04. Решение заключается в том, чтобы предоставить Aider собственный Python 3.12:

pipx install --python 3.12 --fetch-missing-python aider-chat

pipx загружает отдельный интерпретатор специально для Aider, и установка завершается успешно. Это симптом замедления темпов выпуска обновлений Aider; если это вас беспокоит, Goose является более активно поддерживаемым выбором.

После запуска отсоединитесь от сессии комбинацией клавиш Ctrl-b, а затем d — агент продолжит работу, даже если вы закроете ноутбук. Позже вернитесь к сессии с помощью tmux attach -t aider, чтобы увидеть внесенные изменения. Ничто не мешает вам держать открытым второе окно tmux для другого агента, и если оба они являются Claude Code, две сессии могут передавать работу друг другу, вместо того чтобы вы делали это вручную. Aider считывает ваш репозиторий, предлагает правки, применяет их и фиксирует каждую из них коммитом; он также может подключать дополнительные файлы для контекста, если изменения затрагивают несколько файлов сразу. Поскольку каждое изменение является коммитом, отмена действий агента выполняется обычной командой git revert — это и есть страховочный механизм, который делает использование инструмента комфортным. Goose устанавливается с помощью задокументированного однострочного скрипта и работает аналогичным образом из терминала, выполняя задачи через свои расширения:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

Размещаемая модель или self-hosted модель

Размещаемая модель (hosted) обеспечивает наилучшее качество и не требует локального оборудования, но вы платите за каждый токен, а ваш код отправляется провайдеру. Расходы на токены растут быстрее, чем ожидается, так как агент повторно отправляет всю историю переписки на каждом шаге. Разбор Claude Code о том, на что на самом деле уходят токены в длинных сессиях агента, применим и здесь, поскольку Aider и Goose используют ту же схему тарификации. Self-hosted модель через Ollama сохраняет все данные на вашем сервере и бесплатна в использовании после покупки оборудования, но для эффективной работы модели для программирования требуется значительный объем оперативной памяти. Это компромисс, который нужно оценить: качество и удобство против конфиденциальности и стоимости.

Если вы выбираете self-hosted вариант, практический вопрос заключается в том, какая модель подойдет для вашего сервера. Следите за размером контекстного окна, так как Ollama по умолчанию устанавливает небольшое значение и без предупреждения обрезает всё, что выходит за его пределы. Для агента программирования это означает, что файлы, которые он только что прочитал, исчезают из промпта: увеличение num_ctx решает эту проблему, а необходимый для этого увеличенный KV-кэш — это часть объема памяти, который нужно заложить в бюджет. Рассчитайте требования перед тем, как загружать восьмигигабайтную модель на сервер, который не сможет её запустить:

Безопасность: редактирование файлов и выполнение команд

Агент для написания кода не является пассивным инструментом. Он перезаписывает файлы и может запускать команды сборки и тестирования, поэтому относитесь к нему с той же осторожностью, что и к любому процессу, способному изменять вашу систему. Три правила позволяют минимизировать большинство рисков. Работайте внутри репозитория git, чтобы каждое изменение отслеживалось и его можно было отменить — Aider делает это автоматически. Запускайте агента от имени обычного пользователя без привилегий, никогда не используйте root, следуя принципу пользователей с минимальными правами, чтобы вредоносная команда не могла повлиять на всю систему. Обеспечьте защиту самого сервера, так как VPS для разработки остается публичным сервером: используйте только SSH-ключи, межсетевой экран с политикой запрета по умолчанию и другие меры безопасности. В руководстве по защите OpenClaw придерживаются аналогичного подхода для более автономных агентов, и эти принципы применимы повсеместно.

Чтобы интегрировать агента для написания кода в свой рабочий процесс, ознакомьтесь с созданием AI-агента с помощью Claude, где показано, как модель управляет вашими инструментами; запуск Google Gemini CLI на VPS — это еще один вариант для терминала, а самостоятельный хостинг OpenHands представляет собой более сложный путь для автономной работы. Самый популярный открытый проект в этой области теперь имеет собственное руководство: запуск OpenCode на VPS описывает настройку с использованием tmux и пользователя без привилегий.

FAQ

Можно ли запустить агент для программирования с локальной моделью вместо платного API?

Да. И Aider, и Goose работают с локальными моделями, запущенными через Ollama. Вы можете использовать агент для программирования полностью на собственном сервере без оплаты за токены и без передачи кода вовне. Основное ограничение — оперативная память: модели, способной писать качественный код, требуется значительный объем RAM или VRAM. Подбирайте характеристики сервера под требования модели до начала работы.

Что выбрать: Aider или Goose?

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

Сколько памяти нужно для локальной модели программирования?

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

Безопасно ли позволять ИИ-агенту редактировать код и выполнять команды?

Это безопасно при соблюдении правильных привычек. Храните работу в git-репозитории, чтобы каждое изменение можно было отменить через коммит. Запускайте агента от имени непривилегированного пользователя, а не root, и защищайте VPS так же, как любой публичный сервер. Проверяйте изменения, которые вносит агент, вместо того чтобы доверять ему слепо, особенно если он запрашивает выполнение команд в вашей системе.