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

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

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

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

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

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

Клієнт: телефон або вікно на комп'ютері

Клієнт — це застосунок coden, через який ви даєте Агентові роботу й стежите за нею. Це один застосунок у двох місцях:

Телефон (iPhone і Android): Для моментів, коли ви не біля комп'ютера. Даєте завдання, схвалюєте команду, читаєте документацію й у Перегляді клацаєте застосунок, над яким триває робота. Коли Агент закінчить, прийде сповіщення — навіть якщо застосунок закритий.
Вікно на комп'ютері: Для моментів за столом. Ті самі вкладки, лише з більшим простором: дерево файлів поруч із документом, відкриті файли у вкладках і Розмова збоку. Коли Сервер працює на тому самому комп'ютері, вікно читає проєкт просто з диска, і в ньому можна редагувати й вихідні файли. А Сервер у ньому запускається без термінала.

Обидва можуть бути під'єднані одночасно: Розмову, розпочату за столом, завершите з телефона, і навпаки. Кожен пристрій спарюється із Сервером окремо.

Застосунок для телефона завантажите з App Store або Google Play. Застосунок для комп'ютера встановлює інсталятор разом із Сервером.

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

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

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

$ coden-server --version

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

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

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

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

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

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

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

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

На комп'ютері й без термінала

Застосунок coden працює й у вікні на комп'ютері, і звідти Сервер можна запустити самому:

Відкрийте Налаштування → З'єднання.
У розділі Сервер на цьому комп'ютері введіть шлях до теки проєкту, наприклад ~/projekty/muj-projekt.
Торкніться Запустити Сервер.

Вікно одразу спарюється із Сервером, а Сервер працює далі, навіть коли вікно закрити. Телефон потім під'єднаєте через Під'єднати телефон у нижній смузі вікна — він покаже QR-код, який досить відсканувати.

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

Доки не спарований жоден телефон, Сервер виведе QR-код сам одразу після запуску. У застосунку торкніться Спарувати і наведіть на нього камеру. Код діє десять хвилин і лише на одне спарування — після використання він нікчемний.

Коли він спливе або треба спарувати ще один пристрій, зробіть новий. У другому вікні термінала, поки Сервер працює:

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

Обидві команди мають запускатися з тієї самої теки, і Сервер має працювати першим. coden-server pair — не окрема програма, а повідомлення запущеному Серверу, якого вона знаходить за текою, у якій ви її запускаєте. З іншої теки або без запущеного Сервера вона повідомить, що нема кого питати.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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