Saltar para o conteúdo principal
Use este guia para conectar o Claude Desktop Cowork em inferência de terceiros à CometAPI. Essa configuração permite que o Claude Desktop envie solicitações da API Claude Messages para a CometAPI a partir do Cowork, Projects e fluxos de trabalho compatíveis no desktop. Referências oficiais:
A inferência de terceiros no Claude Desktop exige um gateway compatível com Anthropic. A CometAPI oferece suporte a modelos Claude por meio da Anthropic Messages API.
O conteúdo que você envia pelo Claude Desktop é processado pela CometAPI e pelo provedor de modelo selecionado. Não envie dados confidenciais, a menos que sua organização permita esse fluxo de trabalho.

​
Pré-requisitos

  • Claude Desktop instalado a partir de claude.com/download
  • Uma build do Claude Desktop que inclua Developer mode e Configure third-party inference
  • Uma conta da CometAPI com uma chave de API ativa
  • Acesso aos modelos Claude na CometAPI
  • Um caminho de rede que consiga alcançar https://api.cometapi.com
Comece pela tela de login do Claude Desktop. Se você já entrou com uma conta Anthropic, saia antes de configurar a inferência de terceiros.

​
Configuração

1

Ativar o modo desenvolvedor

Abra o Claude Desktop e permaneça na tela de login. No menu do aplicativo, abra Help → Troubleshooting e depois selecione Enable Developer Mode.No Windows, pode ser difícil acessar o menu antes do login. Foque no campo de email, pressione Tab até o menu receber foco e, em seguida, pressione Enter.
2

Abrir as configurações de inferência de terceiros

Depois que o modo 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 da CometAPI.
3

Configurar o gateway

Na seção Connection, insira os valores da CometAPI abaixo:
CampoValor
Provedor de inferênciaGateway
GatewayCompatível com Anthropic
URL base do gatewayhttps://api.cometapi.com
Chave de API do gatewaySua chave de API da CometAPI, como <COMETAPI_KEY>
Esquema de autenticação do gatewayBearer
Cabeçalhos extras do gatewayDeixe em branco
Mantenha a URL base exatamente como mostrado. O Claude Desktop exige uma URL base HTTPS.A captura de tela a seguir mostra a seção Connection preenchida com os valores da CometAPI.Configurações de Connection do Claude Desktop com a URL base do gateway da CometAPI, o campo de chave de API e o esquema de autenticação bearer preenchidos
4

Adicionar model IDs

Em Model list, adicione estes model IDs manualmente:
Model IDUso recomendado
claude-opus-4-7Planejamento complexo e tarefas de agente
claude-sonnet-4-6Uso geral no desktop
claude-haiku-4-5-20251001Prompts 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.
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 Models da CometAPI.
A captura de tela a seguir mostra a lista de modelos com os três model IDs do Claude configurados para a CometAPI.Lista de modelos do Claude Desktop mostrando claude-opus-4-7, claude-sonnet-4-6 e claude-haiku-4-5-20251001 para a CometAPI
5

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

Iniciar uma sessão do Cowork

Na tela de login, escolha a opção de Cowork em inferência de terceiros. Abra o Cowork ou Projects, selecione um dos modelos Claude configurados e envie um prompt de teste curto.Uma resposta bem-sucedida confirma que o Claude Desktop está usando a CometAPI para chamadas de modelo.

​
Verificar a configuração

Use um prompt curto que não exija ferramentas externas: 
Reply with one sentence: Claude Desktop is connected through CometAPI.
Se o Claude Desktop retornar uma resposta, então a URL base, 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 da CometAPI. Resposta do Cowork no Claude Desktop usando a CometAPI após a configuração da inferência de terceiros Para inspecionar as configurações detectadas, abra Help → Troubleshooting → Copy Managed Configuration Report. Valores secretos são ocultados no relatório copiado.

​
Solução de problemas

Confirme que você selecionou Help → Troubleshooting → Enable Developer Mode. Depois, feche o Claude Desktop completamente e abra-o novamente.Se a opção estiver ausente, instale uma build do Claude Desktop que inclua a configuração de inferência de terceiros.
Verifique estes itens:
  • Inference provider está definido como Gateway.
  • Gateway base URL é https://api.cometapi.com.
  • Gateway API key contém sua chave de API da CometAPI sem espaços extras.
  • Você clicou em Apply locally e reiniciou totalmente o Claude Desktop.
Confirme que a URL base começa com https://. O Claude Desktop não aceita URLs de gateway 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.
Abra novamente Developer → Configure third-party inference e verifique as entradas em 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 nem espaços extras nos campos da interface.
A inferência de terceiros no Claude Desktop espera um gateway compatível com Anthropic para esse fluxo. Use https://api.cometapi.com e os model IDs do Claude listados acima.
A aba Code usa o mecanismo Claude Code dentro do Claude Desktop. Algumas configurações do desktop podem não se aplicar a 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.