Zanim pierwszy raz odejdziesz od komputera

Instalacja Serwera, sparowanie telefonu kodem QR, połączenie bezpośrednie kontra Relay i pierwsze zadanie dla Agenta. Krok po kroku.

12 minut Zaktualizowano 2026-09-13

Czego będziesz potrzebować

Komputer z macOS, Windows albo Ubuntu, na którym leży projekt, nad którym chcesz pracować.
Node.js 20 lub nowszy — w nim działa Agent.
Dane logowania do Anthropic API w zmiennej ANTHROPIC_API_KEY, albo subskrypcja Claude, do której Agent zaloguje się sam.
Telefonu z aplikacją coden i aparatem.

Własnego serwera nie potrzebujesz. Rendezvous i Relay, przez które telefon z komputerem się odnajdą, prowadzimy my, a Serwer zna je sam.

1. Zainstaluj Serwer

Pobierz paczkę dla swojego systemu ze strony pobierania. Każdy system ma własny instalator i wszystkie robią to samo: wkładają polecenie coden do PATH, więc potem uruchomisz je skądkolwiek.

macOS: Dwuklik w .pkg i przeklikanie kreatora. Pakiet jest podpisany i notaryzowany, więc Gatekeeper nie pyta.
Windows: Dwuklik w .msi i przeklikanie kreatora. Po instalacji otwórz nowe okno wiersza poleceń — do starego zmiana PATH nie dotrze.
Ubuntu i Debian: Dwuklik w .deb otworzy go w instalatorze systemowym. Z terminala jest to sudo apt install ./coden_*.deb.

$ coden --version

Kiedy polecenie nie zostaje znalezione, otwórz nowy terminal. PATH nie dociera do już uruchomionych.

2. Uruchom Serwer nad projektem

Serwer obsługuje jeden katalog. Ten, który mu przekażesz, to dokładnie ten, w którym Agent będzie pracował i uruchamiał polecenia. Nic o projekcie nie jest zapisywane poza nim.

$ cd ~/projekty/muj-projekt
$ coden start

Bez dalszych przełączników Serwer obsługuje katalog, w którym go uruchomiłeś. Inny da się przekazać przez --dir:

$ coden start --dir ~/projekty/jiny-projekt

Serwer zostaje na pierwszym planie i wypisuje, co się dzieje. Zostaw to okno otwarte — to jedyne miejsce, gdzie zobaczysz, że ktoś się połączył.

Więcej projektów znaczy więcej Serwerów, każdy w swoim oknie. W aplikacji przełączasz się potem między nimi, a każdy trzyma własne Rozmowy, testy i historię.

3. Sparuj telefon

W drugim oknie terminala, kiedy Serwer działa:

$ coden pair

Wypisze się kod QR. W aplikacji stuknij Sparuj i skieruj na niego aparat. Kod jest ważny kilka minut i tylko na jedno parowanie — po użyciu jest do niczego.

Tego kodu nikomu nie pokazuj i nie fotografuj go. Niesie poza tożsamością twojego komputera także dostęp do Usługi. Kto go ma, dostanie się dalej, niż byś chciał.

4. Połączenie bezpośrednie albo przez Relay

Po sparowaniu telefon połączy się sam, a w aplikacji widać, którędy. Różnicy nie musisz ustawiać — wybierana jest lepsza z pozostałych możliwości — ale dobrze wiedzieć, co który stan znaczy:

Połączenie bezpośrednie: Dane płyną z telefonu do komputera i nigdzie indziej. Najszybciej, żadnego limitu, nic nie przechodzi przez naszą Usługę. Działa, kiedy oba urządzenia są w tej samej sieci albo kiedy udaje się przebić przez NAT.
Przez Relay: Dane podaje nasz serwer. Na danych mobilnych i w sieciach firmowych, gdzie połączenie bezpośrednie nie wchodzi w grę, to jedyna droga. Ruch jest zaszyfrowany od telefonu po Serwer, więc treści nie widzimy — tylko ją przesyłamy dalej.

Aplikacja sama spróbuje przełączyć się na bezpośrednie, gdy tylko się da — typowo kiedy wracasz do domu na wi-fi. Relay da się wyłączyć w Ustawieniach; ale wtedy w sieci, która połączenia bezpośredniego nie pozwala, nie połączysz się wcale.

Rendezvous to ta część Usługi, która zapoznaje obie strony. Bez niej telefon nie wiedziałby, gdzie się połączyć — adres komputera wszak się zmienia. Przenosić przez nią danych jednak nie można.

5. Zleć pierwsze zadanie

Zacznij od czegoś, po czym poznasz, czy Agent zrobił to dobrze. Na przykład:

Przejdź README i napisz mi, czego w nim brakuje, żeby dało się według niego uruchomić projekt na czystym komputerze.

Po drodze zobaczysz, które pliki Agent czyta i co uruchamia. Przy pierwszym poleceniu zapyta o zgodę — to normalne i to ustawienie domyślne. Kiedy chcesz, żeby o dany rodzaj działania już nie pytał, udziel stałej zgody; odebrać można ją w Ustawieniach w każdej chwili.

Pracuje tam Claude Code, czyli ten sam Agent, którego znasz z terminala. Umie to samo i zachowuje się tak samo; różnica jest tylko w tym, że wejście i wyjście idą przez telefon i że CLAUDE.md, skille i ustawienia w projekcie obowiązują dokładnie tak jak przy komputerze.

6. Odejdź od komputera

To jest ta część, dla której coden istnieje. Daj dłuższe zadanie, zablokuj telefon i idź. Agent pracuje dalej. Kiedy skończy, przyjdzie powiadomienie; kiedy się połączysz, dotrze całe wyjście, które cię tymczasem ominęło.

Żeby to działało, komputer nie może zasnąć — na to jest osobny poradnik. A kiedy nie chcesz odbiegać do zatwierdzania, zajrzyj do pozwolenia na pracę bez zatwierdzania.

Kiedy telefon się nie łączy

Aplikacja pisze „kod parowania wygasł": Uruchom coden pair jeszcze raz. Kod jest krótko ważny celowo.
Telefon jest na danych komórkowych i połączenie się nie ustanawia: Niektóre sieci komórkowe nie pozwalają na połączenie bezpośrednie. Sprawdź w aplikacji, że masz włączony Relay — bez niego w takiej sieci się nie połączysz.
Aplikacja zgłasza niezgodność klucza: Serwer ma inną tożsamość niż ta, którą telefon pamięta — zwykle dlatego, że skasowałeś jego katalog ze stanem. Sparuj jeszcze raz. Kontynuowania „mimo to" aplikacja celowo nie proponuje.
„Serwer obsługuje inne urządzenie": Podłączony jest inny sparowany telefon. Wypisz je poleceniem coden clients.

Przydatne polecenia

$ coden status    # działa? kto jest podłączony? jak długo?
$ coden clients   # sparowane urządzenia, ostatnie połączenie
$ coden stop      # kontrolowane zamknięcie

Zacięło się gdzie indziej niż to, co tu jest? Napisz na support@coden-app.com.