Jak uruchomić agenta AI na VPS

Dl warto uruchamiać agenta kodującego na VPS

Agent kodujący to narzędzie, które odczytuje bazę kodu, wprowadza zmiany i uruchamia polecenia w celu ich przetestowania, a wszystko to odbywa się z poziomu terminala. Uruchomienie agenta na VPS daje trzy przewagi nad laptopem: proces kontynuowany jest po rozłączeniu, agent znajduje się bezpośrednio obok kodu i narzędzi budowania oraz może komunikować się z modelem hostowanym samodzielnie. Uruchomienie agenta w sesji tmux pozwala zamknąć laptopa i wrócić do pracy później, zgodnie ze schematem opisanym w uruchamianiu Claude Code na VPS przy użyciu tmux.

Warto znać dwóch agentów terminalowych. Aider to opcja natywna dla terminala i oparta na systemie git: automatycznie tworzy commit dla każdej zmiany z odpowiednią wiadomością, dzięki czemu historia pozostaje przejrzysta, a każda edycja jest odwracalna. Jest to jeden z najstarszych agentów kodujących w terminalu, mimo że tempo jego wydawania spadło. Goose od Block jest bardziej rozbudowany: to agent na licencji Apache-2.0 z rozległym ekosystemem rozszerzeń i wsparciem dla wielu dostawców, w tym lokalnych modeli Ollama; obecnie rozwijany w ramach Agentic AI Foundation (AAIF) pod egidą Linux Foundation. Aider pasuje do zdyscyplinowanego przepływu pracy opartego na git; Goose pasuje jako bardziej ogólny asystent z szerokim zestawem wtyczek.

Wymagania

Wymagany jest VPS z zainstalowanymi git, tmux oraz nową wersją Python dla Aider lub instalatorem Goose dla Goose. Niezbędny jest również model: klucz API od dostawcy takiego jak Anthropic lub OpenAI, bądź lokalny model obsługiwany przez Ollama na tym samym VPS. Rozwiązanie typu self-hosted zapewnia prywatność kodu na własnym serwerze i nie generuje kosztów za tokeny, kosztem konieczności posiadania wystarczającej ilości pamięci dla wydajnego modelu.

Instalacja i uruchamianie Aider

Aider należy zainstalować w izolowanym środowisku za pomocą pipx, który pochodzi z pakietu apt, ponieważ Ubuntu 24.04 blokuje instalację pip install poza środowiskiem wirtualnym (PEP 668). Następnie należy uruchomić Aider wewnątrz projektu, w sesji tmux, aby zapewnić ciągłość pracy po rozłączeniu:

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

Uwaga dotycząca wersji: ta metoda instalacji działa na Ubuntu 24.04. Na Ubuntu 26.04 instalacja obecnie kończy się błędem, ponieważ zależności Aider zawierają starszą wersję numpy, która nie buduje się dla Python 3.14 w wersji 26.04. Rozwiązaniem jest przypisanie Aiderowi własnej wersji Python 3.12:

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

pipx pobiera samodzielny interpreter tylko dla Aider, co kończy proces instalacji. Jest to skutek spowolnionego tempa wydawania wersji przez Aider; jeśli jest to problemem, Goose jest rozwiązaniem częściej aktualizowanym.

Po uruchomieniu należy odłączyć się od sesji za pomocą Ctrl-b, a następnie d, co pozwoli agentowi pracować przy zamkniętym laptopie; ponowne połączenie następuje za pomocą tmux attach -t aider w celu sprawdzenia wprowadzonych zmian. Aider odczytuje repozytorium, proponuje edycje, stosuje je i tworzy commit dla każdej z nich; może również pobierać dodatkowe pliki jako kontekst, gdy zmiana obejmuje wiele plików. Ponieważ każda zmiana jest commitem, wycofanie działań agenta to zwykły git revert, co stanowi zabezpieczenie ułatwiające użytkowanie. Goose instaluje się za pomocą dokumentowanego skryptu jednolinijnego i działa podobnie z poziomu terminala, realizując zadania poprzez rozszerzenia:

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

Model hostowany czy model self-hosted

Model hostowany zapewnia najwyższą jakość i nie wymaga lokalnego sprzętu, ale generuje koszty za każdy token, a kod jest przesyłany do dostawcy. Koszty za tokeny rosną szybciej niż przewiduje większość użytkowników, ponieważ agent przesyła całą konwersację przy każdej iteracji. Analiza Claude Code dotycząca rzeczywistych kosztów tokenów w długiej sesji agenta ma zastosowanie również tutaj, ponieważ Aider i Goose rozliczają się w ten sam sposób. Model self-hosted poprzez Ollama utrzymuje wszystkie dane na serwerze i jest bezpłatny w eksploatacji po opłaceniu sprzętu, jednak model kodujący zdolny do użytecznego działania wymaga dużej ilości pamięci. Jest to kompromis do rozważenia: jakość i wygoda kontra prywatność i koszt.

