Integración con Cursor

Cómo llamar a los modelos Claude de 1折AI en Cursor con una clave API de OpenAI personalizada y una URL base, y qué funciones no usan la clave API personalizada.

Cursor permite configurar tu propia clave API (API key) en los ajustes, y los modelos de chat envían solicitudes con esa clave API. A continuación se explica cómo integrar 1折AI y algunas limitaciones que debes conocer antes de empezar.

Ten en cuenta estos tres puntos antes de empezar:

Según la documentación oficial de Cursor, la clave API personalizada solo afecta a los modelos de chat; la autocompletado con Tab siempre usa los propios modelos de Cursor.
Las solicitudes pasan primero por los servidores de Cursor antes de enviarse a la dirección que hayas configurado, por lo que la URL base debe ser accesible desde Internet (https://1zheai.com/v1 funciona, pero un proxy local localhost no).
El interruptor “Override OpenAI Base URL” no aparece en la documentación oficial de Cursor; la descripción de la interfaz que se muestra a continuación procede del foro de Cursor y de tutoriales de la comunidad, y puede cambiar tras una actualización de Cursor.

Configuración

Abrir la configuración de modelos
Cursor → Cursor Settings → Models, y busca la sección Keys.

Rellenar OpenAI API Key y Base URL

1
OpenAI API Key              sk-你的Key（1折AI 的 Key）
2
Override OpenAI Base URL    https://1zheai.com/v1

La URL base debe incluir /v1.

Añadir modelo
En la lista de modelos, haz clic en Add model, introduce el ID del modelo, por ejemplo claude-sonnet-5-5, y activa su interruptor. Los ID de los modelos se encuentran en modelos compatibles.
Probar una vez en el chat
Selecciona el modelo recién añadido en el panel Chat y envía un mensaje. Cuando la respuesta funcione correctamente, comprueba la llamada en el registro de llamadas de la consola.

Problemas conocidos

Hay informes en el foro de Cursor: después de configurar Override OpenAI Base URL, los modelos cuyo nombre empieza por claude- pueden ser tratados por Cursor como modelos de Anthropic y procesados con la clave API de Anthropic, o bien devolver un error directamente. Al elegir Claude, el ID del modelo empieza por claude-; si te encuentras con este problema, borra primero la clave API de Anthropic que hayas configurado en Cursor y vuelve a intentarlo.

Referencias: publicación del foro 144899, publicación del foro 146998.

Preguntas frecuentes

¿La autocompletación con Tab usará 1折AI?

No. Según la documentación oficial de Cursor, la autocompletado con Tab siempre usa los modelos incluidos en Cursor y no pasa por tu clave API.

¿Falla al hacer clic en Verify?

Comprueba primero que la URL base incluye /v1. Según los informes de la comunidad, el botón Verify no siempre acepta nombres de modelos que no sean de OpenAI; puedes enviar directamente un mensaje en el Chat para probarlo, y lo que cuenta es si hay un registro en el registro de llamadas.

¿Se pueden usar Agent / Composer?

Los tutoriales de la comunidad indican de forma general que solo el Chat usa la clave API personalizada; funciones como Agent, Apply o Inline Edit pueden seguir usando el backend propio de Cursor. Lo que cuenta es el registro que veas realmente en el registro de llamadas.

¿Quieres usar Claude por completo en el editor?

Si tu objetivo principal es escribir código con Claude, Claude Code (línea de comandos o extensión de VS Code) y Cline ofrecen un soporte más completo para direcciones personalizadas.