Claude Desktop na Rússia: como configurar um gateway de inferência

O que significa inferência de terceiros no Claude Desktop

Normalmente, o Claude Desktop usa uma conta e os serviços da Anthropic. A inferência de terceiros altera o caminho da solicitação ao modelo: o aplicativo a envia ao gateway configurado. Isso não transforma uma API de terceiros em uma assinatura do Claude nem remove os requisitos do próprio aplicativo quanto à instalação, atualizações ou disponibilidade de recursos.

Não confunda um gateway de inferência com Desktop Extensions ou MCP. Extensões dão ao Claude acesso a aplicativos e dados locais. O gateway encaminha solicitações a um modelo. Uma falha em uma camada não prova que outra camada esteja com problema.

A documentação atual da Anthropic informa que o Claude Desktop está disponível para macOS, Windows e Linux beta. Os caminhos de menu Help → Troubleshooting e Developer → Configure Third-Party Inference… abaixo são confirmados pelo guia atual da BetterToken para macOS. Em outro sistema operacional, verifique primeiro se a versão instalada do aplicativo mostra as mesmas opções.

Escolha a rota pelo grupo de API Key

• Grupo Claude: gateway Anthropic-compatible direto; Gateway base URL é https://www.bettertoken.ai; o esquema de autenticação é x-api-key.
• Grupo Codex: BetterToken → CC Switch → rota local do Claude; Gateway base URL é a Service address do CC Switch; o esquema de autenticação é bearer.

Para um grupo Codex, não coloque https://www.bettertoken.ai/v1 diretamente no Gateway do Claude Desktop. Essa é uma Base URL OpenAI-compatible, enquanto o campo Gateway espera uma rota compatível com Anthropic. O CC Switch aceita a OpenAI Responses API, mapeia modelos e expõe um endereço de serviço local para o Claude Desktop.

Configuração direta para um grupo Claude

1. Instale o Claude Desktop atual

Baixe o aplicativo pela página oficial do Claude. O fluxo normal de instalação da Anthropic pede login. O fluxo BetterToken Gateway começa antes do login normal; siga a sequência do guia do gateway para não misturar os dois modos.

2. Ative o modo de desenvolvedor

No macOS, abra:

Help → Troubleshooting → Enable Developer Mode

Clique em Enable e encerre o Claude Desktop completamente. Ao abri-lo novamente, o menu Developer deve aparecer.

3. Abra as configurações do gateway

Vá para:

Developer → Configure Third-Party Inference…

Selecione Gateway e preencha:

Gateway base URL: https://www.bettertoken.ai
Gateway API key: sua API Key em Token management
Gateway auth scheme: x-api-key

Não coloque a chave em um artigo, captura de tela, log público ou repositório. Depois de selecionar x-api-key, o aplicativo deve solicitar os modelos disponíveis do grupo Claude.

4. Aplique e reinicie

Clique em Apply locally e depois em Relaunch now. Após iniciar, selecione Continue with Gateway. O rótulo Cowork 3P | Gateway no canto inferior esquerdo indica a rota ativa.

Rota local para um grupo Codex

Esta rota é mais longa: o Claude Desktop conecta-se a um endereço local do CC Switch, e o CC Switch envia as solicitações à OpenAI Responses API da BetterToken.

1. Adicione a BetterToken como provider no CC Switch

Abra Claude Code, clique em Add Provider e informe:

Provider Name: BetterToken
Base URL: https://www.bettertoken.ai
API Key: sua BetterToken API Key

Em Advanced Options, selecione OpenAI Responses API. Depois clique em Fetch Model List e atribua explicitamente os modelos aos campos de mapping disponíveis. Use somente IDs atuais do seu grupo Codex; não copie um modelo de artigo antigo ou captura de outra pessoa.

2. Habilite a rota local

Salve o provider, defina-o como In use e ative o proxy. Em Settings → Routing, confira o interruptor principal e a rota Claude. Copie a Service address exibida; esse é o endereço local de que o Claude Desktop precisa.

