Qué es Cline AI: instalación en VS Code, configuración de API y trabajo seguro con código

Cline —también buscado como Cline AI, ClineAI o Cline agent— es un agente de programación con IA y código abierto que funciona dentro del editor y del terminal. En VS Code puede leer archivos del proyecto, buscar código, editar archivos, ejecutar comandos, usar un navegador y llamar a herramientas MCP, siempre según los permisos que hayas configurado. Cline no es un modelo de lenguaje: se conecta a un proveedor y utiliza el modelo elegido para razonar y generar código.

Esta guía explica qué es Cline, cómo instalarlo en VS Code, cómo conectar una API propia mediante OpenAI Compatible y cómo verificar la configuración sin conceder acceso innecesario. El ejemplo utiliza BetterToken, aunque el mismo proceso sirve como referencia para otros endpoints compatibles.

Lo esencial

• Cline es un agente de programación, no un modelo.
• Tras instalar la extensión, puedes usar el acceso a modelos de Cline o aportar tu propia API Key.
• Con BetterToken, selecciona OpenAI Compatible y usa https://www.bettertoken.ai/v1 como Base URL.
• Empieza con acceso de solo lectura. No actives de inmediato ediciones automáticas, comandos, navegador, MCP ni YOLO Mode.

Qué hacen Cline, VS Code y la API del modelo

Una tarea normal de Cline tiene tres capas:

1. VS Code muestra el proyecto, la conversación, los diff, la salida del terminal y las solicitudes de aprobación.
2. El agente Cline reúne contexto, elige herramientas, organiza los pasos y comprueba tus permisos.
3. La API del modelo recibe el contexto y devuelve análisis, código o una propuesta de llamada a una herramienta.

El resultado no depende solo de la extensión. El modelo influye en la calidad del razonamiento y del código, la velocidad, el tamaño del contexto y el coste. La configuración de Cline decide qué archivos y herramientas puede usar el modelo y qué acciones requieren aprobación.

Esa es la diferencia principal frente a un chat sencillo en el editor. Un chat suele producir texto. Cline trabaja en un ciclo de agente: lee información, propone el siguiente paso, utiliza una herramienta, analiza el resultado y continúa hasta completar la tarea o necesitar una decisión.

Cómo instalar Cline en VS Code

1. Abre VS Code.
2. Pulsa Ctrl/Cmd + Shift + X para abrir Extensions.
3. Busca Cline y selecciona la extensión oficial de Cline.
4. Haz clic en Install.
5. Abre Cline desde la Activity Bar.
6. En la pantalla inicial, elige Use your own API key para configurar un proveedor personalizado.

Si el icono no aparece después de instalar, ejecuta Developer: Reload Window o reinicia VS Code por completo. Los textos de la interfaz pueden variar entre versiones, pero los ajustes de Provider y modelo siguen estando disponibles en la barra lateral de Cline.

Qué necesitas antes de conectar la API

Para conectar Cline con BetterToken, prepara:

• una cuenta de BetterToken;
• una API Key dedicada;
• un Model ID actual copiado de la página de modelos y precios;
• una red que pueda acceder al endpoint;
• versiones actuales de VS Code y de la extensión Cline.

Trata la API Key como una contraseña. No la subas al repositorio ni la muestres en capturas, registros, issues o archivos públicos. En equipos, utiliza claves distintas por persona o entorno para poder limitar gasto, revocar acceso y rastrear solicitudes.

Configurar la API de BetterToken en Cline

Abre los ajustes de Cline e introduce estos valores:

Campo	Valor
API Provider	OpenAI Compatible
Base URL	https://www.bettertoken.ai/v1
API Key	Tu API Key de BetterToken
Model	El Model ID actual y exacto de la página de modelos

Ten en cuenta lo siguiente:

1. La Base URL es https://www.bettertoken.ai/v1. No añadas /chat/completions, /responses ni otra ruta concreta.
2. Copia el Model ID exactamente desde la lista actual, no desde un artículo o captura antiguos.
3. Normalmente no hacen falta User-Agent ni Header personalizados. Añádelos solo si la documentación oficial del servicio upstream lo exige.
4. No todos los modelos tienen que usar el mismo protocolo. Consulta la compatibilidad verificada en la documentación de BetterToken para Cline.

Si configuraste antes variables de OpenAI y Cline sigue usando un endpoint antiguo, elimínalas de la sesión actual en macOS o Linux:

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

En Windows PowerShell:

Remove-Item Env:OPENAI_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:OPENAI_BASE_URL -ErrorAction SilentlyContinue

Guarda con Done y recarga Cline. Después de cambiar la Base URL, la clave o el modelo, crea una tarea nueva para evitar que una sesión anterior conserve parámetros obsoletos o un contexto demasiado grande.

Primera solicitud: realiza una prueba de solo lectura

