Як запустити coding AI agent на VPS

Навіщо запускати coding agent на VPS

Coding agent — це інструмент, який читає ваш codebase, вносить зміни та запускає команди для їх тестування безпосередньо з термінала. Запуск на VPS має три переваги перед ноутбуком: робота триває після розриву з'єднання, агент знаходиться поруч із вашим кодом та інструментами збірки, а також він може взаємодіяти з моделлю, яку ви хостите самостійно. Запустіть його в сесії tmux, щоб можна було закрити ноутбук і повернутися до роботи пізніше; це той самий підхід, що й у running Claude Code on a VPS with tmux.

Варто знати про двох агентів для термінала. Aider — це нативний для термінала варіант з фокусом на git: він автоматично робить commit кожної зміни з відповідним повідомленням, тому ваша історія залишається чистою, а кожне редагування можна скасувати. Це один із найстаріших термінальних coding agent, хоча темпи його випуску сповільнилися. Goose від Block є більш універсальним: це агент з ліцензією Apache-2.0, великою екосистемою розширень та підтримкою багатьох провайдерів, включаючи локальні моделі Ollama; зараз він розробляється в межах Linux Foundation's Agentic AI Foundation (AAIF). Aider підходить для дисциплінованого робочого процесу, орієнтованого на git; Goose підходить як більш загальний асистент із широким набором плагінів.

Що вам знадобиться

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

Встановлення та запуск Aider

Встановіть Aider в ізольованому середовищі за допомогою pipx. Це необхідно, оскільки 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 у версії 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, щоб переглянути зміни. Aider читає ваш репозиторій, пропонує правки, застосовує їх і робить commit для кожної зміни; він також може залучати додаткові файли для контексту, якщо зміна охоплює кілька файлів. Оскільки кожна зміна — це commit, скасування дій агента — це звичайний git revert, що є надійним механізмом захисту. Goose встановлюється за допомогою документального скрипта в один рядок і працює схожим чином через термінал, виконуючи завдання через свої розширення:

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

Хостована модель або self-hosted модель

Хостована модель забезпечує найкращу якість і не потребує локального обладнання, але вона коштує грошей за кожен токен, а ваш код надсилається провайдеру. Витрати на токени зростають швидше, ніж очікується, оскільки агент пересилає всю розмову на кожному кроці. Аналіз what a long agent session really spends on tokens від Claude Code також застосовний тут, оскільки Aider та Goose тарифікують так само. Використання self-hosted моделі через Ollama зберігає все на вашому сервері, і це безкоштовно після оплати обладнання, але для корисної моделі кодування потрібна значна кількість оперативної пам'яті. Це компроміс, який слід зважити: якість і зручність проти приватності та вартості.

Якщо ви обираєте self-hosted, головне питання — яка модель підійде вашому серверу. Визначте розмір моделі перед тим, як завантажувати восьмигігабайтний файл на пристрій, який не може його вмістити:

Безпека: він редагує файли та запускає команди

Coding agent не є пасивним. Він перезаписує файли та може запускати команди збірки та тестування, тому ставтеся до нього так само обережно, як до будь-якого процесу, що може змінити вашу систему. Три звички мінімізують ризики. Працюйте всередині git-репозиторію, щоб кожна зміна була відстежувана та її можна було скасувати (Aider робить це автоматично). Запускайте агента від імені звичайного непривілейненого користувача, а не root, дотримуючись принципу least-privilege users, щоб шкідлива команда не змогла змінити всю систему. Також захищайте сам сервер, оскільки VPS для кодування залишається публічним сервером: використовуйте лише SSH-ключі, налаштуйте firewall за принципом "заборонено все, що не дозволено" тощо. OpenClaw hardening guide пропонує такий самий підхід для автономних агентів, і ці принципи є універсальними.

Щоб інтегрувати coding agent у свій робочий процес, building an AI agent with Claude показує, як одна модель керує вашими інструментами; running Google's Gemini CLI on a VPS — це ще один варіант для термінала, а self-hosting OpenHands — це більш важкий шлях автономності. Найпопулярніший open-source проєкт у цій сфері тепер має власну інструкцію: running OpenCode on a VPS налаштовує його за тим самим шаблоном з використанням tmux та непривілейненого користувача.

FAQ

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

Так. І Aider, і Goose працюють з локальними моделями через Ollama, тому ви можете запустити coding agent повністю self-hosted без витрат на токени та без передачі коду на сторонні сервери. Обмеження полягає в пам'яті: моделі, достатній для написання коду, потрібно багато RAM або VRAM, тому перевірте можливості заліза перед вибором моделі.

Що обрати: Aider чи Goose?

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

Скільки пам'яті потрібно для self-hosted моделі кодування?

Це залежить від розміру моделі та ступеня її квантування. Мала квантована модель може працювати на кількох гігабайтах, тоді як потужнішим моделям потрібно значно більше, і це збільшується при великому контексті. Використовуйте інструмент оцінки вище, щоб визначити необхідний обсяг пам'яті для конкретної моделі та довжини контексту перед завантаженням.

Чи безпечно дозволяти AI агенту редагувати мій код і запускати команди?

Це безпечно за умови дотримання правил. Тримайте роботу в git-репозиторії, щоб кожна зміна була комітом, який можна скасувати; запускайте агента від імені непривілейненого користувача, а не root; і захищайте VPS так само, як будь-який публічний сервер. Перевіряйте зміни, які він робить, а не довіряйте їм сліпо, особливо командам, які він намагається виконати у вашій системі.