3. Preencha os campos Gateway no Claude Desktop

Volte a Developer → Configure Third-Party Inference…, selecione Gateway e informe:

Gateway base URL: Service address do CC Switch
Gateway API key: sua BetterToken API Key
Gateway auth scheme: bearer

Em Model list, adicione o Model ID atual e o Display name configurados no CC Switch. Clique em Apply locally, confirme Relaunch now e selecione Continue with Gateway.

Como verificar a requisição e o registro no Dashboard

Não comece acessando diretórios de trabalho ou com uma tarefa longa. Envie uma solicitação curta sem dados pessoais, por exemplo peça a diferença entre um array JSON e um objeto, e abra o Dashboard da BetterToken.

Uma verificação bem-sucedida tem dois sinais:

1. O Claude Desktop mostra a resposta e o modo ativo Cowork 3P | Gateway.
2. O Dashboard mostra um registro correspondente com hora, modelo, status, tokens de entrada/saída/cache e cobrança.

Se houver resposta, mas nenhum registro, confirme que o aplicativo usa realmente o Gateway e não outro modo. Se surgir um registro com status de erro, a rota alcançou a camada de API: confira grupo de chaves, esquema de autenticação, modelo e saldo. Não use o Dashboard para guardar um prompt ou resposta completos; remova chaves e conteúdo de requisições dos logs antes de acionar o suporte.

O que verificar se o Claude Desktop não conecta

• Sem menu Developer: ative novamente o modo de desenvolvedor e encerre o Claude Desktop por completo, em vez de apenas fechar a janela.
• Your provider setup needs a fix: confira Model list, IDs atuais e todos os mappings obrigatórios no CC Switch.
• 401 ou 403: selecione x-api-key para um grupo Claude e bearer para a rota local de um grupo Codex.
• Sem resposta e sem registro no Dashboard: confirme que proxy, interruptor principal de Routing e rota Claude estão habilitados no CC Switch.
• Há registro, mas a requisição falha: confira grupo de chaves, modelo atual, saldo disponível e espaços acidentais na chave.
• Nada muda após Apply locally: clique em Relaunch now e depois escolha Continue with Gateway.

Não diagnostique o Gateway por um único rótulo da interface. Relacione o modo do Claude Desktop, o estado da rota local e o registro de requisição do Dashboard para identificar em qual camada a cadeia foi interrompida.

Limitações deste método

BetterToken é um provedor de API independente, não um produto da Anthropic nem substituto de uma assinatura Claude. Ela é responsável por seu próprio API Endpoint e pela documentação de configuração. Acesso a downloads, login, atualizações, Cowork, Code mode e outros recursos do Claude Desktop dependem da versão atual do aplicativo, do plano e das regras da Anthropic.

Conectar-se ao API Endpoint da BetterToken a partir da Rússia não requer VPN. Essa afirmação não cobre o site do Claude, downloads do aplicativo, contas ou serviços externos. Se os itens de menu forem diferentes deste artigo, pare e compare a documentação oficial de instalação do Claude Desktop com o guia atual de configuração da BetterToken.

Perguntas frequentes

Posso colocar https://www.bettertoken.ai/v1 no Gateway do Claude Desktop?

Não para o fluxo descrito aqui. Esse é um endereço OpenAI-compatible. Um grupo Claude usa o endpoint Anthropic-compatible direto https://www.bettertoken.ai; um grupo Codex conecta-se pela Service address local do CC Switch.

Preciso de uma conta Claude para o modo Gateway?

As instruções normais da Anthropic pedem login após a instalação. O guia atual do BetterToken Gateway orienta o usuário por Continue with Gateway antes do login normal. Não copie passos de um modo para o outro; confira a interface da sua versão instalada do Claude Desktop.

Como saber qual esquema de autenticação está correto?

Use x-api-key para um grupo Claude direto. Use bearer para um grupo Codex encaminhado localmente pelo CC Switch. Após aplicar as configurações, verifique a resposta do Desktop e um novo registro no Dashboard.