W przypadku modelu self-hosted kluczowym pytaniem jest wybór modelu pasującego do serwera. Należy sprawdzić wymagania sprzętowe przed pobraniem ośmiogigabajtowego modelu na maszynę, która nie jest w stanie go obsłużyć:

Bezpieczeństwo: edycja plików i uruchamianie poleceń

Agent kodujący nie jest pasywny. Nadpisuje pliki i może uruchamiać polecenia budowania oraz testowania, dlatego należy traktować go z taką samą ostrożnością jak każdy proces zdolny do zmiany systemu. Trzy nawyki minimalizują ryzyko. Należy pracować wewnątrz repozytorium git, aby każda zmiana była śledzona i odwracalna, co Aider wykonuje automatycznie. Agenta należy uruchamiać jako zwykły użytkownik bez uprawnień administratora, nigdy jako root, zgodnie z zasadą użytkowników o najniższych uprawnieniach, aby błędne polecenie nie mogło uszkodzić całego systemu. Należy również zadbać o zabezpieczenie serwera, ponieważ VPS do kodowania pozostaje serwerem publicznym: należy stosować SSH wyłącznie z kluczem, firewall z domyślną polityką deny oraz inne zabezpieczenia. Przewodnik OpenClaw hardening guide przyjmuje analogiczne podejście dla bardziej autonomicznych agentów, a zasady te są uniwersalne.

Aby zintegrować agenta kodującego z własnym przepływem pracy, budowanie agenta AI z Claude pokazuje, jak jeden model steruje narzędziami; uruchamianie Google Gemini CLI na VPS to kolejna opcja terminalowa, a self-hosting OpenHands to rozwiązanie bardziej autonomiczne. Najpopularniejszy projekt open-source w tej dziedzinie posiada własny poradnik: uruchamianie OpenCode na VPS opisuje konfigurację przy użyciu tego samego wzorca tmux i użytkownika bez uprawnień administratora.

FAQ

Czy mogę uruchamiać agenta kodującego z lokalnym modelem zamiast płatnego API?

Tak. Zarówno Aider, jak i Goose współpracują z lokalnymi modelami obsługiwanymi przez Ollama, co pozwala na pełną samodzielną eksploatację agenta bez kosztów za tokeny i bez przesyłania kodu poza serwer. Ograniczeniem jest pamięć: model zdolny do pisania użytecznego kodu wymaga znacznej ilości RAM lub VRAM, dlatego przed wyborem modelu należy dostosować parametry maszyny.

Aider czy Goose – którego wybrać?

Należy wybrać Aider, jeśli przepływ pracy opiera się na terminalu i systemie git oraz jeśli wymagane jest najbardziej dojrzałe rozwiązanie o niskim narzucie; automatycznie tworzy on commit dla każdej zmiany, co zapewnia możliwość odwrócenia operacji. Należy wybrać Goose, jeśli wymagany jest bardziej rozbudowany asystent z szerokim ekosystemem rozszerzeń i wsparciem dla wielu dostawców. Oba narzędzia działają w terminalu i oba współpracują z Ollama, więc oba nadają się na VPS.

Ile pamięci jest potrzebne dla modelu kodującego typu self-hosted?

Zależy to od rozmiaru modelu oraz stopnia jego kwantyzacji. Mały, skwantyzowany model może działać na kilku gigabajtach, podczas gdy silniejszy model wymaga znacznie więcej, a długie okna kontekstowe dodatkowo zwiększają zapotrzebowanie. Należy użyć powyższego narzędzia do szacowania, aby określić zapotrzebowanie na pamięć dla danego modelu i długości kontekstu przed rozpoczęciem pobierania.

Czy bezpieczne jest dopuszczenie agenta AI do edycji kodu i uruchamiania poleceń?

Jest to możliwe przy zachowaniu odpowiednich nawyków. Należy trzymać prace w repozytorium git, aby każda edycja była odwracalnym commitem, uruchamiać agenta jako użytkownika bez uprawnień administratora (nie jako root) oraz zabezpieczyć VPS zgodnie ze standardami dla serwerów publicznych. Należy weryfikować zmiany wprowadzane przez agenta, zamiast ufać im bezkrytycznie, w szczególności polecenia, które agent chce uruchomić w systemie.