Cómo instalar y usar Cline CLI

Por CodeAgentSwarm · Actualizado el 31 de octubre de 2026

Cline es un agente de código open source que nació como extensión de VS Code y ahora también es el comando cline. En esta guía verás cómo se instala, cómo se inicia sesión, qué opciones vas a usar a diario, dónde guarda sus archivos y cómo lo ejecuta CodeAgentSwarm 2.5.0, en beta. Los datos de Cline se comprobaron en su documentación oficial y en el paquete de npm (versión 3.0.74) el 31 de octubre de 2026.

Qué es Cline CLI

Cline

Cline CLI es un agente de terminal: lee tu proyecto, edita archivos y ejecuta comandos. Con cline a secas abres su interfaz interactiva; con cline "tu tarea" hace una tarea y termina. Es el mismo agente que la extensión de Cline para VS Code y JetBrains, y los dos comparten reglas y skills. El paquete de npm se publica con licencia Apache-2.0.

Cline no te ata a un solo proveedor de modelos. Puedes usar el proveedor de Cline, que cobra la inferencia por uso, o traer tu propia clave de Anthropic, OpenAI, Google Gemini, OpenRouter, AWS Bedrock, GCP Vertex, Groq, Cerebras o cualquier endpoint compatible con OpenAI. Es el motivo principal por el que mucha gente lo prefiere a una CLI de un solo proveedor.

Instalar Cline CLI

bash
npm install -g cline
cline version

El paquete trae binarios nativos para macOS, Linux y Windows en x64 y ARM64, y npm elige el adecuado mediante una dependencia opcional. La documentación de instalación pide Node.js 20 o posterior y recomienda la 22. Hay una versión nightly en cline@nightly. Para actualizar más adelante, ejecuta cline update.

Cline seleccionado en el selector de agentes de CodeAgentSwarm con su etiqueta beta
Captura real de la demo de la versión 2.5.0 de CodeAgentSwarm: Cline seleccionado en el selector de agentes, listo para arrancar en vista CLI o Chat.

En CodeAgentSwarm no necesitas la terminal para esto. Elige Cline en el selector de agentes, o pulsa Install en Settings > Providers, y la app instala por ti el paquete oficial de npm. Antes comprueba que tienes Node.js 22.19 o posterior (en Windows y Linux puede preparar su propio Node; en macOS usa el Node.js que ya tengas) y al final verifica el resultado con cline --version. Settings > Providers te dice el siguiente paso de cada agente: Install, Sign in o Ready.

Conecta un proveedor de modelos con cline auth

bash
cline auth

Si ejecutas cline auth sin opciones, te guía para elegir proveedor, clave o cuenta y modelo por defecto. Las credenciales se guardan en ~/.cline/data/settings/ y las reutilizan todas las sesiones siguientes, también el Chat de CodeAgentSwarm. Con proveedores OAuth, ejecuta antes cline auth: un arranque normal no abre el navegador.

Si abres Cline en el Chat sin haber iniciado sesión, CodeAgentSwarm abre la terminal y te da el comando cline auth para que lo ejecutes. El uso lo factura tu proveedor; CodeAgentSwarm no revende acceso a modelos.

Las opciones que vas a usar a diario

Opción o comandoPara qué sirve
clineAbre la interfaz interactiva en la terminal
cline "arregla el test que falla"Hace una tarea y termina
-p, --planArranca en modo plan en lugar de modo act
-m, --modelElige el modelo del proveedor seleccionado
--thinkingFija el esfuerzo de razonamiento: none, low, medium, high o xhigh
--auto-approve true|falseActiva o desactiva la aprobación automática de herramientas
--id <session-id>Retoma una sesión guardada
cline historyLista las sesiones guardadas
--worktreeEjecuta la tarea en un git worktree separado
Fuente: <a href="https://docs.cline.bot/cli/cli-reference" class="text-neon-cyan hover:text-neon-purple transition-colors">referencia de Cline CLI</a>, consultada el 31 de octubre de 2026.

Según la referencia de la CLI, la aprobación automática viene activada por defecto, salvo en modo ACP, donde viene desactivada. Si quieres revisar cada herramienta en la terminal, arranca Cline con --auto-approve false.

