Como usar o Claude Desktop com sua chave CodeAll

O Claude Desktop é o app oficial da Anthropic — o de janela, não o do terminal. No modo Third-Party Inference ele aceita apontar para um gateway próprio, então o mesmo app que você já usa passa a rodar na sua assinatura CodeAll, pagando em reais.

Se você ainda não tem chave, escolha um plano ou peça um trial de 24h grátis.

1. Pré-requisitos

• Uma chave CodeAll ativa.
• O app instalado (claude.ai/download) e o Modo Desenvolvedor ligado: menu Help → Troubleshooting → Enable Developer Mode, confirmar em Enable. O app reinicia sozinho e passa a mostrar um menu Developer no topo.

2. Configurar o Claude Desktop

Com o Modo Desenvolvedor ligado, vá em Developer → Configure Third-Party Inference… e escolha o provedor Gateway. São quatro campos — os mesmos que aparecem no arquivo abaixo, que é onde o app guarda essa configuração:

{
  "inferenceProvider": "gateway",
  "inferenceCredentialKind": "static",
  "inferenceGatewayBaseUrl": "https://api.tn1.top",
  "inferenceGatewayApiKey": "<sua chave CodeAll>",
  "inferenceGatewayAuthScheme": "x-api-key",
  "inferenceModels": ["gpt-5.5", "Opus 4.8", "Sonnet", "Haiku"]
}

1. Preencha: Gateway base URL https://api.tn1.top, Gateway API key com a sua chave CodeAll, Gateway auth scheme x-api-key (o padrão do app é bearer; o gateway da CodeAll aceita os dois) e, em Model list, os nomes da tabela da próxima seção.
2. A lista de modelos é opcional, mas preencha: deixando vazia, o app monta o seletor com tudo que o /v1/models devolve — hoje são 656 modelos, o que torna o seletor inútil.
3. Se for escrever o arquivo em vez de usar o diálogo, atenção ao nome: ele tem que ser um UUID (gere com uuidgen), e o _meta.json da mesma pasta precisa apontar para ele — {"appliedId": "<o-mesmo-uuid>", "entries": [{"id": "<o-mesmo-uuid>", "name": "CodeAll"}]}. Nome que não seja UUID é ignorado em silêncio: o app não avisa nada e continua respondendo pela Anthropic.
4. Feche o app por completo (Cmd+Q no macOS; sair pela bandeja no Windows) e abra de novo. A configuração é lida uma vez, quando o app inicia — e não há vigia na pasta: editar o arquivo com o app aberto não surte efeito.
5. Mande uma mensagem. Se responder, está valendo pela sua assinatura CodeAll.

3. Modelos disponíveis

O CodeAll junta as duas famílias na mesma chave: gpt-5.5 da OpenAI e os modelos da Anthropic (Opus 4.8, Sonnet, Haiku). Trocar de modelo é trocar uma linha do config.

No Claude Desktop o modelo é informado por inferenceModels (a lista dentro do JSON).

4. O que funciona

5. Troubleshooting

6. FAQ

É o mesmo que o Claude Code?
Não. O Claude Code é o do terminal, e o guia dele é o /setup. Aqui é o app de janela, com a mesma chave.

Preciso pagar a Anthropic também?
Não. O app é gratuito; o que passa a sair da sua assinatura CodeAll é a inferência.

Preciso do Modo Desenvolvedor mesmo?
Precisa: é ele que revela o menu Developer, onde fica a configuração de inferência de terceiros. Ligar não muda mais nada no app.

Posso usar a mesma chave no app e no terminal?
Pode — é a mesma chave e a mesma assinatura. Só não compartilhe entre pessoas diferentes.

Para onde vão meus dados?
Para o gateway da CodeAll e, de lá, para o provedor que atender a requisição.

Dúvida que não está aqui? Fale com a gente em suporte@tn1.top.

7. A mesma chave na próxima ferramenta

A sua chave CodeAll não é só do Claude Desktop. Ela responde nos dois formatos — o da OpenAI e o da Anthropic — então a ferramenta que fala GPT e a que fala Claude usam a mesma chave e a mesma assinatura.

Na prática: você deixa o Claude Desktop no modelo que preferir para a tarefa de agora e abre outra ferramenta com o modelo nativo dela, sem trocar de chave, sem uma segunda mensalidade e sem refazer configuração.

Ferramentas próximas do Claude Desktop, cobertas pela mesma chave:

• Guia do Claude Code
• Guia do Cursor