Než poprvé odejdete od počítače

Instalace Serveru, spárování telefonu QR kódem, přímé spojení versus Relay a první úkol pro Agenta. Krok za krokem.

12 minut Aktualizováno 2026-09-13

Co budete potřebovat

Počítač s macOS, Windows nebo Ubuntu, na kterém máte projekt, na kterém chcete pracovat.
Node.js 20 a novější — v něm běží Agent.
Přihlašovací údaje k Anthropic API v proměnné ANTHROPIC_API_KEY, nebo předplatné u poskytovatele Agenta (například Claude, ChatGPT nebo Gemini), ke kterému se Agent přihlásí sám.
Telefon s aplikací coden a fotoaparátem, nebo aplikaci coden v okně na počítači.

Vlastní server nepotřebujete. Rendezvous a Relay, přes které se telefon s počítačem najdou, provozujeme my a Server je zná sám.

Klient: telefon, nebo okno na počítači

Klient je aplikace coden — ta, přes kterou Agentovi zadáváte práci a sledujete ji. Je to jedna aplikace na dvou místech:

Telefon (iPhone a Android): Pro chvíle, kdy jste od počítače. Zadáte úkol, schválíte příkaz, přečtete si dokumentaci a v Náhledu si proklikáte rozpracovanou aplikaci. Až Agent skončí, přijde upozornění — i když máte aplikaci zavřenou.
Okno na počítači: Pro chvíle, kdy sedíte u stolu. Stejné záložky, jen s místem navíc: strom souborů vedle dokumentu, otevřené soubory v kartách a Konverzace po straně. Když Server běží na tomtéž počítači, čte okno projekt přímo z disku a upravíte v něm i zdrojové soubory. A Server v něm pustíte bez terminálu.

Obojí může být připojené naráz: Konverzaci rozdělanou u stolu dokončíte z telefonu a naopak. Každé zařízení se se Serverem páruje zvlášť.

Aplikaci do telefonu stáhnete z App Store nebo Google Play. Aplikaci pro počítač nainstaluje instalátor spolu se Serverem.

1. Nainstalujte Server

Stáhněte balíček pro svůj systém ze stránky stažení. Každý systém má svůj vlastní instalátor a všechny udělají totéž: dostanou příkaz coden-server do cesty, takže ho pak spustíte odkudkoliv.

macOS: Dvojklik na .pkg a proklikat průvodce. Balíček je podepsaný a notarizovaný, takže se Gatekeeper neptá.
Windows: Dvojklik na .msi a proklikat průvodce. Po instalaci otevřete nové okno příkazové řádky — do toho starého se změna cesty nedostane.
Ubuntu a Debian: Dvojklik na .deb ho otevře v systémovém instalátoru. Z terminálu je to sudo apt install ./coden_*.deb.

$ coden-server --version

Když příkaz není nalezen, otevřete nový terminál. Cesta se do už běžících nepromítne.

2. Spusťte Server nad projektem

Server obsluhuje jeden adresář. Ten, který mu předáte, je přesně ten, ve kterém bude Agent pracovat a spouštět příkazy. Nic o projektu se neukládá nikam mimo něj.

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

Bez dalších přepínačů obsluhuje Server adresář, ve kterém jste ho spustili. Jiný se dá předat přes --dir:

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

Server zůstane běžet v popředí a vypisuje, co se děje. Nechte si to okno otevřené — je to jediné místo, kde uvidíte, že se někdo připojil.

Víc projektů znamená víc Serverů, každý ve svém okně. V aplikaci se pak mezi nimi přepínáte a každý si drží vlastní Konverzace, testy i historii.

Na počítači i bez terminálu

Aplikace coden běží i v okně na počítači, a odtamtud Server pustíte sami:

Otevřete Nastavení → Spojení.
V části Server na tomto počítači napište cestu ke složce projektu, třeba ~/projekty/muj-projekt.
Klepněte na Spustit Server.

Okno se se Serverem rovnou spáruje a Server běží dál, i když okno zavřete. Telefon pak připojíte přes Připojit telefon ve spodním pruhu okna — ukáže QR kód, který stačí naskenovat.

3. Spárujte telefon

