- Установка и настройка Claude Desktop
- Настройка gateway в Claude Desktop
- Справочник по конфигурации Claude Desktop
Сторонний Inference в Claude Desktop требует Anthropic-compatible gateway. CometAPI поддерживает модели Claude через Anthropic Messages API.
Предварительные требования
- Claude Desktop, установленный с claude.com/download
- Сборка Claude Desktop, включающая Developer mode и Configure third-party inference
- Учетная запись CometAPI с активным API key
- Доступ к моделям Claude в CometAPI
- Сетевой маршрут с доступом к
https://api.cometapi.com
Конфигурация
Включите режим разработчика
Откройте Claude Desktop и оставайтесь на экране входа. В меню приложения откройте Help → Troubleshooting, затем выберите Enable Developer Mode.В Windows до входа в систему добраться до меню может быть сложно. Выделите поле email, нажимайте
Tab, пока фокус не перейдет на меню, затем нажмите Enter.Откройте настройки стороннего Inference
После включения режима разработчика откройте Developer → Configure third-party inference.Откроется окно конфигурации с несколькими разделами на левой боковой панели. Для настроек CometAPI используйте раздел Connection.
Настройте gateway
В разделе Connection введите значения CometAPI ниже:
Оставьте base URL точно в таком виде, как показано. Claude Desktop требует base URL с HTTPS.Следующий снимок экрана показывает раздел Connection, заполненный значениями CometAPI.
| Поле | Значение |
|---|---|
| Inference provider | Gateway |
| Gateway | Anthropic-compatible |
| Gateway base URL | https://api.cometapi.com |
| Gateway API key | Ваш API key CometAPI, например <COMETAPI_KEY> |
| Gateway auth scheme | Bearer |
| Gateway extra headers | Оставьте пустым |

Добавьте model ID
В Model list вручную добавьте следующие model ID:
Первая модель в списке становится моделью по умолчанию. Поместите 
| Model ID | Рекомендуемое использование |
|---|---|
claude-opus-4-7 | Сложное планирование и задачи агентов |
claude-sonnet-4-6 | Общее использование в desktop |
claude-haiku-4-5-20251001 | Легковесные Prompt и быстрые черновики |
claude-sonnet-4-6 первым, если хотите использовать универсальную модель по умолчанию.Следующий снимок экрана показывает список моделей с тремя model ID Claude, настроенными для CometAPI.
Примените конфигурацию локально
Нажмите Apply locally. Claude Desktop записывает выбранную конфигурацию в локальный профиль пользователя и перезапускает приложение.Если приложение не перезапускается, полностью закройте Claude Desktop и откройте его снова.
Проверьте конфигурацию
Используйте короткий Prompt, который не требует внешних инструментов:
Устранение неполадок
Меню Developer не появляется
Меню Developer не появляется
Убедитесь, что вы выбрали Help → Troubleshooting → Enable Developer Mode. Затем полностью закройте Claude Desktop и откройте его снова.Если этот параметр отсутствует, установите сборку Claude Desktop, которая включает настройку стороннего Inference.
Claude Desktop открывает стандартный сценарий входа
Claude Desktop открывает стандартный сценарий входа
Проверьте следующие пункты:
- Inference provider установлен в Gateway.
- Gateway base URL —
https://api.cometapi.com. - Gateway API key содержит ваш API key CometAPI без лишних пробелов.
- Вы нажали Apply locally и полностью перезапустили Claude Desktop.
Проверка соединения завершается ошибкой
Проверка соединения завершается ошибкой
Убедитесь, что base URL начинается с
https://. Claude Desktop не принимает URL gateway с обычным HTTP.Также убедитесь, что у вашей учетной записи CometAPI есть доступ к моделям Claude и что API key не был удален или отключен.Настроенные модели не появляются
Настроенные модели не появляются
Снова откройте Developer → Configure third-party inference и проверьте записи в Model list. Model ID должны точно совпадать с ID, которые предоставляет CometAPI.Добавляйте каждый model ID как отдельную запись. Не включайте кавычки, запятые или лишние пробелы в поля интерфейса.
OpenAI-compatible base URL не работает
OpenAI-compatible base URL не работает
Сторонний Inference в Claude Desktop ожидает Anthropic-compatible gateway для этого сценария. Используйте
https://api.cometapi.com и model ID Claude, перечисленные выше.Вкладка Code ведет себя иначе
Вкладка Code ведет себя иначе
Вкладка Code использует движок Claude Code внутри Claude Desktop. Некоторые настройки desktop могут применяться к сеансам Code не так, как к Cowork.Для автономного использования в терминале см. руководство по интеграции Claude Code.