Встановлення Claude Code на Linux. На малому сервері інсталятору може забракнути пам'яті

Як встановити Claude Code на Ubuntu, Debian, Fedora й Alpine. Скрипт, репозиторії apt, dnf і apk, вхід через SSH, типові помилки й видалення.

Частина посібникаClaude Code, повний посібник. Від встановлення до власних скілів і плагінів

У цьому тексті
  1. Вимоги перед встановленням Claude Code на Linux
  2. Встановлення скриптом або з репозиторію
  3. Alpine та інші дистрибутиви з musl
  4. Вхід на сервері без браузера
  5. Типові помилки встановлення на Linux
  6. Пісочниця, оновлення й видалення

Коротко

На Linux Claude Code встановлюють скриптом або з підписаних репозиторіїв apt, dnf і apk. Розповідаємо про вимоги до дистрибутивів, Alpine, вхід на сервері без браузера, помилки з пам'яттю й бібліотеками та видалення.

На найдешевшому хмарному сервері встановлення Claude Code закінчується одним словом Killed. Це не помилка програми, а системний механізм, який зупиняє процес, коли закінчується пам'ять. Linux дає більше способів встановлення, ніж Mac чи Windows, і більше місць, де щось може піти інакше. Усе нижче ми перевірили за документацією Anthropic, станом на 10 листопада 2026.

Що вміє сам інструмент, ми писали в статті Що таке Claude Code. Решту циклу зібрано в путівнику по Claude Code.

Вимоги перед встановленням Claude Code на Linux

Документація називає Ubuntu 20.04 і новіші, Debian 10 і новіші та Alpine Linux 3.19 і новіші. Репозиторії пакетів є також для Fedora й RHEL. Процесор має бути x64 або ARM64, оперативної пам'яті щонайменше 4 GB. Саме встановлення потребує приблизно 512 MB вільної пам'яті. Для входу потрібен план Pro, Max, Ultra, Team або Enterprise, акаунт у Claude Console або доступ через корпоративну хмару.

На Windows із WSL діє та сама інструкція, бо у WSL ставлять версію для Linux. Відмінності ми описали в статті про встановлення на Windows.

Встановлення скриптом або з репозиторію

Найпростіший шлях це скрипт встановлення. Версія з нього оновлюється сама.

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

Програма потрапляє в ~/.local/bin/claude, а її версії в ~/.local/share/claude/versions/. Коли інсталятор закінчить, відкрийте нову сесію термінала й введіть claude --version. Команда claude doctor перевірить встановлення й файли налаштувань без запуску сесії.

На серверах часто зручніші репозиторії, бо оновлення приходять разом з рештою системи. Anthropic веде підписані репозиторії apt, dnf і apk, кожен з каналами stable і latest. Stable це версія приблизно тижневої давності без випусків із серйозними помилками. Так виглядає встановлення каналу stable на Debian і Ubuntu.

bash
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc -o /etc/apt/keyrings/claude-code.asc
gpg --show-keys /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

Команда gpg --show-keys має вивести один відбиток ключа, 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Якщо на свіжій системі бракує curl або gpg, поставте їх через sudo apt install curl gnupg. На Fedora й RHEL репозиторій додають файлом у /etc/yum.repos.d/ і встановлюють через sudo dnf install claude-code. Точний вміст файлу є в документації.

Встановлення з репозиторію не оновлюється через Claude Code. Ви оновлюєте його звичайним оновленням системи, наприклад sudo apt update && sudo apt upgrade claude-code або sudo dnf upgrade claude-code.

Alpine та інші дистрибутиви з musl

В Alpine типово немає bash і curl, тож скрипт встановлення завершується помилкою not found. Перед встановленням поставте потрібні пакети.

bash
apk add bash curl libgcc libstdc++ ripgrep

Пакет ripgrep лежить у репозиторії community. Якщо apk його не знаходить, додайте цей репозиторій у /etc/apk/repositories і виконайте apk update. Потім у файлі ~/.claude/settings.json встановіть змінну USE_BUILTIN_RIPGREP у 0, щоб Claude Code користувався системним ripgrep. Anthropic веде й репозиторій apk, тоді встановлення зводиться до apk add claude-code після додавання ключа й адреси репозиторію.

Вхід на сервері без браузера