Dokud nemáte spárovaný žádný telefon, vypíše Server QR kód sám hned po startu. V aplikaci ťukněte na Spárovat a namiřte na něj fotoaparát. Otevře se aplikace na obrazovce pro párování; QR kód pak naskenujte ještě jednou přímo v aplikaci. Kód platí deset minut a jen na jedno spárování — po použití je k ničemu.

Když vyprší nebo potřebujete spárovat další zařízení, uděláte nový. Ve druhém okně terminálu, zatímco Server běží:

$ cd ~/projekty/muj-projekt
$ coden-server pair

Oba příkazy musí běžet ze stejné složky a Server musí běžet první. Příkaz coden-server pair není samostatný program — je to vzkaz běžícímu Serveru, a ten si hledá podle složky, ve které ho spustíte. Z jiné složky nebo bez běžícího Serveru ohlásí, že se nemá čeho zeptat.

Ten kód nikomu neukazujte a nefoťte ho. Nese kromě identity vašeho počítače i přístup ke Službě. Kdo ho má, dostane se dál, než byste chtěli.

4. Přímé spojení, nebo přes Relay

Po spárování se telefon připojí sám a v aplikaci je vidět, kudy. Rozdíl si nemusíte nastavovat — vybere se ta lepší z možností, které zbyly — ale je dobré vědět, co který stav znamená:

Přímé spojení: Data tečou z telefonu do počítače a nikam jinam. Nejrychlejší, žádná kvóta, nic neprochází naší Službou. Funguje, když jsou obě zařízení na stejné síti nebo když se podaří prorazit přes NAT.
Přes Relay: Data si podá náš server. Na mobilních datech a ve firemních sítích, kde přímé spojení nejde, je to jediná cesta, jak se připojit. Provoz je šifrovaný od telefonu po Server, takže obsah nevidíme — jen ho přeposíláme.

Aplikace se sama zkusí přepnout na přímé, jakmile to jde — typicky když přijdete domů na wi-fi. Relay se dá v Nastavení vypnout; pak se ale v síti, která přímé spojení nedovolí, nepřipojíte vůbec.

Rendezvous je ta část Služby, která obě strany seznámí. Bez ní by telefon nevěděl, kam se připojit — adresa počítače se totiž mění. Přenášet přes ni data ale nejde.

5. Zadejte první úkol

Začněte něčím, u čeho poznáte, jestli to Agent udělal dobře. Třeba:

Projdi README a napiš mi, co v něm chybí, aby se podle něj dal projekt rozběhnout na čistém počítači.

V průběhu uvidíte, které soubory Agent čte a co spouští. U prvního příkazu se vás zeptá na svolení — to je normální a je to výchozí nastavení. Když chcete, aby se určitý typ akce už neptal, udělte trvalé svolení; odebrat se dá kdykoliv v Nastavení.

Pracuje tam Agent, tedy ten samý, kterého znáte z terminálu (Claude Code, Codex, Gemini…). Umí totéž a chová se stejně; rozdíl je jen v tom, že vstup i výstup jdou přes telefon a že CLAUDE.md, skilly a nastavení v projektu platí přesně tak jako u počítače.

6. Odejděte od počítače

Tohle je ta část, kvůli které coden existuje. Zadejte delší úkol, zamkněte telefon a jděte pryč. Agent pracuje dál. Až skončí, přijde upozornění; až se připojíte, dorazí celý výstup, který vám mezitím utekl.

Aby to fungovalo, nesmí počítač usnout — na to je vlastní návod. A když nechcete odbíhat ke schvalování, koukněte se na povolení práce bez schvalování.

Když se telefon nepřipojí

Aplikace píše „párovací kód vypršel“: Spusťte coden-server pair znovu. Kód má krátkou platnost schválně.
Telefon je na mobilních datech a spojení se neustaví: Některé mobilní sítě přímé spojení nedovolí. Zkontrolujte v aplikaci, že máte povolený Relay — bez něj se v takové síti nepřipojíte.
Aplikace hlásí neshodu klíče: Server má jinou identitu, než jakou si telefon pamatuje — typicky proto, že jste smazali jeho adresář se stavem. Spárujte znovu. Pokračovat „přesto“ vám aplikace záměrně nenabídne.

Užitečné příkazy

$ coden-server status    # běží? kdo je připojený? jak dlouho?
$ coden-server clients   # spárovaná zařízení, poslední připojení
$ coden-server stop      # řízené ukončení

Zaseklo se to jinde, než co je tady? Napište na support@coden-app.com.