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.
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
- No novo menu Developer, escolha Configure Third-Party Inference….
- Em Connection, altere o tipo para Gateway.
- URL base do gateway:
https://getvibeapi.com— sem/v1, o aplicativo acrescenta/v1/messagespor conta própria. - Tipo de credencial: Chave de API estática; esquema de autenticação:
x-api-key. - Chave de API do gateway: sua chave
sk-pv-…de Dashboard → API keys. - 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/modelsautomaticamente.
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
.msixe 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âmetro | Tipo | Descrição |
|---|---|---|
App unavailable in region | screen | Este é 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. |
401 | error | Verifique a chave e se o esquema de autenticação é x-api-key, não Bearer. |
404 | error | O 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” | config | Adicione 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” | network | The 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 applied | config | Feche completamente o aplicativo via Quit/Exit e abra-o novamente — fechar a janela não é suficiente. |