InicioGuía
API de Claude Code para Cursor: Configuración de endpoint personalizado
¿Buscas una configuración de API de Claude Code para Cursor que no dependa de un solo proveedor? Cursor puede conectarse a cualquier endpoint compatible con OpenAI, y esta guía muestra cada configuración que necesitas.
Actualizado

Lo que estás configurando
Cursor es un editor con funciones de IA integradas. Entre sus configuraciones de modelo hay un campo que te permite reemplazar la URL base de OpenAI por la tuya, junto con un lugar para ingresar tu propia clave. Esto permite enviar peticiones de chat a cualquier servicio que siga el formato de chat-completions de OpenAI. Este servicio lo hace, por lo que Cursor puede usarlo como el modelo detrás del chat y las ediciones en línea.
Los valores que ingresarás son fijos. URL base: https://api.claudecodeapikey.com/v1. Nombre del modelo: uncensored. Clave: la de tu cuenta, enviada como token Bearer. No se necesita configurar nada más en el lado del servidor.
Ten claro qué es esto. El modelo detrás del endpoint es un modelo de pesos abiertos de un proveedor independiente. No es un modelo Claude ni la API oficial de Anthropic ni de nadie más. Si viniste aquí esperando Claude dentro de Cursor, esto es algo diferente; las secciones finales explican cómo juzgar si es suficiente para tu trabajo.
Antes de abrir Cursor
Prepara esto primero para no detenerte a mitad de camino.
- Crea una cuenta con Google o con correo electrónico y contraseña.
- Abre la página de la clave de API y crea una clave. La guía de claves muestra dónde está cada botón.
- Reclama el crédito de prueba de $0,50 si quieres probar sin pagar. Es un solo clic, no requiere tarjeta y dura 7 días.
- Ejecuta una verificación rápida desde una terminal para confirmar que la clave funciona antes de culpar al editor.
curl https://api.claudecodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'
Una respuesta JSON con un mensaje significa que la clave y la URL son correctas. Un HTTP 401 significa que la clave es incorrecta o tiene un espacio extra. Corrige eso aquí, porque los mensajes de error de Cursor son menos específicos que los de curl.
Configuración paso a paso en Cursor
Los nombres de los menús cambian entre versiones de Cursor, así que trata las etiquetas a continuación como una guía y busca la coincidencia más cercana.
- Abre la configuración de Cursor y ve a la sección de modelos.
- Busca el campo para una clave de API de OpenAI y pega tu clave de este servicio.
- Activa la opción para anular la URL base de OpenAI e ingresa
https://api.claudecodeapikey.com/v1. Incluye el/v1al final y omite cualquier ruta adicional como/chat/completions. - Usa la opción para agregar un modelo personalizado y escribe
uncensoredexactamente, en minúsculas. - Presiona el botón de verificar o guardar junto al campo de la clave. Cursor envía una pequeña petición de prueba.
- Abre un panel de chat, selecciona
uncensoreden el menú desplegable de modelos y envía un prompt corto.
Si el paso de verificación falla pero la prueba con curl pasó, verifica que escribiste la URL en el campo de URL base y no en el campo de la clave, y que tu versión de Cursor no haya restablecido la anulación después de una actualización. La guía de inicio rápido mantiene los pasos actuales para este editor.
Un detalle importante: una sola anulación se aplica al espacio del proveedor OpenAI. Si también usas modelos reales de OpenAI a través de ese espacio, ahora se enrutarán a este endpoint también. Muchas personas mantienen un perfil separado de Cursor o desactivan la anulación cuando quieren volver.
Prueba con un prompt de codificación real
Un saludo prueba poco. Usa un prompt que ejercite el contexto y las instrucciones. Selecciona una función en tu proyecto, abre el chat y pide algo concreto, como agregar validación de entrada y una prueba unitaria. Observa tres cosas.
- Streaming. La respuesta debe aparecer token por token. El endpoint hace streaming sobre SSE, por lo que una larga espera seguida de un bloque de texto sugiere que un proxy o una configuración lo está almacenando en búfer.
- Uso del contexto. Adjunta dos o tres archivos y haz una pregunta que necesite todos ellos. La ventana de contexto es de 100.000 tokens, lo que contiene mucho código fuente, pero tu editor decide cuánto envía realmente.
- Seguimiento de instrucciones. Pide una respuesta solo con diff o un formato de salida estricto y observa si el modelo se mantiene en ello. Los modelos de pesos abiertos varían en esto, y quieres aprender a usarlo desde el primer día.
Mantén una lista corta de cinco tareas reales de tu propio repositorio y ejecútalas cada vez que cambies una configuración como la temperatura. Juzgar desde tu propio código supera cualquier afirmación general, incluida la nuestra.
Corrección de errores comunes
401 o clave inválida
La clave es incorrecta, expiró en tu portapapeles o tiene espacios alrededor. Pégala de nuevo. Asegúrate de que el esquema de autorización sea Bearer, que Cursor hace por ti cuando usas el campo de clave de OpenAI.
404 o modelo no encontrado
Casi siempre un problema de URL base. Falta el /v1 o hay un /chat/completions extra que rompe la ruta. El nombre del modelo también debe ser uncensored, sin mayúsculas ni espacios.
429 con rate_limited o concurrency
Alcanzaste un límite. La clave de prueba permite 2 peticiones simultáneas y 60 por minuto, y una clave completa permite 8 concurrentes y 300 por minuto. Un editor puede disparar varias peticiones a la vez, por ejemplo, chat más ediciones en segundo plano, y el streaming mantiene su ranura hasta que termina. El código de error indica qué límite: rate_limited es por peticiones por minuto, concurrency es demasiadas a la vez. Una sobrecarga temporal también devuelve 429 con Retry-After: 5, por lo que esperar cinco segundos y reintentar es correcto.
La respuesta se corta
La ventana es de 100.000 tokens, prompt más completación. Un adjunto muy grande deja poco espacio para la respuesta. Envía menos archivos o inicia un chat nuevo.
Funciones que no hacen nada
La API es solo de texto y no ofrece embeddings. Si una función de Cursor necesita un modelo de embeddings o entrada de imagen, no funcionará a través de este endpoint.
Ajustes que vale la pena optimizar una vez que funcione
Después del primer chat exitoso, algunos ajustes hacen que el uso diario sea más fluido.
Reduce la temperatura para tareas de edición. Si tu editor lo permite, un valor de alrededor de 0,2 da código más estable. Para lluvia de ideas, súbela. Luego, vigila cuánto contexto adjuntas. La ventana es generosa, pero cada archivo adjunto se cobra como entrada, por lo que cerrar pestañas no relacionadas y excluir carpetas de compilación mantiene el costo bajo y las respuestas más enfocadas.
Si usas los modos de agente o multi-paso, recuerda el soporte de llamadas a funciones: el endpoint acepta tools y tool_choice y envía en streaming tool_calls. Si una función específica de Cursor las usa depende de la versión, así que ejecuta una tarea pequeña de agente y lee qué sucede antes de confiar en ella para un cambio grande. Finalmente, echa un vistazo al encabezado X-Balance-USD en una prueba de terminal de vez en cuando, para que un saldo bajo nunca te sorprenda en medio del trabajo.
Uso de la misma clave en scripts
Una ventaja de un endpoint compatible con OpenAI es que la clave que configuraste en Cursor también funciona en código. Aquí hay un ejemplo en Node, útil para scripts de compilación o herramientas de mensajes de commit.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.claudecodeapikey.com/v1",
apiKey: process.env.API_KEY,
});
const out = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
],
});
console.log(out.choices[0].message.content);
Guarda la clave en una variable de entorno, no en un archivo que subas al repositorio. Cada respuesta incluye un encabezado X-Balance-USD, así que un script puede avisarte cuando el crédito se agote.
Costo y cuándo mantener la configuración
El uso del editor es intensivo en entrada porque cada petición lleva contexto de archivos. A $0,15 por 1M de tokens de entrada y $0,50 por 1M de salida, una petición con 15.000 tokens de entrada y 1.000 de salida cuesta 0,015 x $0,15 + 0,001 x $0,50 = $0,00225 + $0,0005 = $0,00275. Cien de esas cuestan $0,275. La página de tarifas tiene montos de recarga, a partir de $20, con bonos desde $50.
Mantén tu configuración actual si dependes del modelo de un proveedor específico para refactorizaciones complejas, o si tu flujo de trabajo depende de funciones que un endpoint de chat simple no puede darte. Usa este cuando quieras un precio bajo por token, una API simple y menos rechazos de contenido en trabajo lícito. Muchos desarrolladores mantienen ambas configuradas y cambian según la tarea.
Más guías
Preguntas y respuestas
¿Qué URL base escribo en Cursor?
Escribe https://api.claudecodeapikey.com/v1 incluyendo el /v1. No añadas /chat/completions al final.
¿Qué nombre de modelo debo agregar?
Agrega un modelo personalizado llamado uncensored, en minúsculas. Es el único ID de modelo que ofrece la API.
¿Esto me da los modelos de Claude en Cursor?
No. El endpoint ofrece un modelo de pesos abiertos de un proveedor independiente. No es una API oficial de Anthropic ni de ningún otro proveedor.
¿Por qué obtengo errores 429 en el editor?
O bien superaste el límite por minuto o tienes demasiadas peticiones simultáneas. Una clave de prueba permite 2 concurrentes y 60 por minuto; una clave completa, 8 y 300.
¿Puedo probarlo sin pagar?
Sí. Los usuarios nuevos pueden reclamar $0,50 de crédito de prueba en la página de la clave de API. No requiere tarjeta y es válido por 7 días.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.