Jak uruchomić agenta AI do kodowania na VPS

Dlaczego warto uruchomić agenta programistycznego na VPS

Agent programistyczny to narzędzie, które analizuje kod źródłowy, wprowadza zmiany i wykonuje polecenia w celu ich przetestowania, działając w całości z poziomu terminala. Uruchomienie go na VPS oferuje trzy przewagi nad laptopem: praca trwa po rozłączeniu, agent znajduje się w bezpośrednim sąsiedztwie kodu i narzędzi budowania oraz może komunikować się z modelem hostowanym samodzielnie. Uruchomienie w sesji tmux pozwala zamknąć laptopa i wznowić pracę w dowolnym momencie, zgodnie ze schematem opisanym w uruchamianie Claude Code na VPS z użyciem tmux.

Warto znać dwa agenty działające w terminalu. Aider to rozwiązanie natywne dla terminala, stawiające na pierwszym miejscu git: automatycznie zatwierdza każdą zmianę z czytelnym komunikatem, dzięki czemu historia pozostaje przejrzysta, a każda edycja jest odwracalna. Jest to jeden z najdłużej rozwijanych agentów programistycznych dla terminala, choć tempo wydawania nowych wersji spadło. Goose, stworzony przez Block, ma szersze zastosowanie: to agent na licencji Apache-2.0 z rozbudowanym ekosystemem rozszerzeń i wsparciem dla wielu dostawców, w tym lokalnych modeli Ollama, rozwijany obecnie w ramach Agentic AI Foundation (AAIF) pod egidą Linux Foundation. Aider sprawdza się w zdyscyplinowanym przepływie pracy opartym na git; Goose jest odpowiedniejszy jako wszechstronny asystent z szerokim zestawem wtyczek.

Wymagania

Wymagany jest serwer VPS z zainstalowanym git, tmux oraz aktualną wersją Python dla Aider lub instalatorem Goose dla Goose. Niezbędny jest również model: klucz API od dostawcy takiego jak Anthropic lub OpenAI albo model lokalny udostępniany przez Ollama na tym samym serwerze VPS. Rozwiązanie z własnym hostowaniem pozwala zachować kod na własnym serwerze i eliminuje koszty za token, jednak wymaga posiadania pamięci RAM wystarczającej do obsługi wydajnego modelu.

Instalacja i uruchomienie Aider

Zainstaluj Aider w odizolowanym środowisku za pomocą pipx, dostępnego w apt, ponieważ Ubuntu 24.04 blokuje zwykłe pip install poza środowiskiem wirtualnym (PEP 668). Następnie uruchom Aider wewnątrz projektu, w sesji tmux, aby proces działał 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 instalacja działa zgodnie z opisem na Ubuntu 24.04. Na Ubuntu 26.04 kończy się niepowodzeniem. Obecne wydanie, aider-chat 0.86.2 (luty 2026), obsługuje wyłącznie Python w wersjach od 3.10 do 3.12, a Ubuntu 26.04 dostarcza Python 3.14. Instalacja jest odrzucana podczas sprawdzania wersji języka Python przed pobraniem zależności. Rozwiązaniem jest dostarczenie dla Aider własnego interpretera Python 3.12:

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

Narzędzie pipx pobiera samodzielny interpreter wyłącznie dla Aider, co pozwala na ukończenie instalacji. Jest to objaw spowolnienia tempa wydań Aider: główna gałąź projektu akceptuje już Python 3.14, jednak stan na październik 2026 wskazuje, że żadne oficjalne wydanie nie zawiera tej zmiany. Jeśli jest to problematyczne, lepszym wyborem będzie aktywnie rozwijany Goose.

Po uruchomieniu odłącz się od sesji za pomocą Ctrl-b, a następnie d; agent będzie kontynuował pracę nawet po zamknięciu laptopa. Powróć do sesji później za pomocą tmux attach -t aider, aby sprawdzić wprowadzone zmiany. Możesz otworzyć drugie okno tmux dla kolejnego agenta. Jeśli oba są instancjami Claude Code, obie sesje mogą przekazywać sobie zadania bez konieczności ręcznego pośrednictwa. Aider analizuje repozytorium, proponuje edycje, stosuje je i zatwierdza każdą z nich. Może również pobierać dodatkowe pliki w celu uzyskania kontekstu, gdy zmiana dotyczy wielu z nich. Ponieważ każda zmiana jest osobnym commitem, wycofanie działań agenta sprowadza się do prostego git revert, co stanowi zabezpieczenie ułatwiające pracę. Goose instaluje się za pomocą udokumentowanego skryptu jednowierszowego i działa w podobny sposób z poziomu terminala, realizując zadania poprzez swoje 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, jednak wiąże się z kosztami za każdy token, a kod jest przesyłany do dostawcy. Koszty za token sumują się szybciej, niż większość użytkowników zakłada, ponieważ agent przy każdej iteracji przesyła ponownie całą historię konwersacji. Analiza Claude Code dotycząca tego, ile tokenów faktycznie zużywa długa sesja agenta, ma tu zastosowanie, gdyż Aider i Goose rozliczają się w ten sam sposób. Model self-hosted uruchomiony przez Ollama pozwala zachować wszystkie dane na własnym serwerze i jest darmowy w eksploatacji po zakupie sprzętu, jednak model programistyczny o wystarczającej użyteczności wymaga znacznych zasobów pamięci. To jest kompromis, który należy rozważyć: jakość i wygoda kontra prywatność i koszty.

