Tutorial de configuração do Claude Desktop (cliente de desktop)

O Claude Desktop é o cliente de desktop oficial da Anthropic (Windows / macOS). Ele traz embutida uma entrada de configuração para o "gateway de inferência de terceiros", que permite enviar as requisições de conversa para o NextHub sem fazer login com uma conta oficial.

Claude Desktop e Claude Code são duas coisas diferentes

O Claude Desktop (cliente de desktop) e o Claude Code (linha de comando / plugin do VS Code) são dois produtos independentes: as configurações não são intercambiáveis e cada um precisa ser configurado em separado. Esta página trata do cliente de desktop; para a configuração da linha de comando, veja configurar o Claude Code manualmente.

Preparativos

1. Uma ApiKey de um grupo da família Claude: claude code (0.37x), Claude Max (0.5x) ou Claude-AWSB (0.7x); veja gerenciamento de ApiKey. O Claude Desktop usa o protocolo Anthropic Messages, portanto o critério de endereço é o mesmo do Claude Code
2. Baixe o instalador do seu sistema em claude.com/download

Cuidados na instalação no Windows

Ao ser executado, o instalador do Windows precisa acessar os serviços oficiais da Anthropic. Se o seu ambiente de rede não permite conexão direta, abra o cmd no diretório do instalador, defina as variáveis de ambiente de proxy e só então inicie o instalador (troque a porta pela sua):

set HTTP_PROXY=http://127.0.0.1:7897
set HTTPS_PROXY=http://127.0.0.1:7897
"Claude Setup.exe"

No macOS, instale normalmente.

Configuração manual (modo de desenvolvedor)

1. Ativar o modo de desenvolvedor

Abra o Claude Desktop e vá até a tela de login:

• Windows: clique com o mouse no campo de e-mail para dar foco a ele, use a tecla Tab para levar o foco até o menu do canto superior esquerdo e pressione Enter para entrar em Help → Troubleshooting → Enable developer mode
• macOS: entre direto no menu do canto superior esquerdo em Help → Troubleshooting → Enable developer mode

Depois de ativar, aguarde o programa reiniciar automaticamente.

2. Configurar o gateway de inferência de terceiros

Usando o mesmo método, abra o menu e entre em Developer → Configure third-party inference, preenchendo conforme a tabela:

Campo	Conteúdo
Gateway base URL	https://api.nexthub.cc
Gateway auth scheme	x-api-key
Gateway API key	sua ApiKey do NextHub (grupo da família Claude)
Skip login-mode chooser	ativado

Clique em Apply locally, no canto inferior direito, para aplicar a configuração.

Não espere um "teste aprovado"

Esta página usa o modo de gateway de terceiros, não a validação de login da conta oficial da Anthropic, portanto não existe (e não é preciso esperar) um aviso de "conexão bem-sucedida / teste aprovado". Depois de clicar em Apply locally, volte direto para a caixa de diálogo e envie uma mensagem: se receber uma resposta, a configuração está valendo.

3. Verificar

Crie uma conversa nova e envie uma mensagem; receber uma resposta normal do Claude significa que a conexão foi feita com sucesso.

A pequena cobrança da primeira mensagem

Depois de criar uma conversa nova, pode aparecer no registro de consumo uma pequena cobrança de um modelo diferente do que você escolheu — ela é gerada automaticamente pelo cliente para dar título à conversa. O valor é muito pequeno e isso é normal.

Configurar com o CC-Switch (opcional)

Achou o processo manual complicado? O CC-Switch já vem com um painel do Claude Desktop e permite importar com um clique os provedores já configurados no Claude Code:

1. Abra o CC-Switch e selecione Claude Desktop no seletor de aplicativos da esquerda (se não encontrar, vá em Configurações → Geral → Visibilidade de aplicativos para confirmar que a entrada não está oculta)
2. Ao entrar pela primeira vez, clique em "Importar provedores existentes do Claude Code"; ou clique no + do canto superior direito para adicionar manualmente: em endereço da interface coloque https://api.nexthub.cc e em API Key coloque a chave de um grupo da família Claude
3. Na ficha do provedor, clique em "Ativar" e depois saia do Claude Desktop por completo e abra novamente (ele não faz hot reload da configuração como o Claude Code; fechar a janela não é o mesmo que encerrar o programa)

Os dois avisos depois do reinício são falsos positivos

Depois de um reinício completo, a tela de conversa pode exibir faixas de aviso como "configuração não verificada" ou "conexão de rede" — são falsos positivos comuns do modo gateway; ignore e siga: se as mensagens forem e vierem normalmente, a configuração está valendo. Se não receber respostas, verifique nesta ordem: se o CC-Switch está em execução, se o endereço da interface e a ApiKey foram preenchidos corretamente e se você esqueceu de reiniciar por completo.