Než prvýkrát odídete od počítača
Inštalácia Servera, spárovanie telefónu QR kódom, priame spojenie verzus Relay a prvá úloha pre Agenta. Krok za krokom.
Čo budete potrebovať
- Počítač s macOS, Windows alebo Ubuntu, na ktorom máte projekt, na ktorom chcete pracovať.
- Node.js 20 a novší — v ňom beží Agent.
- Prihlasovacie údaje k Anthropic API v premennej
ANTHROPIC_API_KEY, alebo predplatné Claude, ku ktorému sa Agent prihlási sám. - Telefón s aplikáciou coden a fotoaparátom, alebo aplikáciu coden v okne na počítači.
Vlastný server nepotrebujete. Rendezvous a Relay, cez ktoré sa telefón s počítačom nájdu, prevádzkujeme my a Server ich pozná sám.
Klient: telefón, alebo okno na počítači
Klient je aplikácia coden — tá, cez ktorú Agentovi zadávate prácu a sledujete ju. Je to jedna aplikácia na dvoch miestach:
- Telefón (iPhone a Android)
- Na chvíle, keď ste od počítača. Zadáte úlohu, schválite príkaz, prečítate si dokumentáciu a v Náhľade si preklikáte rozpracovanú aplikáciu. Keď Agent skončí, príde upozornenie — aj keď máte aplikáciu zatvorenú.
- Okno na počítači
- Na chvíle, keď sedíte pri stole. Rovnaké záložky, len s miestom navyše: strom súborov vedľa dokumentu, otvorené súbory v kartách a Konverzácia po boku. Keď Server beží na tom istom počítači, číta okno projekt priamo z disku a upravíte v ňom aj zdrojové súbory. A Server v ňom pustíte bez terminálu.
Oboje môže byť pripojené naraz: Konverzáciu rozrobenú pri stole dokončíte z telefónu a naopak. Každé zariadenie sa so Serverom páruje zvlášť.
Aplikáciu do telefónu stiahnete z App Store alebo Google Play. Aplikáciu pre počítač nainštaluje inštalátor spolu so Serverom.
1. Nainštalujte Server
Stiahnite balík pre svoj systém zo stránky stiahnutia. Každý systém má svoj vlastný inštalátor a všetky urobia to isté: dostanú príkaz coden-server do cesty, takže ho potom spustíte odkiaľkoľvek.
- macOS
- Dvojklik na .pkg a preklikať sprievodcu. Balíček je podpísaný a notarizovaný, takže sa Gatekeeper nepýta.
- Windows
- Dvojklik na .msi a preklikať sprievodcu. Po inštalácii otvorte nové okno príkazového riadka — do toho starého sa zmena cesty nedostane.
- Ubuntu a Debian
- Dvojklik na .deb ho otvorí v systémovom inštalátore. Z terminálu je to
sudo apt install ./coden_*.deb.
$ coden-server --version
Keď príkaz nie je nájdený, otvorte nový terminál. Cesta sa do už bežiacich nepremietne.
2. Spustite Server nad projektom
Server obsluhuje jeden adresár. Ten, ktorý mu odovzdáte, je presne ten, v ktorom bude Agent pracovať a spúšťať príkazy. Nič o projekte sa neukladá nikam mimo neho.
$ cd ~/projekty/muj-projekt
$ coden-server start
Bez ďalších prepínačov obsluhuje Server adresár, v ktorom ste ho spustili. Iný sa dá odovzdať cez --dir:
$ coden-server start --dir ~/projekty/jiny-projekt
Server zostane bežať v popredí a vypisuje, čo sa deje. Nechajte si to okno otvorené — je to jediné miesto, kde uvidíte, že sa niekto pripojil.
Viac projektov znamená viac Serverov, každý vo svojom okne. V aplikácii sa potom medzi nimi prepínate a každý si drží vlastné Konverzácie, testy aj históriu.
Na počítači aj bez terminálu
Aplikácia coden beží aj v okne na počítači a odtiaľ Server pustíte sami:
- Otvorte Nastavenia → Spojenie.
- V časti Server na tomto počítači napíšte cestu k priečinku projektu, napríklad ~/projekty/muj-projekt.
- Ťuknite na Spustiť Server.
Okno sa so Serverom hneď spáruje a Server beží ďalej, aj keď okno zavriete. Telefón potom pripojíte cez Pripojiť telefón v spodnom pruhu okna — ukáže QR kód, ktorý stačí naskenovať.
3. Spárujte telefón
Kým nemáte spárovaný žiadny telefón, vypíše Server QR kód sám hneď po štarte. V aplikácii ťuknite na Spárovať a namierte naň fotoaparát. Kód platí desať minút a len na jedno spárovanie — po použití je na nič.
Keď vyprší alebo potrebujete spárovať ďalšie zariadenie, urobíte nový. V druhom okne terminálu, kým Server beží:
$ cd ~/projekty/muj-projekt
$ coden-server pair
Oba príkazy musia bežať z rovnakého priečinka a Server musí bežať prvý. Príkaz coden-server pair nie je samostatný program — je to odkaz bežiacemu Serveru, a ten si ho hľadá podľa priečinka, v ktorom ho spustíte. Z iného priečinka alebo bez bežiaceho Servera ohlási, že sa nemá koho spýtať.
Ten kód nikomu neukazujte a nefoťte ho. Nesie okrem identity vášho počítača aj prístup k Službe. Kto ho má, dostane sa ďalej, než by ste chceli.
4. Priame spojenie, alebo cez Relay
Po spárovaní sa telefón pripojí sám a v aplikácii je vidieť, kadiaľ. Rozdiel si nemusíte nastavovať — vyberie sa tá lepšia z možností, ktoré zostali — ale je dobré vedieť, čo ktorý stav znamená:
- Priame spojenie
- Dáta tečú z telefónu do počítača a nikam inam. Najrýchlejšie, žiadna kvóta, nič neprechádza našou Službou. Funguje, keď sú obe zariadenia na rovnakej sieti alebo keď sa podarí preraziť cez NAT.
- Cez Relay
- Dáta si podá náš server. Na mobilných dátach a vo firemných sieťach, kde priame spojenie nejde, je to jediná cesta, ako sa pripojiť. Prevádzka je šifrovaná od telefónu po Server, takže obsah nevidíme — len ho preposielame.
Aplikácia sa sama skúsi prepnúť na priame, len čo to ide — typicky keď prídete domov na wi-fi. Relay sa dá v Nastaveniach vypnúť; potom sa ale v sieti, ktorá priame spojenie nedovolí, nepripojíte vôbec.
Rendezvous je tá časť Služby, ktorá obe strany zoznámi. Bez nej by telefón nevedel, kam sa pripojiť — adresa počítača sa totiž mení. Prenášať cez ňu dáta ale nejde.
5. Zadajte prvú úlohu
Začnite niečím, pri čom spoznáte, či to Agent urobil dobre. Napríklad:
Prejdi README a napíš mi, čo v ňom chýba, aby sa podľa neho dal projekt rozbehnúť na čistom počítači.
V priebehu uvidíte, ktoré súbory Agent číta a čo spúšťa. Pri prvom príkaze sa vás spýta na svolenie — to je normálne a je to východiskové nastavenie. Keď chcete, aby sa určitý typ akcie už nepýtal, udeľte trvalé svolenie; odobrať sa dá kedykoľvek v Nastaveniach.
Pracuje tam Claude Code, teda ten istý Agent, ktorého poznáte z terminálu. Vie to isté a chová sa rovnako; rozdiel je len v tom, že vstup aj výstup idú cez telefón a že CLAUDE.md, skilly a nastavenia v projekte platia presne tak ako pri počítači.
6. Odíďte od počítača
Toto je tá časť, kvôli ktorej coden existuje. Zadajte dlhšiu úlohu, zamknite telefón a choďte preč. Agent pracuje ďalej. Keď skončí, príde upozornenie; keď sa pripojíte, dorazí celý výstup, ktorý vám medzitým ušiel.
Aby to fungovalo, nesmie počítač zaspať — na to je vlastný návod. A keď nechcete odbiehať k schvaľovaniu, pozrite sa na povolenie práce bez schvaľovania.
Keď sa telefón nepripojí
- Aplikácia píše „párovací kód vypršal"
- Spustite
coden-server pairznova. Kód má krátku platnosť schválne. - Telefón je na mobilných dátach a spojenie sa neustaví
- Niektoré mobilné siete priame spojenie nedovolia. Skontrolujte v aplikácii, že máte povolený Relay — bez neho sa v takej sieti nepripojíte.
- Aplikácia hlási nezhodu kľúča
- Server má inú identitu, než akú si telefón pamätá — typicky preto, že ste zmazali jeho adresár so stavom. Spárujte znova. Pokračovať „napriek tomu" vám aplikácia zámerne neponúkne.
Užitočné príkazy
$ coden-server status # beží? kto je pripojený? ako dlho?
$ coden-server clients # spárované zariadenia, posledné pripojenie
$ coden-server stop # riadené ukončenie
Zaseklo sa to inde, než čo je tu? Napíšte na support@coden-app.com.