Claude Desktop: установка, MCP-серверы и подключение к Relay
Claude Desktop ставится как обычная программа, и главная возня начинается после установки: нужно научить его работать с вашими файлами и решить, откуда брать модель. Локальные инструменты подключаются через MCP-серверы, а запросы приложения можно направить на ключ Relay вместо подписки Anthropic. Разберём установку, правку конфигурации MCP, три способа подключения к шлюзу и ошибки, на которых застревают чаще всего.
Коротко
Установщик берите только со страницы загрузки на официальном сайте Claude.
Подключение MCP-сервера сводится к правке одного JSON-файла и полному перезапуску приложения.
К Relay приложение подключают тремя путями: Relay Desktop, CC Switch или встроенный Gateway.
В режиме Gateway адрес указывается как
https://relay-llm.ru, без/v1.
Где взять приложение и что оно требует
Надёжный источник один: страница загрузки на официальном сайте Claude, плюс Microsoft Store для Windows. Сборки с пометками «portable» или «crack» и раздачи с торрентов обходите стороной. Подменённый установщик получает доступ ко всему, что видит приложение, а вместе с ним и ваши файлы с ключами.
Требования вендора на 29 октября 2026 года. Перед установкой сверьте их на странице загрузки.
| Платформа | Минимальная версия | Источник |
|---|---|---|
| macOS | 13 и выше, Intel и Apple Silicon | страница загрузки на сайте Claude |
| Windows | 10 и выше, сборки x64 и ARM64 | страница загрузки или Microsoft Store |
| Linux | Ubuntu 22.04 и выше или Debian 12 и выше, это бета | apt-репозиторий, по инструкции вендора |
Для Linux вендор опубликовал свои команды вместе с проверкой подписи репозитория, и брать их стоит из его документации, а не из пересказов. Вход в аккаунт Anthropic нужен, если вы работаете по подписке вендора. При подключении через Relay его заменяет ключ, об этом ниже.
Как подключить MCP-сервер
MCP-сервер это отдельная программа, через которую модель читает файлы, ходит в базы данных или вызывает внешние API. Большинство серверов запускается через Node.js, поэтому поставьте версию LTS с официального сайта Node.js.
Настройки лежат в меню приложения Claude в строке меню системы, а не в окне чата. Откройте Settings, перейдите на вкладку Developer и нажмите Edit Config: приложение само откроет нужный файл claude_desktop_config.json. Если нужно найти его вручную:
| Система | Конфигурация | Журналы |
|---|---|---|
| macOS | папка ~/Library/Application Support/Claude | ~/Library/Logs/Claude |
| Windows | папка %APPDATA%\Claude | %APPDATA%\Claude\logs |
| Linux | вендор путь не называет, используйте кнопку Edit Config | вендор путь не называет |
В файле нужен раздел mcpServers. Пример с сервером, который открывает модели одну рабочую папку:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/ivan/projects"
]
}
}
}Замените ivan на своё имя пользователя. Пути должны быть абсолютными, а в Windows обратные слеши в JSON удваиваются. Одна лишняя запятая ломает весь файл, поэтому перед перезапуском проверьте синтаксис (команда для macOS):
python3 -m json.tool "$HOME/Library/Application Support/Claude/claude_desktop_config.json"Затем завершите работу приложения полностью, закрытия одного окна мало, и запустите его снова. Новый сервер появится среди коннекторов в поле ввода сообщения. Если он не появился, смотрите журналы: общий файл mcp.log описывает подключения, а mcp-server-ИМЯ.log содержит вывод конкретного сервера.
Три способа перевести Claude Desktop на Relay
По документации Relay подключение меняет только источник модели. Запросы приложения идут на шлюз и оплачиваются с баланса, подписка Anthropic в этом сценарии не нужна, а расход каждого запроса виден в консоли Relay.
| Способ | Что делаете | Когда выбрать |
|---|---|---|
| Relay Desktop | Ставите приложение Relay, находите в нём Claude Desktop и жмёте «Connect to Relay» | Нужно как можно меньше ручных шагов |
| CC Switch | Добавляете Relay провайдером в графическом менеджере и вводите ключ | Вы держите несколько провайдеров под рукой |
| Встроенный Gateway | Заполняете поля стороннего инференса в самом приложении | Не хотите ставить дополнительные программы |
В Relay Desktop вернуться к подписке Anthropic можно кнопкой «Disconnect Relay»: она убирает подключение из Claude Desktop. CC Switch документация требует версии 3.16.5 или новее. В нём откройте вкладку Claude Desktop, нажмите кнопку добавления в правом верхнем углу, найдите Relay среди готовых провайдеров, введите ключ из консоли и сохраните. Потом включите Relay на главном экране и перезапустите приложение.
Встроенная настройка обходится без сторонних программ. Включите режим разработчика: в меню Help откройте Troubleshooting и выберите Enable Developer Mode. В появившемся меню Developer откройте Configure Third-Party Inference, выберите тип подключения Gateway и заполните поля.
| Поле | Значение |
|---|---|
| Gateway base URL | https://relay-llm.ru, без /v1 |
| Gateway API key | ключ из консоли Relay |
| Схема авторизации | Bearer, если такое поле есть |
| Custom inference headers | пустое значение |
Когда список моделей пуст, добавьте идентификаторы руками в разделе Models, например claude-sonnet-5-5 или claude-haiku-5.5. Примените настройки, полностью закройте приложение и откройте снова. Документация Relay уточняет, что и Cowork, и Code берут шлюз из этой настройки. Отправьте сообщение и найдите его в журнале запросов консоли.
Две оговорки по документации вендора. Режим стороннего инференса рассчитан в первую очередь на организации, и приложение даже в нём может обращаться к серверам Anthropic за служебными данными, например за обновлениями и каталогом моделей. Достучится ли оно туда, зависит от вашей сети. Кроме того, вендор не проверяет и не поддерживает сторонние шлюзы, так что при сбое начинайте с адреса, ключа и названия модели.
Нужен терминальный агент без графической оболочки? Начните со статьи Claude Code: установка и три способа оплаты или со страницы интеграции с Claude Code. Полный порядок для приложения описывает инструкция по Claude Desktop.
Если что-то не работает
| Что видите | В чём причина | Как исправить |
|---|---|---|
| Пустой список моделей | Лишний /v1 в адресе или неверный ключ | Уберите /v1, проверьте ключ, добавьте модели вручную |
| Ответ 401 | Ключ неверный, просроченный или отозванный | Сверьтесь с консолью, при необходимости выпустите новый ключ |
| Ответ 402 | На балансе ноль | Пополните баланс |
| Windows: Virtual Machine Platform not available | Отключён компонент системы | Win+R, команда optionalfeatures, отметить компонент, перезагрузка |
| MCP-сервер не появился в списке | Синтаксис JSON, относительный путь, приложение закрыто не до конца | Прогоните файл через проверку, задайте абсолютные пути, перезапустите |
Не найден npx | Не установлен Node.js | Поставьте LTS и перезапустите приложение |
Как открыть конфигурацию MCP, если не помню путь?
Меню Claude в строке системы, затем Settings, вкладка Developer и кнопка Edit Config. Приложение открывает файл само, поэтому искать его в папках не нужно.
Нужна ли подписка Anthropic, если приложение подключено к Relay?
Нет, запросы идут на шлюз и оплачиваются с баланса за токены. В Relay Desktop вернуться к подписке можно кнопкой «Disconnect Relay», она убирает подключение из Claude Desktop.
На каких дистрибутивах Linux работает приложение?
По данным вендора, это бета для Ubuntu 22.04 и выше и Debian 12 и выше на архитектурах x86_64 и arm64. Для Fedora и Arch десктопной версии нет, там остаётся Claude Code в терминале.