Conecte Cursor / Claude Code / Cherry Studio a um gateway de IA personalizado
As principais ferramentas de IA suportam API personalizada — ou seja, você pode apontá-las para o seu próprio gateway (como o 4-4 AI) e unificar chaves e faturamento. Este artigo cobre a configuração das três ferramentas mais usadas e o enfoque comum de diagnóstico de erros.
https://www.4-4.vip/v1); outros gateways compatíveis com OpenAI funcionam igual.Cursor
O modelo de conversa do Cursor pode usar uma interface personalizada compatível com OpenAI:
- Abra
Settings → Models(ou a página de configuraçõesModels); - Expanda a área
OpenAI API Key: insira a chave do gateway (sk-...); - Marque/preencha
Override OpenAI Base URL:https://www.4-4.vip/v1; - Adicione à lista de modelos os nomes disponíveis no seu gateway (idênticos aos nomes de canal do gateway, diferencia maiúsculas);
- Após uma verificação Verify bem-sucedida, basta trocar para o modelo personalizado no rodapé da conversa.
Nota: o completamento Tab embutido do Cursor e parte do Composer usam o serviço próprio do Cursor e não são afetados; os modelos personalizados servem sobretudo ao chat.
Claude Code
O Claude Code usa o protocolo Anthropic. O pré-requisito para passar pelo gateway é que ele suporte o endpoint do protocolo Anthropic (/v1/messages) — gateways sobre base new-api (incluindo o 4-4 AI) fazem essa conversão; as requisições do protocolo Claude são transformadas e roteadas ao canal de modelo real.
Configuração por variáveis de ambiente (no terminal de onde você lança o claude):
export ANTHROPIC_BASE_URL="https://www.4-4.vip"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_GATEWAY_KEY"
# start
claude
No Windows PowerShell:
$env:ANTHROPIC_BASE_URL = "https://www.4-4.vip"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_GATEWAY_KEY"
Cherry Studio
O Cherry Studio é o mais direto para provedores personalizados compatíveis com OpenAI:
Configurações → Serviços de modelo: adicionar/selecionar um provedor compatível com OpenAI;- Endereço da API:
https://www.4-4.vip/v1(algumas versões completam /v1 automaticamente, cuidado com duplicar); - Chave da API: a chave do gateway;
- Adicione manualmente os nomes de modelos disponíveis na gestão de modelos e selecione-os na conversa após salvar.
A regra comum: qualquer ferramenta compatível com OpenAI
Inúmeras ferramentas (LobeChat, Open WebUI, Immersive Translate, plugins de IDE etc.) seguem o mesmo esquema de configuração — memorize o trio:
| Item | Valor | Armadilhas comuns |
|---|---|---|
| Base URL | https://www.4-4.vip/v1 | Dependendo da ferramenta é preciso /v1 ou não — diante de um 404, teste com e sem /v1 |
| API Key | Chave do gateway (sk-...) | Espaços no início ou fim, chave expirada, crédito esgotado |
| Nome do modelo | O nome tal como está no canal do gateway | Deve corresponder estritamente ao gateway; nomes que a ferramenta não conhece não funcionam |
Guia rápido de erros
401 Unauthorized
- A cópia da chave veio com espaços/quebras → copie de novo;
- Chave desativada ou crédito esgotado → confira a página de tokens do console do gateway;
- Formato errado do cabeçalho Authorization → deve ser
Bearer sk-....
404 Not Found
- Caminho da Base URL errado → teste alternando «com /v1» e «sem /v1»;
- O endpoint do protocolo solicitado não é suportado → confirme que o gateway suporta o protocolo (OpenAI /v1/chat/completions ou Anthropic /v1/messages).
400 Model Not Found / sem canal disponível
- Nome do modelo diferente do canal do gateway → coteje os nomes na página de modelos/canais do console;
- Canal desativado ou grupo sem permissões → revise o escopo de modelos e as configurações de grupo do token.
Streaming interrompido / sem resposta
- O proxy corporativo armazena o SSE em buffer → teste com conexão direta;
- Timeout da ferramenta curto demais → aumente; em tarefas de texto longo, verifique primeiro se o gateway força um timeout.
Perguntas frequentes (FAQ)
Meus dados ficam seguros ao passar pelo gateway?
Suas requisições passam pelo gateway para o canal de modelo upstream. Confira as políticas de logs e privacidade do gateway; com dados sensíveis, desative a retenção de logs de conversa no gateway ou use canais que não persistem dados.
Posso configurar vários gateways na mesma ferramenta?
A maioria das ferramentas suporta múltiplos provedores com troca instantânea (Cherry Studio, Cursor etc.). Com tokens diferentes por ferramenta, você separa também estatísticas de uso e limites.
Por que recomendar um gateway unificado em vez de conexão direta por ferramenta?
Três razões: gestão centralizada de chaves (menor superfície de vazamento), faturamento e uso visíveis em um só lugar (sem conciliar entre plataformas), modelos substituíveis a qualquer momento (desacoplamento do provedor, trocar só toca a configuração do gateway).
Artigos relacionados
Uma chave para GLM, DeepSeek, Qwen e mais modelos de ponta: faturamento unificado e uso visualizado.
Ver modelos e preços Testar grátis