Conecte Cursor / Claude Code / Cherry Studio a um gateway de IA personalizado

Tutorial · 2026-11-20 · 7 min de leitura

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.

Pré-requisito: você já tem uma chave de API. Se não, conclua primeiro registro e criação de chave com «Conecte-se a uma API de IA unificada em 5 minutos». Este artigo usa como exemplo a Base URL do 4-4 AI (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:

  1. Abra Settings → Models (ou a página de configurações Models);
  2. Expanda a área OpenAI API Key: insira a chave do gateway (sk-...);
  3. Marque/preencha Override OpenAI Base URL: https://www.4-4.vip/v1;
  4. Adicione à lista de modelos os nomes disponíveis no seu gateway (idênticos aos nomes de canal do gateway, diferencia maiúsculas);
  5. 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"
Dois detalhes: ① ANTHROPIC_BASE_URL sem o sufixo /v1 (o caminho do protocolo Anthropic é montado pela ferramenta); ② se quiser que o Claude Code use modelos fora da família Claude, confirme que o canal do gateway tem o mapeamento de modelos configurado e use os nomes do lado do gateway.

Cherry Studio

O Cherry Studio é o mais direto para provedores personalizados compatíveis com OpenAI:

  1. Configurações → Serviços de modelo: adicionar/selecionar um provedor compatível com OpenAI;
  2. Endereço da API: https://www.4-4.vip/v1 (algumas versões completam /v1 automaticamente, cuidado com duplicar);
  3. Chave da API: a chave do gateway;
  4. 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:

ItemValorArmadilhas comuns
Base URLhttps://www.4-4.vip/v1Dependendo da ferramenta é preciso /v1 ou não — diante de um 404, teste com e sem /v1
API KeyChave do gateway (sk-...)Espaços no início ou fim, chave expirada, crédito esgotado
Nome do modeloO nome tal como está no canal do gatewayDeve corresponder estritamente ao gateway; nomes que a ferramenta não conhece não funcionam

Guia rápido de erros

401 Unauthorized

404 Not Found

400 Model Not Found / sem canal disponível

Streaming interrompido / sem resposta

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

Início rápido com 4-4 AI: conecte-se a uma API de IA unificada em 5 minutos Interface compatível com OpenAI: uma chave para GLM, DeepSeek, Qwen e mais. Exemplos executáveis em três lingu 7 práticas de engenharia para reduzir o custo de tokens de suas aplicações de IA Roteamento por nível de modelo, corte de contexto, cache de prefixo, salvaguardas de orçamento — sete práticas
Pronto para conectar?

Uma chave para GLM, DeepSeek, Qwen e mais modelos de ponta: faturamento unificado e uso visualizado.

Ver modelos e preços Testar grátis