Від Matt Connor 2026-10-12

Claude у Linux: Desktop app і CLI

Q: Як увійти до Claude Code через SSH?

Виконайте claude. Команда виведе URL для авторизації. Відкрийте цей URL у браузері на власному комп’ютері, а не на сервері. Після входу браузер покаже код входу замість перенаправлення, оскільки він не може підключитися до listener для callback, який Claude Code запустив на loopback-адресі віддаленої машини. Вставте цей код у запит Paste code here if prompted. Для сеансів, які запускаються без присутності користувача, виконайте claude setup-token і задайте виведений token як CLAUDE_CODE_OAUTH_TOKEN у потрібних місцях.

Q: Де Claude Code зберігає дані мого входу в Linux?

У ~/.claude/.credentials.json із режимом доступу до файлу 0600 або в CLAUDE_CONFIG_DIR, якщо цю змінну встановлено. На відміну від macOS, у Linux keychain не використовується, тому будь-який процес, запущений від імені вашого користувача, може прочитати цей файл. Отже, резервна копія /home або образ машини містить активні дані входу. Виконайте /logout перед створенням snapshot або копіюванням системи. Якщо у вашому environment також встановлено ANTHROPIC_API_KEY, воно має пріоритет над збереженим входом за підпискою після підтвердження. Команда /status показує, який спосіб входу активний.

Дізнайтеся, що нативно працює в Linux: beta Desktop app з apt, Claude Code CLI, plugins для редакторів і який paid plan підтримує кожен варіант.

Які компоненти Claude сьогодні працюють нативно в Linux

Claude у Linux працює на чотирьох окремих рівнях. Станом на October 2026 усі чотири працюють на звичайному комп’ютері з Ubuntu або Debian. Desktop app встановлюється з apt-репозиторію Anthropic і перебуває в beta. Claude Code CLI (інтерфейс командного рядка) — це скомпільований binary, який працює в більшій кількості дистрибутивів, ніж desktop app. Web app на claude.ai потребує лише браузера, а API — це HTTPS endpoint, який ви викликаєте зі свого коду.

У Linux desktop beta відсутні або обмежені три функції, доступні в macOS і Windows: Computer Use, за допомогою якого Claude керує застосунками на екрані, голосове диктування та глобальна hotkey Quick Entry. Anthropic зазначає, що Computer Use і диктування недоступні в Linux. Hotkey Quick Entry працює в сеансі X11, але в нативному сеансі Wayland потребує GlobalShortcuts portal вашого desktop environment. Якщо такого portal немає, hotkey недоступна. echo $XDG_SESSION_TYPE виводить x11 або wayland і повідомляє, який саме випадок у вас. У CLI є власне голосове диктування, тому обмеження диктування стосується desktop app, а не Claude загалом.

Доступність змінюється, тому сприймайте цю сторінку як опис рівнів роботи та перевіряйте поточний стан перед плануванням інфраструктури. В останньому розділі наведено сторінки, які потрібно перевірити.

Встановіть desktop app Claude на Ubuntu або Debian

Задокументовані вимоги — Ubuntu 22.04 або новіша версія чи Debian 12 або новіша версія на x86_64 (який dpkg називає amd64) або arm64. Інші дистрибутиви на базі Debian можуть працювати, але їх не тестували. Для Fedora і RHEL пакета ще немає, тому в цих системах використовуйте CLI або браузер.

Встановлюйте app з apt repository, а не зі завантаженого файлу .deb. Linux app не має власного updater, тому нові версії надходять лише через package manager. Реєстрація repository дає змогу apt upgrade знаходити ці версії.

sudo apt install curl gnupg
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc \
  https://downloads.claude.ai/claude-desktop/key.asc
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc

gpg --show-keys має вивести fingerprint 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Перевірте його до реєстрації repository, оскільки неперевірений signing key означає, що ви довіряєте йому без перевірки. Якщо gpg повідомляє, що файл не містить коректних даних OpenPGP, завантаження не вдалося, і apt update згодом завершується помилкою NO_PUBKEY BAA929FF1A7ECACE.

