Invita a un amigo y consigue 1 mes de Pro gratisCómo funciona

Cómo usar Cline CLI: guía paso a paso de Cline en la terminal

Cómo usar Cline CLI: instalar con npm, entrar o usar tu propia clave, alternar Plan y Act, ejecutar sin interfaz con --json, retomar sesiones y añadir reglas y MCP.

Solviera Teknoloji 8 min de lectura

Para usar Cline CLI, lo instalas con npm install -g cline, ejecutas cline auth para iniciar sesión o añadir una clave de proveedor, y luego ejecutas cline dentro de un proyecto y describes la tarea. A diferencia de la mayoría de las CLI de programación, Cline aprueba sus propias llamadas a herramientas por defecto, así que pasa --auto-approve false en cualquier repositorio que te importe.

Esta guía cubre Cline CLI 3.0 a noviembre de 2026 (versión 3.0.74): instalación, inicio de sesión, Plan y Act, aprobaciones, ejecuciones sin interfaz con --json, sesiones, modelos, reglas, MCP y lo que cuesta.

Qué es Cline CLI

Cline nació como extensión de VS Code y es uno de los agentes de programación abiertos más usados. Cline CLI lleva ese mismo agente a la terminal. La versión 3.0, publicada en mayo de 2026, fue una reescritura sobre el nuevo SDK de Cline con una interfaz de terminal nueva, así que las guías escritas para la CLI 2.x están desactualizadas.

Cline no está atado a ningún modelo. Puedes usar una cuenta de Cline con créditos, una suscripción a ClinePass o tu propia clave para Anthropic, OpenAI, Gemini, OpenRouter, Bedrock, Vertex, DeepSeek, un modelo local a través de Ollama o LM Studio, y más de treinta proveedores más.

Paso 1: instalar la CLI

npm install -g cline

Es el único método de instalación oficial. Hay binarios precompilados para macOS, Linux y Windows, tanto en arm64 como en x64; usa Node 22 para ir sobre seguro, porque la documentación y el paquete no coinciden en la versión mínima. Para actualizar más adelante, cline update. Si quieres la compilación más reciente, npm install -g cline@nightly instala el canal nightly.

Paso 2: iniciar sesión o añadir una clave

cline auth

Esto abre una configuración interactiva. cline auth cline inicia sesión en una cuenta de Cline desde el navegador. Para fijar un proveedor sin preguntas, por ejemplo en un servidor:

cline auth -p anthropic -k "$ANTHROPIC_API_KEY" -m claude-sonnet-5-5

Cline también lee claves del entorno (ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY, CLINE_API_KEY y otras). Las credenciales guardadas van a ~/.cline/data/settings/providers.json.

Paso 3: trabajar en la vista interactiva

cd my-project
cline

Describe la tarea con tus palabras, o arranca directamente con una: cline -i "add tests for the price formatter". Teclas y comandos útiles:

  • Tab alterna entre Plan y Act. El modo Plan lee y discute pero no puede editar archivos; el modo Act, el predeterminado, aplica los cambios. cline -p arranca en Plan.
  • Shift+Tab activa o desactiva la aprobación automática.
  • @file añade un archivo (o una imagen) al mensaje.
  • /model y /settings cambian la configuración; /mcp gestiona los servidores; /compact acorta una conversación larga; /undo revierte el último cambio; /history abre sesiones anteriores.
  • Ctrl+C detiene el turno actual; púlsalo dos veces, o Ctrl+D, para salir.

Un buen hábito para tareas grandes: empieza en Plan, acuerda los pasos con Cline y luego cambia a Act.

Paso 4: decidir cuánto puede hacer Cline por su cuenta

Este es el ajuste que más sorprende. En Cline CLI:

SituaciónQué ocurre
cline (interactivo)--auto-approve está activado salvo que lo desactives
cline --auto-approve falsePregunta Approve tool …? [y/N] antes de cada herramienta
cline "task" (una sola tarea) o entrada por pipeSe ejecuta en modo yolo
cline -yModo yolo; la propia ayuda de Cline lo califica de peligroso fuera de un sandbox

