> ## 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, указав базовый URL, API key, а также параметры model или provider.

Используйте это руководство, чтобы подключить Claude Desktop Cowork on third-party 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>
  Для third-party inference в Claude Desktop требуется Anthropic-compatible 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, выйдите из неё перед настройкой third-party 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:

    | Поле                  | Значение                                        |
    | --------------------- | ----------------------------------------------- |
    | Inference provider    | Gateway                                         |
    | Gateway               | Anthropic-compatible                            |
    | Gateway base URL      | `https://api.cometapi.com`                      |
    | Gateway API key       | Ваш API-ключ 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                    | Рекомендуемое использование            |
    | --------------------------- | -------------------------------------- |
    | `claude-opus-4-7`           | Сложное планирование и задачи агентов  |
    | `claude-sonnet-4-6`         | Общее использование на компьютере      |
    | `claude-haiku-4-5-20251001` | Легковесные Prompt и быстрые черновики |

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

    <Tip>
      Доступность моделей может меняться. Если модель не отображается в Claude Desktop после настройки, проверьте доступ на странице [CometAPI Models page](/ru/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 с model ID 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-ключ CometAPI без лишних пробелов.
    * Вы нажали **Apply locally** и полностью перезапустили Claude Desktop.
  </Accordion>

  <Accordion title="Проверка подключения завершается ошибкой">
    Убедитесь, что base URL начинается с `https://`. Claude Desktop не принимает URL gateway с обычным HTTP.

    Также убедитесь, что у вашей учетной записи CometAPI есть доступ к моделям Claude и что API-ключ не был удален или отключен.
  </Accordion>

  <Accordion title="Настроенные модели не появляются">
    Снова откройте **Developer** → **Configure third-party inference** и проверьте записи в **Model list**. Model IDs должны совпадать с ID, которые предоставляет CometAPI.

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

  <Accordion title="OpenAI-compatible base URL не работает">
    Сторонний inference в Claude Desktop для этого сценария ожидает Anthropic-compatible gateway. Используйте `https://api.cometapi.com` и model IDs Claude, перечисленные выше.
  </Accordion>

  <Accordion title="Вкладка Code ведет себя иначе">
    Вкладка Code использует движок Claude Code внутри Claude Desktop. Некоторые настройки приложения могут применяться к сеансам Code не так, как они применяются к Cowork.

    Для отдельного использования в терминале см. [руководство по интеграции Claude Code](/ru/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-ключ и параметры модели или провайдера.",
        "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 IDs",
            "text": "Выполните шаг «Добавьте model IDs» в руководстве «Использование 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>