---
title: "Integración con Cursor"
description: "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."
headingIds: {"Configuración":"section-1","Problemas conocidos":"section-2","Preguntas frecuentes":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentación mantenida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fuentes y correcciones](https://1zheai.com/en/editorial/).

¿Encontraste un error? [Contacta con soporte](mailto:support@1zheai.com) indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

</aside>
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.

<Warning>

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.

</Warning>

## Configuración

<Steps>
<Step title="Abrir la configuración de modelos">

Cursor → **Cursor Settings** → **Models**, y busca la sección Keys.

</Step>
<Step title="Rellenar OpenAI API Key y Base URL">

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

La URL base debe incluir `/v1`.

</Step>
<Step title="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](/es/docs/models/).

</Step>
<Step title="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](/es/docs/usage-logs/).

</Step>
</Steps>

## Problemas conocidos

<Warning>

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](https://forum.cursor.com/t/anthropic-models-break-when-override-openai-baseurl-is-set/144899), [publicación del foro 146998](https://forum.cursor.com/t/override-anthropic-base-url-automatically-switches-on-when-using-anthropic-byok/146998).

</Warning>

## Preguntas frecuentes

<AccordionGroup>
<Accordion title="¿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.

</Accordion>
<Accordion title="¿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.

</Accordion>
<Accordion title="¿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.

</Accordion>
<Accordion title="¿Quieres usar Claude por completo en el editor?">

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

</Accordion>
</AccordionGroup>