No empieces con “refactoriza todo el proyecto”. Abre un archivo de código normal y envía este prompt:

Lee únicamente el archivo abierto. Explica su propósito, sus entradas principales y sus salidas. No modifiques ningún archivo ni ejecutes comandos en el terminal.

La prueba es correcta si:

• Cline responde basándose en el archivo;
• no aparece ningún error de autenticación, modelo o conexión;
• no se modifica ningún archivo ni se ejecutan comandos;
• la solicitud y el consumo de Token aparecen en BetterToken Dashboard.

Si Cline responde pero no hay registro en el Dashboard, confirma que el Provider activo es OpenAI Compatible y revisa Base URL, API Key, Model ID y proxy de red. No publiques la clave completa en una captura al pedir ayuda.

Cómo ejecuta Cline una tarea de código

El ciclo habitual es:

1. Defines el resultado, el alcance permitido y los criterios de finalización.
2. Cline lee los archivos relevantes y busca código relacionado.
3. El modelo propone el siguiente paso: leer, editar, ejecutar una prueba o hacer una pregunta.
4. Cline comprueba el permiso y solicita aprobación cuando corresponde.
5. El resultado de la herramienta se incorpora al contexto y el modelo decide cómo continuar.
6. Revisas el diff final, la salida de comandos y las pruebas.

Para trabajos poco claros, empieza en Plan Mode. Cline puede explorar y discutir el código, pero no modifica archivos ni ejecuta comandos. Cuando el enfoque esté aprobado, cambia a Act Mode.

Ejemplo para Plan Mode:

Investiga por qué el endpoint de inicio de sesión devuelve HTTP 500 de forma intermitente. Lee solo el código y las pruebas relacionadas. Enumera las causas más probables, los archivos afectados y la corrección mínima y segura. No cambies el código.

Después de revisar el plan, pasa a Act Mode:

Aplica la corrección mínima aprobada. Modifica solo el endpoint de inicio de sesión y las pruebas directamente relacionadas. Ejecuta las pruebas más relevantes y detente cuando pasen. No refactorices otros módulos.

Es mucho más verificable que pedir simplemente “arregla el login”.

Permisos recomendados para las primeras tareas

Empieza con un perfil conservador:

Permiso	Recomendación inicial
Read project files	Activado
Read all files / fuera del workspace	Desactivado
Edit project files	Confirmar cada vez o dejar desactivado al principio
Execute safe commands	Confirmar manualmente en las primeras tareas
Execute all commands	Desactivado
Use the browser	Activar solo cuando sea necesario
Use MCP servers	Activar tras validar un servidor concreto
YOLO Mode	Desactivado en proyectos reales

Antes de aprobar un comando, revisa los argumentos, el directorio de trabajo y los archivos afectados. npm test y npm install no tienen el mismo riesgo; tampoco git status y git push.

Checkpoints y Git pueden deshacer cambios locales, pero no revierten una solicitud externa, la eliminación de datos remotos ni la exposición de un secreto. Para repositorios importantes, trabaja en una rama o worktree y evita que el agente acceda a archivos sensibles sin necesidad.

API, MCP y Cline Rules no son lo mismo

Cada concepto resuelve un problema distinto:

• La API del modelo aporta razonamiento y generación.
• MCP añade herramientas y fuentes de datos externas, como bases de datos, servicios alojados o sistemas internos.
• Cline Rules describe convenciones de código, límites arquitectónicos, requisitos de pruebas y forma de trabajar.

MCP no sustituye a la API del modelo. El orden más fiable es conectar la API y superar una prueba de solo lectura, añadir después las reglas del proyecto y, por último, conectar únicamente servidores MCP de confianza para tareas concretas. Guarda las credenciales MCP en variables de entorno o en un almacén seguro.

Cómo se calcula el coste de Cline

Cline es open source, pero ejecutar el modelo consume recursos. Cline ofrece varias vías de acceso, como facturación integrada, suscripciones y BYOK. BetterToken se configura como API propia, por lo que el coste final depende de las solicitudes realizadas al modelo elegido.

El consumo puede incluir:

• input tokens: prompts, archivos, reglas e historial;
• output tokens: respuestas, código y contenido de tool calls;
• cache tokens: solo cuando el modelo y el endpoint admiten caché.

El coste mostrado por Cline suele ser una estimación. Usa la factura del proveedor o BetterToken Dashboard como registro definitivo. Para evitar consumo innecesario:

• asigna un objetivo verificable a cada tarea;
• no cargues todo el repositorio sin motivo;
• busca y lee antes de pedir cambios amplios;
• crea una tarea nueva al cambiar de tema;
• comprueba el precio actual antes de una ejecución larga;
• usa un modelo más rápido y económico para trabajos sencillos si su tool calling es fiable;
• planifica antes de actuar en cambios grandes para evitar rehacer trabajo.