Реєстрація repository — це один рядок deb, записаний у /etc/apt/sources.list.d/claude-desktop.list. Скопіюйте цей рядок зі сторінки встановлення Anthropic для Linux: code.claude.com/docs/en/desktop-linux, точно в тому вигляді, як його наведено на сторінці. Адреса repository — це частина процедури, яка найімовірніше зміниться. Рядок, введений з пам’яті, призводить до помилки E: Unable to locate package claude-desktop. Перевірте рядок перед вставленням: arch=amd64,arm64 пояснює, чому apt в іншій архітектурі нічого не знаходить, а signed-by= вказує на файл keyring, який ви щойно перевірили. Це обмежує використання цього key лише цим repository, замість довіри до нього для всіх даних, які читає apt.

sudo apt update && sudo apt install claude-desktop

Запустіть його з application launcher або виконайте claude-desktop у терміналі. Увійдіть за допомогою облікового запису claude.ai або через SSO (single sign-on) вашої організації, якщо компанія його налаштувала. Desktop app не приймає API key Claude Console: автентифікація за key доступна в CLI. Вкладка Cowork виконує завдання у virtual machine, тому також потребує ввімкненої hardware virtualization і додавання вашого користувача до групи kvm (sudo usermod -aG kvm $USER, після чого вийдіть із системи та увійдіть знову).

E: Unable to locate package claude-desktop означає, що apt не прочитав repository. cat /etc/apt/sources.list.d/claude-desktop.list має показати написаний вами рядок deb, а dpkg --print-architecture має вивести amd64 або arm64, оскільки пакети для інших архітектур не публікуються. Після цього оновлення надходитимуть разом з іншими оновленнями системи з sudo apt update && sudo apt upgrade.

Що доступне лише у браузері

claude.ai працює в будь-якому актуальному браузері на будь-якому дистрибутиві. Тому це варіант для Fedora, RHEL, Arch, openSUSE та інших систем, для яких немає пакета. У браузері також доступний Claude Code on the web. У цьому режимі сеанс виконується в хмарній інфраструктурі, а не на вашій машині: за замовчуванням в інфраструктурі Anthropic або у власному self-hosted середовищі вашої організації, якщо вона спрямовує сеанси туди. Для автентифікації завжди використовуються облікові дані вашої підписки.

Важливо розуміти обмеження браузера. Хмарний сеанс не може читати файли на вашому сервері або виконувати на ньому команди. Для будь-якої взаємодії з вашою машиною потрібне програмне забезпечення на цій машині, тобто CLI або desktop app.

Що дає CLI порівняно з вебзастосунком

Запустіть claude у каталозі — і він працюватиме з файлами в цьому каталозі. У цьому полягає різниця. Усе інше випливає з неї.

Він читає та редагує файли у вашому робочому каталозі й показує кожну зміну перед її застосуванням.
Він виконує схвалені вами shell-команди. Тому може зібрати проєкт, запустити набір тестів, прочитати журнал або перевірити сервіс безпосередньо на сервері.
Він працює без інтерактивного сеансу: claude -p "read the nginx error log and summarise it" виводить одну відповідь і завершує роботу. Саме це потрібно для cron job або pipeline. Формат цієї відповіді ви визначаєте самі, оскільки стиль виводу змінює системний prompt перед кожною відповіддю і дає змогу залишати scripted run стислим, тоді як в інтерактивному сеансі система пояснює свої дії.
Він підключає сервери MCP (model context protocol) за допомогою claude mcp add. Це надає моделі інструменти, що виходять за межі файлової системи.
Він працює там, де взагалі немає графічного робочого столу. Саме такими є всі VPS (virtual private server), які ви орендуватимете.

Саме тому посібник із роботи із сервером приділяє увагу CLI. Орендований сервер має SSH (secure shell) і більше нічого, тому термінал — єдиний доступний інтерфейс для роботи з ним. Для такого використання діють окремі правила. Усі вони описані в матеріалі як запускати Claude Code на VPS усередині tmux, а в матеріалі як використовувати Claude для повсякденної роботи системного адміністратора описано завдання, які доцільно йому доручати.