No hay lista de permitidos o denegados para comandos de shell. Para bloquear un comando, añade un hook PreToolUse (paso 7). En un repositorio real, empieza con --auto-approve false o trabaja en una rama limpia para poder descartar cualquier cambio con facilidad.

Paso 5: ejecuciones sin interfaz y CI

Cline funciona sin la vista interactiva cuando pasas --json, le envías algo por pipe o rediriges su salida:

git diff | cline "review this diff for bugs"
cline --json "summarize the changes on this branch" | jq -r 'select(.type=="run_result") | .text'

--json imprime un evento JSON por línea y termina con un run_result que contiene el texto final, el motivo de finalización y el uso de tokens. Otros flags que conviene conocer: -c fija la carpeta de trabajo, --worktree ejecuta en un git worktree, -t pone un tiempo límite en segundos y --data-dir guarda el estado en una carpeta aislada.

En CI, instala con npm, ejecuta cline auth con una clave del almacén de secretos y luego lanza la tarea. Recuerda que las ejecuciones de una sola tarea lo aprueban todo, así que da al job solo los permisos que necesita.

Paso 6: sesiones y modelos

cline history muestra las sesiones anteriores en un selector donde puedes retomarlas o borrarlas. Para reabrir una directamente:

cline history --json --limit 10
cline --id <session-id>

Las sesiones se guardan en ~/.cline/data/sessions/. cline history export <session-id> -o session.html guarda una como página.

Para elegir modelo en una sola ejecución, usa -P para el proveedor y -m para el modelo; --thinking acepta none, low, medium, high o xhigh. En la vista interactiva, usa /model. Con una cuenta de Cline y sin modelo elegido, el predeterminado es Claude Sonnet 5.5 desde la versión 3.0.73.

Paso 7: reglas, hooks y servidores MCP

Reglas. Pon las reglas del proyecto en .clinerules/ o .cline/rules/, y las globales en ~/.cline/rules. Cline también lee AGENTS.md en la raíz del proyecto, así que un archivo que ya mantienes para Codex u otros agentes funciona tal cual. Nuestra guía sobre CLAUDE.md y AGENTS.md explica qué poner en él.

Skills y hooks. Los skills viven en .cline/skills/ o .agents/skills/ y se ejecutan como /skill-name; cline skill add <owner/repo> instala uno. Los hooks son scripts ejecutables con el nombre del evento, como .cline/hooks/PreToolUse.sh, y son la forma de bloquear comandos arriesgados.

MCP. Añade servidores desde la línea de comandos:

cline mcp add memory --yes -- npx -y @modelcontextprotocol/server-memory
cline mcp add docs https://example.com/mcp --transport http --yes

Se guardan en mcpServers dentro de ~/.cline/data/settings/cline_mcp_settings.json. cline mcp abre un menú y cline mcp remove <name> elimina uno.

Lo que cuesta Cline CLI (a noviembre de 2026)

OpciónPrecioNotas
Cline CLIGratisLa herramienta en sí
Créditos de ClinePago por usoSe compran en app.cline.bot; algunos modelos gratuitos con una cuota pequeña
ClinePass9,99 $/mesLímites más altos en modelos abiertos seleccionados
Tu propia claveEl precio de tu proveedorAnthropic, OpenAI, OpenRouter, modelos locales y más
EnterpriseA medidaSSO, SLA, acceso por roles, facturación centralizada

Consulta la página de precios de Cline antes de decidir.

Errores habituales

  • Aprobación automática activada por defecto. Desactívala con --auto-approve false hasta que confíes en la configuración.
  • Seguir guías de la 2.x. La reescritura 3.0 cambió comandos y flags. Si tienes dudas, ejecuta cline --help en tu versión; algunos flags, como -y, no aparecen en la referencia online.
  • OAuth sin interfaz. Los proveedores OAuth nunca abren un navegador en ejecuciones sin interfaz. Ejecuta antes cline auth <provider> una vez en esa máquina.
  • Procesos en segundo plano atascados. cline doctor revisa la configuración y cline doctor fix detiene los procesos colgados.
  • .clineignore va de salida. Usa un hook PreToolUse para mantener a Cline lejos de ciertos archivos.

