Claude Desktop со сторонним API: настройка Configure Third-Party Inference и диагностика

Wokey Team · 2026-09-24

Коротко: в десктопном приложении Claude есть ровно один способ подключить сторонний API: Developer → Configure Third-Party Inference. Приложение не читает ни ANTHROPIC_BASE_URL, ни ~/.claude/settings.json, поэтому настройка, которая работает у вас в терминале, в десктопном приложении ничего не меняет. В этом руководстве разобраны проблемы, с которыми сталкиваются чаще всего: пропавшее меню, настройки, которые не применяются, пустой список моделей и функции, которые в стороннем режиме просто недоступны. Полную первичную настройку смотрите в руководстве по настройке Claude Desktop.

Правильный порядок действий

1. Запустите десктопное приложение и не входите в аккаунт Anthropic.

2. Откройте Help → Troubleshooting → Enable Developer Mode.

3. Откройте Developer → Configure Third-Party Inference….

4. В разделе Connection установите для Inference provider значение Gateway, затем заполните Gateway credentials:

   Поле	Значение
   Gateway base URL	https://api.wokey.ai (без /v1)
   Gateway API key	Ваш API-ключ Wokey
   Credential kind	Static API key
   Gateway auth scheme	Bearer (Wokey принимает и x-api-key; оставьте значение по умолчанию)

5. Нажмите Apply Changes, затем Save & Restart.

Системные требования:

• macOS: 14 (Sonoma) или новее, на Apple silicon или Intel.
• Windows: Windows 10 сборки 19041 или новее, на x64 или Arm64.

Нет меню Developer

Меню Developer появляется только после включения режима разработчика: Help → Troubleshooting → Enable Developer Mode. Если и этого пункта нет в меню Help, обновите приложение до последней версии — в старых версиях нет настроек стороннего инференса.

Окно конфигурации доступно только для чтения

Если на компьютере уже есть конфигурация, развёрнутая администратором, — например, профиль MDM от вашей компании, — окно открывается только для чтения, и изменить её локально нельзя. Обратитесь к администратору или используйте неуправляемый компьютер.

Переменные окружения ни на что не влияют

Это самая частая ошибка. Десктопное приложение берёт настройки шлюза только из конфигурации стороннего инференса. Оно не читает ни ANTHROPIC_BASE_URL, ни settings.json.

Вкладка Code в десктопном приложении ведёт себя так же. Она работает на том же движке Claude Code, что и CLI, но адрес шлюза и учётные данные берутся напрямую из десктопной конфигурации. Пользовательские настройки в ~/.claude/settings.json не могут их переопределить.

Работает это и в обратную сторону: десктопная конфигурация не влияет на claude в вашем терминале. Настраивайте их по отдельности; для терминала смотрите руководство по base URL для Claude Code.

Список моделей пуст или в нём не хватает моделей

Если вы не задали собственный список моделей, приложение запрашивает у шлюза GET /v1/models и оставляет только модели, ID которых узнаваемо относятся к Claude. Поэтому с Wokey автообнаружение показывает модели вроде claude-opus-5 и claude-sonnet-5 и отфильтровывает GPT, Grok и другие модели. Так и должно быть.

Чтобы зафиксировать список или выбрать модель по умолчанию, укажите полные ID моделей в списке моделей окна конфигурации (Model list, ключ inferenceModels):

• Первая запись — модель по умолчанию; с неё же начинаются новые сессии на вкладке Code.
• Если все записи — полные ID, приложение пропускает запрос /v1/models.
• Если /v1/models завершается ошибкой, а список пуст, то и окно выбора модели будет пустым.

Ошибки

Gateway was unreachable: приложение не может достучаться до шлюза. Проверьте Gateway base URL на опечатки, затем протестируйте из терминала через curl:

curl -X POST https://api.wokey.ai/v1/messages \
  -H "Authorization: Bearer your Wokey API key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'

Если curl работает, а приложение нет, причина обычно в прокси: терминал ходит через него, а приложение — нет, или наоборот.

401 с code invalid_api_key: запрос дошёл до Wokey, но ключ отсутствует или неверен. Wokey принимает обе схемы аутентификации, поэтому менять эту настройку не нужно. Вставьте ключ заново.

invalid x-api-key: запрос ушёл в Anthropic, значит, сторонняя конфигурация не действует. Обычно не была нажата Save & Restart или после этого на экране входа был выбран вход через Anthropic. Смотрите руководство по ошибке invalid x-api-key.

Подробнее: выгрузите отчёт через Help → Troubleshooting → Generate Diagnostic Report. В нём полезны три файла:

• managed-config.txt: действующая конфигурация.
• provider-status.txt: состояние подключения к шлюзу.
• deployment-mode.txt: текущий режим.

Логи находятся здесь:

• macOS: ~/Library/Logs/Claude-3p/main.log
• Windows: %LOCALAPPDATA%\Claude-3p\Logs\main.log

Функции, недоступные в стороннем режиме

Эти функции зависят от аккаунта Anthropic или облачных сервисов Anthropic, поэтому при работе через шлюз они недоступны. Это не проблема конфигурации:

• Доступ с мобильных устройств и через веб-версию claude.ai
• Голосовой режим
• Общий доступ к проектам и плагинам
• Claude Design, Claude Security и Claude Tag
• Computer use
• Remote Control и облачные среды, размещённые Anthropic

Ещё две функции по умолчанию выключены:

• Поиск инструментов и экспериментальные бета-функции. Приложение отключает их ради совместимости со строгими шлюзами. Поиск инструментов можно снова включить через toolSearchEnabled.
• Удалённые SSH-сессии. В стороннем режиме они находятся в бета-версии, и для них администратор должен настроить список разрешённых хостов.

Возврат к аккаунту Anthropic

Выберите на экране входа вход через Anthropic, чтобы вернуться к стандартному десктопному приложению Claude.