Claude Desktop

Rode o Claude Code dentro do app Claude Desktop (aba Code) na OneProvider, sem uma conta Claude.

App Claude Desktop com a aba Code

O que funciona

A aba Code (o Claude Code com interface visual) e o Cowork rodam na OneProvider pelo modo gateway integrado do Claude Desktop, que a Anthropic chama de third-party inference (inferência de terceiros). Não precisa de conta Claude nem Anthropic. Funciona no macOS 14+ e no Windows 10 (2004) ou mais recente, inclusive o Windows 11.

Limitação do cliente

O modo gateway é só local: as sessões rodam no seu computador, sem sessões em nuvem, SSH ou Remote Control. O Desktop pega o gateway do formulário abaixo, não de ANTHROPIC_BASE_URL nem de ~/.claude/settings.json (esses são para a linha de comando do Claude Code). Sem o formulário, o Desktop só abre com uma assinatura paga do Claude.

Configuração

1. Instale o Claude Desktop e não faça login

   Baixe o app em claude.com/download (macOS: .dmg, arraste o Claude para Aplicativos; Windows: instalador .msix) e abra. Fique na tela de login: não entre nem crie uma conta na Anthropic.

2. Ative o Developer Mode

   macOS: na barra de menus, escolha Help → Troubleshooting → Enable Developer Mode (Ajuda → Solução de problemas → Ativar modo de desenvolvedor). Windows: clique no menu do aplicativo ☰, no canto superior esquerdo da tela de login, e depois em Help → Troubleshooting → Enable Developer Mode. O app reinicia e aparece um menu Developer; ele continua ativo depois de reiniciar.

3. Abra Configure Third-Party Inference

   Escolha Developer → Configure Third-Party Inference… (Desenvolvedor → Configurar inferência de terceiros). Na seção Connection, defina Inference provider como Gateway e preencha o cartão Gateway credentials como abaixo. A base URL é exatamente esta, sem /v1 e sem caminho no final; cole a sua chave da OneProvider em Gateway API key.

   Inference provider: Gateway
   Gateway base URL: https://api.oneprovider.dev
   Gateway API key: sk-your-key-here
   Credential kind: Static API key
   Gateway auth scheme: Bearer (x-api-key também funciona)

4. Confira a lista de modelos

   Deixe Models vazio no começo: o Desktop consulta https://api.oneprovider.dev/v1/models e mostra os modelos Claude do catálogo. Se o seletor continuar vazio, abra a seção Models e adicione o ID exato do modelo Claude (<your-compatible-model-id>) do catálogo de modelos; a primeira entrada é o padrão das novas sessões do Code.

5. Aplique, reinicie e comece no modo gateway

   Clique em Apply Changes e depois em Save & Restart. Depois que o app reabrir, a tela de login oferece iniciar com a configuração do seu provedor de inferência (inference provider): escolha essa opção, não o login da Anthropic. Abra a aba Code, escolha uma pasta de projeto local e envie uma mensagem.

Verificar a conexão

Confirme a requisição no seu painel

Envie uma mensagem curta em uma nova sessão do Code. Em até um minuto, a requisição deve aparecer no painel em Consumo, com o modelo, os tokens e o valor debitado. Se falhar:

Tela de login padrão sem a opção de provedor → o formulário não foi aplicado: feche o app por completo (Cmd+Q no macOS, Gerenciador de Tarefas no Windows) e abra de novo
"Gateway was unreachable" → confira a base URL (exatamente https://api.oneprovider.dev) e desligue a VPN ou o proxy
401 → chave errada, revogada ou expirada: confira no painel, em Chaves
429 insufficient balance → recarregue o saldo do painel e envie de novo
Seletor de modelos vazio → adicione o ID do modelo na seção Models
"Error 403: Forbidden" → você está no caminho de login da Anthropic: escolha a opção de provedor
O que o Desktop aplicou: Help → Troubleshooting → Generate Diagnostic Report → Export to file (managed-config.txt, provider-status.txt)
Log: ~/Library/Logs/Claude-3p/main.log (macOS) ou %LOCALAPPDATA%\Claude-3p\Logs\main.log (Windows)

Dados da conexão

Protocolo

anthropic

Endpoint

https://api.oneprovider.dev

Segurança da chave

A chave fica guardada na configuração do Desktop, só neste computador. Use uma chave dedicada com limite de gastos; se o computador for compartilhado ou a chave vazar, exclua ou pause essa chave no painel e o resto do seu saldo fica seguro.

Respostas rápidas

Qual base URL devo usar?

O Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Os SDKs da OpenAI e os clientes compatíveis com a OpenAI usam https://api.oneprovider.dev/v1. Uma única chave funciona nos dois; a lista de modelos está na página de modelos e os preços, na página de preços .

Como me autentico?

Envie a chave sk-… pura em x-api-key ou em Authorization: Bearer: um dos dois, nunca ambos. Guarde a chave em uma variável de ambiente, não em um arquivo que vai para o commit. Mais sobre autenticação .

Onde consigo uma chave?

Abra o seu painel no bot do Telegram @oneprovider_robot ou em app.oneprovider.dev, recarregue o saldo e toque em “Emitir chave”. Cada chave pode ter o seu próprio limite de gastos. Painel e chaves de API .

O que significam 401, 404 e 429?

401: a chave está ausente, foi digitada errado ou enviada no cabeçalho errado; cole a chave inteira, sem aspas nem espaços. 404: em geral, uma base URL errada, por exemplo um /v1 ausente ou duplicado. 429 com “Insufficient balance”: o saldo do painel ou o limite de gastos da chave acabou, então recarregue em vez de tentar de novo; qualquer outro 429 é um limite de requisições, então aguarde o tempo de Retry-After. Detalhes: códigos de erro e solução de problemas .

Por que os streams são cortados ou reiniciados?

VPNs e proxies VLESS costumam armazenar SSE em buffer ou quebrar a negociação do HTTP/2. A OneProvider não tem restrições regionais e não armazena streams em buffer; desative o proxy e tente de novo.

Onde pergunto se isso não bastar?

Escreva para @Oneproviderhelpbot no Telegram ou abra “Suporte” no painel web, informando o código de status HTTP e a mensagem de erro exata. Como funciona o suporte .