Conecta Cursor / Claude Code / Cherry Studio a una pasarela de IA personalizada
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.
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:
- Abre
Settings → Models(o la página de ajustesModels); - Despliega la zona
OpenAI API Key: introduce la clave de la pasarela (sk-...); - Marca/rellena
Override OpenAI Base URL:https://www.4-4.vip/v1; - 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);
- 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"
Cherry Studio
Cherry Studio es el más directo para proveedores personalizados compatibles con OpenAI:
Ajustes → Servicios de modelo: añadir/seleccionar un proveedor compatible con OpenAI;- Dirección API:
https://www.4-4.vip/v1(algunas versiones completan /v1 automáticamente, ojo con duplicar); - Clave API: la clave de la pasarela;
- 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:
| Elemento | Valor | Trampas habituales |
|---|---|---|
| Base URL | https://www.4-4.vip/v1 | Según la herramienta hay que poner /v1 o no — ante un 404, prueba con y sin /v1 |
| API Key | Clave de la pasarela (sk-...) | Espacios al inicio o final, clave caducada, crédito agotado |
| Nombre del modelo | El nombre tal cual está en el canal de la pasarela | Debe coincidir estrictamente con la pasarela; los nombres que la herramienta no conoce no funcionan |
Guía rápida de errores
401 Unauthorized
- La copia de la clave trajo espacios/saltos de línea → vuelve a copiar;
- Clave desactivada o crédito agotado → revisa la página de tokens de la consola de la pasarela;
- Formato incorrecto de la cabecera Authorization → debe ser
Bearer sk-....
404 Not Found
- Ruta de la Base URL incorrecta → prueba alternando «con /v1» y «sin /v1»;
- El endpoint del protocolo solicitado no está soportado → comprueba que la pasarela admita ese protocolo (OpenAI /v1/chat/completions o Anthropic /v1/messages).
400 Model Not Found / sin canal disponible
- El nombre del modelo no coincide con el canal de la pasarela → coteja los nombres en la página de modelos/canales de la consola;
- Canal desactivado o grupo sin permisos → revisa el alcance de modelos y los ajustes de grupo del token.
Streaming interrumpido / sin respuesta
- El proxy corporativo almacena el SSE en búfer → prueba con conexión directa;
- El timeout de la herramienta es demasiado corto → alórgalo; en tareas de texto largo, verifica primero que la pasarela no fuerce un timeout.
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
Una clave para GLM, DeepSeek, Qwen y más modelos destacados: facturación unificada y uso visualizado.
Ver modelos y precios Probar gratis