Cline es una extensión de agente de programación con IA de código abierto; su uso habitual es leer código, modificar archivos y ejecutar comandos desde la barra lateral de VS Code. No está atado a un solo proveedor de modelos: además del sistema de cuentas de Cline, permite elegir una interfaz compatible con OpenAI en API Provider e ingresar tu propia Base URL, clave y ID de modelo. Para un equipo, esto significa que Cline puede conectarse a un gateway unificado que centraliza claves, consumo y modelos.

Este artículo sigue el orden instalación, configuración, verificación y despliegue en equipo. Cline se actualiza con rapidez; los nombres de botones y campos corresponden a la configuración de la versión actual.

Nota: Cline es una marca de Cline Bot Inc. Este artículo solo ofrece una explicación técnica y no implica afiliación, representación ni respaldo de Cline Bot Inc. Las funciones, la interfaz y las reglas de facturación del producto se rigen por la documentación oficial de Cline.

1. Prepara tres datos antes de empezar

La conexión personalizada de Cline solo requiere tres datos: una dirección compatible, una clave de API y un ID de modelo exacto. Conviene prepararlos del lado del gateway antes de abrir el editor.

  1. Abre la página de registro de ZSQH AI Gateway, regístrate e inicia sesión en la consola.
  2. Entra a «Claves de API», crea una clave nueva y ponle un nombre que identifique al usuario y al dispositivo, por ejemplo cline-zhang-macbook.
  3. Configura, si lo necesitas, un límite de cuota y una fecha de expiración. También conviene hacerlo en pruebas personales para evitar consumos anómalos.
  4. Copia la clave y guárdala en un gestor de contraseñas. La consola suele mostrarla completa una sola vez.
  5. Abre los precios de modelos y copia el ID del modelo que vas a usar. Los modelos y precios cambian; toma como referencia lo que muestra la página en este momento.

Registra los tres datos como se muestra abajo, para facilitar el diagnóstico y la entrega:

Base URL: https://ai.zhongshangqihang.com/v1
API Key: sk-... (guardar solo en el gestor de contraseñas)
Model: el ID que muestre la página de precios de modelos
Context Window: según la especificación oficial del modelo

La Base URL usa una dirección compatible con OpenAI y termina en /v1. No escribas la página principal del sitio ni agregues /chat/completions, porque es fácil duplicar la ruta y obtener un 404.

2. Instala Cline en VS Code

La instalación no es complicada; los problemas suelen aparecer después, con la confianza del espacio de trabajo y los permisos.

  1. Abre VS Code y presiona Cmd/Ctrl + Shift + X para abrir la vista de extensiones.
  2. Busca Cline, verifica el editor y haz clic en Install.
  3. Cuando termine la instalación, busca el icono de Cline en la barra de actividad izquierda y abre el panel.
  4. La primera vez se abre la página de configuración; elige usar tu propia clave de API. Según la versión, el texto puede ser Use your own API key.
  5. Actívalo solo en carpetas de confianza. Al abrir un repositorio desconocido, no dejes que el agente ejecute comandos con la aprobación automática activada.

En Cursor, Windsurf y VSCodium la entrada de instalación es similar, aunque el mercado de extensiones puede variar. Este artículo toma VS Code como referencia.

3. Elige un proveedor compatible con OpenAI

Abre el icono de engranaje en la esquina superior derecha del panel de Cline y selecciona OpenAI Compatible en el menú API Provider. Esta es la clave para conectarse a un gateway genérico.

No ingreses la clave del gateway en los campos específicos de OpenAI, Anthropic o Google; esos campos suelen traer su propio endpoint y método de autenticación, y equivocarse allí produce 401, 404 o fallas de conexión. Salvo que el gateway ofrezca explícitamente el protocolo nativo correspondiente, elige OpenAI Compatible.

Use Azure Identity Authentication solo sirve para identidades administradas de Azure; no la marques para una clave de gateway normal.

Si eliges un proveedor propio de Cline, se consume la cuota de la cuenta de Cline. Si eliges OpenAI Compatible e ingresas tu propia clave, las solicitudes van a tu gateway y la facturación la administra el gateway. No mezcles ambos caminos al diagnosticar.

4. Completa Base URL, clave y modelo

Los campos principales se completan así:

