> ## 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.

# Usar Claude Desktop com CometAPI

> Use este guia para configurar o Claude Desktop com CometAPI definindo a URL base, a chave de API e as opções de model ou provider.

Use este guia para conectar o Cowork do Claude Desktop em third-party inference ao CometAPI. Essa configuração permite que o Claude Desktop envie solicitações da API Claude Messages ao CometAPI a partir do Cowork, Projects e fluxos de trabalho compatíveis no desktop.

Referências oficiais:

* [Instalação e configuração do Claude Desktop](https://claude.com/docs/cowork/3p/installation)
* [Configuração de gateway do Claude Desktop](https://claude.com/docs/cowork/3p/gateway)
* [Referência de configuração do Claude Desktop](https://claude.com/docs/cowork/3p/configuration)

<Note>
  O third-party inference do Claude Desktop requer um gateway compatível com Anthropic. O CometAPI oferece suporte a modelos Claude por meio da [Anthropic Messages API](/api/text/anthropic-messages).
</Note>

<Warning>
  O conteúdo que você envia pelo Claude Desktop é processado pelo CometAPI e pelo provider do modelo selecionado. Não envie dados confidenciais, a menos que sua organização permita esse fluxo de trabalho.
</Warning>

## Pré-requisitos

* Claude Desktop instalado a partir de [claude.com/download](https://claude.com/download)
* Uma build do Claude Desktop que inclua **Developer mode** e **Configure third-party inference**
* Uma conta CometAPI com uma chave de API ativa
* Acesso a modelos Claude no CometAPI
* Um caminho de rede com acesso a `https://api.cometapi.com`

Comece pela tela de login do Claude Desktop. Se você já entrou com uma conta Anthropic, saia antes de configurar o third-party inference.

## Configuração

<Steps>
  <Step title="Ativar o modo de desenvolvedor">
    Abra o Claude Desktop e permaneça na tela de login. No menu do aplicativo, abra **Help** → **Troubleshooting** e, em seguida, selecione **Enable Developer Mode**.

    No Windows, pode ser difícil acessar o menu antes do login. Coloque o foco no campo de e-mail, pressione `Tab` até que o menu esteja em foco e depois pressione `Enter`.
  </Step>

  <Step title="Abrir as configurações de inference de terceiros">
    Depois que o modo de desenvolvedor estiver ativado, abra **Developer** → **Configure third-party inference**.

    A janela de configuração é aberta com várias seções na barra lateral esquerda. Use a seção **Connection** para as configurações do CometAPI.
  </Step>

  <Step title="Configurar o gateway">
    Na seção **Connection**, insira os valores do CometAPI abaixo:

    | Campo                 | Valor                                              |
    | --------------------- | -------------------------------------------------- |
    | Inference provider    | Gateway                                            |
    | Gateway               | Anthropic-compatible                               |
    | Gateway base URL      | `https://api.cometapi.com`                         |
    | Gateway API key       | Sua chave de API do CometAPI, como `$COMETAPI_KEY` |
    | Gateway auth scheme   | Bearer                                             |
    | Gateway extra headers | Deixe em branco                                    |

    Mantenha a base URL exatamente como mostrada. O Claude Desktop exige uma base URL HTTPS.

    A captura de tela a seguir mostra a seção Connection preenchida com os valores do 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="Configurações de Connection do Claude Desktop com a base URL do gateway CometAPI, o campo de chave de API e o esquema de autenticação bearer preenchidos" width="1800" height="1440" data-path="images/integrations/claude-desktop-cometapi-connection.png" />
  </Step>

  <Step title="Adicionar model IDs">
    Em **Model list**, adicione estes model IDs manualmente:

    | Model ID                    | Uso recomendado                           |
    | --------------------------- | ----------------------------------------- |
    | `claude-opus-4-7`           | Planejamento complexo e tarefas de agente |
    | `claude-sonnet-4-6`         | Uso geral no desktop                      |
    | `claude-haiku-4-5-20251001` | Prompts leves e rascunhos rápidos         |

    O primeiro modelo da lista se torna o modelo padrão. Coloque `claude-sonnet-4-6` primeiro se quiser um padrão de uso geral.

    <Tip>
      A disponibilidade de modelos pode mudar. Se um modelo não aparecer no Claude Desktop após a configuração, verifique o acesso na [página de modelos do CometAPI](/pt/overview/models).
    </Tip>

    A captura de tela a seguir mostra a lista de modelos com os três model IDs do Claude configurados para o 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="Lista de modelos do Claude Desktop mostrando claude-opus-4-7, claude-sonnet-4-6 e claude-haiku-4-5-20251001 para o CometAPI" width="1764" height="1278" data-path="images/integrations/claude-desktop-cometapi-model-list.png" />
  </Step>

  <Step title="Aplicar a configuração localmente">
    Clique em **Apply locally**. O Claude Desktop grava a configuração selecionada no perfil local do usuário e reinicia o aplicativo.

    Se o aplicativo não reiniciar, feche o Claude Desktop completamente e abra-o novamente.
  </Step>

  <Step title="Iniciar uma sessão do Cowork">
    Na tela de login, escolha a opção de Cowork em third-party inference. Abra Cowork ou Projects, selecione um dos modelos Claude configurados e envie um prompt curto de teste.

    Uma resposta bem-sucedida confirma que o Claude Desktop está usando o CometAPI para chamadas de modelo.
  </Step>
</Steps>

## Verificar a configuração

Use um prompt curto que não exija ferramentas externas:

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

Se o Claude Desktop retornar uma resposta, então a base URL, a chave de API e a lista de modelos estão configuradas corretamente.

A captura de tela a seguir mostra uma resposta bem-sucedida do Cowork por meio do 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="Resposta do Cowork no Claude Desktop usando CometAPI após a configuração de third-party inference" width="2880" height="1600" data-path="images/integrations/claude-desktop-cometapi-chat.png" />

Para inspecionar as configurações detectadas, abra **Help** → **Troubleshooting** → **Copy Managed Configuration Report**. Os valores secretos são ocultados no relatório copiado.

## Solução de problemas

<AccordionGroup>
  <Accordion title="O menu do desenvolvedor não aparece">
    Confirme que você selecionou **Ajuda** → **Solução de problemas** → **Ativar modo de desenvolvedor**. Em seguida, feche o Claude Desktop completamente e abra-o novamente.

    Se a opção estiver ausente, instale uma build do Claude Desktop que inclua configuração de Inference de terceiros.
  </Accordion>

  <Accordion title="O Claude Desktop abre o fluxo padrão de login">
    Verifique estes itens:

    * **Provedor de Inference** está definido como **Gateway**.
    * **URL base do Gateway** é `https://api.cometapi.com`.
    * **Chave de API do Gateway** contém sua chave de API da CometAPI sem espaços extras.
    * Você clicou em **Aplicar localmente** e reiniciou totalmente o Claude Desktop.
  </Accordion>

  <Accordion title="A validação da conexão falha">
    Confirme que a URL base começa com `https://`. O Claude Desktop não aceita URLs de gateway em HTTP simples.

    Confirme também que sua conta da CometAPI tem acesso aos modelos Claude e que a chave de API não foi excluída nem desativada.
  </Accordion>

  <Accordion title="Os modelos configurados não aparecem">
    Reabra **Developer** → **Configure third-party inference** e verifique as entradas de **Model list**. Os model IDs devem corresponder aos IDs expostos pela CometAPI.

    Adicione cada model ID como uma entrada separada. Não inclua aspas, vírgulas ou espaços extras nos campos da interface.
  </Accordion>

  <Accordion title="Uma URL base compatível com OpenAI não funciona">
    A Inference de terceiros do Claude Desktop espera um gateway compatível com Anthropic para este fluxo. Use `https://api.cometapi.com` e os model IDs do Claude listados acima.
  </Accordion>

  <Accordion title="A aba Code se comporta de forma diferente">
    A aba Code usa o mecanismo Claude Code dentro do Claude Desktop. Algumas configurações do desktop podem não se aplicar às sessões do Code da mesma forma que se aplicam ao Cowork.

    Para uso independente no terminal, consulte o [guia de integração do Claude Code](/pt/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": "Usar o Claude Desktop com a CometAPI",
        "description": "Use este guia para configurar o Claude Desktop com a CometAPI definindo a URL base, a chave de API e as opções de modelo ou provedor.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-1",
            "position": 1,
            "name": "Ativar o modo de desenvolvedor",
            "text": "Conclua a etapa Ativar o modo de desenvolvedor no guia Usar o Claude Desktop com a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-2",
            "position": 2,
            "name": "Abrir as configurações de Inference de terceiros",
            "text": "Conclua a etapa Abrir as configurações de Inference de terceiros no guia Usar o Claude Desktop com a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-3",
            "position": 3,
            "name": "Configurar o gateway",
            "text": "Conclua a etapa Configurar o gateway no guia Usar o Claude Desktop com a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-4",
            "position": 4,
            "name": "Adicionar model IDs",
            "text": "Conclua a etapa Adicionar model IDs no guia Usar o Claude Desktop com a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-5",
            "position": 5,
            "name": "Aplicar a configuração localmente",
            "text": "Conclua a etapa Aplicar a configuração localmente no guia Usar o Claude Desktop com a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-6",
            "position": 6,
            "name": "Iniciar uma sessão Cowork",
            "text": "Conclua a etapa Iniciar uma sessão Cowork no guia Usar o Claude Desktop com a CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentação da CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrações",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Usar o Claude Desktop com a CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/claude-desktop"
          }
        ]
      }
    ]
    }
    `}
</script>