Claude Desktop скачивают на странице claude.com/download: там есть сборки для macOS, Windows (x64 и ARM64) и бета-версия для Linux. MCP-серверы подключаются в файле claude_desktop_config.json, который открывает кнопка Edit Config на вкладке Developer. Дальше по шагам: установка, конфиг, режим Gateway для тех, у кого нет аккаунта Anthropic, и разбор ошибок.
Что такое Claude Desktop
Claude Desktop это официальное приложение Anthropic для компьютера. В нём живут чат, Cowork и вкладка Code, то есть Claude Code с графическим интерфейсом. Лимиты у приложения общие с сайтом и терминалом, о чём подробнее в статье «Лимиты Claude». Чат на десктопе доступен и на бесплатном тарифе, а для вкладки Code по документации Claude Code нужна подписка Pro, Max, Team или Enterprise. Что такое Cowork, мы разбираем в статье «Claude Cowork».
Где скачать Claude Desktop и что нужно для установки
Единственный источник, которому стоит доверять, это claude.com/download (на него ведёт и ссылка claude.ai/download). Для Windows есть ещё Microsoft Store. Любые «Claude Desktop crack», «portable» и сборки с торрентов мы не разбираем: подмена установщика даёт злоумышленнику доступ к вашим файлам и ключам.
| Система | Требования | Откуда ставить |
|---|---|---|
| macOS | macOS 13 (Ventura) и новее, Intel и Apple Silicon | claude.com/download |
| Windows x64 | Windows 10 и новее | claude.com/download или Microsoft Store |
| Windows ARM64 | Windows 10 и новее | claude.com/download |
| Linux (бета) | Ubuntu 22.04+ или Debian 12+, x86_64 или arm64 | apt-репозиторий Anthropic |
Требования к macOS и Windows взяты из справки Anthropic. На Fedora и Arch десктопной версии нет, там используйте CLI. Computer Use и диктовка на Linux пока не работают.
Linux ставится из репозитория Anthropic, как описано в документации:
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc
echo "deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
sudo apt update && sudo apt install claude-desktop
Перед установкой сверьте ключ командой gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc: отпечаток должен быть 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Сама программа на Linux не обновляется, обновления приходят через sudo apt update && sudo apt upgrade.
Установка Claude Desktop на Windows и Mac
- Скачайте установщик для своей системы и откройте его.
- Дождитесь окончания установки и запустите Claude: на Mac из папки Applications, на Windows из меню Пуск.
- Войдите в аккаунт Anthropic.
Третий шаг упирается в регион. Россия не входит в список поддерживаемых стран Anthropic, а политика Anthropic не допускает использование людьми, которые физически находятся в неподдерживаемом регионе. Обходить это поддельными данными мы не советуем, а что известно о блокировках за VPN, разобрано в статье «VPN для Claude и баны аккаунтов». Альтернатива описана ниже: режим Gateway, в котором вход в аккаунт вообще не нужен.
Как подключить MCP-сервер к Claude Desktop
MCP-сервер это программа, которая даёт Claude доступ к файлам, базам или API. Большинству серверов нужен Node.js: ставьте версию LTS с официального сайта Node.js.
Откройте меню Claude в строке меню (не настройки внутри окна), выберите Settings, вкладку Developer и нажмите Edit Config. Приложение откроет файл claude_desktop_config.json. Где он лежит, сказано в официальной инструкции MCP:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux: путь в инструкции не указан, открывайте файл кнопкой Edit Config.
Пример для macOS с файловым сервером, которому разрешены две папки:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/Users/username/Downloads"
]
}
}
}
Подставьте своё имя пользователя вместо username. На Windows пути пишутся с двойными обратными слешами: C:\\Users\\username\\Desktop. Пути должны быть абсолютными, относительные не подойдут.
Сохраните файл, полностью выйдите из Claude Desktop и запустите его заново: закрытия одного окна мало. После нового запуска сервер появится в списке коннекторов: кнопка «Add files, connectors, and more» в поле ввода, пункт Connectors. Если сервера нет, смотрите логи: на macOS в ~/Library/Logs/Claude, на Windows в %APPDATA%\Claude\logs. Файл mcp.log описывает соединения, а mcp-server-ИМЯ.log хранит вывод конкретного сервера.
Сервер работает с правами вашего пользователя и умеет всё, что умеете вы. Открывайте ему только те папки, которые готовы показать модели. Как устроены и как пишутся такие серверы, рассказано в статьях «MCP-серверы для Claude» и «MCP-сервер: что это».
Проверка сервера и три правила безопасности
После перезапуска попросите Claude перечислить файлы в одной из разрешённых папок. При первом вызове инструмента приложение попросит подтвердить действие. Дальше соблюдайте три правила.
- Берите серверы из источников, которым доверяете: пакет из npm запускается с правами вашего пользователя.
- Начинайте с узкого доступа. Одна рабочая папка лучше, чем весь домашний каталог.
- Не вписывайте пароли и токены в
args: передавайте их через ключenvи не публикуйте конфиг в репозитории.
Claude Desktop, сайт или Claude Code в терминале
Выбор зависит от задачи. Чат на сайте и в приложении даёт один набор возможностей. Desktop добавляет локальные MCP-серверы, то есть доступ к вашим файлам и программам, и вкладку Code с визуальным просмотром правок. Терминальный Claude Code подходит тем, кто живёт в консоли и гоняет агента по скриптам и CI. Если вам хватает чата с доступом к нескольким папкам, ставьте Desktop. Если нужен агент, который сам запускает тесты и коммитит, начните с Claude Code: MCP там подключается командой claude mcp add.
Claude Desktop через Claudexia: режим Gateway
В Claude Desktop есть режим стороннего инференса (3P): приложение отправляет запросы не в Anthropic, а на шлюз, который вы укажете. По документации Anthropic шлюз должен принимать POST /v1/messages со стримингом и вызовом инструментов, а список моделей через GET /v1/models необязателен. Claudexia подходит под это описание, но для Anthropic это сторонний продукт, который она не проверяет и не рекомендует.
Настройка по нашему гайду занимает пять шагов, входить в аккаунт не нужно:
- Установите приложение и откройте главное меню приложения (значок с тремя полосками), затем Help, Troubleshooting, Enable Developer Mode.
- В появившемся меню Developer выберите
Configure Third-Party Inference…. - В разделе подключения выберите
Gatewayи заполните поля из таблицы ниже. Раздел Gateway SSO IdP (OIDC) оставьте пустым. - Откройте раздел Models и включите Model discovery, список подтянется из
https://api.claudexia.tech/v1/models. Кнопка Test model discovery проверяет связь сразу. - Нажмите
Apply Changes. Приложение перезапустится, а если снова покажет экран входа, нажмитеOr sign in with Gateway.
| Поле | Значение |
|---|---|
| Credential kind | Static API key |
| Gateway base URL | https://api.claudexia.tech (без /v1) |
| Gateway API key | sk_cdx_YOUR_KEY |
| Gateway auth scheme | x-api-key |
Что важно знать заранее. Документация Anthropic называет режим 3P решением для организаций, и приложение даже в нём обращается к хостам Anthropic за служебными данными: пакетом рабочей среды, бинарником Claude CLI, обновлениями и каталогом моделей. Доступны ли эти хосты из вашей сети, мы гарантировать не можем. Локальные MCP-серверы в этом режиме добавляются через Settings, Developer, а удалённые коннекторы пользователь сам добавить не может. Сессия Code подхватывает серверы из конфигурации самого Claude Code: claude mcp add и .mcp.json работают как обычно.
Claudexia остаётся API-доступом: подписок Claude и веб-чата claude.ai она не продаёт. Ключ вы создаёте в кабинете, баланс пополняете картой РФ, через СБП или криптой. Какие модели выбрать и сколько они стоят, смотрите на странице моделей (прайс Claudexia на 29 октября 2026).
Частые ошибки
| Симптом | Вероятная причина | Что делать |
|---|---|---|
| Список моделей пуст | В адресе лишний /v1 или неверный ключ | Уберите /v1, проверьте ключ, нажмите Test model discovery |
| Ошибка 401 | Ключ не начинается с sk_cdx_ или отключён | Проверьте ключ в разделе «API-ключи» |
| Gateway was unreachable | Приложение не дозвонилось до адреса при запуске | Проверьте адрес и сеть, например командой curl к /v1/models |
| MCP-сервер не появился | Ошибка синтаксиса JSON, относительный путь, приложение не перезапущено | Проверьте запятые и кавычки, укажите абсолютные пути, закройте приложение целиком |
В логах ${APPDATA} на Windows | Сервер не раскрыл переменную среды | Добавьте раскрытое значение %APPDATA% в ключ env сервера |
npx не найден | Не установлен Node.js | Поставьте версию LTS и перезапустите приложение |
FAQ
Где скачать Claude Desktop?
Только на официальной странице claude.com/download или в Microsoft Store для Windows. Там есть установщики для macOS, Windows x64 и ARM64, а для Linux ссылка ведёт в документацию по установке из apt-репозитория Anthropic.
Есть ли Claude Desktop для Linux?
Да, в бета-версии для Ubuntu 22.04 и новее и Debian 12 и новее, на архитектурах x86_64 и arm64. На Fedora и Arch десктопного приложения нет, там можно поставить Claude Code из терминала.
Где лежит claude_desktop_config.json?
На macOS в ~/Library/Application Support/Claude/claude_desktop_config.json, на Windows в %APPDATA%\Claude\claude_desktop_config.json. Проще всего открыть файл кнопкой Edit Config на вкладке Developer: путь запоминать не придётся.
Работает ли Claude Desktop в России?
Anthropic не поддерживает Россию, поэтому войти в аккаунт и оплатить подписку официально нельзя. Приложение можно настроить на режим Gateway и вести запросы через Claudexia, тогда вход в аккаунт Anthropic не нужен. Доступность служебных хостов Anthropic зависит от вашей сети.
Какие требования у Claude Desktop для Windows?
Windows 10 или новее, версии для x64 и ARM64. Установщик лежит на claude.com/download, приложение также есть в Microsoft Store.
Нужна ли подписка для Claude Desktop?
Чат в десктопном приложении входит в бесплатный тариф. Для вкладки Code нужна подписка Pro, Max, Team или Enterprise, цены тарифов собраны в статье «Claude подписка: цены». В режиме Gateway подписка не нужна: вы платите за токены шлюзу.