Tutorial de Cline para principiantes: instalación, primera tarea, Plan/Act, reglas y MCP
Un tutorial de Cline paso a paso con 15 capturas verificadas: instala la extensión de VS Code, lanza una app real con un modelo gratuito y domina los modos Plan y Act, las reglas y los servidores MCP.
Lo esencial
- Cline es un agente de programación con IA, gratuito y de código abierto, dentro de VS Code: instálalo desde el Marketplace de extensiones, inicia sesión con Google o GitHub y empieza sin clave de API.
- El nivel Absolutely Free funciona con modelos alojados como DeepSeek V4 Flash (1M de contexto) y GLM-5.3-Flash; este recorrido deja lista una app de calculadora IMC funcional en 15 pasos.
- El modo Plan traza la estrategia con un modelo de razonamiento y el modo Act programa con un modelo rápido: todo el análisis en Plan de la demo costó 0,0145 $.
- Sube de nivel con tu propia clave de Gemini, reglas globales y de espacio de trabajo, y servidores MCP como GitHub y Context7: los tres pilares de una configuración ideal de Cline.
I Found 2 Ways to Use Cline for FREE (Best Free AI Coding Agent)
Vídeo del recorrido:HMA WebCode5:26
Ideal Setup for Cline
Fuente de datos:Cline3:47
Las capturas del recorrido provienen de la demo de configuración gratuita de HMA WebCode; las capturas de los ajustes de Plan/Act, de las reglas y del marketplace de MCP provienen de los vídeos cortos del canal oficial de Cline, que también son la fuente de datos sobre el comportamiento de los modos, el alcance de las reglas y la configuración de tres pilares.
Las capturas pertenecen a sus respectivos canales y se usan con atribución y enlaces profundos; todas las descripciones de los pasos son redacción propia.
El recorrido de Cline en 15 pasos
Instala Cline y desbloquea el nivel gratuito
- 1
Instala la extensión de Cline en VS Code
Abre la vista de extensiones de VS Code, busca Cline y pulsa Install en la ficha del agente de programación autónomo publicado por Cline Bot. Al terminar, el icono del robot de Cline aparece en la barra de actividades: haz clic para abrir el panel del agente junto al editor.
La ficha de Cline en el Marketplace de extensiones de VS Code, lista para instalar.Ver en 0:24 - 2
Elige cómo quieres usar Cline
La primera vez que abres el panel, Cline pregunta cómo quieres usarlo y ofrece cuatro caminos: Absolutely Free (modelos gratuitos alojados), ClinePlans (suscripción de pago para modelos de pesos abiertos), Frontier Model (pago por uso con la facturación de Cline) y Bring my own API key. Si empiezas, elige Absolutely Free: sin clave de API ni tarjeta.
La pantalla inicial de Cline con las cuatro opciones de configuración.Ver en 0:34 - 3
Inicia sesión y entra en el nivel gratuito
Selecciona Absolutely Free, pulsa Log in to Cline e inicia sesión con tu cuenta de Google o GitHub: toma unos diez segundos y no pide ningún método de pago. Aparecerás en la pantalla del proveedor con Cline Usage-Billing seleccionado, que es lo que alimenta los modelos gratuitos.
Tras iniciar sesión, Cline muestra el proveedor Usage-Billing con sus pestañas de modelos.Ver en 1:46 - 4
Elige un modelo gratuito y el esfuerzo de razonamiento
Abre el selector de modelos y cambia a la pestaña Free: DeepSeek V4 Flash (1M de contexto), GLM-5.3-Flash, LongCat 2.0 y Laguna S 2.1 llevan la etiqueta FREE. Elige DeepSeek V4 Flash para trabajar rápido con varios archivos y deja Reasoning Effort en Medium: Low es más rápido y High razona más pero gasta más tokens.
El ID de modelo deepseek/deepseek-v4-flash seleccionado con Reasoning Effort en Medium.Ver en 2:12
Ejecuta tu primera tarea de principio a fin
- 5
Abre un cuadro de tareas vacío
Crea o abre una carpeta de proyecto en VS Code y pulsa el icono de Cline. El panel te recibe con una pregunta sencilla: ese campo es donde empieza cada tarea. La fila de Auto-approve y el interruptor Plan/Act están en la parte inferior del panel.
El panel de tareas de Cline listo para el primer prompt, con Plan/Act en la esquina.Ver en 2:36 - 6
Envía tu primera tarea
Escribe un objetivo concreto en el cuadro de tareas, por ejemplo: crea una app web moderna de calculadora IMC con HTML, CSS y JavaScript donde el usuario introduzca altura en centímetros y peso en kilogramos y la app muestre el IMC con una etiqueta de categoría. Los requisitos concretos de entradas, salidas y diseño dan resultados mucho mejores que una línea suelta.
El prompt de la calculadora IMC escrito en el cuadro de tareas de Cline.Ver en 2:58 - 7
Aprueba cada acción — o apruébalas en automático
Cline trabaja paso a paso: quiere ejecutar un comando, crear un archivo o editar otro, y muestra un diff de cada cambio antes de aplicarlo. Aprueba una acción suelta o activa Auto-approve para Read, Edit y Commands y déjalo completar la lista solo: los checkpoints hacen que cada paso sea reversible de todos modos.
Cline pide aprobación para crear index.html y muestra el diff del CSS.Ver en 3:06 - 8
Abre la app terminada
En pocos minutos la tarea termina con un resumen y una entrada BMI Calculation Checkpoint. Abre el index.html generado con Live Server o cualquier servidor estático y pruébalo: 175 centímetros y 70 kilogramos dan un IMC de 22,9 — Normal. Una app completa y funcional sin escribir ni una línea.
La calculadora IMC terminada en el navegador junto al resumen de Cline en VS Code.Ver en 3:17
Modos Plan y Act sin tokens desperdiciados
- 9
Conoce los modos Plan y Act
El interruptor en la parte inferior del panel cambia entre Plan y Act. En el modo Plan, Cline solo investiga: lee archivos, hace preguntas y propone un plan de implementación. El diálogo de ajustes tiene pestañas con los mismos nombres para asignar un modelo distinto a cada modo: un buen razonador para Plan y un codificador rápido para Act.
Ajustes de Cline con las pestañas Plan Mode y Act Mode para asignar modelos por modo.Ver en 0:48 - 10
Deja que el modo Plan piense antes de programar
Los modelos de razonamiento brillan en el modo Plan porque descomponer una tarea es análisis, no tecleo. Como aún no se ha escrito nada, investigar a fondo es barato: el análisis de violaciones DRY de la demo costó solo 0,0145 $. Responde las preguntas de Cline mientras planifica; cada corrección aquí ahorra reescrituras después.
Una tarjeta de tarea en modo Plan con el análisis, los tokens y un coste de API de 0,0145 $.Ver en 1:10 - 11
Cambia a Act para escribir el código
Cuando el plan te convenza, cambia a Act: el plan queda fijado y Cline empieza a editar archivos. Los modelos de codificación son más baratos y rápidos en esta parte, y ahí está el ahorro de tokens de separar los modos. En la pantalla de reanudar tarea, Cline muestra el atajo: Win+Shift+A alterna entre los modos.
Ajustes con la pestaña Act Mode seleccionada y un modelo de codificación para ejecutar.Ver en 1:28
Tu propia clave, las reglas y el marketplace de MCP
- 12
O aporta tu propia clave gratuita
¿Prefieres tu propia cuota en lugar del grupo gratuito compartido de Cline? Elige Bring my own API key, selecciona Google Gemini y pulsa Get API key en Google AI Studio: el nivel gratuito solo pide una cuenta de Google. Pega la clave en el campo de API key de Cline, elige un modelo Gemini, guarda y trabajarás con tu propia cuota.
El diálogo Create API key de Google AI Studio que genera la clave gratuita de Gemini.Ver en 3:54 - 13
Enséñale a Cline tus estándares con reglas
Las reglas son instrucciones persistentes que Cline lee en cada tarea. Abre la pestaña Rules en los ajustes del panel: las reglas globales se aplican a todos los proyectos de tu equipo y las reglas del espacio de trabajo viven en el repositorio actual como archivos .clinerules que puedes confirmar y compartir. Úsalas para principios de código, prácticas de seguridad, guías de documentación y estilo.
La pestaña Rules en los ajustes de Cline con las secciones Global Rules y Workspace Rules.Ver en 1:06 - 14
Escribe reglas que un modelo pueda cumplir
Las reglas vagas salen mal: «optimiza el código cuando sea posible» le da a Cline margen para ignorarte. Escribe disparadores medibles: optimiza el código cuando las pruebas unitarias tarden más de 100 milisegundos, usa principios SOLID al usar clases, añade comentarios en línea cuando el código asuma algo. Trata las reglas como un documento vivo y elimina contradicciones.
Un archivo de reglas con tres reglas concretas y medibles que Cline aplica en cada tarea.Ver en 1:45 - 15
Amplía Cline con servidores MCP
El icono del MCP Marketplace en el panel abre servidores de un clic que añaden habilidades a Cline: GitHub para operaciones de repositorio, Context7 para documentación actualizada de librerías, Perplexity y Sequential Thinking para investigación y planificación. Instala un servidor, aprueba sus herramientas y Cline podrá invocarlo en mitad de la tarea: el tercer pilar de la configuración ideal.
El marketplace de MCP Servers de Cline con la tarjeta del servidor de GitHub y su botón Install.Ver en 2:44