Source: https://aiprimetech.io/pt/learn/use-claude-api-with-cherry-studio/ [Início](/pt/) / [Aprenda](/pt/learn/) / Conecte o Cherry Studio ao Claude # 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. Copiar ``` # Cherry Studio -> Settings -> Model Services -> + Add # Provider type: Anthropic (native /v1/messages) # API 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 Como adiciono Claude ao Cherry Studio? Configurações, Serviços de modelos, Adicionar, escolha o tipo Anthropic, cole sua chave e defina o Host da API como https://aiprimetech.io (raiz, sem /v1). O Host da API deve incluir /v1? Não. Use a raiz do host; o próprio Cherry Studio acrescenta o caminho da versão. Adicionar /v1 manualmente duplica o caminho e causa uma falha. O que faz o # no final? Ele fixa a URL exata — o Cherry Studio usa o host como está e não acrescenta nada. Use-o somente quando precisar de um caminho preciso. Qual tipo de provedor usar para Claude? Anthropic. Ele usa a interface nativa /v1/messages que o gateway disponibiliza para Claude. Comece a usar o Claude em minutos Obtenha uma chave de API — sem precisar de conta na Anthropic nem de lista de espera.[Obtenha sua chave de API](/register) 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. ## Mais guias da API do Claude [Como obter uma chave de API do Claude](/pt/learn/how-to-get-a-claude-api-key/)[Preços da API Claude explicados](/pt/learn/claude-api-pricing-explained/)[A maneira mais barata de usar a API do Claude](/pt/learn/cheapest-way-to-use-claude-api/)[Cursor ilimitado com a API do Claude](/learn/use-claude-api-with-cursor/)[Acesso ilimitado ao Claude Code](/pt/learn/use-claude-api-with-claude-code/)[Gateway da API do Claude vs. acesso direto à Anthropic](/pt/learn/claude-api-vs-anthropic-direct/)[Como usar Claude por meio de uma API compatível com OpenAI](/pt/learn/openai-compatible-claude-api/)[Modelos Claude explicados: uma comparação entre Claude Opus, Sonnet, Haiku e Fable — todos os modelos da API Claude, nomes e preços dos modelos Anthropic (2026)](/pt/learn/claude-api-models-compared/)[Pagamento da API do Claude com criptomoedas](/pt/learn/claude-api-with-crypto-payment/)[Acesso à API do Claude sem lista de espera](/pt/learn/claude-api-without-waitlist/)[Como reduzir o uso de tokens do Claude](/pt/learn/how-to-reduce-claude-token-usage/)[Cline ilimitado com a API do Claude](/pt/learn/use-claude-api-with-cline/)[Roo Code ilimitado com a API do Claude](/pt/learn/use-claude-api-with-roo-code/)[Claude ilimitado nas IDEs da JetBrains](/pt/learn/use-claude-api-with-jetbrains/)[Aider ilimitado com a API do Claude](/pt/learn/use-claude-api-with-aider/)[Claude ilimitado no VS Code](/pt/learn/use-claude-api-with-vscode/)[Configuração do OpenCode para Claude: configuração do opencode.json, modelos e erros comuns](/pt/learn/use-claude-api-with-opencode/)[Como executar um agente Hermes ilimitado no Claude](/pt/learn/run-hermes-agent-with-claude-api/)[Executando OpenClaw ilimitado com Claude](/pt/learn/run-openclaw-with-claude-api/)[O que significa uma API compatível com a Anthropic](/pt/learn/anthropic-compatible-api/)[Chave de API do Claude Code — ANTHROPIC_API_KEY: como obtê-la, configurá-la e quando usar claude setup-token em seu lugar](/pt/learn/claude-code-api-key-setup/)[Custos da API do Claude Code — Preços e como reduzi-los](/pt/learn/claude-code-api-costs/)[Erros da API Claude explicados: erro de servidor 500, sobrecarga 529, limite de requisições 429, requisição inválida 400 — e a correção para cada um](/pt/learn/claude-api-errors-troubleshooting/)[Como comprar créditos da API do Claude — e por que um crédito do Claude é melhor do que qualquer oferta de "comprar conta do Claude"](/pt/learn/buy-claude-api-credits/)[API Claude gratuita: existe uma chave de API Claude gratuita e o que realmente é gratuito em 2026?](/pt/learn/claude-api-free-trial/)[API do Claude vs assinatura Claude Pro/Max — Qual escolher](/pt/learn/claude-api-vs-subscription/)[Como executar a CLI do Codex no Claude](/pt/learn/use-claude-api-with-codex/)[Conectando Claude ao n8n](/pt/learn/use-claude-api-with-n8n/)[Roteando LiteLLM para Claude](/pt/learn/use-claude-api-with-litellm/)[Usando Claude no Kilo Code](/pt/learn/use-claude-api-with-kilo-code/)[Integre Claude ao GitHub Copilot](/pt/learn/use-claude-api-with-github-copilot/)[Conecte o Zed ao Claude por meio do gateway](/pt/learn/use-claude-api-with-zed/)[ChatAnthropic no LangChain: importação, base_url, streaming, ferramentas e erros](/pt/learn/use-claude-api-with-langchain/)[SDK de Python da Anthropic: instale, defina base_url, use streaming e trate erros](/pt/learn/anthropic-python-sdk/)[Claude com o Vercel AI SDK: baseURL de createAnthropic, streaming e correções](/pt/learn/use-claude-api-with-vercel-ai-sdk/)[Execute o Factory Droid com o Claude](/pt/learn/use-claude-api-with-factory-droid/)[A API do Claude Code, explicada](/pt/learn/claude-code-api/)[Como integrar a API do Claude à sua aplicação](/pt/learn/claude-api-integration/)[Como obter uso ilimitado do Claude — e por que não existe "Claude Code crackeado"](/pt/learn/get-unlimited-claude-usage/)