Як запустити coding agent на VPS у терміналі

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

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

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

Що потрібно

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

Встановлення та запуск 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 модель

Хостингова модель забезпечує найкращу якість і не потребує локального обладнання, але ви платите за кожен токен, а ваш код передається провайдеру. Витрати на токени зростають швидше, ніж очікує більшість користувачів, оскільки агент під час кожного кроку повторно надсилає всю розмову. Пояснення Claude Code про реальні витрати токенів під час тривалої сесії агента застосовне і тут, оскільки Aider і Goose використовують таку саму модель розрахунку. Self-hosted модель через Ollama зберігає всі дані на вашому сервері та після придбання обладнання не потребує оплати за запуск, але для корисної роботи з кодом моделі потрібен значний обсяг пам’яті. Це і є компроміс, який потрібно оцінити: якість і зручність проти приватності та вартості.

Якщо ви обираєте self-hosted варіант, практичне питання полягає в тому, яка модель підходить для вашого сервера. Одразу перевірте розмір контекстного вікна, оскільки Ollama за замовчуванням використовує невелике значення та непомітно обрізає все, що його перевищує. Для coding agent це означає, що файли, які він щойно прочитав, випадають із промпту. Збільшення num_ctx усуває цю проблему, а більший KV cache, який для цього потрібен, також слід врахувати під час розрахунку обсягу пам’яті. Розрахуйте вимоги до пам’яті до завантаження моделі розміром 8 гігабайт на сервер, який не може її розмістити:

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

Агент для роботи з кодом не є пасивним. Він переписує файли та може виконувати команди складання і тестування, тому ставтеся до нього так само обережно, як до будь-якого процесу, що може змінювати систему. Більшість ризиків охоплюють три правила. Працюйте в git-репозиторії, щоб кожну зміну можна було відстежити та скасувати. Aider робить це автоматично. Запускайте агента від імені звичайного непривілейованого користувача, ніколи не від імені root, дотримуючись принципу мінімальних привілеїв користувачів, щоб помилкова команда не могла змінити всю систему. Також підтримуйте належний рівень захисту самого сервера, адже VPS для роботи з кодом усе одно є публічним сервером: SSH лише за ключами, firewall із політикою заборони за замовчуванням та інші базові заходи. У посібнику із захисту OpenClaw застосовано такий самий підхід для більш автономного агента, і ці принципи можна застосовувати в інших сценаріях.

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

FAQ

Чи можна запускати coding agent із локальною моделлю замість платного API?

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

Aider чи Goose: що вибрати?

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

Скільки пам’яті потрібно для self-hosted coding model?

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

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

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