- Встановлення та налаштування 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
Конфігурація
Увімкніть developer mode
Відкрийте Claude Desktop і залишайтеся на екрані входу. У меню застосунку відкрийте Help → Troubleshooting, потім виберіть Enable Developer Mode.У Windows до меню може бути важко дістатися до входу. Переведіть фокус на поле email, натискайте
Tab, доки меню не буде у фокусі, а потім натисніть Enter.Відкрийте налаштування стороннього inference
Після ввімкнення developer mode відкрийте 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.