> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Використання Claude Desktop з CometAPI

> Скористайтеся цим посібником, щоб налаштувати Claude Desktop з CometAPI, указавши base URL, API key, а також model або параметри provider.

Скористайтеся цим посібником, щоб підключити Claude Desktop Cowork на сторонньому inference до CometAPI. Ця конфігурація дає змогу Claude Desktop надсилати запити Claude Messages API до CometAPI із Cowork, Projects і підтримуваних desktop-робочих процесів.

Офіційні довідкові матеріали:

* [Встановлення та налаштування Claude Desktop](https://claude.com/docs/cowork/3p/installation)
* [Налаштування gateway у Claude Desktop](https://claude.com/docs/cowork/3p/gateway)
* [Довідник із конфігурації Claude Desktop](https://claude.com/docs/cowork/3p/configuration)

<Note>
  Для стороннього inference у Claude Desktop потрібен сумісний з Anthropic gateway. CometAPI підтримує моделі Claude через [Anthropic Messages API](/api/text/anthropic-messages).
</Note>

<Warning>
  Вміст, який ви надсилаєте з Claude Desktop, обробляється CometAPI і вибраним provider моделі. Не надсилайте конфіденційні дані, якщо ваша організація не дозволяє такий робочий процес.
</Warning>

## Передумови

* Claude Desktop, встановлений із [claude.com/download](https://claude.com/download)
* Збірка Claude Desktop, яка містить **Developer mode** і **Configure third-party inference**
* Обліковий запис CometAPI з активним API key
* Доступ до моделей Claude у CometAPI
* Мережевий шлях із доступом до `https://api.cometapi.com`

Почніть з екрана входу в Claude Desktop. Якщо ви вже ввійшли за допомогою облікового запису Anthropic, вийдіть із нього перед налаштуванням стороннього inference.

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

<Steps>
  <Step title="Увімкніть режим розробника">
    Відкрийте Claude Desktop і залишайтеся на екрані входу. У меню застосунку відкрийте **Help** → **Troubleshooting**, а потім виберіть **Enable Developer Mode**.

    У Windows до меню може бути важко дістатися до входу. Переведіть фокус на поле email, натискайте `Tab`, доки фокус не перейде на меню, а потім натисніть `Enter`.
  </Step>

  <Step title="Відкрийте налаштування стороннього inference">
    Після ввімкнення режиму розробника відкрийте **Developer** → **Configure third-party inference**.

    Вікно конфігурації відкриється з кількома розділами на лівій бічній панелі. Для налаштувань CometAPI використовуйте розділ **Connection**.
  </Step>

  <Step title="Налаштуйте gateway">
    У розділі **Connection** введіть наведені нижче значення CometAPI:

    | Field                 | Value                                           |
    | --------------------- | ----------------------------------------------- |
    | 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 | Залиште порожнім                                |

    Залиште base URL точно таким, як показано. Claude Desktop вимагає base URL з HTTPS.

    На наведеному нижче знімку екрана показано розділ Connection, заповнений значеннями CometAPI.

    <img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-connection.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=879de5e2a4587861f220a7f6e0f7d2a5" alt="Налаштування Connection у Claude Desktop із заповненими gateway base URL CometAPI, полем API key і схемою авторизації bearer" width="1800" height="1440" data-path="images/integrations/claude-desktop-cometapi-connection.png" />
  </Step>

  <Step title="Додайте model ID">
    У **Model list** вручну додайте такі model ID:

    | Model ID                    | Recommended use                        |
    | --------------------------- | -------------------------------------- |
    | `claude-opus-4-7`           | Складне планування та агентні завдання |
    | `claude-sonnet-4-6`         | Загальне використання на комп’ютері    |
    | `claude-haiku-4-5-20251001` | Легкі Prompt і швидкі чернетки         |

    Перша модель у списку стає моделлю за замовчуванням. Поставте `claude-sonnet-4-6` першою, якщо хочете мати універсальну модель за замовчуванням.

    <Tip>
      Доступність моделей може змінюватися. Якщо модель не з’являється в Claude Desktop після налаштування, перевірте доступ на [сторінці Models CometAPI](/uk/overview/models).
    </Tip>

    На наведеному нижче знімку екрана показано список моделей із трьома model ID Claude, налаштованими для CometAPI.

    <img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-model-list.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=63dcdfe05db59c09782e1514e09a734d" alt="Список моделей у Claude Desktop, що показує claude-opus-4-7, claude-sonnet-4-6 і claude-haiku-4-5-20251001 для CometAPI" width="1764" height="1278" data-path="images/integrations/claude-desktop-cometapi-model-list.png" />
  </Step>

  <Step title="Застосуйте конфігурацію локально">
    Натисніть **Apply locally**. Claude Desktop записує вибрану конфігурацію до локального профілю користувача та перезапускає застосунок.

    Якщо застосунок не перезапуститься, повністю закрийте Claude Desktop і відкрийте його знову.
  </Step>

  <Step title="Почніть сесію Cowork">
    На екрані входу виберіть опцію Cowork on third-party inference. Відкрийте Cowork або Projects, виберіть одну з налаштованих моделей Claude і надішліть короткий тестовий Prompt.

    Успішна відповідь підтверджує, що Claude Desktop використовує CometAPI для викликів моделей.
  </Step>
</Steps>

## Перевірте конфігурацію

Використайте короткий Prompt, який не потребує зовнішніх інструментів:

```text theme={null}
Reply with one sentence: Claude Desktop is connected through CometAPI.
```

Якщо Claude Desktop повертає відповідь, тоді base URL, API key і список моделей налаштовані правильно.

На наведеному нижче знімку екрана показано успішну відповідь Cowork через CometAPI.

<img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-chat.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=93bb3b1a60de0d7edbd25cb6ba3b58d8" alt="Відповідь Cowork у Claude Desktop з використанням CometAPI після налаштування стороннього inference" width="2880" height="1600" data-path="images/integrations/claude-desktop-cometapi-chat.png" />

Щоб перевірити виявлені налаштування, відкрийте **Help** → **Troubleshooting** → **Copy Managed Configuration Report**. Секретні значення в скопійованому звіті замасковані.

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

<AccordionGroup>
  <Accordion title="Меню розробника не з’являється">
    Переконайтеся, що ви вибрали **Help** → **Troubleshooting** → **Enable Developer Mode**. Потім повністю закрийте Claude Desktop і знову відкрийте його.

    Якщо цей параметр відсутній, установіть збірку Claude Desktop, яка включає конфігурацію стороннього inference.
  </Accordion>

  <Accordion title="Claude Desktop відкриває стандартний процес входу">
    Перевірте такі пункти:

    * **Inference provider** встановлено на **Gateway**.
    * **Gateway base URL** має значення `https://api.cometapi.com`.
    * **Gateway API key** містить ваш API key CometAPI без зайвих пробілів.
    * Ви натиснули **Apply locally** і повністю перезапустили Claude Desktop.
  </Accordion>

  <Accordion title="Перевірка з’єднання не проходить">
    Переконайтеся, що base URL починається з `https://`. Claude Desktop не приймає gateway URL із простим HTTP.

    Також переконайтеся, що ваш обліковий запис CometAPI має доступ до моделей Claude, а API key не було видалено або вимкнено.
  </Accordion>

  <Accordion title="Налаштовані моделі не з’являються">
    Знову відкрийте **Developer** → **Configure third-party inference** і перевірте записи **Model list**. model ID мають точно відповідати ID, які надає CometAPI.

    Додавайте кожен model ID як окремий запис. Не вказуйте лапки, коми чи зайві пробіли в полях інтерфейсу.
  </Accordion>

  <Accordion title="OpenAI-сумісний base URL не працює">
    Для цього сценарію сторонній inference у Claude Desktop очікує gateway, сумісний з Anthropic. Використовуйте `https://api.cometapi.com` і model ID Claude, наведені вище.
  </Accordion>

  <Accordion title="Вкладка Code поводиться інакше">
    Вкладка Code використовує рушій Claude Code всередині Claude Desktop. Деякі налаштування desktop можуть не застосовуватися до сеансів Code так само, як вони застосовуються до Cowork.

    Для окремого використання в терміналі див. [посібник з інтеграції Claude Code](/uk/integrations/claude-code).
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#howto",
        "name": "Використання Claude Desktop з CometAPI",
        "description": "Скористайтеся цим посібником, щоб налаштувати Claude Desktop з CometAPI, задавши base URL, API key та параметри моделі або провайдера.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-1",
            "position": 1,
            "name": "Увімкніть режим розробника",
            "text": "Виконайте крок Увімкніть режим розробника в посібнику Використання Claude Desktop з CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-2",
            "position": 2,
            "name": "Відкрийте налаштування стороннього inference",
            "text": "Виконайте крок Відкрийте налаштування стороннього inference в посібнику Використання Claude Desktop з CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-3",
            "position": 3,
            "name": "Налаштуйте gateway",
            "text": "Виконайте крок Налаштуйте gateway в посібнику Використання Claude Desktop з CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-4",
            "position": 4,
            "name": "Додайте model ID",
            "text": "Виконайте крок Додайте model ID в посібнику Використання Claude Desktop з CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-5",
            "position": 5,
            "name": "Застосуйте конфігурацію локально",
            "text": "Виконайте крок Застосуйте конфігурацію локально в посібнику Використання Claude Desktop з CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-6",
            "position": 6,
            "name": "Запустіть сеанс Cowork",
            "text": "Виконайте крок Запустіть сеанс Cowork в посібнику Використання Claude Desktop з CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Документація CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Інтеграції",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Використання Claude Desktop з CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/claude-desktop"
          }
        ]
      }
    ]
    }
    `}
</script>