Ejecutar Cline CLI junto a otras CLI en AgentVera

Si Cline es el único agente que usas, puede que su propia interfaz te baste. La cosa se complica cuando Cline trabaja junto a Claude Code, Codex o Gemini CLI en el mismo proyecto. AgentVera es una app de escritorio que ejecuta estas CLI lado a lado en terminales reales, con tus propias instalaciones y claves. El soporte de Cline funciona así:

  • Una sesión por agente. AgentVera encuentra la sesión que crea Cline mediante cline history --json y la reabre con cline --id <id> en los siguientes arranques, así que la conversación sobrevive a un reinicio de la app.
  • Modelo y esfuerzo. El modelo que eliges se pasa con --model y el nivel de esfuerzo con --thinking.
  • Una cuenta por agente. En Ajustes → Cuentas puedes añadir claves de Anthropic, OpenAI u OpenRouter; cada cuenta de Cline recibe su propio archivo de proveedores y todo lo demás se comparte.
  • MCP y tokens. Los servidores del gestor de MCP de AgentVera llegan a Cline a través de su archivo de ajustes MCP, y AgentVera lee el uso de tokens de Cline para los presupuestos de tokens.
  • Paneles y revisión. Ejecuta Cline en la cuadrícula del workspace junto a otros agentes y comprueba sus cambios con la revisión de código.

El plan gratuito ejecuta 2 agentes a la vez e incluye MCP, Git, Docker, SSH, revisión de código y ahorro de tokens. Pro cuesta 9,99 $ al mes y no tiene límite de agentes; si nunca has tenido una prueba, tu primer inicio de sesión en la app activa Pro durante 7 días sin tarjeta. Para probarlo, descarga AgentVera.

Conclusión

Para empezar con Cline CLI bastan tres comandos: npm install -g cline, cline auth y cline. Las decisiones importantes vienen justo después: desactiva la aprobación automática en trabajo real, planifica antes de actuar en tareas grandes, mantén las reglas del proyecto en AGENTS.md o .clinerules/ y da a las ejecuciones de CI de una sola tarea solo el acceso que necesitan.

Fuentes: referencia de Cline CLI, visión general de la CLI, autorización, reglas de Cline, MCP, changelog de la CLI.

Preguntas frecuentes

¿Cline CLI es gratis?

La CLI en sí no cuesta nada. Lo que pagas es el modelo: créditos de Cline comprados en app.cline.bot, una suscripción a ClinePass (9,99 $ al mes a noviembre de 2026, para modelos abiertos seleccionados) o tu propia clave de API de Anthropic, OpenAI, OpenRouter y muchos otros proveedores. Algunos modelos gratuitos incluyen una cuota pequeña.

¿Cline CLI pregunta antes de editar archivos?

No por defecto. --auto-approve vale true, y una ejecución de una sola tarea como cline "task" funciona en modo yolo. Arranca con --auto-approve false para recibir una pregunta de sí o no por cada herramienta, o activa y desactiva la aprobación automática con Shift+Tab en la vista interactiva.

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

Ejecuta cline history para elegir una sesión anterior de una lista, o cline --id <session-id> para reabrirla directamente. cline history --json lista las sesiones con sus ids, algo muy útil en scripts.

¿Cline CLI lee AGENTS.md?

Sí. Además de sus propias carpetas de reglas (.clinerules/ o .cline/rules/ en el proyecto, ~/.cline/rules a nivel global), Cline lee AGENTS.md en la raíz del proyecto, y también .cursorrules y .windsurfrules.

¿Puedo usar mi suscripción de Claude Code o ChatGPT con Cline CLI?

Entre sus proveedores, Cline incluye un proveedor de Claude Code y un inicio de sesión con ChatGPT (openai-codex). Revisa los términos del propio proveedor antes de usar una suscripción a través de otra herramienta.

Reúne a tus agentes en un mismo escritorio.

Descarga AgentVera gratis; tus CLI instaladas ya están listas.

Más artículos