Під час першого запуску claude хоче відкрити браузер. Через SSH або в контейнері браузера немає, тож натисніть c, щоб скопіювати адресу входу. Відкрийте її в браузері на своєму комп'ютері й увійдіть. Сторінка покаже код, який ви вставляєте в термінал у місці Paste code here. Якщо вставка не спрацьовує, скористайтеся claude auth login, яка читає код зі стандартного введення.

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

Типові помилки встановлення на Linux

Документація описує кілька симптомів, які трапляються переважно на Linux.

  • Killed або повідомлення про перерване встановлення з кодом 137 означає нестачу пам'яті. Допомагає закрити інші процеси або додати файл підкачки, наприклад 2 GB, і запустити скрипт знову.
  • Встановлення зависає в контейнері Docker, коли скрипт стартує з теки /. Заздалегідь задайте WORKDIR /tmp.
  • Error loading shared library libstdc++.so.6 означає, що завантажилася збірка для musl на системі з glibc або навпаки. Перевірити це можна командою ldd --version.
  • Illegal instruction означає неправильну архітектуру або процесор без інструкцій AVX, що часто буває в старіших віртуальних машинах. Інший спосіб встановлення не допоможе, бо завантажує ту саму програму.
  • bash: claude: command not found означає, що ~/.local/bin немає в PATH. Допишіть export PATH="$HOME/.local/bin:$PATH" у ~/.bashrc і відкрийте нову сесію.

Якщо домашні теки лежать на мережевому диску, сесія може впасти з повідомленням Bus error, коли оновлення на іншій машині видалить файл, який вона використовує. Документація радить тоді ставити програму на локальний диск, наприклад з репозиторію.

Пісочниця, оновлення й видалення

На Linux і у WSL 2 Claude Code може запускати команди в пісочниці, яка обмежує доступ до файлів і мережі. Для цього потрібні пакети bubblewrap і socat, на Debian і Ubuntu їх ставлять через sudo apt-get install bubblewrap socat. Команда /sandbox у сесії покаже, чого бракує.

Версія зі скрипта оновлюється сама, а claude update робить це одразу. Видалення виглядає так.

bash
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Встановлення з apt прибирає sudo apt remove claude-code, з dnf sudo dnf remove claude-code, а з apk apk del claude-code. Варто видалити й файл репозиторію з ключем. Налаштування, дозволи й історія лишаються в ~/.claude і у файлі ~/.claude.json.

Після встановлення переходьте до першого запуску й входу, а перед роботою на сервері прочитайте про дозволи Claude Code.

На сервері з малою кількістю пам'яті спершу додайте файл підкачки, а вже потім запускайте інсталятор. Якщо хочете перевірити, де AI розвантажить вашу фірму поза кодом, приходьте на безкоштовний аудит AI.

Що хочете змінити у своїй фірмі?

Залиште номер. Поговоримо про ваш процес і перевіримо, чи можемо допомогти. Перша розмова безкоштовна.

Коли зручно зателефонувати?
Адміністратор: Oleksandr Bondarenko (BondSoft)Політика конфіденційностіРегламент
Юридичні деталі

Адміністратором даних є Oleksandr Bondarenko, що веде господарську діяльність під фірмою Oleksandr Bondarenko Software Solutions (BondSoft), ul. Jana Heweliusza 11, 80-890 Gdańsk, NIP 5833576264, e-mail: office@bondsoft.pl.

Дані обробляємо виключно з метою контакту у справі вашого запиту та надання пропозиції — на підставі вашої згоди (ст. 6 ч. 1 п. a RODO та ст. 398 закону Prawo komunikacji elektronicznej) і нашого правомірного інтересу, що полягає в опрацюванні запиту (ст. 6 ч. 1 п. f RODO).

Надання даних добровільне, але необхідне для зворотного контакту. Згоду можете відкликати будь-коли, написавши на office@bondsoft.pl — це не впливає на законність обробки до відкликання.

Ви маєте право на доступ до даних, їх виправлення, видалення, обмеження обробки, перенесення, а також на скаргу до Голови Управління охорони персональних даних.

Повна інформація: Політика конфіденційності.

Напишіть на пошту

Послуга, про яку цей текст

Автоматизація та AI / OCR

Автоматизація переписування документів, OCR і правила перевірки, а дані лишаються у вас.