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-задачах или пайплайнах. Формат ответа вы определяете сами, так как стиль вывода редактирует системный промпт для каждого ответа, что позволяет сделать скриптовый запуск лаконичным, а интерактивную сессию — подробной.
• Он подключает 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 памяти OOM-killer (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, если хотите, чтобы он подключался после перезагрузки. О том, что еще нужно ограничить перед тем, как позволить агенту выполнять команды на рабочем сервере, рассказывается в безопасном запуске 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 использует её после вашего подтверждения, поэтому подписка остается неиспользованной, а оплата списывается за каждый токен через ключ. Команда /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, и этот каталог отсутствует в переменной окружения 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, что является продуктом, отличным от подписки.