Інтеграції з редакторами займають проміжне положення. Розширення VS Code потребує VS Code 1.94.0 або новішої версії та додає графічну панель усередині редактора з переглядом diff і плану. Для цієї панелі розширення містить окрему копію CLI і не додає claude до вашого PATH. Тому для введення claude в інтегрованому терміналі все одно потрібна окрема інсталяція. Редактори на основі VS Code встановлюють це саме розширення з реєстру Open VSX. Також доступний plugin для JetBrains.

Чи потрібен Node.js для запуску Claude Code у Linux?

Ні, якщо використовувати рекомендований спосіб встановлення. Нативний інсталятор завантажує скомпільований бінарний файл. Цей бінарний файл не працює на Node.js.

curl -fsSL https://claude.ai/install.sh | bash
claude --version

claude --version має вивести номер версії, наприклад 2.1.211 (Claude Code). Якщо щось працює неправильно, виконайте claude doctor. Команда виводить діагностичну інформацію лише для читання про встановлення та файли налаштувань, не запускаючи сеанс.

Node.js потрібен лише для способу встановлення через npm. Станом на October 2026 npm-пакет потребує Node.js 22 або новішої версії. У старішій версії Node.js npm виводить попередження EBADENGINE, а не завершується з помилкою. Це відбувається тому, що пакет підтягує той самий нативний бінарний файл як залежність для відповідної платформи та розміщує на нього посилання.

npm install -g @anthropic-ai/claude-code

Не виконуйте цю команду з sudo. Документація застерігає від sudo npm install -g, оскільки після цього в глобальному префіксі npm залишаються файли, власником яких є root. Через це наступне встановлення або оновлення без привілеїв завершується помилкою доступу. Якщо глобальний каталог npm недоступний для запису, фонове автоматичне оновлення припиняє працювати, а claude doctor містить перелік способів виправлення.

Anthropic також публікує підписані репозиторії пакетів для Debian, Fedora, RHEL і Alpine. Тому sudo apt install claude-code працює майже так само, як пакет для desktop, використовуючи власний ключ підпису в https://downloads.claude.ai/keys/claude-code.asc.

Установлювати для окремого користувача чи в масштабі всієї системи?

Нативний інсталятор встановлює програму для окремого користувача. Він створює launcher у ~/.local/bin/claude як symlink до ~/.local/share/claude/versions/, не потребує root і оновлюється у фоновому режимі. Кожен користувач на машині отримує окрему копію з окремою версією.

Встановлення через package manager виконується в масштабі всієї системи. Один binary обслуговує всіх користувачів, потребує root і не оновлюється автоматично через Claude Code. Для оновлення використовуйте sudo apt update && sudo apt upgrade claude-code — ту саму команду, яку ви вже запускаєте для інших компонентів на сервері.

Вибирайте встановлення для окремого користувача на машині, до якої ви підключаєтеся під власним обліковим записом. Це типовий варіант для більшості VPS. Вибирайте встановлення через package manager на спільному сервері або в образі машини, якщо потрібна одна версія для всіх і ви хочете оновлювати її за власним графіком. У разі нативного встановлення дві настройки у ~/.claude/settings.json визначають поведінку оновлень:

