Tema
Idioma

Claude Desktop (Chat, Cowork, Code)

Conecte o aplicativo oficial Claude Desktop ao GetVibe API por meio de Third-Party Inference: Developer Mode, URL base do Gateway e uma chave sk-pv- usando o esquema x-api-key. Use Chat, Cowork e Code sem uma conta Anthropic.

O caminho mais simples, especialmente sem terminal. Um aplicativo, poucos passos e a sua chave. Se algo não funcionar, veja «Problemas comuns» abaixo; a variante de terminal está na página Claude Code CLI.
Se vires «App unavailable in region», estás na aplicação, não no site. O menu Help → Troubleshooting está dentro do Claude Desktop — a barra de menus do macOS ou o botão ☰ no canto superior esquerdo do ecrã de início de sessão do Windows. Não entres numa conta Anthropic: ativa o Developer Mode e configura o gateway como abaixo. Se a tua versão não mostrar esse menu, usa a Claude Code CLI.

A aplicação oficial Claude Desktop (macOS e Windows) pode funcionar através de um gateway de terceiros — a funcionalidade Third-Party Inference. O GetVibe API fala o formato nativo da Anthropic (/v1/messages com o cabeçalho x-api-key), por isso a aplicação liga-se diretamente, sem proxy tradutor. Os três separadores funcionam: Chat, Cowork e Code. Não é necessária uma conta Anthropic — não entres. A documentação da Anthropic diz que a aplicação deteta o modo de terceiros (3P) no arranque a partir do fornecedor configurado; quando o fornecedor e as credenciais estão presentes, o ecrã de início de sessão oferece o arranque de terceiros sem conta Anthropic, e a documentação não descreve uma verificação de região no modo 3P. Consulta a visão geral de 3P e o guia de instalação.

Para quem é

  • Windows 10/11 ou macOS. Não há mais nada para instalar — nem Node.js, nem terminal.
  • Você só precisa da sua chave sk-pv-… em Painel → Chaves de API.

1. Instalar o aplicativo

Baixe o Claude Desktop no site oficial, instale-o e abra-o. Na tela de login, não faça login em uma conta da Anthropic.

Se o Windows disser “Este aplicativo não pode ser executado em seu PC”, o instalador não corresponde ao seu processador ou o download foi interrompido. Confira Configurações → Sistema → Sobre → Tipo de sistema (x64 ou ARM64), baixe novamente o instalador para essa arquitetura e execute-o.

2. Ativar o Modo de Desenvolvedor

No menu da própria aplicação (barra de menus do macOS; no Windows ☰ no canto superior esquerdo do ecrã de início de sessão) abre Help → Troubleshooting → Enable Developer Mode. Aparece um item Developer no menu.

3. Configurar o gateway GetVibe API

  1. No novo menu Developer, escolha Configure Third-Party Inference….
  2. Em Connection, altere o tipo para Gateway.
  3. URL base do gateway: https://getvibeapi.com — sem /v1, o aplicativo acrescenta /v1/messages por conta própria.
  4. Tipo de credencial: Chave de API estática; esquema de autenticação: x-api-key.
  5. Chave de API do gateway: sua chave sk-pv-… de Dashboard → API keys.
  6. Na aba Modelos, adicione os modelos manualmente antes de testar a conexão: claude-sonnet-5.5, claude-opus-5.5, claude-haiku-5.5. O teste de conexão não passa sem pelo menos um modelo, e nem todas as versões do aplicativo preenchem a lista a partir de /v1/models automaticamente.

4. Reinicie o aplicativo por completo

Clica em Apply Changes, fecha completamente a aplicação (Quit no menu, não apenas fechar a janela) e abre-a novamente. No ecrã de início de sessão, escolhe o arranque de terceiros que aparece depois de guardares a configuração; não entres no Anthropic. Se a configuração definir deploymentMode: "3p" (Claude Desktop 4.16336.0+), a opção de início de sessão da claude.ai fica oculta.

5. Verifique a conexão

Envie qualquer mensagem e abra Painel → Uso: deve aparecer um registro novo com o modelo e o gasto. Se não aparecer, veja «Problemas comuns» abaixo — não é preciso terminal para verificar.

Limitações

  • O Cowork no Windows requer o instalador .msix e a virtualização de hardware habilitada (um requisito do aplicativo).
  • A Anthropic desativa alguns recursos beta (por exemplo, pesquisa de ferramentas) para gateways de terceiros — isso é uma limitação do aplicativo, não um problema com sua chave.

Problemas comuns

ParâmetroTipoDescrição
App unavailable in regionscreenEste é o primeiro ecrã de início de sessão da aplicação, não o nosso gateway. O menu Help/☰ está na aplicação, não no site. Configura o Gateway; se o menu não existir, usa a CLI.
401errorVerifique a chave e se o esquema de autenticação é x-api-key, não Bearer.
404errorO endereço do gateway não deve conter /v1 — use o endereço raiz mostrado acima.
Models did not appear / “The connection test needs at least one model”configAdicione os ids manualmente na aba Models: claude-sonnet-5.5, claude-opus-5.5, claude-haiku-5.5.
“Couldn’t load your organization’s model list”, “Gateway /v1/models was unreachable”, “Can’t reach … provider didn’t respond”networkThe request never reached us — Usage shows no new record. On the same computer open https://getvibeapi.com/v1/models in a browser: it must return a JSON error (the browser sends no key, that is expected). If the page does not open, a VPN, proxy, antivirus or corporate network is cutting the connection. Add the models by hand on the Models tab as well.
Changes not appliedconfigFeche completamente o aplicativo via Quit/Exit e abra-o novamente — fechar a janela não é suficiente.
Claude Desktop + GetVibe API — inferência de terceiros (gateway) | GetVibe API