Usa Cline en Chat o en la terminal

CodeAgentSwarm le da a Cline dos vistas. La de terminal ejecuta la interfaz normal de cline. El Chat habla con Cline a través de su servidor Agent Client Protocol (cline --acp) y te enseña los modelos de tu proveedor, los modos plan y act, adjuntos de imagen, un botón para parar y cada solicitud de permiso.

  • Ask before actions: Cline espera tu aprobación antes de editar un archivo o ejecutar un comando.
  • Auto-accept edits: las ediciones en el proyecto pasan solas; los comandos y las acciones delicadas siguen preguntando.
  • Full access: sin preguntas, igual que --auto-approve true.

El Chat siempre arranca Cline con la aprobación automática desactivada y aplica el modo que elijas. La app recuerda tu última elección para Cline y la usa en las sesiones nuevas. En la terminal solo añade --auto-approve true si esa última elección fue Full access; si no, Cline sigue su propia configuración.

Dónde guarda Cline sus archivos

QuéDónde
Carpeta de configuración~/.cline (o CLINE_DIR)
Proveedores y claves~/.cline/data/settings/providers.json
Servidores MCP~/.cline/data/settings/cline_mcp_settings.json
Reglas y skills globales~/.cline/rules/ y ~/.cline/skills/
Reglas del proyecto.clinerules/, .cline/rules/ o AGENTS.md en la raíz del proyecto
Índice de sesiones~/.cline/data/db/sessions.db
Rutas de la referencia de Cline CLI y de su documentación de reglas, consultadas el 31 de octubre de 2026.

Si lo permites en Settings > Privacy, CodeAgentSwarm añade sus herramientas de tareas y títulos como una entrada MCP, un archivo de reglas corto en ~/.cline/rules/codeagentswarm.md y unos hooks pequeños que avisan cuando una tarea termina y qué archivos han cambiado. Tus servidores y tus hooks no cambian, y al desactivar cada opción solo se quita lo que añadió la app.

Lo que la beta de la 2.5.0 todavía no hace

  • Cline informa del coste y los tokens de cada sesión, así que el panel de uso muestra el gasto por sesión. No hay cuota de cuenta que leer, de modo que Cline no tiene anillo de porcentaje ni presupuesto diario.
  • Los títulos de conversación y los mensajes de commit necesitan una ejecución sin herramientas, y Cline no la ofrece. Usa otro proveedor para esas dos ayudas.
  • Las bifurcaciones nativas de conversación de Cline no están disponibles dentro de CodeAgentSwarm.
  • Si tu versión de Cline no puede cargar una sesión antigua por ACP, el Chat te lo dice en vez de abrir una vacía. Actualiza Cline o abre la sesión en la terminal.

Más sobre Cline en CodeAgentSwarm:

Preguntas frecuentes

¿Cline CLI es gratis?

La CLI es open source y se instala gratis. Pagas el modelo que uses: con el proveedor de Cline, que cobra la inferencia por uso, o con tu propia clave de proveedor. CodeAgentSwarm no incluye uso de modelos.

¿Cómo se instala Cline CLI?

Ejecuta npm install -g cline con Node.js 20 o posterior (se recomienda la 22) y después cline auth para conectar un proveedor. En CodeAgentSwarm, al elegir Cline en el selector de agentes se instala solo.

¿Cómo retomo una sesión de Cline?

Ejecuta cline history para ver las sesiones y cline --id seguido del id para retomar una. CodeAgentSwarm muestra esas mismas sesiones en el historial de conversaciones y las reabre en Chat o en la terminal.

¿Cline CLI lee AGENTS.md?

Sí. Cline lee AGENTS.md en la raíz del proyecto junto con .clinerules y .cline/rules, además de las reglas globales de ~/.cline/rules.

¿Cline es estable en CodeAgentSwarm?

Cline llega a CodeAgentSwarm 2.5.0 con la etiqueta beta. Funcionan la instalación, el Chat, el historial, los permisos y el gasto por sesión; los títulos, los mensajes de commit y las bifurcaciones nativas todavía no.