Перш ніж уперше відійдете від комп'ютера

Встановлення Сервера, спарування телефону QR-кодом, пряме з'єднання проти Relay і перше завдання для Агента. Крок за кроком.

12 хвилин Оновлено 2026-09-13

Що вам знадобиться

Комп'ютер із macOS, Windows або Ubuntu, на якому лежить проєкт, над яким ви хочете працювати.
Node.js 20 і новіший — у ньому працює Агент.
Облікові дані до Anthropic API у змінній ANTHROPIC_API_KEY, або підписка Claude, до якої Агент увійде сам.
Телефон із застосунком coden і камерою.

Власний сервер не потрібен. Rendezvous і Relay, через які телефон із комп'ютером знаходять одне одного, тримаємо ми, і Сервер знає їх сам.

1. Встановіть Сервер

Завантажте пакунок для своєї системи зі сторінки завантаження. Кожна система має власний інсталятор, і всі вони роблять те саме: додають команду coden у PATH, тож потім ви запустите її будь-звідки.

macOS: Подвійний клік на .pkg і пройти майстра. Пакет підписаний і нотаризований, тож Gatekeeper не питає.
Windows: Подвійний клік на .msi і пройти майстра. Після встановлення відкрийте нове вікно командного рядка — у старе зміна PATH не потрапить.
Ubuntu і Debian: Подвійний клік на .deb відкриє його в системному інсталяторі. З термінала це sudo apt install ./coden_*.deb.

$ coden --version

Якщо команду не знайдено, відкрийте новий термінал. PATH у вже запущені не потрапляє.

2. Запустіть Сервер над проєктом

Сервер обслуговує одну теку. Той, який ви йому передасте, — це саме той, у якому Агент працюватиме і виконуватиме команди. Нічого про проєкт не зберігається поза ним.

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

Без додаткових ключів Сервер обслуговує каталог, у якому ви його запустили. Інший можна передати через --dir:

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

Сервер лишиться працювати на передньому плані й пише, що відбувається. Лишіть те вікно відкритим — це єдине місце, де побачите, що хтось під'єднався.

Більше проєктів означає більше Серверів, кожен у своєму вікні. У застосунку ви потім між ними перемикаєтесь, і кожен тримає власні Розмови, тести й історію.

3. Спаруйте телефон

У другому вікні термінала, поки Сервер працює:

$ coden pair

З'явиться QR-код. У застосунку торкніться Спарувати і наведіть на нього камеру. Код діє кілька хвилин і лише на одне спарування — після використання ні на що не годиться.

Той код нікому не показуйте й не фотографуйте. Він несе, крім особи вашого комп'ютера, ще й доступ до Служби. Хто його має, дістанеться далі, ніж вам би хотілося.

4. Пряме з'єднання або через Relay

Після спарування телефон під'єднається сам, і в застосунку видно, яким шляхом. Різницю налаштовувати не треба — вибирається краще з того, що залишилось — але добре знати, що кожен стан означає:

Пряме з'єднання: Дані течуть із телефону в комп'ютер і більше нікуди. Найшвидше, жодної квоти, ніщо не проходить через нашу Службу. Працює, коли обидва пристрої в одній мережі або коли вдається пробитися через NAT.
Через Relay: Дані передає наш сервер. На мобільних даних і в корпоративних мережах, де пряме з'єднання неможливе, це єдиний шлях під'єднатися. Трафік зашифрований від телефону до Сервера, тож вмісту ми не бачимо — лише пересилаємо його.

Застосунок сам спробує перемкнутися на пряме, щойно зможе — типово коли ви приходите додому до wi-fi. Relay можна вимкнути в Налаштуваннях; але тоді в мережі, яка прямого з'єднання не дозволяє, ви не під'єднаєтесь узагалі.

Rendezvous — це та частина Служби, яка знайомить обидві сторони. Без неї телефон не знав би, куди під'єднуватись — адреса комп'ютера ж змінюється. Але передавати дані через неї не можна.

5. Дайте перше завдання

Почніть із чогось, на чому впізнаєте, чи Агент зробив це добре. Наприклад:

Пройди README і напиши мені, чого в ньому бракує, щоб за ним можна було підняти проєкт на чистому комп'ютері.

Дорогою побачите, які файли Агент читає й що запускає. На першій команді він спитає дозволу — це нормально й це типове налаштування. Коли хочете, щоб про певний тип дії вже не питав, дайте постійний дозвіл; відібрати його можна будь-коли в Налаштуваннях.

Там працює Claude Code, тобто той самий Агент, якого ви знаєте з термінала. Він уміє те саме і поводиться так само; різниця лише в тому, що вхід і вихід ідуть через телефон і що CLAUDE.md, skill'и і налаштування в проєкті діють точно так, як за комп'ютером.

6. Відійдіть від комп'ютера

Це та частина, заради якої coden існує. Дайте довше завдання, замкніть телефон і йдіть. Агент працює далі. Коли закінчить, прийде сповіщення; коли під'єднаєтеся, надійде весь вивід, який тим часом вас оминув.

Щоб це працювало, комп'ютер не має засинати — на це є окремий посібник. А коли не хочеться відбігати до погоджень, погляньте на дозвіл роботи без погоджень.

Коли телефон не під'єднується

Застосунок пише «код спарування минув»: Запустіть coden pair знову. Код діє коротко навмисно.
Телефон на мобільних даних і з'єднання не встановлюється: Деякі мобільні мережі прямого з'єднання не дозволяють. Перевірте в застосунку, що Relay увімкнений — без нього в такій мережі не під'єднаєтеся.
Застосунок повідомляє про розбіжність ключа: Сервер має іншу особу, ніж та, яку телефон пам'ятає — зазвичай тому, що ви видалили його теку зі станом. Спаруйте знову. Продовжити «попри це» застосунок навмисно не пропонує.
«Сервер обслуговує інший пристрій»: Під'єднаний інший спарований телефон. Випишіть їх командою coden clients.

Корисні команди

$ coden status    # працює? хто під'єднаний? як довго?
$ coden clients   # спаровані пристрої, останнє під'єднання
$ coden stop      # кероване завершення

Застрягло десь інде, ніж тут написано? Напишіть на support@coden-app.com.