Campo Qué escribir Observaciones
Base URL https://ai.zhongshangqihang.com/v1 Conserva /v1; no incluyas /chat/completions
API Key La clave sk-... creada en la consola Una clave por persona; no la compartas con otras herramientas
Model El ID de modelo de la página de precios Cópialo tal cual; cuida mayúsculas y sufijos de versión
Model Configuration Ventana de contexto, salida máxima, etc. Usa las especificaciones reales del modelo, sin inflarlas
Azure Identity Déjala sin marcar Solo para escenarios de identidad administrada de Azure

Model es un identificador de enrutamiento, no un nombre para mostrar. Si falta un sufijo de versión o hay diferencias de mayúsculas y minúsculas, puede devolver Model Not Found. Cuando no encuentres la opción en la lista desplegable, por lo general puedes escribir el ID directamente, siempre que la versión actual lo permita.

Los campos Max Output Tokens, Context Window, Image Support, Computer Use y precios de Model Configuration sirven sobre todo para que Cline gestione el contexto y estime costos; no son la base de facturación del gateway. Si el contexto se configura más grande de lo real, el agente calculará mal el espacio disponible y el gateway terminará informando el exceso. Usa las especificaciones reales del modelo.

Si el modelo no admite llamadas a herramientas, las capacidades del agente para leer y escribir archivos y ejecutar comandos quedarán limitadas; las imágenes y el uso de computadora también dependen de las capacidades del modelo.

5. Verifica que la configuración funcione de verdad

Que Verify pase solo indica que la dirección, la clave y el nombre del modelo son aproximadamente correctos; no significa que todas las capacidades de llamadas a herramientas funcionen. Conviene hacer una verificación real.

  1. Crea una tarea vacía para evitar interferencias del contexto anterior.
  2. Selecciona explícitamente el modelo que acabas de configurar; no uses la selección automática.
  3. Envía una solicitud de solo lectura; por ejemplo, pide que explique un archivo pequeño del directorio actual.
  4. Abre el consumo o el registro de solicitudes de la consola del gateway y confirma que aparece un registro con la misma hora, el mismo modelo y la misma clave.
  5. Pide después un cambio pequeño que no escriba archivos y observa si requiere aprobación y si se completa.

Errores comunes y cómo interpretarlos:

  • Invalid API Key o 401: la clave es incorrecta, está deshabilitada o se copió con espacios o saltos de línea.
  • 403: la clave no tiene permisos suficientes, se agotó la cuota o el modelo no está permitido.
  • 404 o Model Not Found: la ruta de la Base URL o el ID del modelo son incorrectos.
  • 429: se activó el límite de frecuencia o se alcanzó el límite de cuota de la clave.
  • Tiempo de espera agotado: el endpoint no es accesible o hay un problema en la ruta de red.
  • El chat normal funciona pero las operaciones del agente fallan: sospecha primero de un modelo sin soporte de llamadas a herramientas, no de una clave inválida.

6. Cómo configurar la aprobación automática

La aprobación automática (Auto Approve) se controla por categorías: lectura, edición, comandos de terminal, navegador y herramientas MCP. Cada categoría se activa por separado y algunas distinguen entre «solo comandos seguros» y «todos los comandos».

Recomendación: permite solo la lectura de archivos del proyecto y deja desactivadas la edición, la terminal, el navegador y MCP. Cuando el flujo de trabajo sea estable, habilita cada categoría poco a poco; al habilitar la edición, activa también Checkpoints para poder revertir.

Los comandos de terminal son los de mayor riesgo. Cline no tiene una lista blanca fija: el modelo decide según el comando y sus argumentos. Las compilaciones, las pruebas y git status suelen considerarse seguros; npm install, rm -rf, mv y sed -i normalmente requieren confirmación. Esa decisión no es una barrera de seguridad y no reemplaza la revisión humana.

El modo YOLO omite todas las confirmaciones, incluidas las modificaciones de archivos, los comandos de terminal, el navegador y las llamadas MCP; la documentación oficial advierte claramente sobre su riesgo. Si quieres probarlo, hazlo en un repositorio desechable o en un entorno aislado y prepara una copia de seguridad en Git. Checkpoints ayuda a revertir, pero no equivale a una copia de seguridad ni cubre operaciones fuera del repositorio.

