Claude в Linux: установка приложения и CLI

Какие компоненты Claude сегодня работают в Linux нативно

Claude в Linux работает через четыре отдельных интерфейса, и по состоянию на август 2026 года все они функционируют на стандартных дистрибутивах Ubuntu или Debian. Десктопное приложение устанавливается из apt-репозитория Anthropic и находится в стадии бета-тестирования. Claude Code CLI (интерфейс командной строки) представляет собой скомпилированный бинарный файл и работает на большем количестве дистрибутивов, чем десктопное приложение. Веб-приложение на claude.ai требует только браузера, а API — это HTTPS-эндпоинт, к которому вы обращаетесь из собственного кода.

Две функции, доступные в macOS и Windows, отсутствуют в бета-версии для Linux: Computer Use, позволяющая Claude управлять приложениями на вашем экране, и голосовая диктовка. Anthropic указывает, что обе эти функции пока недоступны в Linux. В CLI есть собственная функция голосовой диктовки, поэтому ограничение касается именно десктопного приложения, а не самого 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 или десктопное приложение.

Преимущества CLI перед веб-приложением

Запустите claude в директории, и он начнет работать с ней. В этом заключается основное различие, из которого вытекает всё остальное.

• Он читает и редактирует файлы в вашей рабочей директории, показывая каждое изменение перед его применением.
• Он выполняет одобренные вами shell-команды, что позволяет собирать проект, запускать набор тестов, читать логи или проверять состояние сервиса непосредственно на сервере.
• Он работает без интерактивной сессии: claude -p "read the nginx error log and summarise it" выводит один ответ и завершает работу, что удобно для использования в cron-задачах или конвейерах CI/CD.
• Он подключает 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; также доступен плагин для 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.

Установка для пользователя или для всей системы?

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

Установка через менеджер пакетов выполняется для всей системы. Один бинарный файл обслуживает всех пользователей, требует прав root и не поддерживает автоматическое обновление через Claude Code. Обновление выполняется с помощью sudo apt update && sudo apt upgrade claude-code — той же команды, которую вы используете для остального ПО на сервере.

Выбирайте установку для пользователя, если вы работаете на машине под своей учетной записью (это типичный сценарий для VPS). Выбирайте установку через менеджер пакетов на общем сервере или при создании образа системы, если вам нужна одна версия для всех пользователей и вы хотите обновлять её по своему графику. При нативной установке поведение обновлений определяется двумя параметрами в ~/.claude/settings.json:

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

Канал stable использует релизы, вышедшие примерно неделю назад, и пропускает версии с критическими ошибками. Параметр DISABLE_AUTOUPDATER отключает только фоновую проверку, поэтому команда claude update продолжает работать, и вы сохраняете контроль над тем, когда будет установлена новая версия. Это важно для серверов, где выполняются длительные фоновые задачи и вы не хотите, чтобы бинарный файл изменился в процессе работы.

Вход по SSH и поддержание сессии в активном состоянии

При первом запуске CLI на арендованном сервере возникают две специфические для Linux проблемы. Процесс входа требует браузер, а на сервере его нет. Разрыв SSH-соединения прерывает выполнение текущих задач.

tmux решает вторую проблему. Сессия tmux принадлежит серверу tmux на удаленной машине, а не вашему соединению, поэтому при обрыве связи процесс продолжает работать.

tmux new -s claude
claude

Отключитесь от сессии с помощью Ctrl-b, затем d, и вернитесь к ней позже командой tmux attach -t claude.

Вход в систему — первая проблема. Запустите claude, и программа выведет URL для авторизации. Откройте этот URL в браузере на своем компьютере. После входа браузер покажет код авторизации вместо перенаправления, так как браузер на вашем ноутбуке не может обратиться к серверу обратного вызова, который 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 — это дисковое пространство, которое ядро использует как дополнительную память. Оно работает значительно медленнее 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, поэтому привычки, сформированные в macOS, здесь не применимы: в 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, при этом подписка остается единой. Бесплатный тарифный план 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, и этот каталог отсутствует в переменной окружения PATH вашей оболочки. Проверьте это с помощью 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

Все номера версий и даты в этом руководстве актуальны на август 2026 года. Общая структура остается неизменной: четыре поверхности, единая учетная запись для платных версий и выбор между установкой CLI для конкретного пользователя или для всей системы.

FAQ

Существует ли десктопное приложение Claude для Linux?

Да. По состоянию на август 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, если вы установили эту переменную. В отличие от macOS, в Linux не используется связка ключей (keychain), поэтому любой процесс, запущенный от имени вашего пользователя, может прочитать этот файл. Таким образом, резервная копия /home или образ машины содержат активные данные для входа: выполните /logout перед созданием снимка или копированием системы. Если в вашем окружении также задана переменная 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, что является продуктом, отличным от подписки.