Установщики 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и не публикуйте конфиг в репозитории.
Что выбрать: Desktop, сайт или Claude Code в терминале
Выбор зависит от задачи. Чат на сайте и в приложении даёт один набор возможностей. Desktop добавляет локальные MCP-серверы, то есть доступ к вашим файлам и программам, и вкладку Code с визуальным просмотром правок. Терминальный Claude Code подойдёт тем, кто живёт в консоли и гоняет агента по скриптам и CI. Хватает чата с доступом к нескольким папкам? Ставьте Desktop. Нужен агент, который сам запускает тесты и коммитит? Начните с Claude Code: MCP там подключается командой claude mcp add.
Claude Desktop через codexkey: режим Gateway
В Claude Desktop есть режим стороннего инференса (3P): приложение шлёт запросы не в Anthropic, а на шлюз, который вы укажете. По документации Anthropic шлюз должен принимать POST /v1/messages со стримингом и вызовом инструментов, а список моделей через GET /v1/models необязателен. codexkey подходит под это описание, но для Anthropic это сторонний продукт, который она не проверяет и не рекомендует.
Настройка по нашему гайду занимает пять шагов, входить в аккаунт не нужно:
- Установите приложение и откройте главное меню приложения (значок с тремя полосками), затем Help, Troubleshooting, Enable Developer Mode.
- В появившемся меню Developer выберите
Configure Third-Party Inference…. - В разделе подключения выберите
Gatewayи заполните поля из таблицы ниже. Раздел Gateway SSO IdP (OIDC) оставьте пустым. - Откройте раздел Models и включите Model discovery: список подтянется из
https://api.codexkey.ru/v1/models. Кнопка Test model discovery сразу проверяет связь. - Нажмите
Apply Changes. Приложение перезапустится, а если снова покажет экран входа, нажмитеOr sign in with Gateway.
| Поле | Значение |
|---|---|
| Credential kind | Static API key |
| Gateway base URL | https://api.codexkey.ru (без /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 работают как обычно.
codexkey остаётся API-доступом: подписок Claude и веб-чата claude.ai он не продаёт. Ключ создаётся в кабинете, баланс пополняется картой РФ, через СБП или криптой. Какие модели выбрать и сколько они стоят, смотрите на странице моделей (прайс codexkey на 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 и вести запросы через codexkey: тогда вход в аккаунт Anthropic не нужен. Доступность служебных хостов Anthropic зависит от вашей сети.
Какие требования у Claude Desktop для Windows?
Windows 10 или новее, версии для x64 и ARM64. Установщик лежит на claude.com/download, приложение есть и в Microsoft Store.
Нужна ли подписка для Claude Desktop?
Чат в десктопном приложении входит в бесплатный тариф. Вкладке Code нужна подписка Pro, Max, Team или Enterprise, цены тарифов собраны в статье «Claude подписка: цены». В режиме Gateway подписка не нужна: вы платите шлюзу за токены.