7. Pasos para implementarlo en el equipo

  • Haz primero una prueba piloto: elige de tres a cinco desarrolladores, unifiquen un modelo principal y trabajen una semana.
  • Registra la tasa de éxito de las solicitudes, la latencia promedio y el consumo diario por persona.
  • Crea una clave independiente para cada persona en el gateway, con cuota y fecha de expiración por persona; no uses claves compartidas.
  • Mantén una tabla de equivalencias de modelos: qué se escribe en Cline, a qué corresponde en el gateway y a qué cambiar si falla.
  • Documenta internamente la Base URL, los ID de modelo, la configuración de permisos y los errores comunes.
  • Unifica la fuente y la versión de la extensión para evitar paquetes modificados de origen desconocido.
  • Incluye las convenciones del proyecto en archivos de reglas del repositorio. Las versiones recientes usan el directorio .cline/; las anteriores suelen usar .clinerules. Consulta la documentación de tu versión y no escribas claves en los archivos de reglas.
  • Al producirse una salida, un cambio de equipo o el fin de un proyecto, deshabilita la clave correspondiente ese mismo día.

Para calcular costos, usa los precios de modelos como referencia y cuenta el volumen real de solicitudes y la longitud del contexto; no decidas por la impresión subjetiva de una sola tarea.

8. Seguridad y límites de los datos

  • La clave puede guardarse en archivos de configuración locales. Las versiones recientes guardan la configuración del proveedor en ~/.cline/data/settings/providers.json, que puede contener la clave. No lo subas a un repositorio ni lo sincronices con un disco público.
  • Activa el cifrado del disco y limita los permisos locales. En una computadora compartida, no guardes claves por mucho tiempo.
  • El agente lee archivos del espacio de trabajo. Excluye .env, credenciales y claves privadas del alcance de lectura; si tu versión admite configuración de archivos ignorados, configúrala y verifícala.
  • Los servidores MCP, complementos y hooks pueden ejecutar código o acceder a la red; instala solo fuentes confiables y lee la descripción de permisos.
  • La aprobación automática amplifica el riesgo de inyección de instrucciones. Cuando el agente lee páginas web, incidencias o repositorios desconocidos, esas instrucciones maliciosas pueden inducirlo a ejecutar comandos. Conserva la confirmación humana para las operaciones de terminal y de red.
  • Confirma primero que los datos saldrán de tu computadora y a qué servicios van antes de decidir qué repositorios habilitar; evalúa primero el código sensible.

9. Preguntas frecuentes

¿Cline puede conectarse a cualquier interfaz compatible con OpenAI?

En la mayoría de los casos sí, siempre que la interfaz sea compatible con las rutas y los parámetros que Cline usa realmente y que el modelo admita llamadas a herramientas. Verifica primero con un chat normal y después prueba la edición de archivos y la terminal.

¿La Base URL debe ser la dirección raíz o incluir /v1?

Con el protocolo compatible con OpenAI, escribe hasta /v1, por ejemplo https://ai.zhongshangqihang.com/v1; no agregues /chat/completions, porque la ruta se duplica.

Verify pasa, pero la tarea falla al ejecutarse. ¿A qué se debe?

Revisa primero el código de error y los registros del gateway. Las causas habituales son que el modelo no admite llamadas a herramientas, un contexto mal configurado, cuota insuficiente o solicitudes limitadas. Verify solo comprueba la conectividad básica y no cubre todas las capacidades.

¿Cuál es la diferencia entre la cuenta de Cline y una clave propia?

La cuenta de Cline consume la cuota del lado de Cline; con una clave propia, las solicitudes van al gateway que indiques y el gateway factura y registra. Los modelos disponibles, la ruta de los datos y la forma de diagnosticar son distintos.

¿El equipo puede compartir una sola clave?

Técnicamente es posible, pero no se recomienda. Una clave compartida no permite distinguir el consumo y, si se filtra, es difícil localizar el origen y limitar el daño. Una clave por persona, con cuota, expiración y registros, es más confiable.

Próximos pasos

Primero regístrate en ZSQH AI Gateway, crea una clave exclusiva para Cline y completa la Base URL y el modelo como se describe aquí. Cuando funcione una tarea de solo lectura, habilita gradualmente la edición y los permisos de terminal, y ajusta el modelo principal y las cuotas según los precios de modelos.

Lecturas relacionadas: