Agent programistyczny w tymczasowej maszynie VM
Sprawdź, jak ograniczyć promień rażenia agenta: czysty stan dla każdego zadania, migawki i tani schemat VPS, który pozwala odtworzyć maszynę w 10 minut.
Dlaczego tymczasowa maszyna wirtualna jest lepsza niż laptop
Udostępnienie agentowi programistycznemu tymczasowej maszyny wirtualnej oznacza, że najgorszym skutkiem jego działania może być zniszczenie maszyny, którą można odtworzyć w ciągu dziesięciu minut. Agent nadal otrzymuje uprawnienia root, nadal instaluje pakiety i nadal uruchamia zestaw testów bez pytania o zgodę na każdy krok. Różnica dotyczy miejsca, w którym powstają szkody. Na laptopie agent współdzieli katalog domowy z kluczami SSH, profilem przeglądarki, plikami .env i każdym innym repozytorium, które kiedykolwiek sklonowano. Na tymczasowym serwerze ma powłokę, kopię roboczą repozytorium i nic więcej, co warto przejąć.
Na tym polega cały argument. Dotyczy on asymetrii, a nie prawdopodobieństwa. Ostrożny agent na ostrożnie używanym laptopie niemal zawsze działa bez problemów. Gdy jednak raz coś pójdzie nie tak, kosztem nie jest nieudany commit. Jest nim odtworzenie systemu z kopii zapasowej, o ile taka kopia istnieje.
Określ zakres skutków, zanim zaczniesz o nim dyskutować
Zakres skutków oznacza zbiór elementów, do których proces ma dostęp. W przypadku agenta działającego jako zwykły użytkownik na zwykłym komputerze zbiór ten jest większy, niż większość osób zakłada.
Obejmuje on ~/.ssh/id_ed25519, który zwykle nie jest szyfrowany, ponieważ wpisywanie hasła stało się uciążliwe. Obejmuje ~/.aws/credentials i ~/.config/gh/hosts.yml, które z założenia zawierają tekst jawny. Obejmuje każde równorzędne repozytorium w ~/code, w tym te, które mają lokalny plik env z parametrami połączenia do środowiska produkcyjnego. Obejmuje również historię powłoki, w której znajdują się tokeny wklejone wcześniej. Obejmuje także sieć, do której podłączony jest laptop. Często jest to sieć domowa lub biurowa z działającymi w niej usługami bez uwierzytelniania.
Żaden z tych scenariuszy nie wymaga złośliwego agenta. Wystarczy jedna błędna, ale wykonana z przekonaniem komenda. rm -rf "$BUILD_DIR"/* z nieustawionym BUILD_DIR rozwija się do /* i omija domyślną odmowę GNU rm usunięcia samego /. Może to być również git clean -xfd w niewłaściwym katalogu, docker system prune -af --volumes, który usuwa lokalną bazę danych, albo pomocnicze chmod -R 777 wykonane w katalogu domowym. Agenty są trenowane na tym samym Internecie, który nauczył tych komend wszystkich pozostałych.
Mechanizmem, który zapewnia bezpieczeństwo, nie jest osąd agenta. Jest nim fakt, że komputer, na którym wystąpią skutki, można było utracić.
Koszt jest banalny, i właśnie o to chodzi
Mały VPS kosztuje kilka dolarów miesięcznie. Odzyskanie środowiska na laptopie deweloperskim zajmuje cały dzień. To wariant optymistyczny, w którym problem zostaje szybko wykryty i istnieje kopia zapasowa.
Wykonaj obliczenia dla własnych danych. Pomnóż swoją stawkę godzinową przez liczbę godzin potrzebnych na ponowną instalację systemu operacyjnego, odtworzenie katalogu domowego, rotację klucza SSH, rotację osobistego tokena dostępu oraz ponowne sklonowanie dwudziestu repozytoriów. Porównaj ten koszt z dwunastoma miesiącami korzystania z najtańszego serwera oferowanego przez dostawcę. Próg opłacalności zostaje osiągnięty przy mniej niż jednym incydencie na kilka lat. Incydent nie musi być katastrofalny, aby go przekroczyć. Jedno popołudnie stracone na naprawę uszkodzonego środowiska lokalnego już pokrywa koszt całego roku.
Druga część obliczeń dotyczy snapshotów. Snapshot wykonany przed ryzykownym uruchomieniem zmienia konsekwencje błędu z „odtworzyć całe środowisko” na „wykonać rollback i użyć innego promptu”. Taka możliwość nie istnieje na laptopie, na którym pisany jest ten tekst, ponieważ nie można wykonać snapshotu komputera używanego jednocześnie jako stanowisko pracy.
Krajobraz na październik 2026
Istnieją trzy rzetelne odpowiedzi na pytanie „gdzie powinien działać agent”, a każda z nich stanowi kompromis między dwoma czynnikami: siłą izolacji oraz nakładem pracy przy konfiguracji.
Lokalna mikro-VM. Narzędzia z tej kategorii uruchamiają pełnoprawną maszynę wirtualną na własnym sprzęcie, montują w niej repozytorium i przyznają agentowi uprawnienia root. clawk jest obecnym przykładem, a jego założenia są tożsame z tezą tego wpisu: zapewnij agentom programistycznym tymczasową maszynę wirtualną z systemem Linux, zamiast używać własnego laptopa. Na listopad 2026 narzędzie wspiera system macOS 14 i nowsze na procesorach Apple silicon, posiada eksperymentalne wsparcie dla systemu Linux poprzez Firecracker i instaluje się za pomocą brew install clawkwork/tap/clawk. Wewnątrz repozytorium uruchamia się clawk, aby wystartować piaskownicę i podłączyć agenta, clawk down w celu zatrzymania, oraz clawk destroy w celu usunięcia. Granicę stanowi hypervisor, co zapewnia silną izolację. Ograniczeniem jest fakt, że maszyna wirtualna działa na przenośnym urządzeniu, więc zużywa pamięć RAM i wstrzymuje pracę, gdy laptop przechodzi w stan uśpienia. Zamknięcie pokrywy jest jednym ze sposobów, które Apple wymienia jako metodę usypiania laptopów Mac, choć Apple dokumentuje również używanie komputera Mac z zamkniętą pokrywą po podłączeniu zewnętrznego monitora, klawiatury i myszy.
Kontener. Docker to rozwiązanie, które większość użytkowników ma już zainstalowane i jest ono faktycznie użyteczne.
docker run --rm -it -v "$PWD:/work" -w /work --network none ubuntu:24.04 bash--rm usuwa kontener po zakończeniu pracy, a --network none całkowicie odcina dostęp do sieci, co stanowi dobre ustawienie domyślne dla procesu budowania lub testów. Należy mieć świadomość ograniczeń: kontener współdzieli jądro systemu gospodarza, więc błąd w jądrze pozwala na ucieczkę z izolacji, a granica bezpieczeństwa znika w momencie dodania flagi --privileged lub zamontowania /var/run/docker.sock, aby agent mógł „używać Dockera”. Montowanie gniazda (socket) Dockera wewnątrz kontenera jest równoznaczne z przyznaniem temu kontenerowi uprawnień root na hoście.
Zwykły VPS z możliwością szybkiego odtworzenia. Brak nowych narzędzi, rzeczywista izolacja na poziomie jądra, migawki (snapshots) u dostawcy oraz ciągłość działania po zamknięciu laptopa. Jest to wzorzec opisany w dalszej części tego przewodnika; sprawdza się on przy długotrwałych zadaniach agenta, ponieważ zadanie trwające cztery godziny nie przerywa się po zakończeniu pracy użytkownika.
Wzorzec VPS: przydzielenie agentowi własnego użytkownika
Należy rozpocząć od utwardzonego systemu. pierwsze dziesięć minut na nowym VPS obejmuje czynności niezwiązane bezpośrednio z agentem: aktualizacje, logowanie przy użyciu użytkownika innego niż root, SSH tylko z użyciem klucza oraz zaporę sieciową.
Następnie należy utworzyć konto przeznaczone wyłącznie dla agenta, aby błąd w jego obrębie nie mógł wpłynąć na pozostałe elementy serwera.
sudo adduser --disabled-password --gecos "" agent
sudo install -d -m 700 -o agent -g agent /home/agent/work
sudo -u agent -H bash -lc 'id; ls -la ~'--disabled-password oznacza, że nie ma hasła, które można odgadnąć, a dostęp do konta uzyskuje się za pomocą sudo -u agent lub klucza SSH. Należy pamiętać, że agent celowo nie należy do grupy sudo. Agent z sudo ma uprawnienia root, a root może odczytać pliki wszystkich pozostałych użytkowników, więc utworzona separacja jest pozorna. Jeżeli agent rzeczywiście musi instalować pakiety, przemawia to za użyciem całego serwera należącego do agenta, a nie za nadaniem mu sudo na serwerze współdzielonym. Ogólne zasady opisano w zasadzie najmniejszych uprawnień dla użytkowników Linux na VPS.
Przed zaufaniem tej izolacji należy sprawdzić jej granice. Jako użytkownik agent należy spróbować wyświetlić zawartość katalogu domowego własnego konta:
sudo -u agent ls /home/youPowinien zostać wyświetlony ls: cannot open directory '/home/you': Permission denied. Jeżeli zamiast tego zostanie wyświetlona lista plików, katalog domowy jest dostępny do odczytu dla innych użytkowników, a agent może odczytać wszystkie znajdujące się w nim dane, które nie zostały dodatkowo zabezpieczone, na przykład plik .env dostępny do odczytu dla wszystkich użytkowników. Należy naprawić to za pomocą sudo chmod 700 /home/you. Ten test nie zabezpiecza prywatnego klucza SSH: ssh ignoruje plik klucza prywatnego, do którego mają dostęp inni użytkownicy, więc każdy klucz, który faktycznie działa, jest już niedostępny do odczytu dla agent, niezależnie od trybu uprawnień katalogu domowego.
Nie przechowuj poświadczeń na tej maszynie
Cel używania maszyny jednorazowej zostaje zaprzepaszczony, jeśli zostaną na nią skopiowane produkcyjne sekrety. Zasada jest prosta: na tej maszynie nie powinno być żadnego poświadczenia, którego rotacja jeszcze dziś po południu byłaby problemem.
W przypadku git należy przekazywać agent SSH zamiast kopiować klucz. Klucz prywatny pozostaje na laptopie, a przez połączenie przechodzą wyłącznie żądania podpisu.
ssh -A agent@203.0.113.10
ssh -T git@github.comDruga komenda powinna zwrócić Hi yourname! You've successfully authenticated, but GitHub does not provide shell access.. Potwierdza to, że git push zadziała bez obecności pliku klucza na serwerze. Następnie uruchom na tej maszynie ls -la ~/.ssh i potwierdź, że nie ma na niej klucza prywatnego.
Przekazywanie agenta ma jedno istotne zastrzeżenie, dlatego należy wyrazić je wprost: podczas połączenia każda osoba mająca root na tym serwerze może użyć przekazanego gniazda do uwierzytelnienia się jako użytkownik. Na serwerze, którego jedynym innym użytkownikiem jesteś Ty, jest to akceptowalny kompromis. Na współdzielonej maszynie nie jest, dlatego lepszym rozwiązaniem jest klucz wdrożeniowy ograniczony do jednego repozytorium. Dostępne możliwości opisano w Podstawy zarządzania kluczami SSH.
W przypadku kluczy API należy przydzielić agentowi osobny klucz z własnym limitem wydatków i przechowywać go w pliku należącym do użytkownika agent, z trybem 600. Po zniszczeniu maszyny należy unieważnić ten klucz, zamiast zastanawiać się, czy wyciekł. Widoczność wydatków modelu osobno dla każdego klucza pozwala również utrzymać przewidywalność wartości opisanych w Kontrola kosztów agenta AI na VPS.
Ograniczenie zasięgu agenta w sieci
Izolacja systemu plików to tylko połowa zabezpieczenia. Drugą połowę stanowi ruch wychodzący: z jakimi zasobami proces może się komunikować. Linux pozwala filtrować ruch wychodzący na podstawie użytkownika, który go wygenerował, co idealnie pasuje do tego modelu.
sudo iptables -A OUTPUT -m owner --uid-owner agent -o lo -j ACCEPT
sudo iptables -A OUTPUT -m owner --uid-owner agent -p udp --dport 53 -j ACCEPT
sudo iptables -A OUTPUT -m owner --uid-owner agent -p tcp --dport 443 -j ACCEPT
sudo iptables -A OUTPUT -m owner --uid-owner agent -j REJECTTe cztery reguły obejmują wyłącznie IPv4. Projekt netfilter wskazuje, że „ip6tables służy do konfiguracji filtra pakietów IPv6”, więc na serwerze z adresem IPv6 ruch agenta po prostu wyjdzie przez IPv6, chyba że dodasz tam analogiczne reguły:
sudo ip6tables -A OUTPUT -m owner --uid-owner agent -o lo -j ACCEPT
sudo ip6tables -A OUTPUT -m owner --uid-owner agent -p udp --dport 53 -j ACCEPT
sudo ip6tables -A OUTPUT -m owner --uid-owner agent -p tcp --dport 443 -j ACCEPT
sudo ip6tables -A OUTPUT -m owner --uid-owner agent -j REJECTReguły są odczytywane w kolejności, więc końcowe REJECT w każdym zestawie przechwytuje wszystko, na co nie pozwoliły wcześniejsze linie. Przetestuj to jako użytkownik agenta:
sudo -u agent curl -sS -m 5 http://example.comPo wprowadzeniu obu zestawów reguł, polecenie powinno natychmiast zakończyć się błędem curl: (7) Failed to connect to example.com, po którym nastąpi komunikat zależny od wersji curl, ponieważ reguły odrzucające odpowiadają bezzwłocznie, zamiast pozwalać na zawieszenie połączenia. Jeśli strona mimo to się ładuje, uruchom sudo ip6tables -S OUTPUT i sprawdź, czy reguły IPv6 są obecne: example.com odpowiada zarówno przez IPv6, jak i IPv4, więc serwer z samymi regułami IPv4 przepuści żądanie. Żądanie HTTPS do tego samego hosta powinno nadal działać.
Dwa istotne ograniczenia. Po pierwsze, reguły te zostaną utracone po restarcie, chyba że zostaną zapisane za pomocą sudo apt install -y iptables-persistent, a następnie sudo netfilter-persistent save, co zapisuje reguły IPv4 i IPv6 łącznie. Po drugie, filtrowanie odbywa się na poziomie portów i adresów, a nie nazw domenowych. Reguła zezwalająca na port 443 umożliwia połączenie z każdym hostem HTTPS w Internecie, co wystarcza do komunikacji z API modelu, ale pozwala również na dostęp do serwisów typu pastebin. Prawdziwa lista dozwolonych domen wymaga przepuszczenia ruchu przez proxy, które odczytuje żądaną nazwę hosta, co stanowi większą złożoność, niż wymagają tego typowe konfiguracje dla jednego programisty. Deklaruj tylko to, co faktycznie posiadasz: kontrolę ruchu wychodzącego na poziomie portów na maszynie, którą jesteś gotów utracić.
Powrót do czystego stanu między zadaniami
Czysty stan dla każdego zadania to niedoceniana korzyść. Agent, który przez trzy godziny pracował nad poprzednim zgłoszeniem, pozostawił zainstalowane pakiety, częściowo wykonane migracje, nieaktualny node_modules oraz drzewo robocze git ze zmianami, których nikt nie przejrzał. Kolejne zadanie dziedziczy cały ten stan, a Ty wykorzystujesz czas przeznaczony na przegląd, aby ustalić, który bałagan należy do którego uruchomienia. Węższy zakres agenta oznacza mniej pozostałości od samego początku, dlatego połączenie maszyny jednorazowej z umiejętnością kierującą agenta ku najmniejszej działającej zmianie pozwala utrzymać zarówno diff, jak i pozostały stan na poziomie umożliwiającym przegląd.
Najprostsza wersja polega na utworzeniu świeżej kopii repozytorium dla każdego zadania.
sudo -u agent -H bash -lc 'rm -rf ~/work/repo && git clone git@github.com:you/repo.git ~/work/repo'Bardziej niezawodna wersja to migawka dostawcy utworzona raz, bezpośrednio po skonfigurowaniu maszyny i przed użyciem jej przez dowolnego agenta. Przywrócenie tej migawki odtwarza cały system, włącznie z pakietami, do znanego stanu. Większość dostawców udostępnia tę funkcję w panelu sterowania lub przez API, a nie jako polecenie uruchamiane na maszynie, dlatego dokładne kroki zależą od dostawcy. Należy utworzyć migawkę, gdy maszyna jest jeszcze w podstawowym, niezmienionym stanie.
Wszystko, na czym Ci zależy, przechowuj poza maszyną jednorazową. W praktyce oznacza to głównie wypychanie branchy zamiast gromadzenia ich lokalnie. Jeśli na maszynie znajdzie się jednak coś, czego utrata byłaby problemem, wykonaj prawidłową kopię zapasową za pomocą kopii zapasowych restic na VPS. Maszyna, którą można zniszczyć, jest użyteczna tylko wtedy, gdy jej zniszczenie rzeczywiście nie powoduje problemów.
Jeśli chcesz mieć kilka odizolowanych środowisk bez opłacania kilku serwerów, jeden większy VPS może bezpośrednio hostować maszyny wirtualne gościa. Wirtualizacja zagnieżdżona na VPS wyjaśnia zasadę działania tego rozwiązania, w tym sposób sprawdzenia, czy dostawca na nie zezwala. Izolacja działa w obie strony. Jeśli wolisz, aby dwa agenty koordynowały pracę na tej samej maszynie, zamiast działać w całkowitym odseparowaniu, jedna sesja Claude Code może wysyłać tekst bezpośrednio do drugiej zamiast przekazywać każde przekazanie przez Ciebie.
Kiedy laptop przy zachowaniu ostrożności rzeczywiście wystarcza
Należy zachować w tej kwestii uczciwość, ponieważ przesadne przedstawianie zalet izolacji sprawia, że użytkownicy przestają słuchać.
Jeżeli każde polecenie jest sprawdzane przed wykonaniem, laptop wystarcza. Monit o uprawnienia jest rzeczywistym mechanizmem kontroli, a bezpieczne uruchamianie Claude Code na serwerze wyjaśnia, co dokładnie blokuje każdy poziom tego mechanizmu. Jeżeli praca obejmuje jedno repozytorium i na komputerze nie ma żadnych danych uwierzytelniających do systemów produkcyjnych, zakres potencjalnych skutków jest już niewielki. Jeżeli sesje agenta są krótkie i nadzorowane, krótki jest również czas ekspozycji.
Sytuacja zmienia się w chwili pomijania monitów. Warto wziąć to pod uwagę, ponieważ tryb automatyczny jest domyślnym trybem Claude Code, a świeża instalacja nie pyta już użytkownika przed edycją plików ani wykonaniem poleceń. Uruchomienia bez nadzoru, zadania wykonywane przez noc oraz każdy proces, w którym zatwierdzany jest plan, a następnie pozostawia się system bez nadzoru, usuwają kontrolę człowieka zapewniającą ograniczenie skutków błędu. W takiej sytuacji kontrolę musi przejąć komputer. Dotyczy to również wszystkiego, co zwiększa zasięg działania agenta, w tym uruchamiania agenta programistycznego na VPS jednocześnie w kilku repozytoriach.
Decyzja nie dotyczy w rzeczywistości stopnia zaufania do modelu. Dotyczy tego, co znajduje się obok niego, gdy model popełni błąd.
FAQ
Czy kontener zapewnia wystarczającą izolację dla agenta programistycznego?
W większości przypadków tak, pod dwoma warunkami. Kontener nie może działać z --privileged i nie może mieć zamontowanego /var/run/docker.sock, ponieważ oba te elementy dają procesowi ścieżkę do uzyskania uprawnień root na hoście. Kontener współdzieli jądro systemu hosta, więc granica bezpieczeństwa jest słabsza niż w przypadku maszyny wirtualnej. Jeśli agent uruchamia niezaufany kod pobrany z Internetu, należy preferować pełną maszynę wirtualną lub oddzielny serwer.
Czy agent potrzebuje sudo na serwerze?
Nie, a przyznanie mu sudo niweluje zbudowaną izolację, ponieważ użytkownik root może odczytać dane każdego innego konta na serwerze. Należy utworzyć użytkownika dla agenta bez uprawnień sudo i nadać mu dostęp do zapisu wyłącznie w jego własnym katalogu roboczym. Jeśli zadanie faktycznie wymaga instalacji pakietów, należy zapewnić agentowi dedykowaną maszynę, zamiast przyznawać uprawnienia root na maszynie współdzielonej.
Jak umożliwić agentowi wypychanie zmian do git bez umieszczania klucza SSH na serwerze?
Podczas łączenia należy przekazać agenta SSH za pomocą ssh -A. Żądania podpisu są przesyłane przez połączenie, podczas gdy klucz prywatny pozostaje na laptopie, dzięki czemu ssh -T git@github.com uwierzytelnia operacje, a git push działa bez obecności klucza prywatnego na serwerze. Ograniczeniem jest fakt, że użytkownik root na tym serwerze może użyć przekazanego gniazda, gdy użytkownik jest połączony, dlatego na maszynach współdzielonych z innymi osobami należy używać klucza wdrożeniowego (deploy key) o zakresie ograniczonym do konkretnego repozytorium.
Jakiego rozmiaru VPS potrzebuje agent?
Praca agenta polega głównie na edycji plików, uruchamianiu kompilacji i testów, dlatego rozmiar maszyny należy dobrać pod kątem procesu budowania, a nie modelu. Hostowany model działa na sprzęcie dostawcy, co generuje ruch sieciowy, ale prawie nie obciąża lokalnie maszyny. Sam agent wyznacza jednak próg minimalny: według stanu na 3 listopada 2026, wymagania systemowe Claude Code określają 4 GB pamięci RAM jako minimum. Należy zacząć od 4 GB nawet w przypadku pracy skryptowej i zwiększyć zasoby do 8 GB, jeśli repozytorium buduje kontenery lub kompiluje bardziej złożone projekty.
Jak często należy usuwać i odtwarzać maszynę?
Maszynę należy odtwarzać, gdy jej stan przestaje być przewidywalny, a w każdym przypadku, gdy mogło dojść do ujawnienia jakichkolwiek danych uwierzytelniających na serwerze. Świeże pobranie kodu (checkout) między zadaniami pozwala wyeliminować bieżące rozbieżności, a migawka wykonana przed pierwszym uruchomieniem agenta zapewnia czysty obraz systemu, do którego można wrócić. Jeśli odtwarzanie maszyny wydaje się kosztowne, jest to sygnał, że na maszynie uznanej za tymczasową znajdują się ważne dane.