{
  "autoUpdatesChannel": "stable",
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Канал stable використовує реліз, якому приблизно тиждень, і пропускає релізи зі значними регресіями. DISABLE_AUTOUPDATER вимикає лише фонову перевірку, тому claude update продовжує працювати, а ви самі визначаєте, коли встановлювати нову версію. Це важливо на сервері, де тривалий процес працює без нагляду і небажано, щоб binary змінювався під час його виконання.

Увійдіть через SSH і збережіть сеанс активним

Під час першого запуску CLI на орендованому сервері виникають дві специфічні для Linux проблеми. Процес входу потребує браузера, а на сервері його немає. Якщо SSH-з’єднання розривається, разом із ним припиняється запущена робота.

tmux вирішує другу проблему. Сеанс tmux належить серверу tmux на віддаленій машині, а не вашому з’єднанню. Тому після розриву зв’язку процес продовжує працювати.

tmux new -s claude
claude

Від’єднайтеся за допомогою Ctrl-b, потім d. Пізніше поверніться за допомогою tmux attach -t claude.

Вхід — це перша проблема. Виконайте claude. Команда виведе URL для авторизації. Відкрийте цей URL у браузері на власному комп’ютері. Після входу браузер покаже код входу, а не перенаправить вас назад, оскільки браузер на вашому ноутбуці не може підключитися до callback-сервера, який Claude Code запустив на loopback-адресі віддаленої машини. Вставте цей код у термінал у відповідь на запит Paste code here if prompted. Термінал повідомить Login successful.

Для сеансу, який має запуститися без нагляду, claude setup-token відкриває таку саму авторизацію в браузері та виводить у термінал OAuth-токен зі строком дії один рік. Токен ніде не зберігається, тому скопіюйте його та задайте там, де потрібно.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Для цього токена потрібен платний план, і його можна використовувати лише для запитів до моделей. Ставтеся до нього як до пароля зі строком дії один рік. Де зберігати цей токен і як не дозволити агенту прочитати його, описано в розділі як не допустити секрети до AI-агентів.

Невеликі сервери мають ще одне обмеження. Для встановлення потрібно приблизно 512 MB вільної пам’яті, а задокументована вимога до обладнання для запуску — 4 GB RAM або більше. Тому на інстансі з 1 GB RAM, де залишилося мало вільної пам’яті, kernel out-of-memory killer може припинити встановлення, після чого інсталятор виведе:

Setting up Claude Code...
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

Додайте swap і повторно запустіть інсталятор. Swap — це дисковий простір, який kernel використовує як додаткову пам’ять. Він значно повільніший за RAM, але його достатньо, щоб завершити встановлення.

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

swapon активує файл лише для цього завантаження. Додайте рядок для /swapfile до /etc/fstab, якщо потрібно зберегти цю конфігурацію після перезавантаження. Що ще потрібно захистити перед тим, як дозволити агенту виконувати команди на робочому сервері, описано в розділі як безпечно запускати Claude Code на VPS.

Де зберігаються облікові дані Claude у Linux

У Linux /login записує облікові дані у ~/.claude/.credentials.json із режимом доступу 0600. macOS зберігає ті самі облікові дані в зашифрованому Keychain, тому звичка, сформована на Mac, тут не працює: у Linux токен є звичайним файлом у домашньому каталозі, і кожен процес, запущений від імені вашого користувача, може його прочитати. Установлення CLAUDE_CONFIG_DIR переміщує файл у цей каталог.

Із цього випливають два наслідки. Резервна копія /home містить чинні дані для входу, тому копіювання такої резервної копії на спільну машину передає ваш обліковий запис кожному, хто може її прочитати. Образ машини, створений із системи, у якій ви виконали вхід, переносить ці дані для входу до кожного екземпляра, клонованого з цього образу. Виконайте /logout, перш ніж створювати знімок.

Пріоритет облікових даних часто створює проблеми користувачам, які одночасно мають підписку та API key. Якщо ANTHROPIC_API_KEY задано у вашій оболонці, Claude Code використовує його після вашого підтвердження, тому підписка залишається невикористаною, а оплата API key нараховується за кожен токен. /status показує, які облікові дані активні, а unset ANTHROPIC_API_KEY повертає вас до входу за підпискою.

Сеанси входу завершуються. Протягом трьох днів до завершення строку дії в рядку запуску з’являється Your login expires in 3 days, і це попередження не блокує запит. Після завершення строку дії кожен запит завершується помилкою Login expired · Please run /login. Пам’ятайте про це, якщо залишаєте сесію без нагляду на вихідні: така сесія припиняє виконувати роботу й не може відновитися самостійно.

Чи охоплює одна підписка Claude все це?

Один платний план охоплює всі способи доступу з одним обліковим записом. Виняток становлять деякі старі плани Enterprise. Обліковий запис Pro, Max або Team дає змогу входити до claude.ai у браузері, настільної програми, CLI і розширення VS Code. У кожному випадку використовується та сама підписка. Те саме стосується нового або self-serve плану Enterprise. У старому плані Enterprise для способів доступу Claude Code потрібне місце Chat + Claude Code або Premium. Місце Chat-only або Standard не включає ці способи доступу. У планах Pro, Max, Team і Enterprise з оплатою за місця також використовується одна спільна норма використання. Тому тривалий запуск CLI на сервері зменшує доступний залишок для настільної програми. Коли будь-який спосіб доступу перестає приймати запити, потрібно з’ясувати, яке обмеження використання ви досягли та що з цим робити. У плані Enterprise з оплатою за використання немає включеної норми, яка може вичерпатися: кожен спосіб доступу тарифікується за API-ставками з першого токена. Безкоштовний план claude.ai не включає доступ до Claude Code. Для CLI потрібен платний план або обліковий запис Claude Console. Настільна програма входить лише за допомогою підписки claude.ai або SSO вашої організації. Тому для компонентів Claude Code у настільній програмі потрібен платний план, а обліковий запис Console не відкриває до них доступ.

API — це окремий продукт з іншою моделлю тарифікації. Обліковий запис Console тарифікує фактично передані токени. Це підходить для сервісу, який ви створюєте, а не для введення команд у терміналі. Встановлення ANTHROPIC_API_KEY переводить CLI на цю модель тарифікації. Це свідомий вибір, а не резервний варіант. Настільна програма не читає цю змінну і не запускає скрипт apiKeyHelper, оскільки входить через OAuth. Тому на власному комп’ютері ключ API працює лише через CLI та інструменти, які його обгортають, зокрема розширення VS Code.

Ціни та ліміти планів змінюються надто часто, щоб наводити їх тут. Поточні значення відстежують дві сторінки: скільки насправді коштує Claude Code і який план Claude вам потрібен. Якщо ви порівнюєте оплату за токени з місячним планом, порівняння API з підпискою допоможе визначити точку беззбитковості.

Фактичні помилки, які ви побачите під час інсталяції

bash: claude: command not found одразу після успішної інсталяції. Бінарний файл розташований у ~/.local/bin/claude, а цей каталог не входить до шляху пошуку вашої оболонки. Перевірте це за допомогою echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin": якщо запис відсутній, команда нічого не виводить. Виправте це для bash за допомогою echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc, а потім виконайте source ~/.bashrc. Окреме встановлення розширення VS Code ніколи не створює цей файл, оскільки розширення зберігає свою копію CLI у каталозі розширення.

Error loading shared library libstdc++.so.6. Або інсталятор завантажив неправильний варіант бінарного файлу, зазвичай збірку для musl у системі з glibc, або ви працюєте в системі з musl, де відсутні бібліотеки середовища виконання. Неправильний варіант з’являється, коли встановлені пакети для крос-компіляції під musl і механізм визначення помилково визначає систему. Виконайте ldd --version 2>&1 | head -1: назва у виведенні GNU libc або GLIBC означає, що у вас glibc і отримано неправильний бінарний файл, тому видаліть інсталяцію та повторно запустіть інсталятор. В Alpine та інших системах із musl виправлення протилежне — apk add libgcc libstdc++ ripgrep.

Дві копії claude в одній системі. which -a claude виводить усі збіги у вашому PATH. Нативна інсталяція — це символічне посилання з ~/.local/bin/claude на ~/.local/share/claude/versions/, застаріла локальна інсталяція npm розташована в ~/.claude/local/, а npm -g ls @anthropic-ai/claude-code показує глобальну інсталяцію npm. Видаліть непотрібні копії, оскільки саме застаріла копія на початку PATH створює враження, що виправлення помилки не спрацювало.

Де перевірити поточний стан

Стан Linux desktop, вимоги та команди для встановлення: code.claude.com/docs/en/desktop-linux
Підтримувані дистрибутиви та всі способи встановлення CLI: code.claude.com/docs/en/setup
Платформи, для яких взагалі доступний застосунок для завантаження: claude.com/download
Що входить до кожного плану та скільки це коштує: claude.com/pricing

Усі номери версій і дати в цьому посібнику актуальні станом на October 2026. Незмінною залишається загальна структура: чотири способи роботи, один обліковий запис для платних варіантів і вибір, чи має CLI належати вашому користувачеві, чи всій системі.

FAQ

Чи є desktop-застосунок Claude для Linux?

Так. Станом на October 2026 він перебуває в бета-версії та підтримує Ubuntu 22.04 або новішу версію і Debian 12 або новішу версію на amd64 або arm64. Встановіть його за допомогою sudo apt install claude-desktop після додавання apt-репозиторію Anthropic і його ключа підпису, щоб нові версії надходили під час звичайного оновлення системи. Версія для Linux має ті самі вкладки, що й застосунок для macOS, зокрема вкладку Claude Code. Computer Use і голосовий ввід поки що недоступні у версії для Linux. Глобальна комбінація клавіш Quick Entry працює в X11, але в нативному сеансі Wayland потребує порталу GlobalShortcuts вашого desktop environment. Для Fedora і RHEL пакета немає, тому в цих дистрибутивах використовуйте CLI або claude.ai у браузері.

Чи потрібен Node.js для запуску Claude Code у Linux?

Ні, якщо використовувати рекомендований спосіб встановлення. curl -fsSL https://claude.ai/install.sh | bash завантажує скомпільований binary, якому Node.js не потрібен під час виконання. Node.js потрібен лише в разі встановлення npm-пакета, який станом на October 2026 вимагає Node.js 22 або новішої версії. У старішій версії Node.js npm виводить попередження EBADENGINE, але встановлення все одно завершується, оскільки той самий native binary завантажується як залежність для відповідної платформи. Не встановлюйте його за допомогою sudo npm install -g, оскільки це створює файли, власником яких є root, у вашому npm prefix і порушує подальші оновлення.

Як увійти до Claude Code через SSH?

Виконайте claude. Команда виведе URL для авторизації. Відкрийте цей URL у браузері на власному комп’ютері, а не на сервері. Після входу браузер покаже код входу замість перенаправлення, оскільки він не може підключитися до listener для callback, який Claude Code запустив на loopback-адресі віддаленої машини. Вставте цей код у запит Paste code here if prompted. Для сеансів, які запускаються без присутності користувача, виконайте claude setup-token і задайте виведений token як CLAUDE_CODE_OAUTH_TOKEN у потрібних місцях.

Де Claude Code зберігає дані мого входу в Linux?

У ~/.claude/.credentials.json із режимом доступу до файлу 0600 або в CLAUDE_CONFIG_DIR, якщо цю змінну встановлено. На відміну від macOS, у Linux keychain не використовується, тому будь-який процес, запущений від імені вашого користувача, може прочитати цей файл. Отже, резервна копія /home або образ машини містить активні дані входу. Виконайте /logout перед створенням snapshot або копіюванням системи. Якщо у вашому environment також встановлено ANTHROPIC_API_KEY, воно має пріоритет над збереженим входом за підпискою після підтвердження. Команда /status показує, який спосіб входу активний.

Чи поширюється моя підписка Claude Pro на CLI і web app?

Так. План Pro, Max або Team дає змогу ввійти до claude.ai, desktop app, CLI і розширення VS Code за допомогою одного облікового запису. Те саме стосується Enterprise, за винятком старіших планів Enterprise, у яких Claude Code доступний лише для місць Chat + Claude Code або Premium. Безкоштовний план claude.ai не включає Claude Code, тому для terminal CLI потрібен платний план або обліковий запис Claude Console. Обліковий запис Console не дає змоги ввійти до desktop app, яка приймає лише підписку claude.ai або SSO вашої організації. API оплачується окремо за кількістю token з облікового запису Console. Це інший продукт, ніж підписка.

#claude #linux #claude-code #cli#desktop