Перейти до основного вмісту
Скористайтеся цим посібником, щоб підключити Claude Desktop Cowork на сторонній inference до CometAPI. Ця конфігурація дає змогу Claude Desktop надсилати запити Claude Messages API до CometAPI з Cowork, Projects і підтримуваних desktop-сценаріїв. Офіційні посилання:
Для стороннього inference у Claude Desktop потрібен Anthropic-compatible gateway. CometAPI підтримує моделі Claude через Anthropic Messages API.
Вміст, який ви надсилаєте з Claude Desktop, обробляється CometAPI і вибраним провайдером моделі. Не надсилайте конфіденційні дані, якщо ваша організація не дозволяє такий сценарій.

Передумови

  • Claude Desktop, встановлений з claude.com/download
  • Збірка Claude Desktop, що містить Developer mode і Configure third-party inference
  • Обліковий запис CometAPI з активним API key
  • Доступ до моделей Claude у CometAPI
  • Мережевий шлях, який має доступ до https://api.cometapi.com
Почніть з екрана входу Claude Desktop. Якщо ви вже увійшли за допомогою облікового запису Anthropic, вийдіть перед тим, як налаштовувати сторонній inference.

Конфігурація

1

Увімкніть developer mode

Відкрийте Claude Desktop і залишайтеся на екрані входу. У меню застосунку відкрийте HelpTroubleshooting, потім виберіть Enable Developer Mode.У Windows до меню може бути важко дістатися до входу. Переведіть фокус на поле email, натискайте Tab, доки меню не буде у фокусі, а потім натисніть Enter.
2

Відкрийте налаштування стороннього inference

Після ввімкнення developer mode відкрийте DeveloperConfigure third-party inference.Відкриється вікно конфігурації з кількома розділами на лівій боковій панелі. Для налаштувань CometAPI використовуйте розділ Connection.
3

Налаштуйте gateway

У розділі Connection введіть наведені нижче значення CometAPI:
ПолеЗначення
Inference providerGateway
GatewayAnthropic-compatible
Gateway base URLhttps://api.cometapi.com
Gateway API keyВаш API key CometAPI, наприклад <COMETAPI_KEY>
Gateway auth schemeBearer
Gateway extra headersЗалиште порожнім
Залиште base URL точно таким, як показано. Claude Desktop вимагає base URL через HTTPS.На наведеному нижче знімку екрана показано розділ Connection, заповнений значеннями CometAPI.Налаштування Connection у Claude Desktop із заповненими gateway base URL CometAPI, полем API key і схемою auth bearer
4

Додайте 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 на перше місце, якщо хочете мати універсальну модель за замовчуванням.
Доступність моделей може змінюватися. Якщо модель не з’являється в Claude Desktop після конфігурації, перевірте доступ на сторінці Models у CometAPI.
На наведеному нижче знімку екрана показано список моделей із трьома model ID Claude, налаштованими для CometAPI.Список моделей у Claude Desktop, що показує claude-opus-4-7, claude-sonnet-4-6 і claude-haiku-4-5-20251001 для CometAPI
5

Застосуйте конфігурацію локально

Натисніть Apply locally. Claude Desktop записує вибрану конфігурацію до локального профілю користувача та перезапускає застосунок.Якщо застосунок не перезапускається, повністю закрийте Claude Desktop і відкрийте його знову.
6

Запустіть сесію Cowork

На екрані входу виберіть опцію Cowork on third-party inference. Відкрийте Cowork або Projects, виберіть одну з налаштованих моделей Claude і надішліть короткий тестовий Prompt.Успішна відповідь підтверджує, що Claude Desktop використовує CometAPI для викликів моделей.

Перевірка конфігурації

Використайте короткий Prompt, який не потребує зовнішніх інструментів:
Reply with one sentence: Claude Desktop is connected through CometAPI.
Якщо Claude Desktop повертає відповідь, тоді base URL, API key і список моделей налаштовані правильно. На наведеному нижче знімку екрана показано успішну відповідь Cowork через CometAPI. Відповідь Claude Desktop Cowork через CometAPI після налаштування стороннього inference Щоб перевірити виявлені налаштування, відкрийте HelpTroubleshootingCopy Managed Configuration Report. Секретні значення в скопійованому звіті приховано.

Усунення несправностей

Переконайтеся, що ви вибрали HelpTroubleshootingEnable Developer Mode. Потім повністю закрийте Claude Desktop і відкрийте його знову.Якщо опція відсутня, установіть збірку Claude Desktop, яка містить конфігурацію стороннього inference.
Перевірте ці пункти:
  • 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 не було видалено або вимкнено.
Знову відкрийте DeveloperConfigure third-party inference і перевірте записи в Model list. Model ID мають точно відповідати ID, які надає CometAPI.Додавайте кожен model ID як окремий запис. Не додавайте лапки, коми чи зайві пробіли в полях інтерфейсу.
Сторонній inference у Claude Desktop очікує Anthropic-compatible gateway для цього сценарію. Використовуйте https://api.cometapi.com і model ID Claude, наведені вище.
Вкладка Code використовує рушій Claude Code всередині Claude Desktop. Деякі desktop-налаштування можуть не застосовуватися до сесій Code так само, як вони застосовуються до Cowork.Для окремого використання в терміналі див. посібник з інтеграції Claude Code.