Conecta Cursor / Claude Code / Cherry Studio a una pasarela de IA personalizada

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

Las principales herramientas de IA admiten API personalizadas — es decir, puedes apuntarlas a tu propia pasarela (como 4-4 AI) y unificar claves y facturación. Este artículo cubre la configuración de las tres herramientas más usadas y el enfoque común de diagnóstico de errores.

Requisito previo: ya tienes una clave API. Si no, completa primero el registro y la creación de la clave con «Conéctate a una API de IA unificada en 5 minutos». Este artículo usa como ejemplo la Base URL de 4-4 AI (https://www.4-4.vip/v1); otras pasarelas compatibles con OpenAI funcionan igual.

Cursor

El modelo de conversación de Cursor puede usar una interfaz personalizada compatible con OpenAI:

  1. Abre Settings → Models (o la página de ajustes Models);
  2. Despliega la zona OpenAI API Key: introduce la clave de la pasarela (sk-...);
  3. Marca/rellena Override OpenAI Base URL: https://www.4-4.vip/v1;
  4. Añade a la lista de modelos los nombres disponibles en tu pasarela (idénticos a los nombres de canal de la pasarela, distingue mayúsculas);
  5. Tras una verificación Verify correcta, cambia al modelo personalizado en la parte inferior del chat.

Nota: el autocompletado Tab integrado de Cursor y parte de Composer usan el servicio propio de Cursor y no se ven afectados; los modelos personalizados se usan sobre todo en el chat.

Claude Code

Claude Code usa el protocolo Anthropic. El requisito para pasar por la pasarela es que esta admita el endpoint del protocolo Anthropic (/v1/messages) — las pasarelas sobre base new-api (incluida 4-4 AI) hacen esa conversión; las peticiones del protocolo Claude se transforman y se enrutan al canal de modelo real.

Configuración por variables de entorno (en el terminal desde el que lanzas claude):

export ANTHROPIC_BASE_URL="https://www.4-4.vip"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_GATEWAY_KEY"

# start
claude

En Windows PowerShell:

$env:ANTHROPIC_BASE_URL = "https://www.4-4.vip"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_GATEWAY_KEY"
Dos detalles: ① ANTHROPIC_BASE_URL sin el sufijo /v1 (la ruta del protocolo Anthropic la arma la herramienta); ② si quieres que Claude Code use modelos que no sean de la familia Claude, verifica que el canal de la pasarela tenga configurado el mapeo de modelos correspondiente y usa los nombres del lado de la pasarela.

Cherry Studio

Cherry Studio es el más directo para proveedores personalizados compatibles con OpenAI:

  1. Ajustes → Servicios de modelo: añadir/seleccionar un proveedor compatible con OpenAI;
  2. Dirección API: https://www.4-4.vip/v1 (algunas versiones completan /v1 automáticamente, ojo con duplicar);
  3. Clave API: la clave de la pasarela;
  4. Añade manualmente los nombres de modelos disponibles en la gestión de modelos y selecciónalos en el chat tras guardar.

La regla común: cualquier herramienta compatible con OpenAI

Infinidad de herramientas (LobeChat, Open WebUI, Immersive Translate, plugins de IDE, etc.) siguen el mismo esquema de configuración — recuerda el trío:

ElementoValorTrampas habituales
Base URLhttps://www.4-4.vip/v1Según la herramienta hay que poner /v1 o no — ante un 404, prueba con y sin /v1
API KeyClave de la pasarela (sk-...)Espacios al inicio o final, clave caducada, crédito agotado
Nombre del modeloEl nombre tal cual está en el canal de la pasarelaDebe coincidir estrictamente con la pasarela; los nombres que la herramienta no conoce no funcionan

Guía rápida de errores

401 Unauthorized

404 Not Found

400 Model Not Found / sin canal disponible

Streaming interrumpido / sin respuesta

Preguntas frecuentes (FAQ)

¿Mis datos están seguros al pasar por la pasarela?

Tus peticiones pasan por la pasarela hacia el canal de modelo upstream. Comprueba las políticas de registros y privacidad de la pasarela; con datos sensibles, desactiva la conservación de registros de conversación en la pasarela o usa canales que no persistan datos.

¿Puedo configurar varias pasarelas en una misma herramienta?

La mayoría de las herramientas admite varios proveedores con cambio instantáneo (Cherry Studio, Cursor, etc.). Con tokens distintos por herramienta, separas también estadísticas de uso y límites.

¿Por qué recomendar una pasarela unificada en vez de conexión directa por herramienta?

Tres razones: gestión centralizada de claves (menos superficie de fuga), facturación y uso visibles en un solo sitio (sin conciliar entre plataformas), modelos reemplazables en cualquier momento (desacoplamiento del proveedor, cambiar solo toca la configuración de la pasarela).

Artículos relacionados

Inicio rápido con 4-4 AI: conéctate a una API de IA unificada en 5 minutos Interfaz compatible con OpenAI: una clave para GLM, DeepSeek, Qwen y más. Ejemplos ejecutables en tres lenguaj 7 prácticas de ingeniería para reducir el coste de tokens de tus aplicaciones de IA Enrutado por nivel de modelo, recorte de contexto, caché de prefijos, salvaguardas de presupuesto — siete prác
¿Listo para conectarte?

Una clave para GLM, DeepSeek, Qwen y más modelos destacados: facturación unificada y uso visualizado.

Ver modelos y precios Probar gratis