Home → Guides → Apontando o Claude Desktop e o Codex para a APICLAN
Aplicativos de desktop não têm campo de base URL nas próprias configurações. O CC Switch escreve essa configuração por você. Aqui está exatamente o que preencher e as duas coisas que explicam quase toda configuração que dá errado.
Você precisa de uma conta com saldo e de uma chave de API. Crie a chave no console, em «Chaves de API»: escolha a família de fornecedor que vai chamar — Anthropic para o Claude Desktop, OpenAI para o Codex — e depois o grupo de chaves de onde quer gastar. O grupo define a sua taxa; quanto custa cada modelo está na página de preços.
Uma chave pertence a exatamente um grupo. Uma chave criada para modelos de texto não chama modelos de imagem, e vice-versa; isso volta como 404 no modelo, não como erro de permissão. Se precisar dos dois, crie duas chaves. O que uma chave pode chamar é sempre o que GET /v1/models responde quando enviado com ela.
Toda requisição precisa chegar em um caminho que comece com /v1. Se você digita /v1 no cliente depende do cliente: alguns acrescentam sozinhos, outros não. Esse único detalhe está por trás da maioria dos relatos de «não conecta».
| Cliente | Endereço de requisição a preencher |
|---|---|
| Claude Desktop (via CC Switch) | https://apiclan.us/v1 |
| Codex / ChatGPT desktop app | https://apiclan.us/v1 |
| OpenAI SDK, Cherry Studio, Chatbox, LobeChat, LM Studio | https://apiclan.us/v1 |
| Cursor, Cline, Roo Code | https://apiclan.us/v1 |
| Claude Code | https://apiclan.us |
| Anthropic SDK | https://apiclan.us |
Invertido, a requisição dá 404 na borda, ou seja, nunca chega ao gateway e nunca aparece no seu registro de uso — portanto um registro vazio já é o sintoma. Nunca deixe barra no final do endereço.
O Codex foi integrado ao aplicativo de desktop do ChatGPT. No Windows, instale o ChatGPT pela Microsoft Store; no macOS, baixe no site da OpenAI. O Codex de linha de comando usa as mesmas configurações.
No CC Switch, adicione um fornecedor para o Codex, cole sua chave e preencha https://apiclan.us/v1 como endereço de requisição. Ative esse fornecedor e então feche o Codex por completo — fechar a janela não basta — e abra de novo. A configuração só é lida na inicialização, então uma instância em execução continua com os ajustes antigos e parece que nada aconteceu.
Se preferir editar o arquivo de configuração na mão em vez de usar o CC Switch, a base URL e o lugar da chave estão no nosso guia rápido.
Instale o Claude Desktop pelo claude.com e configure o fornecedor no CC Switch:
https://apiclan.us/v1 como endereço de requisição — o cliente acrescenta /messages sozinho. Sem barra no final.Se o CC Switch oferecer a escolha entre conexão direta e mapeamento de modelos, leia a próxima seção antes de decidir. É esse ajuste que determina se o seletor de modelos funciona.
Um aviso dizendo que a conexão funciona mas o fornecedor recusou a requisição quase sempre é sobre o nome do modelo, não sobre a chave. O aplicativo de desktop envia os próprios identificadores de modelo embutidos, e um gateway só consegue servir os modelos que as contas a montante realmente oferecem.
A solução é mapeamento de modelos em vez de conexão direta: faça as entradas do aplicativo corresponderem aos nomes que este gateway serve. A conexão direta só funciona quando o fornecedor aceita exatamente os identificadores que o aplicativo envia.
Envie GET /v1/models com sua chave para obter a lista para a qual mapear. Essa lista é construída a partir do grupo da sua própria chave, então é a resposta real para a sua conta e não um catálogo genérico.
Nada é sobrescrito de forma permanente. No CC Switch, ative o fornecedor oficial de novo e reinicie o cliente: o aplicativo volta para a sua assinatura. Dá para manter os dois configurados e alternar quando quiser — o saldo aqui é pré-pago e não expira, então uma configuração parada não custa nada.
/v1 e tire qualquer barra do final.Continua travado? Escreva para support@apiclan.us com o nome do modelo que falhou e mais ou menos quando você tentou. Uma pessoa lê.
No subscription, no monthly minimum, no sales call. Top up with USDT and spend what you use — 1 USDT gives you 2 credits of API balance.
Read the 30-second quickstartPrices quoted on this page are regenerated automatically from live billing data. Third-party terms are quoted from that party's own published documentation.