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é Claude, ke kterému se Agent přihlásí sám.
Telefon s aplikací coden a fotoaparátem.

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.

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 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 --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 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 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.

3. Spárujte telefon

Ve druhém okně terminálu, zatímco Server běží:

$ coden pair

Vypíše se QR kód. V aplikaci ťukněte na Spárovat a namiřte na něj fotoaparát. Kód platí pár minut a jen na jedno spárování — po použití je k ničemu.

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 Claude Code, tedy ten samý Agent, kterého znáte z terminálu. 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 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.
„Server obsluhuje jiné zařízení“: Je připojený jiný spárovaný telefon. Vypište si je příkazem coden clients.

Užitečné příkazy

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

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