W przypadku wyboru modelu self-hosted, kluczowym pytaniem technicznym jest to, który model zmieści się na serwerze. Należy monitorować okno kontekstowe, ponieważ Ollama domyślnie ustawia małą wartość i bez ostrzeżenia ucina dłuższe treści, co w przypadku agenta programistycznego oznacza, że pliki właśnie odczytane znikają z promptu: zwiększenie num_ctx rozwiązuje ten problem, a większa pamięć podręczna KV, której to wymaga, stanowi część budżetu pamięci RAM. Należy oszacować wymagania przed pobraniem ośmiogigabajtowego modelu na maszynę, która nie posiada wystarczających zasobów:

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

Agent programistyczny 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 mający uprawnienia do modyfikacji systemu. Trzy nawyki pozwalają pokryć większość ryzyka. Pracuj wewnątrz repozytorium git, aby każda zmiana była śledzona i odwracalna, co Aider wykonuje automatycznie. Uruchamiaj agenta jako zwykły użytkownik bez uprawnień administracyjnych, nigdy jako root, zgodnie z zasadą użytkowników z minimalnymi uprawnieniami, aby błędne polecenie nie mogło wpłynąć na cały system. Dbaj również o zabezpieczenie samej maszyny, ponieważ VPS z agentem programistycznym pozostaje serwerem publicznym: stosuj logowanie SSH wyłącznie przez klucze, domyślną politykę firewall typu deny oraz pozostałe standardy. Przewodnik po zabezpieczeniach OpenClaw przyjmuje to samo stanowisko w przypadku bardziej autonomicznych agentów, a te zasady mają zastosowanie uniwersalne.

Aby włączyć agenta programistycznego do własnego przepływu pracy, budowanie agenta AI z Claude pokazuje, jak jeden model steruje narzędziami; uruchamianie Gemini CLI od Google na VPS to kolejna opcja terminalowa, a samodzielne hostowanie OpenHands stanowi bardziej rozbudowaną, autonomiczną ścieżkę. Najpopularniejszy projekt open source w tej dziedzinie posiada obecnie własny przewodnik: uruchamianie OpenCode na VPS konfiguruje go przy użyciu tego samego schematu z tmux oraz użytkownikiem bez uprawnień root.

FAQ

Czy mogę uruchomić agenta programistycznego z lokalnym modelem zamiast płatnego API?

Tak. Zarówno Aider, jak i Goose współpracują z lokalnymi modelami udostępnianymi przez Ollama, dzięki czemu można uruchomić agenta programistycznego w pełni we własnej infrastrukturze, bez kosztów za token i bez przesyłania kodu poza serwer. Ograniczeniem jest pamięć: model wystarczająco wydajny, aby pisać użyteczny kod, wymaga znacznej ilości pamięci RAM lub VRAM, dlatego przed podjęciem decyzji należy dobrać parametry maszyny do modelu.

Aider czy Goose, co wybrać?

Wybierz Aider, jeśli Twój proces pracy opiera się na terminalu i git, a zależy Ci na najbardziej dojrzałym rozwiązaniu o najniższym narzucie; narzędzie automatycznie zatwierdza każdą zmianę, dzięki czemu historia pozostaje odwracalna. Wybierz Goose, jeśli potrzebujesz bardziej rozbudowanego asystenta z dużym ekosystemem rozszerzeń i wsparciem dla wielu dostawców. Oba narzędzia działają z poziomu terminala i oba współpracują z Ollama, więc każde z nich sprawdzi się na VPS.

Ile pamięci potrzeba dla lokalnego modelu programistycznego?

Zależy to od rozmiaru modelu i 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ą to zapotrzebowanie. Użyj powyższego narzędzia do szacowania, aby określić pamięć wymaganą dla danego modelu i długości kontekstu przed jego pobraniem.

Czy bezpieczne jest zezwalanie agentowi AI na edycję kodu i uruchamianie poleceń?

Jest to możliwe do opanowania przy odpowiednich nawykach. Przechowuj pracę w repozytorium git, aby każda edycja była odwracalnym commitem, uruchamiaj agenta jako użytkownik bez uprawnień, a nie jako root, i zabezpiecz VPS tak, jak każdy inny serwer publiczny. Weryfikuj zmiany, które agent zatwierdza, zamiast ufać im bezkrytycznie, zwłaszcza w przypadku poleceń, które mają zostać wykonane w systemie.