Claude у Linux: desktop app і Claude Code CLI

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

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

У Linux desktop beta відсутні дві функції, доступні в macOS і Windows: Computer Use, за допомогою якої Claude керує застосунками на екрані, і voice dictation. Anthropic зазначає, що обидві функції ще недоступні в Linux. CLI має власну voice dictation, тому обмеження стосується desktop app, а не Claude загалом.

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

Встановлення десктопного застосунку Claude в Ubuntu або Debian

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

Встановлюйте застосунок з apt-репозиторію, а не з завантаженого файлу .deb. Linux-застосунок не має власного механізму оновлення, тому нові версії надходять лише через менеджер пакетів. Реєстрація репозиторію дає змогу 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 має вивести відбиток 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Порівняйте його до реєстрації репозиторію, оскільки неперевірений ключ підпису ви фактично приймаєте наосліп. Якщо gpg повідомляє, що файл не містить коректних даних OpenPGP, завантаження не вдалося, а apt update згодом завершується помилкою NO_PUBKEY BAA929FF1A7ECACE.

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

sudo apt update && sudo apt install claude-desktop

Запустіть застосунок із меню програм або виконайте claude-desktop у терміналі. Увійдіть за допомогою облікового запису claude.ai або через SSO (єдиний вхід) вашої організації, якщо компанія його налаштувала. Десктопний застосунок не приймає ключ API Claude Console: автентифікація за ключем доступна в CLI.

E: Unable to locate package claude-desktop означає, що apt не прочитав репозиторій. 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 у вебі. Сеанс виконується в хмарі Anthropic, а не на вашій машині, і завжди використовує облікові дані вашої підписки.

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

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

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

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

Останній пункт пояснює, чому посібник для серверів приділяє увагу CLI. Орендований сервер має SSH (захищену оболонку) і більше нічого, тому термінал є єдиним інтерфейсом, доступним разом із сервером. Робота в такому режимі має власні правила. Усі вони докладно описані в матеріалі як запускати Claude Code на VPS у tmux, а в матеріалі як використовувати Claude для повсякденних завдань системного адміністрування розглянуто завдання, які варто йому доручати.

Інтеграції з редакторами є проміжним варіантом. Розширення VS Code потребує VS Code 1.94.0 або новішої версії та додає графічну панель усередині редактора з переглядом diff і плану. Для цієї панелі воно містить окрему копію CLI і не додає claude до вашого PATH. Тому для введення claude в інтегрованому терміналі все одно потрібне окреме встановлення. Редактори на основі VS Code встановлюють це саме розширення з реєстру Open VSX. Також існує плагін для 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. Починаючи з версії пакета 2.1.198, пакет 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 працює майже так само, як пакет для настільної системи, і використовує власний ключ підпису в 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 kernel OOM 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.

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

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

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

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

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

Чи покриває одна підписка Claude всі ці способи доступу?

Один платний план охоплює всі способи доступу з одним обліковим записом. Обліковий запис Pro, Max, Team або Enterprise дає змогу увійти до claude.ai у браузері, у desktop app, CLI та розширенні для VS Code. У кожному випадку використовується та сама підписка. Ліміт використання також є спільним для всіх способів доступу. Тому тривалий запуск CLI на сервері зменшує доступний ліміт desktop app. Коли будь-який спосіб доступу починає відхиляти запити, потрібно з’ясувати який ліміт спрацював і що з цим робити. Безкоштовний план claude.ai не надає доступу до Claude Code. Тому для CLI та функцій Claude Code у desktop app потрібен платний план або обліковий запис Claude Console.

API — це інший продукт з іншою моделлю оплати. Обліковий запис Console оплачує фактично надіслані токени. Це зручно для сервісу, який ви розробляєте, а не для роботи в терміналі вручну. Налаштування ANTHROPIC_API_KEY переводить CLI на цю модель оплати. Це окремий свідомий вибір, а не резервний варіант.

Ціни та ліміти планів надто часто змінюються, тому тут їх не наведено. Поточні значення відстежуються на двох сторінках: скільки насправді коштує 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 і механізм визначення помилково їх враховує. Виконайте 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

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

FAQ

Чи є десктопний застосунок Claude для Linux?

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

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

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

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

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

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

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

Чи поширюється моя підписка Claude Pro також на CLI, як і на вебзастосунок?

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