Errores frecuentes y solución

Síntoma	Qué revisar primero
401, Unauthorized o Invalid API Key	Clave correcta, espacios al principio o final y posible revocación
404	Base URL exactamente https://www.bettertoken.ai/v1, sin rutas adicionales
model not found	Model ID actual, con mayúsculas, minúsculas y símbolos exactos
Sigue activa la configuración antigua	Guardar, recargar la extensión o VS Code y crear una tarea nueva
Fallos constantes de conexión	Red local, proxy, firewall y DNS hacia el endpoint
Hay respuesta, pero el Dashboard está vacío	Provider activo, cuenta, variables antiguas y Base URL
Respuestas extrañas o tools fallan	Adecuación del modelo para agent/tool calling y parámetros correctos
Consumo de Token demasiado rápido	Contexto excesivo, historial largo o lectura repetida de los mismos archivos

Cambia una sola variable cada vez. Confirma primero Provider, Base URL, clave y Model; después ajusta contexto, límite de salida, Header o proxy.

Tareas adecuadas para Cline

Cline resulta útil para:

• comprender un módulo desconocido y localizar archivos relacionados;
• corregir un Bug acotado con pasos de reproducción o una prueba existente;
• aplicar un cambio coherente en varios archivos;
• ejecutar lint, build o pruebas y explicar el fallo;
• implementar una función bien delimitada siguiendo patrones existentes;
• usar herramientas MCP bajo una política de acceso explícita.

Ejemplo de prompt práctico:

Objetivo: añadir un filtro por estado a la lista de pedidos.
Alcance permitido: la página de lista, los parámetros de consulta usados directamente y las pruebas relacionadas.
No hacer: no refactorizar el módulo de pedidos, no actualizar dependencias y no cambiar la lógica de pagos.
Criterios de finalización: el usuario puede elegir un estado y ver resultados correctos; el filtro se conserva al actualizar la página.
Verificación: ejecutar las pruebas de la lista de pedidos y detenerse cuando pasen.

Cline puede ser innecesario para una pregunta de una línea. Tampoco conviene darle acceso ilimitado a un repositorio muy sensible sin aislamiento y políticas. Para flujos fijos, repetitivos y sin supervisión, una integración CLI o CI suele ser mejor que mantener VS Code abierto.

Preguntas frecuentes

¿Qué es Cline AI?

Cline es un agente de programación con IA y código abierto para editores y terminales. Puede leer código, editar archivos, ejecutar comandos, usar el navegador y llamar a MCP. Una API externa aporta el razonamiento, mientras los permisos de Cline mantienen las acciones bajo control del usuario.

¿ClineAI, Cline agent y Cline son lo mismo?

En las búsquedas, estos términos suelen referirse al mismo agente. El nombre oficial del producto es Cline.

¿Cline funciona en VS Code?

Sí. La extensión oficial se abre en la barra lateral de VS Code y muestra conversación, diff, estado de la tarea y solicitudes de aprobación.

¿Cómo conecto mi propia API a Cline?

Elige el Provider adecuado en los ajustes. Para BetterToken, selecciona OpenAI Compatible, introduce https://www.bettertoken.ai/v1, tu API Key y el Model ID actual exacto; guarda y recarga la extensión.

¿Necesito una suscripción de Cline?

No necesariamente. Cline admite diferentes métodos de acceso a modelos, incluidos sus propios planes y API Keys externas. La elección depende de tu cuenta, región, modelos y presupuesto.

¿Cuál es la diferencia entre Cline y MCP?

Cline es el agente que ejecuta la tarea, la API del modelo aporta inteligencia y MCP añade herramientas y datos externos. Son capas complementarias.

¿Es seguro Cline?

Depende de los permisos, el prompt, el modelo, los servidores MCP y el entorno. El principio de mínimo acceso, la revisión de comandos, Git, el aislamiento de secretos y mantener YOLO Mode desactivado reducen mucho el riesgo.

Conclusión

Cline es más que un chat dentro de VS Code. Reúne contexto del proyecto, modificaciones, comandos y diff revisables en un solo flujo de agente. La forma correcta de empezar es instalar la extensión oficial, conectar una API, superar una prueba de solo lectura y ampliar los permisos de edición, terminal, navegador y MCP solo cuando exista una necesidad concreta.

Con BetterToken, usa OpenAI Compatible, la Base URL https://www.bettertoken.ai/v1, tu propia API Key y un Model ID válido y actual. Empieza con una tarea pequeña y específica, y trata cada permiso nuevo como una decisión deliberada.

Lecturas recomendadas:

• Introducción oficial a Cline
• Guía de instalación de Cline
• Configuración OpenAI Compatible en Cline
• Guía de BetterToken para Cline
• Crear una cuenta de BetterToken