Cline

Agente de programación de código abierto para VS Code que usa la API de OneProvider compatible con OpenAI.

Agente de programación Cline para VS Code

Qué funciona

Cline envía a OneProvider solicitudes de texto y de agente de programación compatibles con OpenAI, con un ID de modelo compatible que eliges del catálogo.

Limitación del cliente

Las capacidades de imagen, uso de herramientas y contexto dependen del modelo concreto elegido; verifica primero con una tarea de texto pequeña.

Configuración

1. Elige OpenAI Compatible

   En los ajustes de API Provider de Cline, elige OpenAI Compatible y pega tu clave de OneProvider.

   API Provider: OpenAI Compatible
   API Key: sk-your-key-here

2. Define la base URL personalizada

   Define la base URL como https://api.oneprovider.dev/v1 y el ID exacto del modelo como gpt-6.1-terra.

   Base URL: https://api.oneprovider.dev/v1
   Model ID: gpt-6.1-terra

3. Empieza una tarea de texto pequeña

   Abre una sesión nueva de Cline y pide una explicación pequeña de solo lectura antes de activar capacidades propias de un modelo.

Verifica la conexión

Confirma la solicitud en Consumo del Dashboard

La solicitud debe mostrar el modelo configurado y una fila de consumo compatible con OpenAI ya cobrada.

Datos de conexión

Protocolo

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Seguridad de la clave

Usa una clave dedicada con límites de modelo, frecuencia, gasto y caducidad; nunca subas la clave al repositorio en los ajustes del espacio de trabajo.

Qué modelo elegir

Cline usa el proveedor OpenAI Compatible, así que introduce el ID del modelo exactamente como en el catálogo . gpt-6.1-terra es una opción equilibrada por defecto para tareas de programación, gpt-6.1-sol sirve para trabajo grande con varios archivos y gpt-5.6-luna es barato para preguntas rápidas. Los ID de Claude también funcionan con el mismo proveedor, por ejemplo claude-sonnet-5-5. La entrada de imágenes, el uso de herramientas y el tamaño del contexto dependen del modelo concreto, así que empieza con una tarea pequeña de solo lectura. Si Cline pide una ventana de contexto o una salida máxima, copia los valores de la fila del modelo en el catálogo.

Errores frecuentes y soluciones

404 o “Invalid URL”

La Base URL debe ser https://api.oneprovider.dev/v1: con /v1 y sin /chat/completions.

401 Unauthorized

A la clave le falta un carácter o tiene un espacio o comillas alrededor, o el saldo está vacío. Pega la clave completa otra vez y revisa el panel.

“Model not found” o un 400 sobre el modelo

El ID tiene un error de escritura o no está en el catálogo. Cópialo de la página de modelos; la coincidencia es exacta y distingue mayúsculas de minúsculas.

429 “Insufficient balance”

Se agotó el saldo o el límite de gasto de la clave. Reintentar no ayuda: recarga el saldo o sube el límite.

El agente se detiene tras un paso

Puede que el modelo seleccionado no maneje bien las llamadas a herramientas. Elige un modelo de gama alta o equilibrado y mantén la tarea pequeña.

Los flujos se rompen o se quedan colgados

Desactiva las VPN o los proxies VLESS: almacenan SSE en búfer. OneProvider no lo hace.

Preguntas frecuentes

¿Qué proveedor elijo en Cline?

OpenAI Compatible. Pega la clave de OneProvider y la base URL de arriba.

¿Puedo usar modelos Claude en Cline?

Sí, introduce un ID de Claude en el mismo proveedor OpenAI Compatible, o usa el proveedor Anthropic de Cline con la base URL personalizada https://api.oneprovider.dev si tu versión lo ofrece.

¿Mi clave se guarda en el repositorio?

No, Cline la guarda en el almacén de secretos de VS Code. Aun así, usa una clave dedicada con límite de gasto y nunca la subas al repositorio en los ajustes del espacio de trabajo.

¿Dónde veo el consumo?

En la página Consumo del Dashboard: cada solicitud muestra el modelo y el importe cobrado.

Respuestas rápidas

¿Qué base URL uso?

Claude Code y los SDK de Anthropic usan https://api.oneprovider.dev. Los SDK de OpenAI y los clientes compatibles con OpenAI usan https://api.oneprovider.dev/v1. Una misma clave funciona con ambas; la lista de modelos está en la página de modelos y las tarifas, en la página de precios .

¿Cómo me autentico?

Envía la clave sk-… tal cual en x-api-key o en Authorization: Bearer: en uno de los dos, nunca en ambos. Guarda la clave en una variable de entorno, no en un archivo que se suba al repositorio. Más sobre la autenticación .

¿Dónde obtengo una clave?

Abre tu panel en el bot de Telegram @oneprovider_robot o en app.oneprovider.dev, recarga el saldo y pulsa “Emitir una clave”. Cada clave puede tener su propio límite de gasto. Panel y claves de API .

¿Qué significan 401, 404 y 429?

401: falta la clave, está mal escrita o se envió en un encabezado equivocado; pega la clave completa, sin comillas ni espacios. 404: casi siempre es una base URL incorrecta, por ejemplo con /v1 ausente o duplicado. 429 con “Insufficient balance”: se agotó el saldo del panel o el límite de gasto de la clave, así que recarga en lugar de reintentar; cualquier otro 429 es un límite de frecuencia, así que espera según Retry-After. Detalles: códigos de error y solución de problemas .

¿Por qué se cortan o se reinician los streams?

Las VPN y los proxies VLESS suelen almacenar SSE en búfer o romper la negociación de HTTP/2. OneProvider no tiene restricciones regionales y no almacena los streams en búfer: desactiva el proxy y reintenta.

¿Dónde pregunto si esto no basta?

Escribe a @Oneproviderhelpbot en Telegram o abre “Soporte” en el panel web, con el código de estado HTTP y el mensaje de error exacto. Cómo funciona el soporte .