Conecte o Cherry Studio ao Claude

O Cherry Studio é um cliente de desktop organizado para conversar com vários modelos e se comunica diretamente no formato nativo da Anthropic. Adicionar o gateway da AI Prime Tech como um provedor do tipo Anthropic permite usar Claude na mesma janela que todos os outros modelos que você utiliza, com um único host e uma única chave.

Abra Serviços de modelos

Acesse Configurações e abra Serviços de modelos. É nessa seção que o Cherry Studio lista todos os provedores com os quais pode se comunicar e onde você adiciona novos. Pressione o botão de adição para adicionar um provedor; em seguida, será solicitado o tipo dele.

A escolha do tipo é importante porque define o formato de comunicação. Para Claude no gateway, escolha o tipo Anthropic, que usa a interface nativa /v1/messages em vez de um endpoint no estilo OpenAI.

Como o Cherry Studio mantém os provedores em uma lista, o gateway fica ao lado dos outros serviços que você configurou, e você alterna entre eles a cada conversa. Isso o torna uma opção prática para um gateway multimodelo: uma única entrada de provedor pode incluir vários modelos Claude, que você escolhe no menu conforme necessário. Tratar o gateway como uma entrada entre várias é o que torna o Cherry Studio um painel multimodelo prático. Você alterna entre provedores a cada conversa sem sair do aplicativo.

Escolha o tipo Anthropic

Selecione Anthropic como tipo de provedor e ative-o. O Cherry Studio então exibe dois campos que determinam tudo: Chave da API e Host da API. Cole sua chave do gateway no campo da chave.

Como o tipo é Anthropic nativo, o Cherry Studio enviará solicitações no formato Messages que o gateway disponibiliza para Claude. Depois de definir o tipo, não há uma opção separada de protocolo com que se preocupar.

Se o seu gateway também expõe uma interface compatível com OpenAI para outros modelos, adicione-os como um provedor separado do tipo OpenAI, em vez de misturá-los neste. Manter a entrada do tipo Anthropic dedicada ao Claude torna o formato de comunicação inequívoco e evita confusão entre protocolos. Manter os protocolos em entradas de provedor separadas é um pequeno cuidado que evita muita confusão mais tarde. Cada entrada passa a ter exatamente um formato de comunicação a considerar.

Defina corretamente o Host da API

O Host da API é o campo que as pessoas mais costumam preencher incorretamente. Insira apenas a raiz do host, sem /v1 no final, porque o próprio Cherry Studio acrescenta o caminho da versão. Adicionar /v1 manualmente duplica o caminho e faz a solicitação falhar.

Portanto, o valor é apenas o host do gateway. Se você encontrou erros 404 ou de caminho depois de adicionar um provedor, um /v1 indevido no Host da API é quase sempre a causa.

Uma barra no final do host causa o mesmo tipo de falha, portanto insira somente o host, sem nada depois dele. Quando uma solicitação falha, o diagnóstico mais rápido é conferir o campo Host da API e remover tudo que estiver além do nome do host antes de procurar em outro lugar. Quando algo falha, conferir primeiro esse campo resolve a maioria dos problemas de configuração na hora. O objetivo é ter apenas o host, sem sufixo.

O bloqueio com cerquilha no final

O Cherry Studio oferece um pequeno, mas importante truque: termine o Host da API com # e o cliente usará essa URL exata, sem acrescentar nada. É assim que você força um endpoint preciso quando o acréscimo automático atrapalha.

Para um gateway padrão, normalmente você deixa apenas o host e permite que o Cherry Studio acrescente o caminho. Use # somente quando seu gateway precisar de um caminho exato que o acréscimo automático acabaria alterando incorretamente.

Vale a pena lembrar do # justamente porque ele não é óbvio — é a saída para qualquer gateway cujo caminho não corresponda à suposição padrão do Cherry Studio. Se você descobrir que o /v1/messages acrescentado automaticamente não corresponde ao que seu gateway espera, o # permite especificar a URL completa manualmente. Guardar esse truque com # agora significa que você reconhecerá a solução imediatamente se algum caminho ficar incorreto. É a opção de substituição que atende a qualquer caminho de gateway fora do padrão.

Escolha um modelo e converse

Adicione os modelos Claude desejados ao provedor, usando os IDs que o gateway disponibiliza, como claude-sonnet-4-5 para conversas cotidianas e claude-opus-4-8 para raciocínios mais difíceis. Eles aparecerão no menu de modelos do Cherry Studio.

Inicie uma conversa, escolha um modelo Claude no menu e você estará se comunicando com o gateway. Como o provedor é Anthropic nativo, os recursos que dependem do formato Messages funcionam como esperado.

Você pode manter várias conversas abertas com diferentes modelos Claude ao mesmo tempo, o que é útil para comparar como Sonnet e Opus lidam com o mesmo prompt. Como todos passam pelo mesmo provedor do gateway, trocar de modelo é uma escolha no menu, em vez de uma reconfiguração. Comparar modelos lado a lado é um dos pequenos prazeres de usar tudo por meio de um único provedor. Basta uma troca no menu para usar o mesmo prompt com Sonnet e Opus.

# Cherry Studio -> Settings -> Model Services -> + Add
# Provider type: Anthropic   (native /v1/messages)
# API Key:  <your gateway key>
# API Host: https://aiprimetech.io        (root only, NO /v1 -- it auto-appends)
#   end with #  ->  https://aiprimetech.io#   to lock the exact URL
# Model: claude-sonnet-4-5

Perguntas frequentes

AI Prime Tech é um gateway de API independente. Não tem afiliação com a Anthropic, não é endossado por ela e não é seu revendedor. Claude e os nomes dos modelos relacionados são marcas comerciais de seus respectivos proprietários.