Claude у Linux: Desktop app і CLI

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

Claude у Linux працює на чотирьох окремих рівнях. Станом на August 2026 усі чотири працюють на звичайній системі Ubuntu або Debian. Desktop app встановлюється з apt repository Anthropic і перебуває в beta. Claude Code CLI (command line interface) — це скомпільований binary. Він працює в більшій кількості дистрибутивів, ніж desktop app. Web app на claude.ai потребує лише browser. 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 on the web. Сесія працює в хмарі Anthropic, а не на вашій машині, і завжди використовує облікові дані вашої підписки.

Важливо розуміти обмеження браузера. Хмарна сесія не може читати файли на вашому сервері або виконувати на ньому команди. Для будь-якої дії, що стосується вашої машини, потрібне програмне забезпечення на цій машині. Це 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. Починаючи з версії пакета 2.1.198, пакет npm потребує Node.js 22 або новішої версії. У старішій версії Node.js npm виводить попередження EBADENGINE, а не завершується з помилкою, оскільки пакет підключає той самий нативний бінарний файл як залежність для відповідної платформи та створює на нього посилання.

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

Не виконуйте цю команду з sudo. Документація застерігає від sudo npm install -g, оскільки це залишає файли, власником яких є root, у глобальному каталозі npm. Через це наступне встановлення або оновлення без привілеїв завершується помилкою доступу. Якщо глобальний каталог 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 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, якщо потрібно, щоб swap знову активувався після перезавантаження. Про те, що ще потрібно обмежити перед запуском агентом команд на робочому сервері, дивіться в розділі безпечний запуск 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 все це?

Один платний план охоплює всі інтерфейси з одним обліковим записом. Обліковий запис Pro, Max, Team або Enterprise дає змогу увійти до claude.ai у браузері, настільної програми, CLI та розширення VS Code. Щоразу використовується та сама підписка. Ліміт використання також є спільним для всіх інтерфейсів. Тому тривалий запуск CLI на сервері зменшує доступний залишок для настільної програми. Якщо будь-який інтерфейс перестає приймати запити, потрібно визначити, яке вікно ліміту вичерпано та що з цим робити. Безкоштовний план claude.ai не включає доступ до Claude Code. Тому для CLI та функцій Claude Code у настільній програмі потрібен платний план або обліковий запис 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

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

Так. Станом на August 2026 він перебуває в beta та підтримує Ubuntu 22.04 або новішу версію і Debian 12 або новішу версію на amd64 або arm64. Встановіть його за допомогою sudo apt install claude-desktop після додавання apt-репозиторію Anthropic і його signing key, щоб нові версії надходили під час звичайних оновлень системи. 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 завантажує скомпільований binary, який не використовує Node.js під час виконання. Node.js потрібен лише в разі встановлення npm-пакета, якому станом на версію 2.1.198 потрібен Node.js 22 або новіший. У старішій версії Node.js npm виводить попередження EBADENGINE, але встановлення все одно завершується, оскільки той самий native binary завантажується як per-platform dependency. Не встановлюйте його за допомогою sudo npm install -g. Це створює файли, власником яких є root, у вашому npm prefix і порушує подальші оновлення.

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

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

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

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

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

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